@surea11y/core 1.2.0 → 1.4.0

package/src/checks/automatic/aria-allowed-attr.js

@@ -1,3 +1,5 @@
+/* SPDX-License-Identifier: MPL-2.0 */
+
 'use strict';
 
 /**
@@ -19,57 +21,19 @@
  *   set already covers implicit-role elements without asserting anything
  *   role-specific; scope kept deliberately narrow to avoid false positives
  *   on implicit-role ARIA-in-HTML edge cases not modeled here.
- * - SUPPORTED_ATTRS_BY_ROLE widened 2026-07-21 (7 new roles), cross-checked
- *   against a widely-used reference engine's own per-role `allowedAttrs`
- *   table AND verified each addition is an unambiguous, well-established ARIA
- *   fact rather than a blind import:
- *   - `searchbox`: identical to the already-covered `textbox` (ARIA
- *     explicitly defines searchbox as textbox's subclass, same supported
- *     set).
- *   - `meter`: valuenow/valuemax/valuemin/valuetext, matching the
- *     already-covered slider/progressbar/scrollbar/spinbutton pattern
- *     (valuenow is also separately *required* on meter — see
- *     `aria-required-attr`'s own 2026-07-21 widening — but the two tables
- *     aren't unioned automatically, so it needs listing in both places).
- *   - `columnheader`/`rowheader`: same table-role family already covered
- *     by `gridcell`/`row` — sort/col-row-index/span are standard WAI-ARIA
- *     grid-model properties.
- *   - `dialog`/`alertdialog`: `aria-modal` — the spec-defining property
- *     that distinguishes a modal from a non-modal dialog; unambiguous.
- *   - `listitem`: level/posinset/setsize — standard flat-representation-
- *     of-hierarchy properties, same family as the already-covered
- *     `treeitem`.
- *   - `menu`/`menubar`/`toolbar`: activedescendant/orientation — standard
- *     composite-widget properties, same family as the already-covered
- *     `tablist`.
- * - SUPPORTED_ATTRS_BY_ROLE full-reconciliation pass 2026-07-28: the
- *   2026-07-21 pass deliberately deferred ~61 roles where the reference
- *   engine (axe-core) allows `aria-expanded`, treating it as too thin/
- *   near-universal to import blindly. Checked against `aria-query`
- *   (tracks the published WAI-ARIA 1.2 Recommendation, 6 June 2023 — the
- *   latest actually-published version, as opposed to the in-progress 1.3
- *   Editor's Draft) instead of axe-core directly, because axe-core's own
- *   source comments (`// Spec difference: Aria-expanded removed in 1.2`)
- *   show that most of its `aria-expanded` allowances are deliberate
- *   ARIA-1.1 legacy/AT-compat carryovers axe-core keeps on purpose, not
- *   current-spec facts — importing them wholesale would have re-added
- *   exactly the kind of unverified allowance the 07-21 pass was avoiding.
- *   `aria-query`'s per-role tables (with superclass inheritance resolved,
- *   e.g. `aria-activedescendant` via the abstract `composite` role) gave a
- *   spec-grounded diff instead. Net changes from that diff:
- *   - `aria-expanded` added to: checkbox, columnheader, gridcell, listbox,
- *     menuitemcheckbox, menuitemradio, row, rowheader, switch, tab —
- *     confirmed present in current spec for these roles specifically
- *     (unlike e.g. `listitem`, `dialog`, `alertdialog`, `heading`, which
- *     the spec does NOT list it for — those stay excluded).
- *   - `aria-activedescendant` added to: combobox, grid, listbox,
- *     radiogroup, row, spinbutton, tablist, treegrid (inherited from the
- *     abstract `composite` role for any composite/managed-focus widget).
- *   - `aria-readonly`/`aria-required` added to: switch, menuitemcheckbox,
- *     menuitemradio. `aria-posinset`/`aria-setsize` added to: tab, radio,
- *     menuitemcheckbox, menuitemradio. `aria-level` added to: tablist.
- *   - `tree`'s `aria-readonly` removed: not in aria-query's resolved
- *     props for `tree` (was an unverified carryover, not spec-backed).
+ * - SUPPORTED_ATTRS_BY_ROLE holds unambiguous, well-established ARIA facts:
+ *   subclass relationships like `searchbox`==`textbox`; same-family widget
+ *   properties like `columnheader`/`rowheader` sort/col-row-index/span
+ *   matching `gridcell`/`row`; spec-defining properties like `dialog`/
+ *   `alertdialog` `aria-modal`. `aria-expanded` entries are checked against
+ *   `aria-query` (which tracks the published WAI-ARIA 1.2 Recommendation,
+ *   with superclass inheritance resolved, e.g. `aria-activedescendant` via
+ *   the abstract `composite` role) rather than imported wholesale, since
+ *   much of the wider ARIA-1.1 `aria-expanded` allowance list is legacy/
+ *   AT-compat carryover, not current-spec fact.
+ *   `meter`'s valuenow/valuemax/valuemin/valuetext is also separately
+ *   *required* (see `aria-required-attr`), but the two tables aren't
+ *   unioned automatically, so it's listed in both places.
  * - Not rule-gated on isAccTreeEligible: this remains a static-markup
  *   property, while engine-level hidden-subtree filtering still applies
  *   unless engineOptions.includeHiddenElements is true.
@@ -79,7 +43,8 @@ const id = 'aria-allowed-attr';
 
 const meta = {
   title: 'aria-* attributes must be permitted for the element’s role',
-  description: 'Checks that every recognized aria-* attribute present on an element with an explicit role is either globally supported or supported by that role.',
+  description:
+    'Checks that every recognized aria-* attribute present on an element with an explicit role is either globally supported or supported by that role.',
   i18n: {
     titleKey: 'ariaAllowedAttr_title',
     descriptionKey: 'ariaAllowedAttr_description'
@@ -88,7 +53,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',
@@ -98,7 +69,7 @@ const meta = {
 };
 
 function runInPage(ctx) {
-  const { document, helpers, rule } = ctx;
+  const { helpers, rule } = ctx;
 
   const ariaHelpers = helpers && helpers.aria ? helpers.aria : null;
   if (!ariaHelpers) {
@@ -111,12 +82,30 @@ function runInPage(ctx) {
   // build inlines only this function's own source text — see
   // scripts/build-core.js header ("runInPage MUST be self-contained").
   const GLOBAL_ATTRS = [
-    'aria-atomic', 'aria-braillelabel', 'aria-brailleroledescription', 'aria-busy',
-    'aria-controls', 'aria-current', 'aria-describedby', 'aria-description',
-    'aria-details', 'aria-disabled', 'aria-dropeffect', 'aria-errormessage',
-    'aria-flowto', 'aria-grabbed', 'aria-haspopup', 'aria-hidden', 'aria-invalid',
-    'aria-keyshortcuts', 'aria-label', 'aria-labelledby', 'aria-live', 'aria-owns',
-    'aria-relevant', 'aria-roledescription'
+    'aria-atomic',
+    'aria-braillelabel',
+    'aria-brailleroledescription',
+    'aria-busy',
+    'aria-controls',
+    'aria-current',
+    'aria-describedby',
+    'aria-description',
+    'aria-details',
+    'aria-disabled',
+    'aria-dropeffect',
+    'aria-errormessage',
+    'aria-flowto',
+    'aria-grabbed',
+    'aria-haspopup',
+    'aria-hidden',
+    'aria-invalid',
+    'aria-keyshortcuts',
+    'aria-label',
+    'aria-labelledby',
+    'aria-live',
+    'aria-owns',
+    'aria-relevant',
+    'aria-roledescription'
   ];
 
   // Per-role supported (non-global) states/properties. Deliberately
@@ -126,43 +115,173 @@ function runInPage(ctx) {
   const SUPPORTED_ATTRS_BY_ROLE = {
     alertdialog: ['aria-modal'],
     checkbox: ['aria-checked', 'aria-readonly', 'aria-required', 'aria-expanded'],
-    columnheader: ['aria-sort', 'aria-colindex', 'aria-colspan', 'aria-readonly', 'aria-required', 'aria-rowindex', 'aria-rowspan', 'aria-selected', 'aria-expanded'],
-    combobox: ['aria-expanded', 'aria-autocomplete', 'aria-readonly', 'aria-required', 'aria-activedescendant'],
+    columnheader: [
+      'aria-sort',
+      'aria-colindex',
+      'aria-colspan',
+      'aria-readonly',
+      'aria-required',
+      'aria-rowindex',
+      'aria-rowspan',
+      'aria-selected',
+      'aria-expanded'
+    ],
+    combobox: [
+      'aria-expanded',
+      'aria-autocomplete',
+      'aria-readonly',
+      'aria-required',
+      'aria-activedescendant'
+    ],
     dialog: ['aria-modal'],
-    grid: ['aria-multiselectable', 'aria-readonly', 'aria-colcount', 'aria-rowcount', 'aria-activedescendant'],
-    gridcell: ['aria-selected', 'aria-readonly', 'aria-required', 'aria-colindex', 'aria-colspan', 'aria-rowindex', 'aria-rowspan', 'aria-expanded'],
+    grid: [
+      'aria-multiselectable',
+      'aria-readonly',
+      'aria-colcount',
+      'aria-rowcount',
+      'aria-activedescendant'
+    ],
+    gridcell: [
+      'aria-selected',
+      'aria-readonly',
+      'aria-required',
+      'aria-colindex',
+      'aria-colspan',
+      'aria-rowindex',
+      'aria-rowspan',
+      'aria-expanded'
+    ],
     heading: ['aria-level'],
-    listbox: ['aria-multiselectable', 'aria-readonly', 'aria-required', 'aria-orientation', 'aria-expanded', 'aria-activedescendant'],
+    listbox: [
+      'aria-multiselectable',
+      'aria-readonly',
+      'aria-required',
+      'aria-orientation',
+      'aria-expanded',
+      'aria-activedescendant'
+    ],
     listitem: ['aria-level', 'aria-posinset', 'aria-setsize'],
     menu: ['aria-activedescendant', 'aria-orientation'],
     menubar: ['aria-activedescendant', 'aria-orientation'],
-    menuitemcheckbox: ['aria-checked', 'aria-expanded', 'aria-readonly', 'aria-required', 'aria-posinset', 'aria-setsize'],
-    menuitemradio: ['aria-checked', 'aria-expanded', 'aria-readonly', 'aria-required', 'aria-posinset', 'aria-setsize'],
+    menuitemcheckbox: [
+      'aria-checked',
+      'aria-expanded',
+      'aria-readonly',
+      'aria-required',
+      'aria-posinset',
+      'aria-setsize'
+    ],
+    menuitemradio: [
+      'aria-checked',
+      'aria-expanded',
+      'aria-readonly',
+      'aria-required',
+      'aria-posinset',
+      'aria-setsize'
+    ],
     meter: ['aria-valuenow', 'aria-valuemin', 'aria-valuemax', 'aria-valuetext'],
     option: ['aria-selected', 'aria-checked', 'aria-posinset', 'aria-setsize'],
     progressbar: ['aria-valuenow', 'aria-valuemin', 'aria-valuemax', 'aria-valuetext'],
     radio: ['aria-checked', 'aria-posinset', 'aria-setsize'],
     radiogroup: ['aria-readonly', 'aria-required', 'aria-orientation', 'aria-activedescendant'],
-    row: ['aria-selected', 'aria-level', 'aria-posinset', 'aria-setsize', 'aria-colindex', 'aria-rowindex', 'aria-expanded', 'aria-activedescendant'],
-    rowheader: ['aria-sort', 'aria-colindex', 'aria-colspan', 'aria-readonly', 'aria-required', 'aria-rowindex', 'aria-rowspan', 'aria-selected', 'aria-expanded'],
-    scrollbar: ['aria-valuenow', 'aria-valuemin', 'aria-valuemax', 'aria-valuetext', 'aria-orientation', 'aria-controls'],
-    searchbox: ['aria-activedescendant', 'aria-autocomplete', 'aria-multiline', 'aria-placeholder', 'aria-readonly', 'aria-required'],
-    separator: ['aria-valuenow', 'aria-valuemin', 'aria-valuemax', 'aria-valuetext', 'aria-orientation'],
-    slider: ['aria-valuenow', 'aria-valuemin', 'aria-valuemax', 'aria-valuetext', 'aria-orientation', 'aria-readonly'],
-    spinbutton: ['aria-valuenow', 'aria-valuemin', 'aria-valuemax', 'aria-valuetext', 'aria-readonly', 'aria-required', 'aria-activedescendant'],
+    row: [
+      'aria-selected',
+      'aria-level',
+      'aria-posinset',
+      'aria-setsize',
+      'aria-colindex',
+      'aria-rowindex',
+      'aria-expanded',
+      'aria-activedescendant'
+    ],
+    rowheader: [
+      'aria-sort',
+      'aria-colindex',
+      'aria-colspan',
+      'aria-readonly',
+      'aria-required',
+      'aria-rowindex',
+      'aria-rowspan',
+      'aria-selected',
+      'aria-expanded'
+    ],
+    scrollbar: [
+      'aria-valuenow',
+      'aria-valuemin',
+      'aria-valuemax',
+      'aria-valuetext',
+      'aria-orientation',
+      'aria-controls'
+    ],
+    searchbox: [
+      'aria-activedescendant',
+      'aria-autocomplete',
+      'aria-multiline',
+      'aria-placeholder',
+      'aria-readonly',
+      'aria-required'
+    ],
+    separator: [
+      'aria-valuenow',
+      'aria-valuemin',
+      'aria-valuemax',
+      'aria-valuetext',
+      'aria-orientation'
+    ],
+    slider: [
+      'aria-valuenow',
+      'aria-valuemin',
+      'aria-valuemax',
+      'aria-valuetext',
+      'aria-orientation',
+      'aria-readonly'
+    ],
+    spinbutton: [
+      'aria-valuenow',
+      'aria-valuemin',
+      'aria-valuemax',
+      'aria-valuetext',
+      'aria-readonly',
+      'aria-required',
+      'aria-activedescendant'
+    ],
     switch: ['aria-checked', 'aria-expanded', 'aria-readonly', 'aria-required'],
     tab: ['aria-selected', 'aria-expanded', 'aria-posinset', 'aria-setsize'],
     table: ['aria-colcount', 'aria-rowcount'],
     tablist: ['aria-multiselectable', 'aria-orientation', 'aria-level', 'aria-activedescendant'],
-    textbox: ['aria-activedescendant', 'aria-autocomplete', 'aria-multiline', 'aria-placeholder', 'aria-readonly', 'aria-required'],
+    textbox: [
+      'aria-activedescendant',
+      'aria-autocomplete',
+      'aria-multiline',
+      'aria-placeholder',
+      'aria-readonly',
+      'aria-required'
+    ],
     toolbar: ['aria-activedescendant', 'aria-orientation'],
     tree: ['aria-multiselectable', 'aria-required', 'aria-orientation', 'aria-activedescendant'],
-    treegrid: ['aria-multiselectable', 'aria-readonly', 'aria-required', 'aria-orientation', 'aria-colcount', 'aria-rowcount', 'aria-activedescendant'],
-    treeitem: ['aria-checked', 'aria-selected', 'aria-expanded', 'aria-level', 'aria-posinset', 'aria-setsize']
+    treegrid: [
+      'aria-multiselectable',
+      'aria-readonly',
+      'aria-required',
+      'aria-orientation',
+      'aria-colcount',
+      'aria-rowcount',
+      'aria-activedescendant'
+    ],
+    treeitem: [
+      'aria-checked',
+      'aria-selected',
+      'aria-expanded',
+      'aria-level',
+      'aria-posinset',
+      'aria-setsize'
+    ]
   };
 
   const globalSet = new Set(GLOBAL_ATTRS);
-  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;
@@ -198,7 +317,7 @@ function runInPage(ctx) {
     if (!disallowed || !disallowed.length) 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 || '';
 
     for (const name of disallowed) {
       occurrences.push({
@@ -222,7 +341,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-allowed-role.js

@@ -1,3 +1,5 @@
+/* SPDX-License-Identifier: MPL-2.0 */
+
 'use strict';
 
 /**
@@ -27,7 +29,8 @@ const id = 'aria-allowed-role';
 
 const meta = {
   title: 'Explicit role must be permitted for its host element',
-  description: 'Checks that an explicit role="" attribute is one of the roles the ARIA-in-HTML specification permits for the host element (e.g. role="tab" is not permitted on <nav>).',
+  description:
+    'Checks that an explicit role="" attribute is one of the roles the ARIA-in-HTML specification permits for the host element (e.g. role="tab" is not permitted on <nav>).',
   i18n: {
     titleKey: 'ariaAllowedRole_title',
     descriptionKey: 'ariaAllowedRole_description'
@@ -36,7 +39,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',
@@ -46,14 +55,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,7 +83,7 @@ function runInPage(ctx) {
     if (info.allowed) 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 tag = (el.tagName || '').toLowerCase();
 
     occurrences.push({
@@ -95,9 +106,14 @@ 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: [] };
 }
 
-module.exports = { id, meta, runInPage };
+module.exports = { id, meta, runInPage };

package/src/checks/automatic/aria-braille-equivalent.js

@@ -1,3 +1,5 @@
+/* SPDX-License-Identifier: MPL-2.0 */
+
 'use strict';
 
 /**
@@ -42,7 +44,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: 'serious',
   category: 'robust',
@@ -52,9 +60,11 @@ const meta = {
 };
 
 function runInPage(ctx) {
-  const { document, helpers, rule } = ctx;
+  const { helpers, rule } = ctx;
 
-  function trim(v) { return (v == null ? '' : String(v)).trim(); }
+  function trim(v) {
+    return (v == null ? '' : String(v)).trim();
+  }
 
   function getConservativeSubtreeText(container) {
     // "Name from content" — recurses into descendants and uses each one's
@@ -68,7 +78,7 @@ function runInPage(ctx) {
       const info = helpers.getContentNameInfo(container, ctx);
       return info && info.present ? info.value : '';
     }
-    const t = (container && container.textContent) ? String(container.textContent) : '';
+    const t = container && container.textContent ? String(container.textContent) : '';
     return t.replace(/\s+/g, ' ').trim();
   }
 
@@ -91,21 +101,26 @@ function runInPage(ctx) {
     const missing = [];
 
     if (brailleLabel) {
-      const nameInfo = helpers.getAccessibleNameInfo ? helpers.getAccessibleNameInfo(el, ctx) : null;
-      const programmaticName = trim(nameInfo && typeof nameInfo.value === 'string' ? nameInfo.value : '');
+      const nameInfo = helpers.getAccessibleNameInfo
+        ? helpers.getAccessibleNameInfo(el, ctx)
+        : null;
+      const programmaticName = trim(
+        nameInfo && typeof nameInfo.value === 'string' ? nameInfo.value : ''
+      );
       const name = programmaticName || getConservativeSubtreeText(el);
       if (!name) missing.push({ attr: 'aria-braillelabel', requires: 'an accessible name' });
     }
 
     if (brailleRoleDesc) {
       const roleDesc = trim(el.getAttribute('aria-roledescription'));
-      if (!roleDesc) missing.push({ attr: 'aria-brailleroledescription', requires: 'aria-roledescription' });
+      if (!roleDesc)
+        missing.push({ attr: 'aria-brailleroledescription', requires: 'aria-roledescription' });
     }
 
     if (!missing.length) 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 tag = (el.tagName || '').toLowerCase();
 
     for (const m of missing) {
@@ -120,7 +135,11 @@ function runInPage(ctx) {
           params: { element: tag, attr: m.attr, requires: m.requires }
         },
         data: {
-          details: { reasonCode: 'BRAILLE_ATTR_WITHOUT_EQUIVALENT', attr: m.attr, requires: m.requires }
+          details: {
+            reasonCode: 'BRAILLE_ATTR_WITHOUT_EQUIVALENT',
+            attr: m.attr,
+            requires: m.requires
+          }
         }
       });
     }
@@ -130,7 +149,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 || 'serious', occurrences };
+    return {
+      ruleId: rule.ruleId,
+      outcome: 'fail',
+      severity: rule.defaultSeverity || 'serious',
+      occurrences
+    };
   }
   return { ruleId: rule.ruleId, outcome: 'pass', severity: 'minor', occurrences: [] };
 }

package/src/checks/automatic/aria-conditional-attr.js

@@ -1,3 +1,5 @@
+/* SPDX-License-Identifier: MPL-2.0 */
+
 'use strict';
 
 /**
@@ -16,13 +18,12 @@
  *   `"false"` silently drops the error message from the accessibility
  *   tree — authors almost always intend it to be exposed.
  * @implementation-notes
- * - This is deliberately narrow: a widely-used reference engine's own
- *   `aria-conditional-attr` rule covers a broader table of attribute/condition
- *   pairs. This rule implements only the one pairing (`aria-errormessage` /
- *   `aria-invalid`) that is unambiguous and explicitly stated in the
- *   ARIA spec, to keep `fail` high-confidence — matches this repo's
- *   established pattern (see `aria-required-attr`/`aria-prohibited-attr`
- *   for the same "narrower than that reference engine, but zero false positives"
+ * - This is deliberately narrow: the broader space is a table of many
+ *   attribute/condition pairs. This rule implements only the one pairing
+ *   (`aria-errormessage` / `aria-invalid`) that is unambiguous and
+ *   explicitly stated in the ARIA spec, to keep `fail` high-confidence —
+ *   matches this repo's established pattern (see `aria-required-attr`/
+ *   `aria-prohibited-attr` for the same "narrow but zero false positives"
  *   trade-off).
  * - Does not check whether the `aria-errormessage` ID reference itself
  *   resolves to an existing element — that is `aria-valid-attr-value`'s
@@ -43,7 +44,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: 'serious',
   category: 'robust',
@@ -53,9 +60,11 @@ const meta = {
 };
 
 function runInPage(ctx) {
-  const { document, helpers, rule } = ctx;
+  const { helpers, rule } = ctx;
 
-  function trim(v) { return (v == null ? '' : String(v)).trim(); }
+  function trim(v) {
+    return (v == null ? '' : String(v)).trim();
+  }
 
   const TRUTHY_INVALID_VALUES = new Set(['true', 'grammar', 'spelling']);
 
@@ -78,13 +87,14 @@ function runInPage(ctx) {
     if (TRUTHY_INVALID_VALUES.has(invalidValue)) 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 tag = (el.tagName || '').toLowerCase();
 
     occurrences.push({
       selector: stableSelector,
       html,
-      summary: 'This element has aria-errormessage but aria-invalid is missing or "false", so the error message is not exposed.',
+      summary:
+        'This element has aria-errormessage but aria-invalid is missing or "false", so the error message is not exposed.',
       hint: 'Set aria-invalid to "true" (or "grammar"/"spelling") whenever aria-errormessage should be exposed to assistive technology.',
       i18n: {
         summaryKey: 'ariaConditionalAttr_summary_fail',
@@ -92,7 +102,10 @@ function runInPage(ctx) {
         params: { element: tag, ariaInvalid: invalidValue || '(absent)' }
       },
       data: {
-        details: { reasonCode: 'ARIA_ERRORMESSAGE_WITHOUT_TRUTHY_INVALID', ariaInvalid: invalidValue }
+        details: {
+          reasonCode: 'ARIA_ERRORMESSAGE_WITHOUT_TRUTHY_INVALID',
+          ariaInvalid: invalidValue
+        }
       }
     });
   }
@@ -101,7 +114,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 || 'serious', occurrences };
+    return {
+      ruleId: rule.ruleId,
+      outcome: 'fail',
+      severity: rule.defaultSeverity || 'serious',
+      occurrences
+    };
   }
   return { ruleId: rule.ruleId, outcome: 'pass', severity: 'minor', occurrences: [] };
 }