@surea11y/core 1.2.0 → 1.3.0

package/src/checks/automatic/video-poster-text-alternative-present.js

@@ -37,7 +37,13 @@ const meta = {
   tags: ['wcag2a', 'wcag111', 'media', 'video', 'atomic', 'automatic'],
   wcagSc: ['1.1.1'],
   normativeMappings: [
-    { standard: 'WCAG', version: '2.2', requirement: '1.1.1', title: 'Non-text Content', conformanceLevel: 'A' }
+    {
+      standard: 'WCAG',
+      version: '2.2',
+      requirement: '1.1.1',
+      title: 'Non-text Content',
+      conformanceLevel: 'A'
+    }
   ],
   defaultSeverity: 'serious',
   category: 'perceivable',
@@ -54,32 +60,28 @@ function runInPage(ctx) {
   const { document, root, helpers, rule } = ctx;
   const safeRoot = root || document;
 
-  const reportOccurrence = helpers && typeof helpers.reportOccurrence === 'function'
-      ? helpers.reportOccurrence
-      : null;
+  const reportOccurrence =
+    helpers && typeof helpers.reportOccurrence === 'function' ? helpers.reportOccurrence : null;
 
-  const queryAllSmart = helpers && typeof helpers.queryAllSmart === 'function' ? helpers.queryAllSmart : null;
-  const queryAll = helpers && typeof helpers.queryAll === 'function'
-      ? helpers.queryAll
-      : null;
+  const queryAllSmart =
+    helpers && typeof helpers.queryAllSmart === 'function' ? helpers.queryAllSmart : null;
+  const queryAll = helpers && typeof helpers.queryAll === 'function' ? helpers.queryAll : null;
 
-  const getEligibilityInfo = helpers && typeof helpers.getEligibilityInfo === 'function'
-    ? helpers.getEligibilityInfo
-    : null;
+  const getEligibilityInfo =
+    helpers && typeof helpers.getEligibilityInfo === 'function' ? helpers.getEligibilityInfo : null;
 
-  const isAccTreeEligible = helpers && typeof helpers.isAccTreeEligible === 'function'
-    ? helpers.isAccTreeEligible
-    : null;
+  const isAccTreeEligible =
+    helpers && typeof helpers.isAccTreeEligible === 'function' ? helpers.isAccTreeEligible : null;
 
-  const isFocusableInfo = helpers && typeof helpers.getFocusableInfo === 'function'
-    ? helpers.getFocusableInfo
-    : null;
+  const isFocusableInfo =
+    helpers && typeof helpers.getFocusableInfo === 'function' ? helpers.getFocusableInfo : null;
 
-  const getAriaNameInfo = helpers && typeof helpers.getAriaNameInfo === 'function'
-    ? helpers.getAriaNameInfo
-    : null;
+  const getAriaNameInfo =
+    helpers && typeof helpers.getAriaNameInfo === 'function' ? helpers.getAriaNameInfo : null;
 
-  function trim(v) { return (v == null ? '' : String(v)).trim(); }
+  function trim(v) {
+    return (v == null ? '' : String(v)).trim();
+  }
 
   function computeNameInfo(el) {
     // <video> is not a labelable element (no browser computes an accessible
@@ -89,11 +91,22 @@ function runInPage(ctx) {
     let aria = null;
 
     if (getAriaNameInfo) {
-      aria = (() => { try { return getAriaNameInfo(el, ctx); } catch { return null; } })();
+      aria = (() => {
+        try {
+          return getAriaNameInfo(el, ctx);
+        } catch {
+          return null;
+        }
+      })();
     }
 
     if (aria && aria.present && trim(aria.value)) {
-      return { present: true, value: trim(aria.value), mechanism: aria.mechanism || 'aria', flags: (aria.flags || []).slice(0) };
+      return {
+        present: true,
+        value: trim(aria.value),
+        mechanism: aria.mechanism || 'aria',
+        flags: (aria.flags || []).slice(0)
+      };
     }
 
     const title = trim(el.getAttribute && el.getAttribute('title'));
@@ -113,14 +126,22 @@ function runInPage(ctx) {
     try {
       if (queryAllSmart) return Array.from(queryAllSmart('video') || []);
       if (queryAll) return Array.from(queryAll('video') || []);
-      return safeRoot && safeRoot.querySelectorAll ? Array.from(safeRoot.querySelectorAll('video')) : [];
+      return safeRoot && safeRoot.querySelectorAll
+        ? Array.from(safeRoot.querySelectorAll('video'))
+        : [];
     } catch {
-      try { return safeRoot && safeRoot.querySelectorAll ? Array.from(safeRoot.querySelectorAll('video')) : []; }
-      catch { return []; }
+      try {
+        return safeRoot && safeRoot.querySelectorAll
+          ? Array.from(safeRoot.querySelectorAll('video'))
+          : [];
+      } catch {
+        return [];
+      }
     }
   })();
 
-  if (!videos.length) return { ruleId: rule.ruleId, outcome: 'notApplicable', severity: 'minor', occurrences: [] };
+  if (!videos.length)
+    return { ruleId: rule.ruleId, outcome: 'notApplicable', severity: 'minor', occurrences: [] };
 
   const occurrences = [];
   let applicableCount = 0;
@@ -134,7 +155,11 @@ function runInPage(ctx) {
     // Eligibility: only elements exposed to AT (with helper exceptions)
     if (isAccTreeEligible) {
       const elig = (() => {
-        try { return isAccTreeEligible(el, ctx); } catch { return { eligible: true, reasons: [] }; }
+        try {
+          return isAccTreeEligible(el, ctx);
+        } catch {
+          return { eligible: true, reasons: [] };
+        }
       })();
       if (elig && elig.eligible === false) continue;
     }
@@ -142,13 +167,20 @@ function runInPage(ctx) {
     // Role presentation/none excluded ONLY if not focusable (mirrors img behavior)
     const role = trim(el.getAttribute('role')).toLowerCase();
     if (role === 'presentation' || role === 'none') {
-      let focusable = false;
+      let focusable;
       if (isFocusableInfo) {
-        const fi = (() => { try { return isFocusableInfo(el, ctx); } catch { return null; } })();
+        const fi = (() => {
+          try {
+            return isFocusableInfo(el, ctx);
+          } catch {
+            return null;
+          }
+        })();
         focusable = !!(fi && fi.focusable);
       } else {
         const tabindex = el.getAttribute('tabindex');
-        focusable = tabindex != null && trim(tabindex) !== '' && !Number.isNaN(Number(trim(tabindex)));
+        focusable =
+          tabindex != null && trim(tabindex) !== '' && !Number.isNaN(Number(trim(tabindex)));
       }
       if (!focusable) continue;
     }
@@ -160,12 +192,16 @@ function runInPage(ctx) {
 
     let eligInfo = null;
     if (getEligibilityInfo) {
-      try { eligInfo = getEligibilityInfo(el, ctx, { targetSet: 'acc' }); } catch { eligInfo = null; }
+      try {
+        eligInfo = getEligibilityInfo(el, ctx, { targetSet: 'acc' });
+      } catch {
+        eligInfo = null;
+      }
     }
 
     const baseOccurrence = {
       summary: 'Missing text alternative for <video> poster.',
-      hint: 'Provide an accessible name (e.g., aria-label/aria-labelledby) for the poster image.',
+      hint: 'Provide an accessible name for the poster image (aria-label/aria-labelledby preferred, or a title attribute as a fallback).',
       i18n: {
         summaryKey: 'videoPoster_textAltPresent_summary_fail',
         hintKey: 'videoPoster_textAltPresent_hint_fail',
@@ -185,9 +221,16 @@ function runInPage(ctx) {
     }
   }
 
-  if (applicableCount === 0) return { ruleId: rule.ruleId, outcome: 'notApplicable', severity: 'minor', occurrences: [] };
-  if (!occurrences.length) return { ruleId: rule.ruleId, outcome: 'pass', severity: 'minor', occurrences: [] };
-  return { ruleId: rule.ruleId, outcome: 'fail', severity: rule.defaultSeverity || 'minor', occurrences };
+  if (applicableCount === 0)
+    return { ruleId: rule.ruleId, outcome: 'notApplicable', severity: 'minor', occurrences: [] };
+  if (!occurrences.length)
+    return { ruleId: rule.ruleId, outcome: 'pass', severity: 'minor', occurrences: [] };
+  return {
+    ruleId: rule.ruleId,
+    outcome: 'fail',
+    severity: rule.defaultSeverity || 'minor',
+    occurrences
+  };
 }
 
 module.exports = { id, meta, runInPage };

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

@@ -40,8 +40,10 @@ const meta = {
 };
 
 function runInPage(ctx) {
-  const { document, helpers, rule } = ctx;
-  const nodes = helpers.queryAllSmart ? helpers.queryAllSmart('[accesskey]') : helpers.queryAll('[accesskey]');
+  const { helpers, rule } = ctx;
+  const nodes = helpers.queryAllSmart
+    ? helpers.queryAllSmart('[accesskey]')
+    : helpers.queryAll('[accesskey]');
 
   const groups = new Map(); // normalized key -> elements[]
   for (const el of nodes) {
@@ -59,12 +61,14 @@ function runInPage(ctx) {
     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 || '');
+      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.',
+        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',
@@ -81,7 +85,12 @@ function runInPage(ctx) {
   if (!occurrences.length) {
     return { ruleId: rule.ruleId, outcome: 'notApplicable', severity: 'minor', occurrences: [] };
   }
-  return { ruleId: rule.ruleId, outcome: 'cantTell', severity: rule.defaultSeverity || 'minor', occurrences };
+  return {
+    ruleId: rule.ruleId,
+    outcome: 'cantTell',
+    severity: rule.defaultSeverity || 'minor',
+    occurrences
+  };
 }
 
 module.exports = { id, meta, runInPage };

package/src/checks/manual/area-alt-decorative-manual.js

@@ -11,237 +11,236 @@
  *   Human review is required to confirm that the provided text alternative is accurate and appropriate.
  */
 
-const id = "area-alt-decorative";
+const id = 'area-alt-decorative';
 
 const meta = {
-    title: "<area> with alt=\"\" must be decorative (manual review)",
-    description: "Flags <area> elements with empty alt for human review that they are decorative/non-informative.",
-    i18n: {
-        titleKey: "area_altDecorative_title",
-        descriptionKey: "area_altDecorative_description"
-    },
-    helpUrl: null,
-    tags: ["wcag2a", "wcag111", "nontext", "images", "imagemap", "manual", "atomic"],
-    wcagSc: ['1.1.1'],
-    normativeMappings: [
-        {standard: 'WCAG', version: '2.2', requirement: '1.1.1', title: 'Non-text Content', conformanceLevel: 'A'}
-    ],
-    defaultSeverity: 'minor',
-    category: 'perceivable',
-    type: 'manual',
-    defaultConfidence: 'medium',
-    coverage: {
-        facetsBySc: {
-            '1.1.1': ['text-alternative-quality']
-        }
+  title: '<area> with alt="" must be decorative (manual review)',
+  description:
+    'Flags <area> elements with empty alt for human review that they are decorative/non-informative.',
+  i18n: {
+    titleKey: 'area_altDecorative_title',
+    descriptionKey: 'area_altDecorative_description'
+  },
+  helpUrl: null,
+  tags: ['wcag2a', 'wcag111', 'nontext', 'images', 'imagemap', 'manual', 'atomic'],
+  wcagSc: ['1.1.1'],
+  normativeMappings: [
+    {
+      standard: 'WCAG',
+      version: '2.2',
+      requirement: '1.1.1',
+      title: 'Non-text Content',
+      conformanceLevel: 'A'
+    }
+  ],
+  defaultSeverity: 'minor',
+  category: 'perceivable',
+  type: 'manual',
+  defaultConfidence: 'medium',
+  coverage: {
+    facetsBySc: {
+      '1.1.1': ['text-alternative-quality']
     }
+  }
 };
 
 function runInPage(ctx) {
-    const {document, root, helpers, rule} = ctx;
-    const safeRoot = root || document;
-
-    const queryAllSmart = helpers && typeof helpers.queryAllSmart === 'function' ? helpers.queryAllSmart : null;
-    const queryAll = helpers && typeof helpers.queryAll === 'function'
-        ? helpers.queryAll
-        : (sel) => {
-            try {
-                return safeRoot && safeRoot.querySelectorAll ? Array.from(safeRoot.querySelectorAll(sel)) : [];
-            } catch {
-                return [];
-            }
+  const { document, root, helpers, rule } = ctx;
+  const safeRoot = root || document;
+
+  const queryAllSmart =
+    helpers && typeof helpers.queryAllSmart === 'function' ? helpers.queryAllSmart : null;
+  const queryAll =
+    helpers && typeof helpers.queryAll === 'function'
+      ? helpers.queryAll
+      : (sel) => {
+          try {
+            return safeRoot && safeRoot.querySelectorAll
+              ? Array.from(safeRoot.querySelectorAll(sel))
+              : [];
+          } catch {
+            return [];
+          }
         };
 
-    const __accEligCache = new WeakMap();
-    function accEligibleCached(node) {
-        if (!isAccTreeEligible) return { eligible: true, reasons: [] };
-        if (!node || typeof node !== 'object') return { eligible: true, reasons: [] };
-        const cached = __accEligCache.get(node);
-        if (cached) return cached;
-        let res;
-        try { res = isAccTreeEligible(node, ctx); }
-        catch { res = { eligible: true, reasons: [] }; }
-        res = res && typeof res === 'object' ? res : { eligible: !!res, reasons: [] };
-        __accEligCache.set(node, res);
-        return res;
+  const __accEligCache = new WeakMap();
+  function accEligibleCached(node) {
+    if (!isAccTreeEligible) return { eligible: true, reasons: [] };
+    if (!node || typeof node !== 'object') return { eligible: true, reasons: [] };
+    const cached = __accEligCache.get(node);
+    if (cached) return cached;
+    let res;
+    try {
+      res = isAccTreeEligible(node, ctx);
+    } catch {
+      res = { eligible: true, reasons: [] };
     }
+    res = res && typeof res === 'object' ? res : { eligible: !!res, reasons: [] };
+    __accEligCache.set(node, res);
+    return res;
+  }
 
-    const getEligibilityInfo = helpers && typeof helpers.getEligibilityInfo === 'function'
-        ? helpers.getEligibilityInfo
-        : null;
-
-    const isAccTreeEligible = helpers && typeof helpers.isAccTreeEligible === 'function'
-        ? helpers.isAccTreeEligible
-        : null;
+  const getEligibilityInfo =
+    helpers && typeof helpers.getEligibilityInfo === 'function' ? helpers.getEligibilityInfo : null;
 
+  const isAccTreeEligible =
+    helpers && typeof helpers.isAccTreeEligible === 'function' ? helpers.isAccTreeEligible : null;
 
-// --- image-map semantics (rule-local; match automatic <area> applicability) ---
-    function normUsemap(val) {
-        try {
-            const t = String(val || '').trim();
-            if (!t) return '';
-            return (t[0] === '#') ? t.slice(1).trim().toLowerCase() : t.toLowerCase();
-        } catch {
-            return '';
-        }
+  // --- image-map semantics (rule-local; match automatic <area> applicability) ---
+  function normUsemap(val) {
+    try {
+      const t = String(val || '').trim();
+      if (!t) return '';
+      return t[0] === '#' ? t.slice(1).trim().toLowerCase() : t.toLowerCase();
+    } catch {
+      return '';
     }
+  }
 
-    function getMapName(mapEl) {
-        try {
-            if (!mapEl || !mapEl.getAttribute) return '';
-            const n = String(mapEl.getAttribute('name') || mapEl.getAttribute('id') || '').trim();
-            return n ? n.toLowerCase() : '';
-        } catch {
-            return '';
-        }
+  function getMapName(mapEl) {
+    try {
+      if (!mapEl || !mapEl.getAttribute) return '';
+      const n = String(mapEl.getAttribute('name') || mapEl.getAttribute('id') || '').trim();
+      return n ? n.toLowerCase() : '';
+    } catch {
+      return '';
     }
+  }
+
+  const getFocusableInfo =
+    helpers && typeof helpers.getFocusableInfo === 'function' ? helpers.getFocusableInfo : null;
+
+  function isRolePresentationExcluded(el) {
+    const role = (() => {
+      try {
+        return String(el.getAttribute('role') || '')
+          .trim()
+          .toLowerCase();
+      } catch {
+        return '';
+      }
+    })();
+    if (role !== 'presentation' && role !== 'none') return false;
 
-    function getReferencingImgForArea(areaEl) {
+    // Exclude only when NOT focusable (mirrors img-alt-present policy)
+    let focusable;
+    if (getFocusableInfo) {
+      const fi = (() => {
         try {
-            if (!areaEl || !areaEl.closest) return null;
-            const map = areaEl.closest('map');
-            if (!map) return null;
-            const mapName = getMapName(map);
-            if (!mapName) return null;
-
-            const imgs = Array.from(document.querySelectorAll('img[usemap]'));
-            for (const img of imgs) {
-                const u = normUsemap(img.getAttribute('usemap'));
-                if (u && u === mapName) return img; // deterministic: first match in doc order
-            }
+          return getFocusableInfo(el, ctx);
         } catch {
+          return null;
         }
-        return null;
+      })();
+      focusable = !!(fi && fi.focusable);
+    } else {
+      const tabindex = el.getAttribute('tabindex');
+      focusable =
+        tabindex != null &&
+        String(tabindex).trim() !== '' &&
+        !Number.isNaN(Number(String(tabindex).trim()));
     }
+    return !focusable;
+  }
 
-    const getFocusableInfo = helpers && typeof helpers.getFocusableInfo === 'function'
-        ? helpers.getFocusableInfo
-        : null;
-
-    function isRolePresentationExcluded(el) {
-        const role = (() => {
-            try {
-                return String(el.getAttribute('role') || '').trim().toLowerCase();
-            } catch {
-                return '';
-            }
-        })();
-        if (role !== 'presentation' && role !== 'none') return false;
-
-        // Exclude only when NOT focusable (mirrors img-alt-present policy)
-        let focusable = false;
-        if (getFocusableInfo) {
-            const fi = (() => {
-                try {
-                    return getFocusableInfo(el, ctx);
-                } catch {
-                    return null;
-                }
-            })();
-            focusable = !!(fi && fi.focusable);
-        } else {
-            const tabindex = el.getAttribute('tabindex');
-            focusable = tabindex != null && String(tabindex).trim() !== '' && !Number.isNaN(Number(String(tabindex).trim()));
-        }
-        return !focusable;
+  const els = (() => {
+    try {
+      return Array.from((queryAllSmart ? queryAllSmart('area') : queryAll('area')) || []);
+    } catch {
+      return queryAll('area');
+    }
+  })();
+
+  const __usemapIndex = new Map(); // mapName -> img (first in document order)
+  try {
+    const imgs = Array.from(document.querySelectorAll('img[usemap]'));
+    for (const img of imgs) {
+      const u = normUsemap(img.getAttribute('usemap'));
+      if (!u) continue;
+      if (!__usemapIndex.has(u)) __usemapIndex.set(u, img); // keep first match only
     }
+  } catch {}
 
+  if (!els.length) {
+    return { ruleId: rule.ruleId, outcome: 'notApplicable', severity: 'minor', occurrences: [] };
+  }
 
-    const els = (() => {
-        try {
-            return Array.from((queryAllSmart ? queryAllSmart("area") : queryAll("area")) || []);
-        } catch {
-            return queryAll("area");
-        }
-    })();
+  const occurrences = [];
+  let applicableCount = 0;
+
+  for (const el of els) {
+    if (!el || !el.getAttribute) continue;
 
-    const __usemapIndex = new Map(); // mapName -> img (first in document order)
+    // Must belong to a *used* image map (referenced by an <img usemap>). If unused, not applicable.
+    let img;
     try {
-        const imgs = Array.from(document.querySelectorAll('img[usemap]'));
-        for (const img of imgs) {
-            const u = normUsemap(img.getAttribute('usemap'));
-            if (!u) continue;
-            if (!__usemapIndex.has(u)) __usemapIndex.set(u, img); // keep first match only
-        }
+      const map = el.closest && el.closest('map');
+      const mapName = map ? getMapName(map) : '';
+      img = mapName ? __usemapIndex.get(mapName) || null : null;
     } catch {
+      img = null;
     }
+    if (!img) continue;
 
-    if (!els.length) {
-        return {ruleId: rule.ruleId, outcome: 'notApplicable', severity: 'minor', occurrences: []};
+    // The referencing <img> must be eligible in the accessibility tree.
+    if (isAccTreeEligible) {
+      const imgElig = accEligibleCached(img);
+      if (imgElig && imgElig.eligible === false) continue;
     }
 
-    const occurrences = [];
-    let applicableCount = 0;
-
-    for (const el of els) {
-        if (!el || !el.getAttribute) continue;
-
-        // Must belong to a *used* image map (referenced by an <img usemap>). If unused, not applicable.
-        let img = null;
+    if (isAccTreeEligible) {
+      const elig = (() => {
         try {
-            const map = el.closest && el.closest('map');
-            const mapName = map ? getMapName(map) : '';
-            img = mapName ? (__usemapIndex.get(mapName) || null) : null;
+          return isAccTreeEligible(el, ctx);
         } catch {
-            img = null;
-        }
-        if (!img) continue;
-
-        // The referencing <img> must be eligible in the accessibility tree.
-        if (isAccTreeEligible) {
-            const imgElig = accEligibleCached(img);
-            if (imgElig && imgElig.eligible === false) continue;
+          return { eligible: true, reasons: [] };
         }
+      })();
+      if (elig && elig.eligible === false) continue;
+    }
 
-        if (isAccTreeEligible) {
-            const elig = (() => {
-                try {
-                    return isAccTreeEligible(el, ctx);
-                } catch {
-                    return {eligible: true, reasons: []};
-                }
-            })();
-            if (elig && elig.eligible === false) continue;
-        }
+    if (isRolePresentationExcluded(el)) continue;
 
-        if (isRolePresentationExcluded(el)) continue;
-
-        // Rule-specific applicability (only elements that already have a text alternative mechanism)
-        let alt = null;
-        try { alt = el.getAttribute('alt'); } catch { alt = null; }
-        if (alt === null) continue;
-        if (String(alt).trim() !== '') continue; // only alt=""
-
-        applicableCount += 1;
-
-        const eligInfo = getEligibilityInfo ? getEligibilityInfo(el, ctx, {targetSet: 'acc'}) : null;
-
-        const baseOccurrence = {
-            summary: 'Review whether <area> is decorative (alt="").',
-            hint: 'Confirm the area does not convey information or function. If it is interactive or meaningful, provide meaningful alt text.',
-            i18n: {
-                summaryKey: 'area_altDecorative_summary_cantTell',
-                hintKey: 'area_altDecorative_hint_cantTell',
-                params: {element: (el.tagName || '').toLowerCase()}
-            },
-            data: {
-                visibilityFilter: eligInfo || {targetSet: 'acc', accEligible: null, reasons: []},
-                details: null
-            }
-        };
-
-        if (helpers && typeof helpers.reportOccurrence === 'function') {
-            occurrences.push(helpers.reportOccurrence(el, baseOccurrence));
-        } else {
-            occurrences.push({selector: '', html: '', ...baseOccurrence});
-        }
+    // Rule-specific applicability (only elements that already have a text alternative mechanism)
+    let alt;
+    try {
+      alt = el.getAttribute('alt');
+    } catch {
+      alt = null;
     }
-
-    if (applicableCount === 0) {
-        return {ruleId: rule.ruleId, outcome: 'notApplicable', severity: 'minor', occurrences: []};
+    if (alt === null) continue;
+    if (String(alt).trim() !== '') continue; // only alt=""
+
+    applicableCount += 1;
+
+    const eligInfo = getEligibilityInfo ? getEligibilityInfo(el, ctx, { targetSet: 'acc' }) : null;
+
+    const baseOccurrence = {
+      summary: 'Review whether <area> is decorative (alt="").',
+      hint: 'Confirm the area does not convey information or function. If it is interactive or meaningful, provide meaningful alt text.',
+      i18n: {
+        summaryKey: 'area_altDecorative_summary_cantTell',
+        hintKey: 'area_altDecorative_hint_cantTell',
+        params: { element: (el.tagName || '').toLowerCase() }
+      },
+      data: {
+        visibilityFilter: eligInfo || { targetSet: 'acc', accEligible: null, reasons: [] },
+        details: null
+      }
+    };
+
+    if (helpers && typeof helpers.reportOccurrence === 'function') {
+      occurrences.push(helpers.reportOccurrence(el, baseOccurrence));
+    } else {
+      occurrences.push({ selector: '', html: '', ...baseOccurrence });
     }
+  }
+
+  if (applicableCount === 0) {
+    return { ruleId: rule.ruleId, outcome: 'notApplicable', severity: 'minor', occurrences: [] };
+  }
 
-    return {ruleId: rule.ruleId, outcome: 'cantTell', severity: 'minor', occurrences};
+  return { ruleId: rule.ruleId, outcome: 'cantTell', severity: 'minor', occurrences };
 }
 
-module.exports = {id, meta, runInPage};
+module.exports = { id, meta, runInPage };