@surea11y/core 1.4.1 → 1.5.0

package/src/checks/automatic/table-th-has-data-cells.js

@@ -156,25 +156,21 @@ function runInPage(ctx) {
 
     for (const th of headers) {
       if (!th) continue;
-      const stableSelector = helpers.buildSelector ? helpers.buildSelector(th) : 'html';
-      const html = helpers.getOuterHtmlSnippet
-        ? helpers.getOuterHtmlSnippet(th)
-        : th.outerHTML || '';
-
-      occurrences.push({
-        selector: stableSelector,
-        html,
-        summary: 'This table has header cells but no data cells for them to describe.',
-        hint: 'Add data cells (<td>) to the table, or remove the header cells if the table has no data.',
-        i18n: {
-          summaryKey: 'tableThHasDataCells_summary_fail',
-          hintKey: 'tableThHasDataCells_hint_fail',
-          params: {}
-        },
-        data: {
-          details: { reasonCode: 'TABLE_TH_NO_DATA_CELLS' }
-        }
-      });
+
+      occurrences.push(
+        helpers.reportOccurrence(th, {
+          summary: 'This table has header cells but no data cells for them to describe.',
+          hint: 'Add data cells (<td>) to the table, or remove the header cells if the table has no data.',
+          i18n: {
+            summaryKey: 'tableThHasDataCells_summary_fail',
+            hintKey: 'tableThHasDataCells_hint_fail',
+            params: {}
+          },
+          data: {
+            details: { reasonCode: 'TABLE_TH_NO_DATA_CELLS' }
+          }
+        })
+      );
     }
   }
 

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

@@ -227,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

@@ -148,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

@@ -145,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

@@ -92,23 +92,21 @@ function runInPage(ctx) {
     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) {

package/src/checks/manual/bypass-blocks-present-manual.js

@@ -51,9 +51,8 @@
  *       unmounted SPA view).
  *   Both cases would produce false positives under a hard `fail`, which this
  *   engine reserves for high-confidence violations; `cantTell` routes them to
- *   human review instead. This mirrors how other tools treat 2.4.1 (e.g. axe
- *   marks the no-mechanism case "needs review" via reviewOnFail rather than
- *   failing it), and why no ACT rule hard-fails 2.4.1 by presence alone.
+ *   human review instead. No ACT rule hard-fails 2.4.1 by presence alone,
+ *   for the same reason.
  * - This rule intentionally checks presence, not position, for the
  *   same-page-anchor condition (b): a full bypass algorithm is heuristic
  *   (see ROADMAP.md's Tier 1a note on why this rule was
@@ -244,15 +243,8 @@ function runInPage(ctx) {
     return { ruleId: rule.ruleId, outcome: 'notApplicable', severity: 'minor', occurrences: [] };
   }
 
-  const stableSelector = helpers.buildSelector ? helpers.buildSelector(body) : 'body';
-  const html = helpers.getOuterHtmlSnippet
-    ? helpers.getOuterHtmlSnippet(body)
-    : (body.outerHTML || '').slice(0, 200);
-
   const occurrences = [
-    {
-      selector: stableSelector,
-      html,
+    helpers.reportOccurrence(body, {
       summary:
         'No recognized way to bypass repeated blocks of content was detected on this page — verify a bypass mechanism exists.',
       hint: 'Confirm the page offers a bypass mechanism: a main landmark (<main> or role="main"), a working "skip to content" link, or heading elements that assistive technology can use to jump past repeated content. (A mechanism may be temporarily hidden — e.g. while a modal dialog makes the page inert — or provided on a per-site basis; this needs human confirmation.)',
@@ -265,7 +257,7 @@ function runInPage(ctx) {
         details: { reasonCode: 'BYPASS_MECHANISM_ABSENT' },
         visibilityFilter: { targetSet: 'acc', accEligible: null, reasons: [] }
       }
-    }
+    })
   ];
 
   return {