@surea11y/core 1.4.0 → 1.5.0

package/src/checks/automatic/target-size-minimum.js

@@ -28,7 +28,11 @@
  *   its own wrapping link/button) is one visual region, not two independent
  *   targets; that pattern is nested-interactive-controls-absent's
  *   concern, not a spacing one.
- * - Inline: a link inside a run of text (isInlineTextExceptionTarget).
+ * - Inline: a link inside a text-block container passes outright
+ *   (isInlineTextExceptionTarget). An inline link whose only spacing conflict
+ *   is another inline link in the same run is reported as cantTell
+ *   (isInlineLinkTarget) — the inline exception may cover it, but geometry
+ *   can't confirm that.
  * - User Agent Control: an unstyled native checkbox/radio, detected via
  *   `appearance` not being reset to `none` (see isUserAgentSizedControl) —
  *   scoped narrowly to checkbox/radio specifically, not every form control,
@@ -147,23 +151,10 @@ function runInPage(ctx) {
     return 'html';
   }
 
-  function htmlSnippet(el) {
-    try {
-      if (helpers && typeof helpers.getOuterHtmlSnippet === 'function')
-        return helpers.getOuterHtmlSnippet(el);
-    } catch {}
-    try {
-      return el && el.outerHTML ? String(el.outerHTML) : '';
-    } catch {}
-    return '';
-  }
-
-  function isInlineTextExceptionTarget(el) {
-    // SC 2.5.8 exception: target is in a sentence/block of text (inline)
-    // Deterministic heuristic:
-    // - must be a link-like target
-    // - must be rendered as inline/inline-*
-    // - must be inside a typical text container
+  // A link-like target (a[href] or role="link") rendered inline/inline-* and
+  // carrying visible text. This is the shape the SC 2.5.8 inline exception is
+  // about, without the surrounding-container requirement.
+  function isInlineLinkTarget(el) {
     try {
       if (!el || el.nodeType !== 1) return false;
 
@@ -180,27 +171,31 @@ function runInPage(ctx) {
 
       const cs = getStyle(el);
       const display = cs && cs.display ? String(cs.display) : '';
-      if (!display) return false;
-
-      // Inline exception is for inline text runs; many design systems use inline-block for links,
-      // so treat inline-block variants as eligible for this exception.
+      // Many design systems use inline-block for links, so treat the
+      // inline-block variants as inline here too.
       const isInline =
         display === 'inline' ||
         display === 'inline-block' ||
         display === 'inline-flex' ||
         display === 'inline-grid' ||
         display === 'inline-table';
-
       if (!isInline) return false;
 
-      const t = (el.textContent || '').trim();
-      if (!t) return false;
+      return (el.textContent || '').trim().length > 0;
+    } catch {
+      return false;
+    }
+  }
+
+  function isInlineTextExceptionTarget(el) {
+    // SC 2.5.8 exception: an inline link that sits inside a run of text.
+    try {
+      if (!isInlineLinkTarget(el)) return false;
 
-      // Require that it sits in a "text block" context
       const textContainer = closest(el, 'p, li, dd, dt, blockquote, figcaption, caption, td, th');
       if (textContainer) return true;
 
-      // Fallback: sometimes links are inside spans within a paragraph-like region
+      // Links are often wrapped in an inline element inside the text block.
       const inlineContainer = closest(el, 'span, em, strong, small, label');
       if (inlineContainer) {
         const outerTextBlock = closest(
@@ -590,27 +585,27 @@ function runInPage(ctx) {
       // the result once any other target on the page had a confident
       // fail (see helpers.resolveTieredOutcome's header comment). Now
       // reported as its own cantTell-tier occurrence instead.
-      cantTellOccurrences.push({
-        selector: buildSelector(it.el),
-        html: htmlSnippet(it.el),
-        occurrenceOutcome: 'cantTell',
-        summary:
-          'Target may be too small and too close to another target, but the overlap is near the detection threshold and could not be confidently measured.',
-        hint: 'Manually verify the effective spacing between this target and its neighbor; increase target size or spacing if the overlap is real.',
-        i18n: {
-          summaryKey: 'targetSizeMinimum_summary_cantTell_ambiguousSpacing',
-          hintKey: 'targetSizeMinimum_hint_cantTell_ambiguousSpacing',
-          params: {}
-        },
-        data: {
-          details: {
-            measured: { width: it.rect.width, height: it.rect.height },
-            reasonCode: 'undersized-ambiguous-spacing',
-            conflictHitCount: info.hitCount,
-            conflictWith: info.conflictEl ? buildSelector(info.conflictEl) : null
+      cantTellOccurrences.push(
+        helpers.reportOccurrence(it.el, {
+          occurrenceOutcome: 'cantTell',
+          summary:
+            'Target may be too small and too close to another target, but the overlap is near the detection threshold and could not be confidently measured.',
+          hint: 'Manually verify the effective spacing between this target and its neighbor; increase target size or spacing if the overlap is real.',
+          i18n: {
+            summaryKey: 'targetSizeMinimum_summary_cantTell_ambiguousSpacing',
+            hintKey: 'targetSizeMinimum_hint_cantTell_ambiguousSpacing',
+            params: {}
+          },
+          data: {
+            details: {
+              measured: { width: it.rect.width, height: it.rect.height },
+              reasonCode: 'undersized-ambiguous-spacing',
+              conflictHitCount: info.hitCount,
+              conflictWith: info.conflictEl ? buildSelector(info.conflictEl) : null
+            }
           }
-        }
-      });
+        })
+      );
       continue;
     }
 
@@ -619,50 +614,78 @@ function runInPage(ctx) {
         // Confident spacing conflict, but the target may be exempt as part
         // of an essential graphic/image-map region — same "previously
         // unrecoverable" gap as above, now reported instead of dropped.
-        cantTellOccurrences.push({
-          selector: buildSelector(it.el),
-          html: htmlSnippet(it.el),
-          occurrenceOutcome: 'cantTell',
-          summary:
-            'Target is too small and too close to another target, but may be exempt as part of an essential graphic or image-map region.',
-          hint: 'Verify whether this target’s size is genuinely essential to its function (e.g. part of an SVG/canvas/image map); if not, increase target size or spacing.',
+        cantTellOccurrences.push(
+          helpers.reportOccurrence(it.el, {
+            occurrenceOutcome: 'cantTell',
+            summary:
+              'Target is too small and too close to another target, but may be exempt as part of an essential graphic or image-map region.',
+            hint: 'Verify whether this target’s size is genuinely essential to its function (e.g. part of an SVG/canvas/image map); if not, increase target size or spacing.',
+            i18n: {
+              summaryKey: 'targetSizeMinimum_summary_cantTell_plausiblyEssential',
+              hintKey: 'targetSizeMinimum_hint_cantTell_plausiblyEssential',
+              params: {}
+            },
+            data: {
+              details: {
+                measured: { width: it.rect.width, height: it.rect.height },
+                reasonCode: 'undersized-plausibly-essential',
+                conflictHitCount: info.hitCount,
+                conflictWith: info.conflictEl ? buildSelector(info.conflictEl) : null
+              }
+            }
+          })
+        );
+        continue;
+      }
+
+      // This target and its conflicting neighbor are both inline links in the
+      // same text run, where the SC 2.5.8 inline exception may apply. That
+      // can't be decided from geometry alone, so defer to manual review.
+      if (isInlineLinkTarget(it.el) && info.conflictEl && isInlineLinkTarget(info.conflictEl)) {
+        cantTellOccurrences.push(
+          helpers.reportOccurrence(it.el, {
+            occurrenceOutcome: 'cantTell',
+            summary:
+              'Target is smaller than 24×24 CSS px and close to another inline link in the same run of text, where the inline exception may apply.',
+            hint: 'Confirm whether these links form a run of inline text (which is exempt); otherwise increase the target size to at least 24×24 CSS px or add spacing.',
+            i18n: {
+              summaryKey: 'targetSizeMinimum_summary_cantTell_inlineLinkRun',
+              hintKey: 'targetSizeMinimum_hint_cantTell_inlineLinkRun',
+              params: {}
+            },
+            data: {
+              details: {
+                measured: { width: it.rect.width, height: it.rect.height },
+                reasonCode: 'undersized-inline-link-run',
+                conflictHitCount: info.hitCount,
+                conflictWith: info.conflictEl ? buildSelector(info.conflictEl) : null
+              }
+            }
+          })
+        );
+        continue;
+      }
+
+      failOccurrences.push(
+        helpers.reportOccurrence(it.el, {
+          occurrenceOutcome: 'fail',
+          summary: 'Target is too small and too close to another target.',
+          hint: 'Increase target size to at least 24 by 24 CSS pixels, or add sufficient spacing.',
           i18n: {
-            summaryKey: 'targetSizeMinimum_summary_cantTell_plausiblyEssential',
-            hintKey: 'targetSizeMinimum_hint_cantTell_plausiblyEssential',
+            summaryKey: 'targetSizeMinimum_summary_fail',
+            hintKey: 'targetSizeMinimum_hint_fail',
             params: {}
           },
           data: {
             details: {
               measured: { width: it.rect.width, height: it.rect.height },
-              reasonCode: 'undersized-plausibly-essential',
+              reasonCode: 'undersized-and-too-close',
               conflictHitCount: info.hitCount,
               conflictWith: info.conflictEl ? buildSelector(info.conflictEl) : null
             }
           }
-        });
-        continue;
-      }
-
-      failOccurrences.push({
-        selector: buildSelector(it.el),
-        html: htmlSnippet(it.el),
-        occurrenceOutcome: 'fail',
-        summary: 'Target is too small and too close to another target.',
-        hint: 'Increase target size to at least 24 by 24 CSS pixels, or add sufficient spacing.',
-        i18n: {
-          summaryKey: 'targetSizeMinimum_summary_fail',
-          hintKey: 'targetSizeMinimum_hint_fail',
-          params: {}
-        },
-        data: {
-          details: {
-            measured: { width: it.rect.width, height: it.rect.height },
-            reasonCode: 'undersized-and-too-close',
-            conflictHitCount: info.hitCount,
-            conflictWith: info.conflictEl ? buildSelector(info.conflictEl) : null
-          }
-        }
-      });
+        })
+      );
     }
   }
 

package/src/checks/automatic/td-has-header.js

@@ -150,26 +150,21 @@ function runInPage(ctx) {
         if (hasColumnHeaderAbove(r, c)) continue;
         if (hasRowHeaderBefore(r, c)) continue;
 
-        const stableSelector = helpers.buildSelector ? helpers.buildSelector(cell) : 'html';
-        const html = helpers.getOuterHtmlSnippet
-          ? helpers.getOuterHtmlSnippet(cell)
-          : cell.outerHTML || '';
-
-        occurrences.push({
-          selector: stableSelector,
-          html,
-          summary:
-            'This data cell has no associated header (no headers attribute, no column <th> above it, no row <th> to its left).',
-          hint: 'Add a headers attribute referencing the relevant <th> id(s), or restructure the table so this cell has an implicit row/column header.',
-          i18n: {
-            summaryKey: 'tdHasHeader_summary_fail',
-            hintKey: 'tdHasHeader_hint_fail',
-            params: { row: String(r), column: String(c) }
-          },
-          data: {
-            details: { reasonCode: 'TD_NO_ASSOCIATED_HEADER', row: r, column: c }
-          }
-        });
+        occurrences.push(
+          helpers.reportOccurrence(cell, {
+            summary:
+              'This data cell has no associated header (no headers attribute, no column <th> above it, no row <th> to its left).',
+            hint: 'Add a headers attribute referencing the relevant <th> id(s), or restructure the table so this cell has an implicit row/column header.',
+            i18n: {
+              summaryKey: 'tdHasHeader_summary_fail',
+              hintKey: 'tdHasHeader_hint_fail',
+              params: { row: String(r), column: String(c) }
+            },
+            data: {
+              details: { reasonCode: 'TD_NO_ASSOCIATED_HEADER', row: r, column: c }
+            }
+          })
+        );
       }
     }
   }

package/src/checks/automatic/textbox-name-present.js

@@ -109,9 +109,16 @@ function runInPage(ctx) {
     return '';
   }
 
+  // Naming rules apply only to elements included in the accessibility tree
+  // (ACT c487ae and siblings), which excludes focusable aria-hidden content.
+  // aria-hidden-focus (ACT 6cfa84) covers that markup instead.
   function isEligibleAcc(helpers, el, ctx) {
     const fn =
-      helpers && typeof helpers.isAccTreeEligible === 'function' ? helpers.isAccTreeEligible : null;
+      helpers && typeof helpers.isIncludedInAccessibilityTree === 'function'
+        ? helpers.isIncludedInAccessibilityTree
+        : helpers && typeof helpers.isAccTreeEligible === 'function'
+          ? helpers.isAccTreeEligible
+          : null;
     if (!fn) return true;
     try {
       const r = fn(el, ctx);
@@ -220,24 +227,22 @@ function runInPage(ctx) {
           }
         })()
       : null;
-    const stableSelector = helpers.buildSelector ? helpers.buildSelector(el) : 'html';
-    const html = helpers.getOuterHtmlSnippet ? helpers.getOuterHtmlSnippet(el) : el.outerHTML || '';
 
-    occurrences.push({
-      selector: stableSelector,
-      html,
-      summary: 'This element has no accessible name.',
-      hint: "Provide aria-label, aria-labelledby, or a title attribute — visible text content is not exposed as this textbox's accessible name.",
-      i18n: {
-        summaryKey: 'textboxNamePresent_summary_fail',
-        hintKey: 'textboxNamePresent_hint_fail',
-        params: { controlType: 'textbox' }
-      },
-      data: {
-        details: { reasonCode: 'name_missing', controlType: 'textbox', methodTried: res.method },
-        visibilityFilter: eligInfo || { targetSet: 'acc', accEligible: null, reasons: [] }
-      }
-    });
+    occurrences.push(
+      helpers.reportOccurrence(el, {
+        summary: 'This element has no accessible name.',
+        hint: "Provide aria-label, aria-labelledby, or a title attribute — visible text content is not exposed as this textbox's accessible name.",
+        i18n: {
+          summaryKey: 'textboxNamePresent_summary_fail',
+          hintKey: 'textboxNamePresent_hint_fail',
+          params: { controlType: 'textbox' }
+        },
+        data: {
+          details: { reasonCode: 'name_missing', controlType: 'textbox', methodTried: res.method },
+          visibilityFilter: eligInfo || { targetSet: 'acc', accEligible: null, reasons: [] }
+        }
+      })
+    );
   }
 
   if (applicableCount === 0) {

package/src/checks/automatic/tooltip-name-present.js

@@ -83,9 +83,16 @@ function runInPage(ctx) {
     return '';
   }
 
+  // Naming rules apply only to elements included in the accessibility tree
+  // (ACT c487ae and siblings), which excludes focusable aria-hidden content.
+  // aria-hidden-focus (ACT 6cfa84) covers that markup instead.
   function isEligibleAcc(helpers, el, ctx) {
     const fn =
-      helpers && typeof helpers.isAccTreeEligible === 'function' ? helpers.isAccTreeEligible : null;
+      helpers && typeof helpers.isIncludedInAccessibilityTree === 'function'
+        ? helpers.isIncludedInAccessibilityTree
+        : helpers && typeof helpers.isAccTreeEligible === 'function'
+          ? helpers.isAccTreeEligible
+          : null;
     if (!fn) return true;
     try {
       const r = fn(el, ctx);
@@ -141,24 +148,22 @@ function runInPage(ctx) {
           }
         })()
       : null;
-    const stableSelector = helpers.buildSelector ? helpers.buildSelector(el) : 'html';
-    const html = helpers.getOuterHtmlSnippet ? helpers.getOuterHtmlSnippet(el) : el.outerHTML || '';
-
-    occurrences.push({
-      selector: stableSelector,
-      html,
-      summary: 'This tooltip has no accessible name.',
-      hint: 'Provide tooltip text that is not hidden from assistive technologies, or provide aria-label or aria-labelledby.',
-      i18n: {
-        summaryKey: 'tooltipNamePresent_summary_fail',
-        hintKey: 'tooltipNamePresent_hint_fail',
-        params: {}
-      },
-      data: {
-        details: { reasonCode: 'name_missing', controlType: 'tooltip', methodTried: res.method },
-        visibilityFilter: eligInfo || { targetSet: 'acc', accEligible: null, reasons: [] }
-      }
-    });
+
+    occurrences.push(
+      helpers.reportOccurrence(el, {
+        summary: 'This tooltip has no accessible name.',
+        hint: 'Provide tooltip text that is not hidden from assistive technologies, or provide aria-label or aria-labelledby.',
+        i18n: {
+          summaryKey: 'tooltipNamePresent_summary_fail',
+          hintKey: 'tooltipNamePresent_hint_fail',
+          params: {}
+        },
+        data: {
+          details: { reasonCode: 'name_missing', controlType: 'tooltip', methodTried: res.method },
+          visibilityFilter: eligInfo || { targetSet: 'acc', accEligible: null, reasons: [] }
+        }
+      })
+    );
   }
 
   if (applicableCount === 0) {

package/src/checks/automatic/treeitem-name-present.js

@@ -83,9 +83,16 @@ function runInPage(ctx) {
     return '';
   }
 
+  // Naming rules apply only to elements included in the accessibility tree
+  // (ACT c487ae and siblings), which excludes focusable aria-hidden content.
+  // aria-hidden-focus (ACT 6cfa84) covers that markup instead.
   function isEligibleAcc(helpers, el, ctx) {
     const fn =
-      helpers && typeof helpers.isAccTreeEligible === 'function' ? helpers.isAccTreeEligible : null;
+      helpers && typeof helpers.isIncludedInAccessibilityTree === 'function'
+        ? helpers.isIncludedInAccessibilityTree
+        : helpers && typeof helpers.isAccTreeEligible === 'function'
+          ? helpers.isAccTreeEligible
+          : null;
     if (!fn) return true;
     try {
       const r = fn(el, ctx);
@@ -138,24 +145,22 @@ function runInPage(ctx) {
           }
         })()
       : null;
-    const stableSelector = helpers.buildSelector ? helpers.buildSelector(el) : 'html';
-    const html = helpers.getOuterHtmlSnippet ? helpers.getOuterHtmlSnippet(el) : el.outerHTML || '';
-
-    occurrences.push({
-      selector: stableSelector,
-      html,
-      summary: 'This element has no accessible name.',
-      hint: 'Provide aria-label or aria-labelledby (preferred), or provide visible text that is not hidden from assistive technologies.',
-      i18n: {
-        summaryKey: 'treeitemNamePresent_summary_fail',
-        hintKey: 'treeitemNamePresent_hint_fail',
-        params: { controlType: 'treeitem' }
-      },
-      data: {
-        details: { reasonCode: 'name_missing', controlType: 'treeitem', methodTried: res.method },
-        visibilityFilter: eligInfo || { targetSet: 'acc', accEligible: null, reasons: [] }
-      }
-    });
+
+    occurrences.push(
+      helpers.reportOccurrence(el, {
+        summary: 'This element has no accessible name.',
+        hint: 'Provide aria-label or aria-labelledby (preferred), or provide visible text that is not hidden from assistive technologies.',
+        i18n: {
+          summaryKey: 'treeitemNamePresent_summary_fail',
+          hintKey: 'treeitemNamePresent_hint_fail',
+          params: { controlType: 'treeitem' }
+        },
+        data: {
+          details: { reasonCode: 'name_missing', controlType: 'treeitem', methodTried: res.method },
+          visibilityFilter: eligInfo || { targetSet: 'acc', accEligible: null, reasons: [] }
+        }
+      })
+    );
   }
 
   if (applicableCount === 0) {

package/src/checks/automatic/valid-lang.js

@@ -58,7 +58,13 @@ const meta = {
 function runInPage(ctx) {
   const { helpers, rule } = ctx;
 
+  // Shape alone accepts unregistered tags such as "eng" and "em-US", so the
+  // primary subtag is checked against the IANA registry via the shared helper.
   const BCP47_RE = /^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$/;
+  const isValidTag =
+    typeof helpers.isValidLanguageTag === 'function'
+      ? helpers.isValidLanguageTag
+      : (v) => BCP47_RE.test(String(v || ''));
 
   const nodes = helpers.queryAllSmart
     ? helpers.queryAllSmart('[lang]')
@@ -71,31 +77,36 @@ function runInPage(ctx) {
     if (!el || !el.getAttribute) continue;
     if (el.tagName && el.tagName.toLowerCase() === 'html') continue;
 
-    const raw = String(el.getAttribute('lang') || '').trim();
-    if (!raw) continue;
+    const rawAttr = el.getAttribute('lang');
+    if (rawAttr === null || rawAttr === '') continue; // ACT de46e4: empty is out of scope
+
+    // The rule applies only where text actually inherits the language, so an
+    // element with no text, or whose text reaches no one, has nothing to
+    // declare a language for.
+    if (!String(el.textContent || '').trim()) continue;
 
     applicableCount += 1;
 
-    if (BCP47_RE.test(raw)) continue;
+    // A whitespace-only value is in scope and has no primary language tag.
+    const raw = String(rawAttr).trim();
+    if (isValidTag(raw)) continue;
 
     const tag = el.tagName.toLowerCase();
-    const stableSelector = helpers.buildSelector ? helpers.buildSelector(el) : 'html';
-    const html = helpers.getOuterHtmlSnippet ? helpers.getOuterHtmlSnippet(el) : el.outerHTML || '';
-
-    occurrences.push({
-      selector: stableSelector,
-      html,
-      summary: `This lang attribute value ("${raw}") is not a syntactically valid language tag.`,
-      hint: 'Use a valid BCP47 language tag (e.g. "fr", "es-MX").',
-      i18n: {
-        summaryKey: 'validLang_summary_fail',
-        hintKey: 'validLang_hint_fail',
-        params: { element: tag, value: raw }
-      },
-      data: {
-        details: { reasonCode: 'ELEMENT_LANG_INVALID', element: tag, value: raw }
-      }
-    });
+
+    occurrences.push(
+      helpers.reportOccurrence(el, {
+        summary: `This lang attribute value ("${raw}") is not a syntactically valid language tag.`,
+        hint: 'Use a valid BCP47 language tag (e.g. "fr", "es-MX").',
+        i18n: {
+          summaryKey: 'validLang_summary_fail',
+          hintKey: 'validLang_hint_fail',
+          params: { element: tag, value: raw }
+        },
+        data: {
+          details: { reasonCode: 'ELEMENT_LANG_INVALID', element: tag, value: raw }
+        }
+      })
+    );
   }
 
   if (applicableCount === 0) {

package/src/checks/manual/accesskeys-manual.js

@@ -62,25 +62,24 @@ function runInPage(ctx) {
   for (const [key, els] of groups) {
     if (els.length <= 1) continue;
     for (const el of els) {
-      const stableSelector = helpers.buildSelector ? helpers.buildSelector(el) : 'html';
-      const html = helpers.getOuterHtmlSnippet
-        ? helpers.getOuterHtmlSnippet(el)
-        : el.outerHTML || '';
-
-      occurrences.push({
-        selector: stableSelector,
-        html,
-        summary: "This element's accesskey is shared with another element on the page.",
-        hint: 'Make each accesskey value unique across the page.',
-        i18n: {
-          summaryKey: 'accesskeys_summary_cantTell',
-          hintKey: 'accesskeys_hint_cantTell',
-          params: { accesskey: key, duplicateCount: String(els.length) }
-        },
-        data: {
-          details: { reasonCode: 'ACCESSKEY_DUPLICATE', accesskey: key, duplicateCount: els.length }
-        }
-      });
+      occurrences.push(
+        helpers.reportOccurrence(el, {
+          summary: "This element's accesskey is shared with another element on the page.",
+          hint: 'Make each accesskey value unique across the page.',
+          i18n: {
+            summaryKey: 'accesskeys_summary_cantTell',
+            hintKey: 'accesskeys_hint_cantTell',
+            params: { accesskey: key, duplicateCount: String(els.length) }
+          },
+          data: {
+            details: {
+              reasonCode: 'ACCESSKEY_DUPLICATE',
+              accesskey: key,
+              duplicateCount: els.length
+            }
+          }
+        })
+      );
     }
   }
 

package/src/checks/manual/aria-checked-state-mismatch-manual.js

@@ -114,29 +114,26 @@ function runInPage(ctx) {
 
     if (normalizedAriaChecked === actualState) continue;
 
-    const stableSelector = helpers.buildSelector ? helpers.buildSelector(el) : 'html';
-    const html = helpers.getOuterHtmlSnippet ? helpers.getOuterHtmlSnippet(el) : el.outerHTML || '';
-
-    occurrences.push({
-      selector: stableSelector,
-      html,
-      summary:
-        'This element’s aria-checked value does not match its actual checked/indeterminate state.',
-      hint: 'Set aria-checked to match the element’s real state, or remove it — a native checkbox/radio already exposes this state without it.',
-      i18n: {
-        summaryKey: 'ariaCheckedStateMismatch_summary_cantTell',
-        hintKey: 'ariaCheckedStateMismatch_hint_cantTell',
-        params: { ariaChecked: normalizedAriaChecked, actualState, type }
-      },
-      data: {
-        details: {
-          reasonCode: 'ARIA_CHECKED_STATE_MISMATCH',
-          ariaChecked: normalizedAriaChecked,
-          actualState,
-          type
+    occurrences.push(
+      helpers.reportOccurrence(el, {
+        summary:
+          'This element’s aria-checked value does not match its actual checked/indeterminate state.',
+        hint: 'Set aria-checked to match the element’s real state, or remove it — a native checkbox/radio already exposes this state without it.',
+        i18n: {
+          summaryKey: 'ariaCheckedStateMismatch_summary_cantTell',
+          hintKey: 'ariaCheckedStateMismatch_hint_cantTell',
+          params: { ariaChecked: normalizedAriaChecked, actualState, type }
+        },
+        data: {
+          details: {
+            reasonCode: 'ARIA_CHECKED_STATE_MISMATCH',
+            ariaChecked: normalizedAriaChecked,
+            actualState,
+            type
+          }
         }
-      }
-    });
+      })
+    );
   }
 
   if (applicableCount === 0) {