@surea11y/core 1.2.0 → 1.4.0

package/src/checks/automatic/aria-deprecated-role.js

@@ -1,3 +1,5 @@
+/* SPDX-License-Identifier: MPL-2.0 */
+
 'use strict';
 
 /**
@@ -12,9 +14,8 @@
  *   declare — either because WAI-ARIA has deprecated it (e.g. "directory",
  *   superseded by role="list") or because it's reserved for user-agent-
  *   internal use only, not a spec deprecation but the same "valid token,
- *   prohibited for authors" shape (role="generic" — verified 2026-07-20
- *   against both the WAI-ARIA 1.2 spec text and MDN's explicit "It should
- *   not be used by web authors" guidance).
+ *   prohibited for authors" shape (role="generic" — per WAI-ARIA 1.2 and
+ *   MDN's "It should not be used by web authors" guidance).
  * @expectation
  *   The role in use is neither deprecated nor author-prohibited. This is a
  *   distinct, atomic decision from aria-roles-valid (existence/
@@ -26,7 +27,8 @@ const id = 'aria-deprecated-role';
 
 const meta = {
   title: 'role attribute must not use a deprecated or author-prohibited ARIA role',
-  description: 'Checks that an explicit role="" attribute does not use a role deprecated by the WAI-ARIA specification, or one reserved for user-agent-internal use only (e.g. role="generic").',
+  description:
+    'Checks that an explicit role="" attribute does not use a role deprecated by the WAI-ARIA specification, or one reserved for user-agent-internal use only (e.g. role="generic").',
   i18n: {
     titleKey: 'ariaDeprecatedRole_title',
     descriptionKey: 'ariaDeprecatedRole_description'
@@ -35,7 +37,13 @@ const meta = {
   tags: ['wcag2a', 'wcag412', 'aria', 'structure', 'atomic', 'automatic'],
   wcagSc: ['4.1.2'],
   normativeMappings: [
-    { standard: 'WCAG', version: '2.2', requirement: '4.1.2', title: 'Name, Role, Value', conformanceLevel: 'A' }
+    {
+      standard: 'WCAG',
+      version: '2.2',
+      requirement: '4.1.2',
+      title: 'Name, Role, Value',
+      conformanceLevel: 'A'
+    }
   ],
   defaultSeverity: 'moderate',
   category: 'robust',
@@ -45,14 +53,16 @@ const meta = {
 };
 
 function runInPage(ctx) {
-  const { document, helpers, rule } = ctx;
+  const { helpers, rule } = ctx;
 
   const ariaHelpers = helpers && helpers.aria ? helpers.aria : null;
   if (!ariaHelpers) {
     return { ruleId: rule.ruleId, outcome: 'notApplicable', severity: 'minor', occurrences: [] };
   }
 
-  const nodes = helpers.queryAllSmart ? helpers.queryAllSmart('[role]') : helpers.queryAll('[role]');
+  const nodes = helpers.queryAllSmart
+    ? helpers.queryAllSmart('[role]')
+    : helpers.queryAll('[role]');
 
   const occurrences = [];
   let applicableCount = 0;
@@ -72,10 +82,10 @@ function runInPage(ctx) {
     if (!ariaHelpers.isDeprecatedRole(role)) continue;
 
     const stableSelector = helpers.buildSelector ? helpers.buildSelector(el) : 'html';
-    const html = helpers.getOuterHtmlSnippet ? helpers.getOuterHtmlSnippet(el) : (el.outerHTML || '');
+    const html = helpers.getOuterHtmlSnippet ? helpers.getOuterHtmlSnippet(el) : el.outerHTML || '';
     const guidance = ariaHelpers.getDeprecatedRoleGuidance
-        ? ariaHelpers.getDeprecatedRoleGuidance(role)
-        : 'Replace the deprecated role with its recommended replacement.';
+      ? ariaHelpers.getDeprecatedRoleGuidance(role)
+      : 'Replace the deprecated role with its recommended replacement.';
 
     occurrences.push({
       selector: stableSelector,
@@ -97,7 +107,12 @@ function runInPage(ctx) {
     return { ruleId: rule.ruleId, outcome: 'notApplicable', severity: 'minor', occurrences: [] };
   }
   if (occurrences.length) {
-    return { ruleId: rule.ruleId, outcome: 'fail', severity: rule.defaultSeverity || 'moderate', occurrences };
+    return {
+      ruleId: rule.ruleId,
+      outcome: 'fail',
+      severity: rule.defaultSeverity || 'moderate',
+      occurrences
+    };
   }
   return { ruleId: rule.ruleId, outcome: 'pass', severity: 'minor', occurrences: [] };
 }

package/src/checks/automatic/aria-hidden-body.js

@@ -1,3 +1,5 @@
+/* SPDX-License-Identifier: MPL-2.0 */
+
 'use strict';
 
 /**
@@ -14,17 +16,18 @@
  * @expectation
  *   <body> does not have aria-hidden="true". Hiding the document body
  *   removes the entire page's content and structure from the
- *   accessibility tree at once — a widely-used reference engine tags this under both 1.3.1
- *   (Info and Relationships: the page's structure becomes entirely
- *   non-determinable) and 4.1.2 (Name, Role, Value: nothing in the
- *   document exposes a role/name/value any longer).
+ *   accessibility tree at once — both 1.3.1 (Info and Relationships: the
+ *   page's structure becomes entirely non-determinable) and 4.1.2 (Name,
+ *   Role, Value: nothing in the document exposes a role/name/value any
+ *   longer) apply.
  */
 
 const id = 'aria-hidden-body';
 
 const meta = {
   title: 'The document <body> must not be aria-hidden',
-  description: 'Checks that <body> does not have aria-hidden="true", which would remove the entire page from the accessibility tree.',
+  description:
+    'Checks that <body> does not have aria-hidden="true", which would remove the entire page from the accessibility tree.',
   i18n: {
     titleKey: 'ariaHiddenBody_title',
     descriptionKey: 'ariaHiddenBody_description'
@@ -33,8 +36,20 @@ const meta = {
   tags: ['wcag2a', 'wcag131', 'wcag412', 'structure', 'atomic', 'automatic'],
   wcagSc: ['1.3.1', '4.1.2'],
   normativeMappings: [
-    { standard: 'WCAG', version: '2.2', requirement: '1.3.1', title: 'Info and Relationships', conformanceLevel: 'A' },
-    { standard: 'WCAG', version: '2.2', requirement: '4.1.2', title: 'Name, Role, Value', conformanceLevel: 'A' }
+    {
+      standard: 'WCAG',
+      version: '2.2',
+      requirement: '1.3.1',
+      title: 'Info and Relationships',
+      conformanceLevel: 'A'
+    },
+    {
+      standard: 'WCAG',
+      version: '2.2',
+      requirement: '4.1.2',
+      title: 'Name, Role, Value',
+      conformanceLevel: 'A'
+    }
   ],
   defaultSeverity: 'critical',
   category: 'perceivable',
@@ -72,24 +87,34 @@ function runInPage(ctx) {
   }
 
   const stableSelector = helpers.buildSelector ? helpers.buildSelector(body) : 'body';
-  const html = helpers.getOuterHtmlSnippet ? helpers.getOuterHtmlSnippet(body) : (body.outerHTML || '').slice(0, 200);
+  const html = helpers.getOuterHtmlSnippet
+    ? helpers.getOuterHtmlSnippet(body)
+    : (body.outerHTML || '').slice(0, 200);
 
-  const occurrences = [{
-    selector: stableSelector,
-    html,
-    summary: 'The document body has aria-hidden="true", which hides the entire page from assistive technologies.',
-    hint: 'Remove aria-hidden from <body>. Hide specific elements instead, if that was the intent.',
-    i18n: {
-      summaryKey: 'ariaHiddenBody_summary_fail',
-      hintKey: 'ariaHiddenBody_hint_fail',
-      params: {}
-    },
-    data: {
-      details: { reasonCode: 'ARIA_HIDDEN_BODY' }
+  const occurrences = [
+    {
+      selector: stableSelector,
+      html,
+      summary:
+        'The document body has aria-hidden="true", which hides the entire page from assistive technologies.',
+      hint: 'Remove aria-hidden from <body>. Hide specific elements instead, if that was the intent.',
+      i18n: {
+        summaryKey: 'ariaHiddenBody_summary_fail',
+        hintKey: 'ariaHiddenBody_hint_fail',
+        params: {}
+      },
+      data: {
+        details: { reasonCode: 'ARIA_HIDDEN_BODY' }
+      }
     }
-  }];
+  ];
 
-  return { ruleId: rule.ruleId, outcome: 'fail', severity: rule.defaultSeverity || 'critical', occurrences };
+  return {
+    ruleId: rule.ruleId,
+    outcome: 'fail',
+    severity: rule.defaultSeverity || 'critical',
+    occurrences
+  };
 }
 
-module.exports = { id, meta, runInPage, applicability };
+module.exports = { id, meta, runInPage, applicability };