@diegovelasquezweb/a11y-engine 0.1.0

package/assets/reporting/wcag-reference.json

@@ -0,0 +1,588 @@
+{
+  "apgPatterns": {
+    "alert": "https://www.w3.org/WAI/ARIA/apg/patterns/alert/",
+    "alertdialog": "https://www.w3.org/WAI/ARIA/apg/patterns/alertdialog/",
+    "button": "https://www.w3.org/WAI/ARIA/apg/patterns/button/",
+    "carousel": "https://www.w3.org/WAI/ARIA/apg/patterns/carousel/",
+    "checkbox": "https://www.w3.org/WAI/ARIA/apg/patterns/checkbox/",
+    "combobox": "https://www.w3.org/WAI/ARIA/apg/patterns/combobox/",
+    "dialog": "https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/",
+    "disclosure": "https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/",
+    "feed": "https://www.w3.org/WAI/ARIA/apg/patterns/feed/",
+    "grid": "https://www.w3.org/WAI/ARIA/apg/patterns/grid/",
+    "link": "https://www.w3.org/WAI/ARIA/apg/patterns/link/",
+    "listbox": "https://www.w3.org/WAI/ARIA/apg/patterns/listbox/",
+    "menu": "https://www.w3.org/WAI/ARIA/apg/patterns/menubar/",
+    "menubar": "https://www.w3.org/WAI/ARIA/apg/patterns/menubar/",
+    "menuitem": "https://www.w3.org/WAI/ARIA/apg/patterns/menubar/",
+    "meter": "https://www.w3.org/WAI/ARIA/apg/patterns/meter/",
+    "radio": "https://www.w3.org/WAI/ARIA/apg/patterns/radio/",
+    "radiogroup": "https://www.w3.org/WAI/ARIA/apg/patterns/radio/",
+    "slider": "https://www.w3.org/WAI/ARIA/apg/patterns/slider/",
+    "spinbutton": "https://www.w3.org/WAI/ARIA/apg/patterns/spinbutton/",
+    "switch": "https://www.w3.org/WAI/ARIA/apg/patterns/switch/",
+    "table": "https://www.w3.org/WAI/ARIA/apg/patterns/table/",
+    "tab": "https://www.w3.org/WAI/ARIA/apg/patterns/tabs/",
+    "tablist": "https://www.w3.org/WAI/ARIA/apg/patterns/tabs/",
+    "tabpanel": "https://www.w3.org/WAI/ARIA/apg/patterns/tabs/",
+    "toolbar": "https://www.w3.org/WAI/ARIA/apg/patterns/toolbar/",
+    "tooltip": "https://www.w3.org/WAI/ARIA/apg/patterns/tooltip/",
+    "treeview": "https://www.w3.org/WAI/ARIA/apg/patterns/treeview/",
+    "treegrid": "https://www.w3.org/WAI/ARIA/apg/patterns/treegrid/",
+    "navigation": "https://www.w3.org/WAI/ARIA/apg/patterns/landmarks/examples/navigation.html",
+    "banner": "https://www.w3.org/WAI/ARIA/apg/patterns/landmarks/examples/banner.html",
+    "contentinfo": "https://www.w3.org/WAI/ARIA/apg/patterns/landmarks/examples/contentinfo.html",
+    "complementary": "https://www.w3.org/WAI/ARIA/apg/patterns/landmarks/examples/complementary.html",
+    "main": "https://www.w3.org/WAI/ARIA/apg/patterns/landmarks/examples/main.html",
+    "form": "https://www.w3.org/WAI/ARIA/apg/patterns/landmarks/examples/form.html",
+    "heading": "https://www.w3.org/WAI/ARIA/apg/practices/structural-roles/",
+    "group": "https://www.w3.org/WAI/ARIA/apg/patterns/landmarks/examples/form.html"
+  },
+  "mdn": {
+    "accesskeys": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/accesskey",
+    "area-alt": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/area",
+    "aria-allowed-attr": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes",
+    "aria-allowed-role": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles",
+    "aria-braille-equivalent": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-braillelabel",
+    "aria-command-name": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/button_role",
+    "aria-conditional-attr": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes",
+    "aria-deprecated-role": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles",
+    "aria-dialog-name": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/dialog_role",
+    "aria-hidden-body": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-hidden",
+    "aria-hidden-focus": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-hidden",
+    "aria-input-field-name": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/textbox_role",
+    "aria-meter-name": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/meter_role",
+    "aria-progressbar-name": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/progressbar_role",
+    "aria-prohibited-attr": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes",
+    "aria-required-attr": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes",
+    "aria-required-children": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles",
+    "aria-required-parent": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles",
+    "aria-roledescription": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-roledescription",
+    "aria-roles": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles",
+    "aria-text": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-label",
+    "aria-toggle-field-name": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input/checkbox",
+    "aria-tooltip-name": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/tooltip_role",
+    "aria-treeitem-name": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/treeitem_role",
+    "aria-valid-attr": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes",
+    "aria-valid-attr-value": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes",
+    "audio-caption": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/track",
+    "autocomplete-valid": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/autocomplete",
+    "avoid-inline-spacing": "https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/letter-spacing",
+    "blink": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/blink",
+    "button-name": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/button_role",
+    "bypass": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/a",
+    "color-contrast": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/Guides/Understanding_WCAG/Perceivable#contrast_minimum",
+    "css-orientation-lock": "https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/At-rules/@media/orientation",
+    "definition-list": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/dl",
+    "dlitem": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/dd",
+    "document-title": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/title",
+    "duplicate-id": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/id",
+    "duplicate-id-aria": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/id",
+    "empty-heading": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/Heading_Elements",
+    "empty-table-header": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/th",
+    "focus-order-semantics": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/tabindex",
+    "form-field-multiple-labels": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/label",
+    "frame-focusable-content": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/iframe",
+    "frame-tested": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/iframe",
+    "frame-title": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/iframe#title",
+    "frame-title-unique": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/iframe#title",
+    "heading-order": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/Heading_Elements",
+    "hidden-content": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/hidden",
+    "html-has-lang": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/lang",
+    "html-lang-valid": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/lang",
+    "html-xml-lang-mismatch": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/lang",
+    "identical-links-same-purpose": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/a",
+    "image-alt": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/img#alt",
+    "image-redundant-alt": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/img#alt",
+    "input-button-name": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input/submit",
+    "input-image-alt": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input/image",
+    "label": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/label",
+    "label-content-name-mismatch": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-label",
+    "label-title-only": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/label",
+    "landmark-banner-is-top-level": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/header",
+    "landmark-complementary-is-top-level": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/aside",
+    "landmark-contentinfo-is-top-level": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/footer",
+    "landmark-main-is-top-level": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/main",
+    "landmark-no-duplicate-banner": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/header",
+    "landmark-no-duplicate-contentinfo": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/footer",
+    "landmark-no-duplicate-main": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/main",
+    "landmark-one-main": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/main",
+    "landmark-unique": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/nav",
+    "link-in-text-block": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/a",
+    "link-name": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/a",
+    "list": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/ul",
+    "listitem": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/li",
+    "marquee": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/marquee",
+    "meta-refresh": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/meta/http-equiv",
+    "meta-viewport": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/meta/name/viewport",
+    "meta-viewport-large": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/meta/name/viewport",
+    "nested-interactive": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/button",
+    "no-autoplay-audio": "https://developer.mozilla.org/en-US/docs/Web/Media/Guides/Autoplay",
+    "object-alt": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/object",
+    "p-as-heading": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/Heading_Elements",
+    "page-has-heading-one": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/Heading_Elements",
+    "presentation-role-conflict": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/presentation_role",
+    "region": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/header",
+    "role-img-alt": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/img_role",
+    "scope-attr-valid": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/th#scope",
+    "scrollable-region-focusable": "https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/overflow",
+    "select-name": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/select",
+    "server-side-image-map": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/map",
+    "skip-link": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/a",
+    "summary-name": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/summary",
+    "svg-img-alt": "https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/svg",
+    "tabindex": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/tabindex",
+    "table-duplicate-name": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/caption",
+    "table-fake-caption": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/caption",
+    "target-size": "https://developer.mozilla.org/en-US/docs/Web/Accessibility/Guides/Understanding_WCAG/Operable#guideline_2.5_%E2%80%94_input_modalities",
+    "td-has-header": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/th",
+    "td-headers-attr": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/td#headers",
+    "th-has-data-cells": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/th",
+    "valid-lang": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/lang",
+    "video-caption": "https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/track"
+  },
+  "wcagCriterionMap": {
+    "accesskeys": "2.1.1",
+    "area-alt": "2.4.4",
+    "aria-allowed-attr": "4.1.2",
+    "aria-allowed-role": "4.1.2",
+    "aria-braille-equivalent": "4.1.2",
+    "aria-command-name": "4.1.2",
+    "aria-conditional-attr": "4.1.2",
+    "aria-deprecated-role": "4.1.2",
+    "aria-dialog-name": "4.1.2",
+    "aria-hidden-body": "4.1.2",
+    "aria-hidden-focus": "4.1.2",
+    "aria-input-field-name": "4.1.2",
+    "aria-meter-name": "1.1.1",
+    "aria-progressbar-name": "1.1.1",
+    "aria-prohibited-attr": "4.1.2",
+    "aria-required-attr": "4.1.2",
+    "aria-required-children": "1.3.1",
+    "aria-required-parent": "1.3.1",
+    "aria-roledescription": "4.1.2",
+    "aria-roles": "4.1.2",
+    "aria-text": "4.1.2",
+    "aria-toggle-field-name": "4.1.2",
+    "aria-tooltip-name": "4.1.2",
+    "aria-treeitem-name": "4.1.2",
+    "aria-valid-attr": "4.1.2",
+    "aria-valid-attr-value": "4.1.2",
+    "audio-caption": "1.2.1",
+    "autocomplete-valid": "1.3.5",
+    "avoid-inline-spacing": "1.4.12",
+    "blink": "2.2.2",
+    "button-name": "4.1.2",
+    "bypass": "2.4.1",
+    "color-contrast": "1.4.3",
+    "css-orientation-lock": "1.3.4",
+    "definition-list": "1.3.1",
+    "dlitem": "1.3.1",
+    "document-title": "2.4.2",
+    "duplicate-id": "4.1.2",
+    "duplicate-id-aria": "4.1.2",
+    "empty-heading": "2.4.6",
+    "empty-table-header": "1.3.1",
+    "focus-order-semantics": "2.4.3",
+    "form-field-multiple-labels": "3.3.2",
+    "frame-focusable-content": "2.1.1",
+    "frame-tested": "4.1.2",
+    "frame-title": "4.1.2",
+    "frame-title-unique": "4.1.2",
+    "heading-order": "1.3.1",
+    "hidden-content": "4.1.2",
+    "html-has-lang": "3.1.1",
+    "html-lang-valid": "3.1.1",
+    "html-xml-lang-mismatch": "3.1.1",
+    "identical-links-same-purpose": "2.4.9",
+    "image-alt": "1.1.1",
+    "image-redundant-alt": "1.1.1",
+    "input-button-name": "4.1.2",
+    "input-image-alt": "1.1.1",
+    "label": "4.1.2",
+    "label-content-name-mismatch": "2.5.3",
+    "label-title-only": "3.3.2",
+    "landmark-banner-is-top-level": "1.3.6",
+    "landmark-complementary-is-top-level": "1.3.6",
+    "landmark-contentinfo-is-top-level": "1.3.6",
+    "landmark-main-is-top-level": "1.3.6",
+    "landmark-no-duplicate-banner": "1.3.6",
+    "landmark-no-duplicate-contentinfo": "1.3.6",
+    "landmark-no-duplicate-main": "1.3.6",
+    "landmark-one-main": "1.3.6",
+    "landmark-unique": "1.3.6",
+    "link-in-text-block": "1.4.1",
+    "link-name": "2.4.4",
+    "list": "1.3.1",
+    "listitem": "1.3.1",
+    "marquee": "2.2.2",
+    "meta-refresh": "2.2.1",
+    "meta-viewport": "1.4.4",
+    "meta-viewport-large": "1.4.4",
+    "nested-interactive": "4.1.2",
+    "no-autoplay-audio": "1.4.2",
+    "object-alt": "1.1.1",
+    "p-as-heading": "1.3.1",
+    "page-has-heading-one": "2.4.6",
+    "presentation-role-conflict": "4.1.2",
+    "region": "1.3.6",
+    "role-img-alt": "1.1.1",
+    "scope-attr-valid": "1.3.1",
+    "scrollable-region-focusable": "2.1.1",
+    "select-name": "4.1.2",
+    "server-side-image-map": "2.1.1",
+    "skip-link": "2.4.1",
+    "summary-name": "4.1.2",
+    "svg-img-alt": "1.1.1",
+    "tabindex": "2.4.3",
+    "table-duplicate-name": "1.3.1",
+    "table-fake-caption": "1.3.1",
+    "target-size": "2.5.8",
+    "td-has-header": "1.3.1",
+    "td-headers-attr": "1.3.1",
+    "th-has-data-cells": "1.3.1",
+    "valid-lang": "3.1.2",
+    "video-caption": "1.2.2"
+  },
+  "impactedUsers": {
+    "accesskeys": "Keyboard-only users and screen reader users (duplicate access keys cause unpredictable focus jumps)",
+    "area-alt": "Screen reader users navigating image maps",
+    "aria-allowed-attr": "Screen reader users (invalid attributes cause unpredictable AT behavior)",
+    "aria-allowed-role": "Screen reader users (mismatched roles cause incorrect element announcements)",
+    "aria-braille-equivalent": "Braille display users",
+    "aria-command-name": "Screen reader users and voice control users",
+    "aria-conditional-attr": "Screen reader users (conditional attributes in incorrect states confuse AT)",
+    "aria-deprecated-role": "Screen reader users (deprecated roles may be dropped by AT in future versions)",
+    "aria-dialog-name": "Screen reader users (unnamed dialogs are announced without context)",
+    "aria-hidden-body": "All users (entire page becomes invisible to assistive technology)",
+    "aria-hidden-focus": "Keyboard-only users and screen reader users",
+    "aria-input-field-name": "Screen reader users and voice control users",
+    "aria-meter-name": "Screen reader users (meters without names are announced as unlabeled gauges)",
+    "aria-progressbar-name": "Screen reader users (progress bars without names cannot be identified)",
+    "aria-prohibited-attr": "Screen reader users",
+    "aria-required-attr": "Screen reader users",
+    "aria-required-children": "Screen reader users (missing required child roles break widget navigation)",
+    "aria-required-parent": "Screen reader users (orphaned child roles are not recognized by AT)",
+    "aria-roledescription": "Screen reader users (misapplied roledescription overrides meaningful role announcements)",
+    "aria-roles": "Screen reader users (invalid roles are ignored or misinterpreted by AT)",
+    "aria-text": "Screen reader users (elements with role='text' or aria-label on non-interactive elements may cause fragmented or missing announcements)",
+    "aria-toggle-field-name": "Screen reader users and voice control users",
+    "aria-tooltip-name": "Screen reader users and keyboard-only users",
+    "aria-treeitem-name": "Screen reader users navigating tree views",
+    "aria-valid-attr": "Screen reader users (invalid ARIA attributes are ignored by AT)",
+    "aria-valid-attr-value": "Screen reader users",
+    "audio-caption": "Deaf users and users with hearing disabilities",
+    "autocomplete-valid": "Users with motor disabilities and cognitive disabilities",
+    "avoid-inline-spacing": "Users with low vision and users with reading disabilities who override text spacing",
+    "blink": "Users with vestibular disorders, photosensitive epilepsy, and cognitive disabilities",
+    "button-name": "Screen reader users and voice control users",
+    "bypass": "Keyboard-only users and screen reader users",
+    "color-contrast": "Users with low vision or color blindness",
+    "css-orientation-lock": "Users with motor disabilities who mount devices in a fixed orientation",
+    "definition-list": "Screen reader users (incorrect dl structure breaks term/definition relationships)",
+    "dlitem": "Screen reader users (dd/dt elements outside dl lose semantic meaning)",
+    "document-title": "Screen reader users and users with cognitive disabilities",
+    "duplicate-id": "Screen reader users (broken element references)",
+    "duplicate-id-aria": "Screen reader users (broken accessible name, description, or widget relationships)",
+    "empty-heading": "Screen reader users navigating by headings",
+    "empty-table-header": "Screen reader users (empty headers provide no context for associated data cells)",
+    "focus-order-semantics": "Keyboard-only users and screen reader users",
+    "form-field-multiple-labels": "Screen reader users",
+    "frame-focusable-content": "Keyboard-only users (focusable content trapped in inaccessible frames)",
+    "frame-tested": "All users (untested frames may contain undetected accessibility violations)",
+    "frame-title": "Screen reader users",
+    "frame-title-unique": "Screen reader users navigating between multiple frames",
+    "heading-order": "Screen reader users navigating by headings",
+    "hidden-content": "Screen reader users (hidden content may still be announced or may hide important information)",
+    "html-has-lang": "Screen reader users (language detection for pronunciation)",
+    "html-lang-valid": "Screen reader users (language detection for pronunciation)",
+    "html-xml-lang-mismatch": "Screen reader users (conflicting language declarations cause pronunciation errors)",
+    "identical-links-same-purpose": "Screen reader users navigating the links list and voice control users",
+    "image-alt": "Blind users relying on screen readers",
+    "image-redundant-alt": "Screen reader users (redundant announcements increase cognitive load)",
+    "input-button-name": "Screen reader users and voice control users",
+    "input-image-alt": "Blind users relying on screen readers",
+    "label": "Screen reader users and voice control users",
+    "label-content-name-mismatch": "Voice control users (Dragon NaturallySpeaking, iOS Voice Control)",
+    "label-title-only": "Screen reader users and voice control users (title attribute is not universally exposed as the accessible name)",
+    "landmark-banner-is-top-level": "Screen reader users navigating by landmarks",
+    "landmark-complementary-is-top-level": "Screen reader users navigating by landmarks",
+    "landmark-contentinfo-is-top-level": "Screen reader users navigating by landmarks",
+    "landmark-main-is-top-level": "Screen reader users navigating by landmarks",
+    "landmark-no-duplicate-banner": "Screen reader users navigating by landmarks",
+    "landmark-no-duplicate-contentinfo": "Screen reader users navigating by landmarks",
+    "landmark-no-duplicate-main": "Screen reader users navigating by landmarks",
+    "landmark-one-main": "Screen reader users navigating by landmarks",
+    "landmark-unique": "Screen reader users navigating by landmarks",
+    "link-in-text-block": "Users with low vision or color blindness who cannot distinguish links by color alone",
+    "link-name": "Screen reader users and voice control users",
+    "list": "Screen reader users (list item count and navigation)",
+    "listitem": "Screen reader users (invalid list structure causes incorrect announcements)",
+    "marquee": "Users with vestibular disorders, cognitive disabilities, and screen reader users",
+    "meta-refresh": "Users with cognitive disabilities and screen reader users",
+    "meta-viewport": "Users who need to zoom (low vision, motor disabilities)",
+    "meta-viewport-large": "Users with low vision who need to zoom beyond the default maximum scale",
+    "nested-interactive": "Keyboard-only users and screen reader users",
+    "no-autoplay-audio": "Screen reader users (audio conflicts with AT speech), users with cognitive disabilities, users with vestibular disorders",
+    "object-alt": "Blind users relying on screen readers",
+    "p-as-heading": "Screen reader users navigating by headings",
+    "page-has-heading-one": "Screen reader users navigating by headings",
+    "presentation-role-conflict": "Screen reader users (conflicting roles cause AT to ignore or misrepresent elements)",
+    "region": "Screen reader users navigating by landmarks",
+    "role-img-alt": "Blind users relying on screen readers",
+    "scope-attr-valid": "Screen reader users navigating data tables",
+    "scrollable-region-focusable": "Keyboard-only users",
+    "select-name": "Screen reader users and voice control users",
+    "server-side-image-map": "Keyboard-only users and screen reader users",
+    "skip-link": "Keyboard-only users and screen reader users",
+    "summary-name": "Screen reader users and voice control users",
+    "svg-img-alt": "Blind users relying on screen readers",
+    "tabindex": "Keyboard-only users",
+    "table-duplicate-name": "Screen reader users (duplicate announcement of table description creates cognitive load)",
+    "table-fake-caption": "Screen reader users (spanning cells used as captions are not associated with the table)",
+    "target-size": "Mobile/touch users and users with motor disabilities",
+    "td-has-header": "Screen reader users navigating data tables",
+    "td-headers-attr": "Screen reader users navigating complex tables",
+    "th-has-data-cells": "Screen reader users navigating tables",
+    "valid-lang": "Screen reader users (language detection for pronunciation)",
+    "video-caption": "Deaf users and users with hearing disabilities"
+  },
+  "expected": {
+    "accesskeys": "The accesskey attribute value must be unique across the page to prevent conflicting keyboard shortcuts.",
+    "area-alt": "Every <area> element in an image map must have an alt attribute that describes the link destination.",
+    "aria-allowed-attr": "ARIA attributes used on an element must be valid for that element's role. Invalid attributes must be removed.",
+    "aria-allowed-role": "The role attribute value must be appropriate for the element. Assigning a role that conflicts with the element's native semantics confuses assistive technology.",
+    "aria-braille-equivalent": "Elements with aria-braillelabel or aria-brailleroledescription must also have a non-braille accessible name or roledescription.",
+    "aria-command-name": "Elements with ARIA command roles (button, link, menuitem) must have a non-empty accessible name.",
+    "aria-conditional-attr": "ARIA attributes that are conditional on the element's state or role must only be used when those conditions are met.",
+    "aria-deprecated-role": "Elements must not use deprecated ARIA roles. Replace deprecated roles with their modern equivalents.",
+    "aria-dialog-name": "Elements with role=\"dialog\" or role=\"alertdialog\" must have a non-empty accessible name via aria-label or aria-labelledby.",
+    "aria-hidden-body": "The <body> element must not have aria-hidden=\"true\", as this hides the entire page from assistive technology.",
+    "aria-hidden-focus": "Elements with aria-hidden=\"true\" must not be focusable.",
+    "aria-input-field-name": "ARIA input roles (textbox, searchbox, spinbutton, slider, combobox) must have an accessible name.",
+    "aria-meter-name": "Elements with role=\"meter\" must have a non-empty accessible name via aria-label or aria-labelledby.",
+    "aria-progressbar-name": "Elements with role=\"progressbar\" must have a non-empty accessible name via aria-label or aria-labelledby.",
+    "aria-prohibited-attr": "ARIA attributes must only be used on roles that allow them per the WAI-ARIA specification.",
+    "aria-required-attr": "ARIA roles must include all required attributes defined in the WAI-ARIA spec.",
+    "aria-required-children": "ARIA parent roles must contain their required child roles (e.g., role=\"list\" must contain role=\"listitem\").",
+    "aria-required-parent": "ARIA child roles must be nested within their required parent roles (e.g., role=\"listitem\" must be inside role=\"list\").",
+    "aria-roledescription": "The aria-roledescription attribute must only be used on elements with a valid implicit or explicit ARIA role.",
+    "aria-roles": "All role attribute values must be valid ARIA roles from the WAI-ARIA specification.",
+    "aria-text": "Elements using role=\"text\" or aria-label on non-interactive container elements should ensure AT reads the content as a single uninterrupted string without losing child semantics.",
+    "aria-toggle-field-name": "Toggle fields (checkbox, radio, role='switch') must have an accessible name so AT can announce what is being toggled.",
+    "aria-tooltip-name": "Elements with role=\"tooltip\" must have a non-empty accessible name.",
+    "aria-treeitem-name": "Elements with role=\"treeitem\" must have a non-empty accessible name.",
+    "aria-valid-attr": "All ARIA attributes must be valid and spelled correctly per the WAI-ARIA specification.",
+    "aria-valid-attr-value": "ARIA attributes must use only valid values defined in the WAI-ARIA spec.",
+    "audio-caption": "All <audio> elements with speech or meaningful audio must provide synchronized captions or a full transcript.",
+    "autocomplete-valid": "Inputs collecting personal data must have a valid autocomplete attribute per WCAG 1.3.5.",
+    "avoid-inline-spacing": "Inline styles must not use !important on text-spacing properties (letter-spacing, word-spacing, line-height) to allow user overrides (WCAG 1.4.12).",
+    "blink": "The <blink> element must not be used. Blinking content cannot be paused or stopped by the user (WCAG 2.2.2).",
+    "button-name": "Every <button> and [role=\"button\"] must have a non-empty accessible name.",
+    "bypass": "Page must provide a mechanism to skip repetitive navigation (e.g., a skip link).",
+    "color-contrast": "Text contrast ratio must be at least 4.5:1 for normal text, 3:1 for large text.",
+    "css-orientation-lock": "Content must not be locked to a single display orientation (portrait or landscape) unless a specific orientation is essential (WCAG 1.3.4).",
+    "definition-list": "A <dl> element must only contain <dt> and <dd> groups, <div>, <script>, or <template> elements as direct children.",
+    "dlitem": "Every <dt> and <dd> element must be contained within a <dl> element.",
+    "document-title": "Page must have a descriptive, unique <title> element.",
+    "duplicate-id": "All id attributes must be unique within the document.",
+    "duplicate-id-aria": "All IDs referenced by ARIA attributes must be unique within the document. Duplicate ARIA-referenced IDs cause AT to resolve to the first matching element, breaking all subsequent references.",
+    "empty-heading": "Every heading element must contain non-empty, meaningful text content.",
+    "empty-table-header": "Table header cells (<th>) must contain non-empty text content so screen readers can announce column or row context.",
+    "focus-order-semantics": "Elements in the focus order must have an appropriate interactive role. Non-interactive elements with tabindex=\"0\" should use a suitable ARIA role.",
+    "form-field-multiple-labels": "Each form input must have exactly one accessible name source (label, aria-label, or aria-labelledby).",
+    "frame-focusable-content": "Frames with tabindex=\"-1\" must not contain focusable content, as keyboard users cannot reach it.",
+    "frame-tested": "All <iframe> elements must be testable by the accessibility engine. Frames that fail to load or block testing may contain undetected violations.",
+    "frame-title": "Every <iframe> must have a descriptive title attribute.",
+    "frame-title-unique": "Each <iframe> on the page must have a unique title attribute to distinguish it from other frames.",
+    "heading-order": "Heading levels must not skip (h1 → h2 → h3, no gaps allowed).",
+    "hidden-content": "Content hidden from the page should be reviewed to ensure it is not unintentionally hidden from assistive technology users.",
+    "html-has-lang": "The <html> element must have a lang attribute.",
+    "html-lang-valid": "The lang attribute on <html> must be a valid BCP 47 language tag.",
+    "html-xml-lang-mismatch": "The lang and xml:lang attributes on the <html> element must specify the same base language.",
+    "identical-links-same-purpose": "Links with the same accessible name must have the same destination, or their distinct purpose must be distinguishable from context or accessible name.",
+    "image-alt": "Every <img> must have an alt attribute. Decorative images use alt=\"\".",
+    "image-redundant-alt": "Image alt text must not duplicate adjacent visible text. If adjacent text fully describes the image, use alt='' to mark it as decorative.",
+    "input-button-name": "Input elements with type 'button', 'submit', or 'reset' must have a non-empty accessible name via the value attribute or aria-label.",
+    "input-image-alt": "Every <input type=\"image\"> must have an alt attribute describing the button's action.",
+    "label": "Every form input must have an associated <label>, aria-label, or aria-labelledby.",
+    "label-content-name-mismatch": "The accessible name of interactive elements must contain the visible label text (WCAG 2.5.3).",
+    "label-title-only": "Form inputs must not rely solely on the title attribute for their accessible name. Use a visible <label> or aria-label instead.",
+    "landmark-banner-is-top-level": "The banner landmark (header or role=\"banner\") must be a top-level landmark, not nested inside another landmark.",
+    "landmark-complementary-is-top-level": "The complementary landmark (aside or role=\"complementary\") must be a top-level landmark, not nested inside another landmark.",
+    "landmark-contentinfo-is-top-level": "The contentinfo landmark (footer or role=\"contentinfo\") must be a top-level landmark, not nested inside another landmark.",
+    "landmark-main-is-top-level": "The main landmark must be a top-level landmark, not nested inside another landmark such as a nav or aside.",
+    "landmark-no-duplicate-banner": "A page must not have more than one banner landmark (<header> at top level or role='banner').",
+    "landmark-no-duplicate-contentinfo": "A page must not have more than one contentinfo landmark (<footer> at top level or role=\"contentinfo\").",
+    "landmark-no-duplicate-main": "A page must not have more than one main landmark (<main> or role='main'). Multiple main landmarks break skip navigation.",
+    "landmark-one-main": "Page must contain exactly one <main> landmark element.",
+    "landmark-unique": "When multiple landmarks of the same type exist (e.g., multiple <nav> elements), each must have a unique accessible label.",
+    "link-in-text-block": "Links within blocks of text must be distinguishable from surrounding text by means other than color alone (e.g., underline or other visual indicator).",
+    "link-name": "Every <a href> must have descriptive, non-empty text content or an aria-label.",
+    "list": "<ul> and <ol> must only contain <li> elements as direct children. Screen readers use this structure to announce the list count and enable list navigation.",
+    "listitem": "<li> elements must be direct children of <ul>, <ol>, or <menu> elements.",
+    "marquee": "The <marquee> element must not be used. Use CSS animations with pause controls instead (WCAG 2.2.2).",
+    "meta-refresh": "Pages must not auto-refresh or auto-redirect with a non-zero delay (WCAG 2.2.1).",
+    "meta-viewport": "Viewport meta must not disable user scaling (user-scalable=no is forbidden).",
+    "meta-viewport-large": "The viewport meta tag should allow scaling to at least 500% to support users with low vision (WCAG 1.4.4).",
+    "nested-interactive": "Interactive elements (a, button, input, select, textarea) must not be nested inside other interactive elements.",
+    "no-autoplay-audio": "Audio that plays automatically must stop within 3 seconds, or a mechanism to pause/stop/mute it must be provided at the start of the page (WCAG 1.4.2).",
+    "object-alt": "Every <object> must have an accessible name via aria-label or aria-labelledby.",
+    "p-as-heading": "Text that visually functions as a section heading must be marked up with a heading element (<h1>–<h6>), not a styled paragraph.",
+    "page-has-heading-one": "Page must have exactly one <h1> element as the primary heading.",
+    "presentation-role-conflict": "Elements with role=\"presentation\" or role=\"none\" must not have global ARIA attributes or focusable states that conflict with the presentation role.",
+    "region": "All visible page content must be contained within a landmark element (main, nav, header, footer, aside).",
+    "role-img-alt": "Elements with role=\"img\" must have a non-empty accessible name via aria-label or aria-labelledby.",
+    "scope-attr-valid": "The scope attribute on <th> elements must use a valid value (row, col, rowgroup, colgroup) and must not be used on <td> elements.",
+    "scrollable-region-focusable": "Any element with scrollable overflow must be reachable via keyboard (tabindex=\"0\" or natively focusable).",
+    "select-name": "Every <select> must have an accessible name via <label>, aria-label, or aria-labelledby.",
+    "server-side-image-map": "Server-side image maps must not be used. Replace with client-side image maps or accessible alternatives operable via keyboard.",
+    "skip-link": "Skip navigation links must have a valid target that exists in the page and is focusable, allowing keyboard users to bypass repetitive content (WCAG 2.4.1).",
+    "summary-name": "Every <summary> element must have a non-empty accessible name describing the disclosure widget it controls.",
+    "svg-img-alt": "SVG elements used as images must have an accessible name (aria-label or aria-labelledby). Decorative SVGs must be hidden from AT with aria-hidden='true'.",
+    "tabindex": "tabindex values must be 0 or -1. Positive values disrupt natural focus order.",
+    "table-duplicate-name": "The <caption> and summary attribute of a table must not contain identical text — this causes screen readers to announce the same description twice.",
+    "table-fake-caption": "Tables must not use a spanning cell as a pseudo-caption. Use the <caption> element for table titles.",
+    "target-size": "All interactive targets must be at least 24×24 CSS pixels (WCAG 2.5.8). Spacing or a larger equivalent target is an acceptable alternative.",
+    "td-has-header": "Every data cell (<td>) in a data table must be associated with a header cell (<th>) via scope or headers attributes.",
+    "td-headers-attr": "When the headers attribute is used on <td>, every referenced ID must point to a valid <th> element in the same table.",
+    "th-has-data-cells": "Every <th> must have at least one associated data cell — a header with no data cells is meaningless structure.",
+    "valid-lang": "All lang attributes must use valid BCP 47 language codes.",
+    "video-caption": "All <video> elements with audio content must have synchronized captions via a <track kind='captions'> element."
+  },
+  "tagImpactedUsers": {
+    "cat.color": "Users with low vision or color blindness",
+    "cat.keyboard": "Keyboard-only users",
+    "cat.aria": "Screen reader users",
+    "cat.forms": "Screen reader users and voice control users",
+    "cat.structure": "Screen reader users navigating by headings or landmarks",
+    "cat.semantics": "Screen reader users",
+    "cat.text-alternatives": "Blind users relying on screen readers"
+  },
+  "wcagTagLabels": {
+    "wcag22aa": "WCAG 2.2 AA",
+    "wcag22a": "WCAG 2.2 A",
+    "wcag21aa": "WCAG 2.1 AA",
+    "wcag2aa": "WCAG 2.1 AA",
+    "wcag21a": "WCAG 2.1 A",
+    "wcag2a": "WCAG 2.1 A"
+  },
+  "wcagTagPrecedence": [
+    "wcag22aa",
+    "wcag22a",
+    "wcag21aa",
+    "wcag2aa",
+    "wcag21a",
+    "wcag2a"
+  ],
+  "implicitRoles": {
+    "tagMap": {
+      "a": "link",
+      "button": "button",
+      "dialog": "dialog",
+      "select": "listbox",
+      "details": "group",
+      "summary": "group",
+      "table": "table",
+      "nav": "navigation",
+      "header": "banner",
+      "footer": "contentinfo",
+      "aside": "complementary",
+      "main": "main",
+      "form": "form",
+      "fieldset": "group",
+      "h1": "heading",
+      "h2": "heading",
+      "h3": "heading",
+      "h4": "heading",
+      "h5": "heading",
+      "h6": "heading"
+    },
+    "inputTypeMap": {
+      "checkbox": "checkbox",
+      "radio": "radio",
+      "range": "slider"
+    }
+  },
+  "personaMapping": {
+    "screenReader": {
+      "rules": [
+        "frame-title",
+        "aria-dialog-name",
+        "landmark-unique",
+        "aria-allowed-role",
+        "nested-interactive",
+        "aria-hidden-focus",
+        "aria-valid-attr"
+      ],
+      "keywords": [
+        "screen reader",
+        "assistive technology",
+        "aria",
+        "label",
+        "announced"
+      ]
+    },
+    "keyboard": {
+      "rules": [
+        "nested-interactive",
+        "scrollable-region-focusable",
+        "focus-order-semantics",
+        "tabindex"
+      ],
+      "keywords": [
+        "keyboard",
+        "focusable",
+        "tab order",
+        "interactive"
+      ]
+    },
+    "vision": {
+      "rules": [
+        "color-contrast",
+        "image-redundant-alt",
+        "image-alt"
+      ],
+      "keywords": [
+        "vision",
+        "color",
+        "contrast",
+        "blind"
+      ]
+    },
+    "cognitive": {
+      "rules": [
+        "heading-order",
+        "empty-heading",
+        "page-has-heading-one",
+        "duplicate-id"
+      ],
+      "keywords": [
+        "cognitive",
+        "motor",
+        "heading",
+        "structure",
+        "navigation",
+        "hierarchy"
+      ]
+    }
+  },
+  "personaConfig": {
+    "screenReader": {
+      "label": "Screen Readers",
+      "icon": "<svg class=\"w-5 h-5\" fill=\"none\" stroke=\"currentColor\" viewBox=\"0 0 24 24\"><path d=\"M19 11a7 7 0 01-7 7m0 0a7 7 0 01-7-7m7 7v4m0 0H8m4 0h4m-4-8a3 3 0 01-3-3V5a3 3 0 116 0v6a3 3 0 01-3 3z\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/></svg>"
+    },
+    "keyboard": {
+      "label": "Keyboard Only",
+      "icon": "<svg class=\"w-5 h-5\" fill=\"none\" stroke=\"currentColor\" viewBox=\"0 0 24 24\"><path d=\"M3 10h18M7 15h1m4 0h1m4 0h1m-7 4h4M5 5h14a2 2 0 012 2v10a2 2 0 01-2 2H5a2 2 0 01-2-2V7a2 2 0 012-2z\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/></svg>"
+    },
+    "vision": {
+      "label": "Color/Low Vision",
+      "icon": "<svg class=\"w-5 h-5\" fill=\"none\" stroke=\"currentColor\" viewBox=\"0 0 24 24\"><path d=\"M15 12a3 3 0 11-6 0 3 3 0 016 0z\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/><path d=\"M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/></svg>"
+    },
+    "cognitive": {
+      "label": "Cognitive/Motor",
+      "icon": "<svg class=\"w-5 h-5\" fill=\"none\" stroke=\"currentColor\" viewBox=\"0 0 24 24\"><path d=\"M9.663 17h4.673M12 3v1m6.364 1.636l-.707.707M21 12h-1M4 12H3m3.343-5.657l-.707-.707m2.828 9.9a5 5 0 117.072 0l-.548.547A3.374 3.374 0 0014 18.469V19a2 2 0 11-4 0v-.531c0-.895-.356-1.754-.988-2.386l-.548-.547z\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/></svg>"
+    }
+  }
+}