@surea11y/core 1.1.2 → 1.3.0

package/src/checks/manual/link-name-quality-manual.js

@@ -50,7 +50,13 @@ const meta = {
   tags: ['wcag2a', 'wcag244', 'navigation', 'quality', 'atomic', 'manual'],
   wcagSc: ['2.4.4'],
   normativeMappings: [
-    { standard: 'WCAG', version: '2.2', requirement: '2.4.4', title: 'Link Purpose (In Context)', conformanceLevel: 'A' }
+    {
+      standard: 'WCAG',
+      version: '2.2',
+      requirement: '2.4.4',
+      title: 'Link Purpose (In Context)',
+      conformanceLevel: 'A'
+    }
   ],
   defaultSeverity: 'minor',
   category: 'operable',
@@ -60,13 +66,28 @@ const meta = {
 };
 
 function runInPage(ctx) {
-  const { document, helpers, rule } = ctx;
+  const { helpers, rule } = ctx;
 
   const GENERIC_LINK_TEXT = new Set([
-    'click here', 'here', 'click', 'more', 'more info', 'more information',
-    'read more', 'learn more', 'continue reading', 'continue', 'details',
-    'more details', 'link', 'this link', 'go', 'download', 'view more',
-    'see more', 'info'
+    'click here',
+    'here',
+    'click',
+    'more',
+    'more info',
+    'more information',
+    'read more',
+    'learn more',
+    'continue reading',
+    'continue',
+    'details',
+    'more details',
+    'link',
+    'this link',
+    'go',
+    'download',
+    'view more',
+    'see more',
+    'info'
   ]);
 
   function normalize(s) {
@@ -79,7 +100,9 @@ function runInPage(ctx) {
   }
 
   const selector = 'a[href]';
-  const nodes = helpers.queryAllSmart ? helpers.queryAllSmart(selector) : helpers.queryAll(selector);
+  const nodes = helpers.queryAllSmart
+    ? helpers.queryAllSmart(selector)
+    : helpers.queryAll(selector);
 
   const occurrences = [];
   let applicableCount = 0;
@@ -88,11 +111,12 @@ function runInPage(ctx) {
     if (!el || !el.getAttribute) continue;
 
     const eligResult = helpers.isAccTreeEligible ? helpers.isAccTreeEligible(el, ctx) : true;
-    const eligible = typeof eligResult === 'boolean' ? eligResult : !!(eligResult && eligResult.eligible);
+    const eligible =
+      typeof eligResult === 'boolean' ? eligResult : !!(eligResult && eligResult.eligible);
     if (!eligible) continue;
 
     const nameInfo = helpers.getAccessibleNameInfo ? helpers.getAccessibleNameInfo(el, ctx) : null;
-    const programmaticName = (nameInfo && typeof nameInfo.value === 'string') ? nameInfo.value : '';
+    const programmaticName = nameInfo && typeof nameInfo.value === 'string' ? nameInfo.value : '';
 
     let rawName = programmaticName;
     if (!rawName.trim() && helpers.getContentNameInfo) {
@@ -108,8 +132,10 @@ function runInPage(ctx) {
     if (!GENERIC_LINK_TEXT.has(normalized)) continue;
 
     const stableSelector = helpers.buildSelector ? helpers.buildSelector(el) : 'html';
-    const html = helpers.getOuterHtmlSnippet ? helpers.getOuterHtmlSnippet(el) : (el.outerHTML || '');
-    const eligInfo = helpers.getEligibilityInfo ? helpers.getEligibilityInfo(el, ctx, { targetSet: 'acc' }) : null;
+    const html = helpers.getOuterHtmlSnippet ? helpers.getOuterHtmlSnippet(el) : el.outerHTML || '';
+    const eligInfo = helpers.getEligibilityInfo
+      ? helpers.getEligibilityInfo(el, ctx, { targetSet: 'acc' })
+      : null;
 
     occurrences.push({
       selector: stableSelector,
@@ -133,7 +159,12 @@ function runInPage(ctx) {
   }
 
   if (occurrences.length) {
-    return { ruleId: rule.ruleId, outcome: 'cantTell', severity: rule.defaultSeverity || 'minor', occurrences };
+    return {
+      ruleId: rule.ruleId,
+      outcome: 'cantTell',
+      severity: rule.defaultSeverity || 'minor',
+      occurrences
+    };
   }
 
   return { ruleId: rule.ruleId, outcome: 'notApplicable', severity: 'minor', occurrences: [] };

package/src/checks/manual/media-transcript-present-manual.js

@@ -99,20 +99,23 @@ function runInPage(ctx) {
   const __eligCache = new WeakMap();
 
   function getEligibility(node) {
-    if (!node || node.nodeType !== 1) return { eligible: true, reasons: [], targetSet: 'acc', accEligible: null };
+    if (!node || node.nodeType !== 1)
+      return { eligible: true, reasons: [], targetSet: 'acc', accEligible: null };
     const cached = __eligCache.get(node);
     if (cached) return cached;
 
-    let info = null;
+    let info;
     try {
-      info = (helpers && typeof helpers.getEligibilityInfo === 'function')
+      info =
+        helpers && typeof helpers.getEligibilityInfo === 'function'
           ? helpers.getEligibilityInfo(node, ctx, { targetSet: 'acc' })
           : null;
     } catch {
       info = null;
     }
 
-    const norm = (info && typeof info === 'object')
+    const norm =
+      info && typeof info === 'object'
         ? info
         : { eligible: true, reasons: [], targetSet: 'acc', accEligible: null };
 
@@ -125,10 +128,6 @@ function runInPage(ctx) {
     return !!(info && info.eligible);
   }
 
-  function safeSelector(node) {
-    return helpers.buildSelector ? helpers.buildSelector(node) : 'html';
-  }
-
   // Evidence object includes strength, so the rule can treat "unverified external link" as insufficient proof.
   function evidenceNone() {
     return {
@@ -173,7 +172,9 @@ function runInPage(ctx) {
       if (hasToken || len >= MIN_DESCRIBEDBY_CHARS_WITHOUT_TOKEN) {
         evidence.strength = 'strong';
         evidence.method = 'aria-describedby';
-        evidence.notes.push('media has aria-describedby with explicit or substantial transcript text');
+        evidence.notes.push(
+          'media has aria-describedby with explicit or substantial transcript text'
+        );
         return evidence;
       }
     }
@@ -197,7 +198,9 @@ function runInPage(ctx) {
               evidence.strength = 'strong';
               evidence.method = 'adjacent-heading';
               evidence.transcriptNodeSelector = nodeRef(h);
-              evidence.notes.push('found transcript heading with substantial visible adjacent text');
+              evidence.notes.push(
+                'found transcript heading with substantial visible adjacent text'
+              );
               return evidence;
             }
           }
@@ -215,7 +218,9 @@ function runInPage(ctx) {
       for (const a of links) {
         if (!isEligible(a)) continue;
 
-        const nameInfo = helpers.getAccessibleNameInfo ? helpers.getAccessibleNameInfo(a, ctx) : null;
+        const nameInfo = helpers.getAccessibleNameInfo
+          ? helpers.getAccessibleNameInfo(a, ctx)
+          : null;
         const linkName = nameInfo && nameInfo.value ? nameInfo.value : getNodeText(a);
         if (!containsTranscriptToken(linkName)) continue;
 
@@ -227,7 +232,9 @@ function runInPage(ctx) {
         if (href.startsWith('#')) {
           const targetId = href.slice(1);
           const target = targetId
-            ? (safeRoot.getElementById ? safeRoot.getElementById(targetId) : document.getElementById(targetId))
+            ? safeRoot.getElementById
+              ? safeRoot.getElementById(targetId)
+              : document.getElementById(targetId)
             : null;
 
           if (isElement(target) && isEligible(target)) {
@@ -246,7 +253,9 @@ function runInPage(ctx) {
             if (hasTranscriptHeading && textLen(targetText) >= MIN_TRANSCRIPT_CHARS) {
               evidence.strength = 'strong';
               evidence.method = 'anchor-target';
-              evidence.notes.push('resolved transcript link to an on-page section with transcript heading and substantial text');
+              evidence.notes.push(
+                'resolved transcript link to an on-page section with transcript heading and substantial text'
+              );
               return evidence;
             }
           }
@@ -254,7 +263,9 @@ function runInPage(ctx) {
           // If anchor cannot be verified, treat as weak (still better than nothing, but not proof).
           evidence.strength = 'weak';
           evidence.method = 'anchor-unverified';
-          evidence.notes.push('transcript link found but anchor target could not be verified as a transcript section');
+          evidence.notes.push(
+            'transcript link found but anchor target could not be verified as a transcript section'
+          );
           return evidence;
         }
 
@@ -300,9 +311,8 @@ function runInPage(ctx) {
     if (evidence.strength === 'none') {
       const baseOccurrence = {
         summary:
-            'A transcript or other text alternative for this time-based media is not strongly evidenced on the page.',
-        hint:
-            'Provide a clearly identified transcript or other text alternative for audio-only/video-only prerecorded media (for example, a “Transcript” section or link).',
+          'A transcript or other text alternative for this time-based media is not strongly evidenced on the page.',
+        hint: 'Provide a clearly identified transcript or other text alternative for audio-only/video-only prerecorded media (for example, a “Transcript” section or link).',
         i18n: {
           summaryKey: 'mediaTranscriptPresent_summary_cantTell_missing',
           hintKey: 'mediaTranscriptPresent_hint_cantTell_missing',
@@ -327,12 +337,10 @@ function runInPage(ctx) {
     }
 
     if (evidence.strength === 'weak') {
-
       const baseOccurrence = {
         summary:
-            'A transcript or other text alternative may be available for this time-based media, but it could not be verified from the page content.',
-        hint:
-            'Ensure a clearly identified transcript or other text alternative is available and programmatically or visibly associated with the media on the page.',
+          'A transcript or other text alternative may be available for this time-based media, but it could not be verified from the page content.',
+        hint: 'Ensure a clearly identified transcript or other text alternative is available and programmatically or visibly associated with the media on the page.',
         i18n: {
           summaryKey: 'mediaTranscriptPresent_summary_cantTell_unverified',
           hintKey: 'mediaTranscriptPresent_hint_cantTell_unverified',
@@ -361,7 +369,12 @@ function runInPage(ctx) {
   }
 
   if (occurrences.length) {
-    return { ruleId: rule.ruleId, outcome: 'cantTell', severity: rule.defaultSeverity || 'minor', occurrences };
+    return {
+      ruleId: rule.ruleId,
+      outcome: 'cantTell',
+      severity: rule.defaultSeverity || 'minor',
+      occurrences
+    };
   }
 
   // Manual rules may only emit cantTell/notApplicable (never pass/fail).

package/src/checks/manual/meta-viewport-large-manual.js

@@ -27,7 +27,8 @@ const id = 'meta-viewport-large';
 
 const meta = {
   title: 'Viewport meta tag should allow zooming up to 500%',
-  description: 'Checks that <meta name="viewport"> does not set user-scalable=no or maximum-scale below 5 (500%).',
+  description:
+    'Checks that <meta name="viewport"> does not set user-scalable=no or maximum-scale below 5 (500%).',
   i18n: {
     titleKey: 'metaViewportLarge_title',
     descriptionKey: 'metaViewportLarge_description'
@@ -43,6 +44,14 @@ const meta = {
   coverage: {}
 };
 
+// This check is inherently whole-document (does the PAGE have this
+// property?), not evaluable per-subtree -- notApplicable when contextSelector
+// scoped this run narrower than the whole document, or when
+// engineOptions.fragment:true was set (see helpers.isWholeDocumentScope).
+function applicability(ctx) {
+  return ctx.helpers.isWholeDocumentScope ? ctx.helpers.isWholeDocumentScope() : true;
+}
+
 function runInPage(ctx) {
   const { document, helpers, rule } = ctx;
 
@@ -52,13 +61,18 @@ function runInPage(ctx) {
       const eq = pair.indexOf('=');
       if (eq === -1) continue;
       const key = pair.slice(0, eq).trim().toLowerCase();
-      const value = pair.slice(eq + 1).trim().toLowerCase();
+      const value = pair
+        .slice(eq + 1)
+        .trim()
+        .toLowerCase();
       if (key) out[key] = value;
     }
     return out;
   }
 
-  const nodes = document.querySelectorAll ? document.querySelectorAll('meta[name="viewport" i]') : [];
+  const nodes = document.querySelectorAll
+    ? document.querySelectorAll('meta[name="viewport" i]')
+    : [];
 
   const occurrences = [];
   let applicableCount = 0;
@@ -89,7 +103,7 @@ function runInPage(ctx) {
     if (!reasons.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 || '';
 
     occurrences.push({
       selector: stableSelector,
@@ -111,9 +125,14 @@ function runInPage(ctx) {
     return { ruleId: rule.ruleId, outcome: 'notApplicable', severity: 'minor', occurrences: [] };
   }
   if (occurrences.length) {
-    return { ruleId: rule.ruleId, outcome: 'cantTell', severity: rule.defaultSeverity || 'minor', occurrences };
+    return {
+      ruleId: rule.ruleId,
+      outcome: 'cantTell',
+      severity: rule.defaultSeverity || 'minor',
+      occurrences
+    };
   }
   return { ruleId: rule.ruleId, outcome: 'notApplicable', severity: 'minor', occurrences: [] };
 }
 
-module.exports = { id, meta, runInPage };
+module.exports = { id, meta, runInPage, applicability };

package/src/checks/manual/mouse-only-event-handlers-manual.js

@@ -57,7 +57,13 @@ const meta = {
   tags: ['wcag2a', 'wcag211', 'structure', 'atomic', 'manual'],
   wcagSc: ['2.1.1'],
   normativeMappings: [
-    { standard: 'WCAG', version: '2.2', requirement: '2.1.1', title: 'Keyboard', conformanceLevel: 'A' }
+    {
+      standard: 'WCAG',
+      version: '2.2',
+      requirement: '2.1.1',
+      title: 'Keyboard',
+      conformanceLevel: 'A'
+    }
   ],
   defaultSeverity: 'moderate',
   category: 'operable',
@@ -67,18 +73,28 @@ const meta = {
 };
 
 function runInPage(ctx) {
-  const { document, helpers, rule } = ctx;
+  const { helpers, rule } = ctx;
 
   const MOUSE_ONLY_ATTRS = [
-    'onmouseover', 'onmouseout', 'onmousedown', 'onmouseup',
-    'ondblclick', 'onmousemove', 'onmouseenter', 'onmouseleave'
+    'onmouseover',
+    'onmouseout',
+    'onmousedown',
+    'onmouseup',
+    'ondblclick',
+    'onmousemove',
+    'onmouseenter',
+    'onmouseleave'
   ];
   const KEYBOARD_EQUIV_ATTRS = ['onkeydown', 'onkeyup', 'onkeypress', 'onfocus', 'onblur'];
 
-  function trim(v) { return (v == null ? '' : String(v)).trim(); }
+  function trim(v) {
+    return (v == null ? '' : String(v)).trim();
+  }
 
   const selector = MOUSE_ONLY_ATTRS.map((a) => `[${a}]`).join(', ');
-  const nodes = helpers.queryAllSmart ? helpers.queryAllSmart(selector) : helpers.queryAll(selector);
+  const nodes = helpers.queryAllSmart
+    ? helpers.queryAllSmart(selector)
+    : helpers.queryAll(selector);
 
   const occurrences = [];
   let applicableCount = 0;
@@ -90,7 +106,8 @@ function runInPage(ctx) {
     if (!presentMouseAttrs.length) continue;
 
     const eligResult = helpers.isAccTreeEligible ? helpers.isAccTreeEligible(el, ctx) : true;
-    const eligible = typeof eligResult === 'boolean' ? eligResult : !!(eligResult && eligResult.eligible);
+    const eligible =
+      typeof eligResult === 'boolean' ? eligResult : !!(eligResult && eligResult.eligible);
     if (!eligible) continue;
 
     applicableCount += 1;
@@ -99,8 +116,10 @@ function runInPage(ctx) {
     if (hasKeyboardEquiv) continue;
 
     const stableSelector = helpers.buildSelector ? helpers.buildSelector(el) : 'html';
-    const html = helpers.getOuterHtmlSnippet ? helpers.getOuterHtmlSnippet(el) : (el.outerHTML || '');
-    const eligInfo = helpers.getEligibilityInfo ? helpers.getEligibilityInfo(el, ctx, { targetSet: 'acc' }) : null;
+    const html = helpers.getOuterHtmlSnippet ? helpers.getOuterHtmlSnippet(el) : el.outerHTML || '';
+    const eligInfo = helpers.getEligibilityInfo
+      ? helpers.getEligibilityInfo(el, ctx, { targetSet: 'acc' })
+      : null;
 
     occurrences.push({
       selector: stableSelector,
@@ -113,7 +132,10 @@ function runInPage(ctx) {
         params: { attrs: presentMouseAttrs.join(', ') }
       },
       data: {
-        details: { reasonCode: 'MOUSE_ONLY_HANDLER_NO_KEYBOARD_EQUIVALENT', mouseAttrs: presentMouseAttrs },
+        details: {
+          reasonCode: 'MOUSE_ONLY_HANDLER_NO_KEYBOARD_EQUIVALENT',
+          mouseAttrs: presentMouseAttrs
+        },
         visibilityFilter: eligInfo || { targetSet: 'acc', accEligible: null, reasons: [] }
       }
     });
@@ -124,7 +146,12 @@ function runInPage(ctx) {
   }
 
   if (occurrences.length) {
-    return { ruleId: rule.ruleId, outcome: 'cantTell', severity: rule.defaultSeverity || 'moderate', occurrences };
+    return {
+      ruleId: rule.ruleId,
+      outcome: 'cantTell',
+      severity: rule.defaultSeverity || 'moderate',
+      occurrences
+    };
   }
 
   return { ruleId: rule.ruleId, outcome: 'notApplicable', severity: 'minor', occurrences: [] };

package/src/checks/manual/no-autoplay-audio-manual.js

@@ -48,7 +48,13 @@ const meta = {
   tags: ['wcag2a', 'wcag142', 'media', 'atomic', 'manual'],
   wcagSc: ['1.4.2'],
   normativeMappings: [
-    { standard: 'WCAG', version: '2.2', requirement: '1.4.2', title: 'Audio Control', conformanceLevel: 'A' }
+    {
+      standard: 'WCAG',
+      version: '2.2',
+      requirement: '1.4.2',
+      title: 'Audio Control',
+      conformanceLevel: 'A'
+    }
   ],
   defaultSeverity: 'moderate',
   category: 'perceivable',
@@ -58,9 +64,11 @@ const meta = {
 };
 
 function runInPage(ctx) {
-  const { document, helpers, rule } = ctx;
+  const { helpers, rule } = ctx;
 
-  const nodes = helpers.queryAllSmart ? helpers.queryAllSmart('audio[autoplay], video[autoplay]') : helpers.queryAll('audio[autoplay], video[autoplay]');
+  const nodes = helpers.queryAllSmart
+    ? helpers.queryAllSmart('audio[autoplay], video[autoplay]')
+    : helpers.queryAll('audio[autoplay], video[autoplay]');
 
   const occurrences = [];
   let applicableCount = 0;
@@ -75,12 +83,13 @@ function runInPage(ctx) {
 
     const mediaTag = (el.tagName || '').toLowerCase();
     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 baseOccurrence = {
       selector: stableSelector,
       html,
-      summary: 'This element autoplays audio without a native pause/stop or volume-control mechanism.',
+      summary:
+        'This element autoplays audio without a native pause/stop or volume-control mechanism.',
       hint: 'If this clip plays for more than 3 seconds, add a `controls` attribute (or an equivalent custom mechanism) so users can pause/stop it or control its volume independently of the system volume.',
       i18n: {
         summaryKey: 'noAutoplayAudio_summary_cantTell',
@@ -104,7 +113,12 @@ function runInPage(ctx) {
   }
 
   if (occurrences.length) {
-    return { ruleId: rule.ruleId, outcome: 'cantTell', severity: rule.defaultSeverity || 'moderate', occurrences };
+    return {
+      ruleId: rule.ruleId,
+      outcome: 'cantTell',
+      severity: rule.defaultSeverity || 'moderate',
+      occurrences
+    };
   }
 
   // Manual rules may only emit cantTell/notApplicable (never pass/fail):