@surea11y/core 1.2.0 → 1.4.0

package/src/checks/manual/landmark-no-duplicate-contentinfo-manual.js

@@ -1,10 +1,12 @@
+/* SPDX-License-Identifier: MPL-2.0 */
+
 'use strict';
 
 /**
  * @check landmark-no-duplicate-contentinfo
  * @atomic true
  * @summary A page must not have more than one contentinfo landmark
- * @standard Best Practices (a widely-used reference engine's classification; no formal WCAG Success Criterion — see ROADMAP.md Tier 1b)
+ * @standard Best Practices (no formal WCAG Success Criterion — see ROADMAP.md Tier 1b)
  * @applicability
  *   Applies whenever the page contains at least one contentinfo landmark
  *   (explicit role="contentinfo", or an implicit, non-nested <footer>).
@@ -16,18 +18,16 @@
  *   `type: 'manual'` rule; see landmark-banner-is-top-level's
  *   header comment for the shared rationale/precedent.
  * - Only landmarks actually exposed to assistive technology can collide —
- *   matches a widely-used reference engine's own `page-no-duplicate` check (confirmed by reading
- *   its source directly: `query_selector_all_filter_default(..., elm =>
- *   _isVisibleToScreenReaders(elm))`) — same fix applied to the sibling
- *   banner/main rules after finding real hidden-duplicate false positives
- *   on Trello and Zoom.
+ *   same as the sibling banner/main rules, avoiding hidden-duplicate false
+ *   positives.
  */
 
 const id = 'landmark-no-duplicate-contentinfo';
 
 const meta = {
   title: 'Page must not have more than one contentinfo landmark',
-  description: 'Checks that at most one contentinfo landmark (role="contentinfo" or a non-nested <footer>) exists on the page.',
+  description:
+    'Checks that at most one contentinfo landmark (role="contentinfo" or a non-nested <footer>) exists on the page.',
   i18n: {
     titleKey: 'landmarkNoDuplicateContentinfo_title',
     descriptionKey: 'landmarkNoDuplicateContentinfo_description'
@@ -47,14 +47,15 @@ function runInPage(ctx) {
   const { document, helpers, rule } = ctx;
 
   function normalizeWs(s) {
-    return String(s || '').replace(/\s+/g, ' ').trim();
+    return String(s || '')
+      .replace(/\s+/g, ' ')
+      .trim();
   }
 
   // Delegates to the shared helpers.getLandmarkNameInfo (aria-label -> aria-labelledby, via the
   // target's own accessible name, not raw textContent -> title attribute fallback) rather than a
-  // local copy -- see that function's header comment in src/core/dom-helpers.js for the real bug
-  // (missing title fallback) this replaced across all 7 landmark rule files that had their own
-  // copy of this logic.
+  // local copy -- see that function's header comment in src/core/dom-helpers.js. Sharing it keeps
+  // the title-attribute fallback consistent across the landmark rules.
   function getAccessibleLandmarkName(el) {
     try {
       if (helpers && typeof helpers.getLandmarkNameInfo === 'function') {
@@ -77,10 +78,8 @@ function runInPage(ctx) {
   // (an ancestor's bare TAG only counts when it carries no role attribute
   // at all; an explicit role="dialog"-style override no longer suppresses)
   // rather than a local tag-only copy. See that function's header comment
-  // in src/core/aria-helpers.js for the full algorithm and the real page
-  // (handsontable.com's docs-assistant side panel, an
-  // <aside role="dialog"> containing its own <header>) that surfaced this
-  // rule's own former tag-only copy as a false negative.
+  // in src/core/aria-helpers.js for the full algorithm. Example: an
+  // <aside role="dialog"> containing its own <header>.
   function hasSectioningAncestor(el, includeMain) {
     return helpers && typeof helpers.hasLandmarkScopingAncestor === 'function'
       ? helpers.hasLandmarkScopingAncestor(el, { includeMain })
@@ -94,11 +93,9 @@ function runInPage(ctx) {
     if (tag === 'main') return 'main';
     if (tag === 'nav') return 'navigation';
     if (tag === 'aside') {
-      // A named <aside> is never suppressed, even when nested — matches
-      // landmark-unique's own verified-against-reference-engine precedent
-      // (that engine's real `aside` implicit-role function keeps
-      // "complementary" when the element has an accessible name, even
-      // inside sectioning content); propagated here for consistency.
+      // A named <aside> is never suppressed, even when nested — it keeps
+      // "complementary" when it has an accessible name, even inside
+      // sectioning content. Matches landmark-unique's precedent.
       if (!hasSectioningAncestor(el, false)) return 'complementary';
       return getAccessibleLandmarkName(el) ? 'complementary' : '';
     }
@@ -107,7 +104,16 @@ function runInPage(ctx) {
     return '';
   }
 
-  const LANDMARK_ROLES = new Set(['banner', 'contentinfo', 'main', 'navigation', 'complementary', 'region', 'form', 'search']);
+  const LANDMARK_ROLES = new Set([
+    'banner',
+    'contentinfo',
+    'main',
+    'navigation',
+    'complementary',
+    'region',
+    'form',
+    'search'
+  ]);
 
   function getLandmarkRole(el) {
     if (!el || !el.getAttribute) return '';
@@ -117,19 +123,20 @@ function runInPage(ctx) {
   }
 
   // queryAllSmart (shadow-DOM-aware) instead of plain document.querySelectorAll -- see
-  // landmark-unique-manual.js's header comment for the real page (Airtable, 2026-07-23)
-  // that surfaced this gap: a third-party shadow-DOM-hosted widget's own landmark is
-  // invisible to a light-DOM-only query.
-  let nodes = [];
+  // landmark-unique-manual.js's header comment. A third-party shadow-DOM-hosted
+  // widget's own landmark is invisible to a light-DOM-only query.
+  let nodes;
   try {
-    nodes = helpers && typeof helpers.queryAllSmart === 'function'
-      ? helpers.queryAllSmart('header, footer, main, nav, aside, section, form, [role]')
-      : document.querySelectorAll('header, footer, main, nav, aside, section, form, [role]');
+    nodes =
+      helpers && typeof helpers.queryAllSmart === 'function'
+        ? helpers.queryAllSmart('header, footer, main, nav, aside, section, form, [role]')
+        : document.querySelectorAll('header, footer, main, nav, aside, section, form, [role]');
   } catch {
     nodes = [];
   }
 
-  const isAccTreeEligible = helpers && typeof helpers.isAccTreeEligible === 'function' ? helpers.isAccTreeEligible : null;
+  const isAccTreeEligible =
+    helpers && typeof helpers.isAccTreeEligible === 'function' ? helpers.isAccTreeEligible : null;
 
   function isExposedToAt(el) {
     if (!isAccTreeEligible) return true;
@@ -157,7 +164,7 @@ function runInPage(ctx) {
 
   const occurrences = contentinfos.map((el) => {
     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 || '';
 
     return {
       selector: stableSelector,
@@ -175,7 +182,12 @@ function runInPage(ctx) {
     };
   });
 
-  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/landmark-no-duplicate-main-manual.js

@@ -1,29 +1,27 @@
+/* SPDX-License-Identifier: MPL-2.0 */
+
 'use strict';
 
 /**
  * @check landmark-no-duplicate-main
  * @atomic true
  * @summary A page must not have more than one main landmark
- * @standard Best Practices (a widely-used reference engine's classification; no formal WCAG Success Criterion — see ROADMAP.md Tier 1b)
+ * @standard Best Practices (no formal WCAG Success Criterion — see ROADMAP.md Tier 1b)
  * @applicability
  *   Applies whenever the page contains at least one main landmark
  *   (explicit role="main", or an implicit <main>).
  * @expectation
  *   At most one main landmark exists on the page. Distinct, atomic
  *   decision from landmark-one-main (that rule flags zero
- *   mains too; this one only flags more than one) — matches a widely-used
- *   reference engine shipping both as separate rules with some overlap by design.
+ *   mains too; this one only flags more than one).
  * @implementation-notes
  * - Not WCAG-normative — authored as an advisory, cantTell-capped
  *   `type: 'manual'` rule; see landmark-banner-is-top-level's
  *   header comment for the shared rationale/precedent.
- * - Only landmarks actually exposed to assistive technology can collide —
- *   matches a widely-used reference engine's own `page-no-duplicate` check (confirmed by reading
- *   its source directly: `query_selector_all_filter_default(..., elm =>
- *   _isVisibleToScreenReaders(elm))`). Without this, a responsive layout
- *   rendering both a visible and a CSS-hidden duplicate `<main>` (found on
- *   a real site — Zoom's homepage) was wrongly flagged as a duplicate
- *   landmark; the hidden copy is never actually reachable by AT.
+ * - Only landmarks actually exposed to assistive technology can collide.
+ *   Without this, a responsive layout rendering both a visible and a
+ *   CSS-hidden duplicate `<main>` is flagged as a duplicate landmark even
+ *   though the hidden copy is never reachable by AT.
  */
 
 const id = 'landmark-no-duplicate-main';
@@ -50,7 +48,9 @@ function runInPage(ctx) {
   const { document, helpers, rule } = ctx;
 
   function normalizeWs(s) {
-    return String(s || '').replace(/\s+/g, ' ').trim();
+    return String(s || '')
+      .replace(/\s+/g, ' ')
+      .trim();
   }
 
   function getExplicitRoleToken(el) {
@@ -68,19 +68,20 @@ function runInPage(ctx) {
   }
 
   // queryAllSmart (shadow-DOM-aware) instead of plain document.querySelectorAll -- see
-  // landmark-unique-manual.js's header comment for the real page (Airtable, 2026-07-23)
-  // that surfaced this gap: a third-party shadow-DOM-hosted widget's own landmark is
-  // invisible to a light-DOM-only query.
-  let nodes = [];
+  // landmark-unique-manual.js's header comment. A third-party shadow-DOM-hosted
+  // widget's own landmark is invisible to a light-DOM-only query.
+  let nodes;
   try {
-    nodes = helpers && typeof helpers.queryAllSmart === 'function'
-      ? helpers.queryAllSmart('main, [role]')
-      : document.querySelectorAll('main, [role]');
+    nodes =
+      helpers && typeof helpers.queryAllSmart === 'function'
+        ? helpers.queryAllSmart('main, [role]')
+        : document.querySelectorAll('main, [role]');
   } catch {
     nodes = [];
   }
 
-  const isAccTreeEligible = helpers && typeof helpers.isAccTreeEligible === 'function' ? helpers.isAccTreeEligible : null;
+  const isAccTreeEligible =
+    helpers && typeof helpers.isAccTreeEligible === 'function' ? helpers.isAccTreeEligible : null;
 
   function isExposedToAt(el) {
     if (!isAccTreeEligible) return true;
@@ -108,7 +109,7 @@ function runInPage(ctx) {
 
   const occurrences = mains.map((el) => {
     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 || '';
 
     return {
       selector: stableSelector,
@@ -126,7 +127,12 @@ function runInPage(ctx) {
     };
   });
 
-  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/landmark-one-main-manual.js

@@ -1,10 +1,12 @@
+/* SPDX-License-Identifier: MPL-2.0 */
+
 'use strict';
 
 /**
  * @check landmark-one-main
  * @atomic true
  * @summary The page should have a main landmark
- * @standard Best Practices (a widely-used reference engine's classification; no formal WCAG Success Criterion — see ROADMAP.md Tier 1b)
+ * @standard Best Practices (no formal WCAG Success Criterion — see ROADMAP.md Tier 1b)
  * @applicability
  *   Always applicable to any HTML document with a <body> element —
  *   "does the page have a main landmark" is a whole-page concern,
@@ -18,27 +20,15 @@
  * - Not WCAG-normative — authored as an advisory, cantTell-capped
  *   `type: 'manual'` rule; see landmark-banner-is-top-level's
  *   header comment for the shared rationale/precedent.
- * - Presence-only, matching a widely-used reference engine's real
- *   `landmark-one-main` scope exactly (confirmed 2026-07-22 by reading that
- *   engine's source directly: its `page-has-main` check is a plain
- *   descendant-exists test, `has-descendant-evaluate` — it does NOT flag
- *   more than one). This rule previously ALSO flagged "more than one main,"
- *   which was both a real scope mismatch against that reference engine (it
- *   ships that as a fully separate rule, `landmark-no-duplicate-main` /
- *   `page-no-duplicate-main`, already correctly implemented here as
- *   `landmark-no-duplicate-main`) and missing that sibling rule's
- *   accessibility-tree visibility filter, so it double-flagged cases the
- *   sibling rule already handles correctly — found via a real page
- *   (2026-07-22, live-DOM corpus): Resy's and DuckDuckGo's homepages each
- *   genuinely have two visible `<main>` elements, which that reference
- *   engine's `landmark-one-main` doesn't flag at all (out of its scope) but
- *   this rule wrongly did, disagreeing with it for a
- *   reason that wasn't a real coverage gap on either side — just a
- *   redundant, incorrectly-scoped extra branch here.
+ * - Presence-only: a plain descendant-exists test. It does NOT flag more
+ *   than one main. "More than one main" is a separate rule,
+ *   `landmark-no-duplicate-main`, already implemented — deliberately not
+ *   duplicated here, since a page can genuinely have two visible `<main>`
+ *   elements, which is out of scope for "does a main landmark exist," not
+ *   a violation this rule should report.
  * - Filters candidates through `isAccTreeEligible` (hidden/aria-hidden/
  *   display:none/inert elements don't count as "a main landmark exists"),
- *   matching `landmark-no-duplicate-main`'s own precedent and
- *   that reference engine's own accessibility-tree-scoped matching.
+ *   matching `landmark-no-duplicate-main`'s own precedent.
  */
 
 const id = 'landmark-one-main';
@@ -78,7 +68,7 @@ function runInPage(ctx) {
   }
 
   function getExplicitRoleToken(el) {
-    const raw = (el.getAttribute && el.getAttribute('role') || '').trim();
+    const raw = ((el.getAttribute && el.getAttribute('role')) || '').trim();
     if (!raw) return '';
     return raw.split(/\s+/)[0].toLowerCase();
   }
@@ -91,7 +81,8 @@ function runInPage(ctx) {
     return tag === 'main';
   }
 
-  const isAccTreeEligible = helpers && typeof helpers.isAccTreeEligible === 'function' ? helpers.isAccTreeEligible : null;
+  const isAccTreeEligible =
+    helpers && typeof helpers.isAccTreeEligible === 'function' ? helpers.isAccTreeEligible : null;
 
   function isExposedToAt(el) {
     if (!isAccTreeEligible) return true;
@@ -105,14 +96,14 @@ function runInPage(ctx) {
   }
 
   // queryAllSmart (shadow-DOM-aware) instead of plain document.querySelectorAll -- see
-  // landmark-unique-manual.js's header comment for the real page (Airtable, 2026-07-23)
-  // that surfaced this gap: a third-party shadow-DOM-hosted widget's own landmark is
-  // invisible to a light-DOM-only query.
-  let nodes = [];
+  // landmark-unique-manual.js's header comment. A third-party shadow-DOM-hosted
+  // widget's own landmark is invisible to a light-DOM-only query.
+  let nodes;
   try {
-    nodes = helpers && typeof helpers.queryAllSmart === 'function'
-      ? helpers.queryAllSmart('main, [role]')
-      : document.querySelectorAll('main, [role]');
+    nodes =
+      helpers && typeof helpers.queryAllSmart === 'function'
+        ? helpers.queryAllSmart('main, [role]')
+        : document.querySelectorAll('main, [role]');
   } catch {
     nodes = [];
   }
@@ -133,26 +124,30 @@ function runInPage(ctx) {
   }
 
   const stableSelector = helpers.buildSelector ? helpers.buildSelector(body) : 'body';
-  const html = helpers.getOuterHtmlSnippet ? helpers.getOuterHtmlSnippet(body) : (body.outerHTML || '').slice(0, 200);
+  const html = helpers.getOuterHtmlSnippet
+    ? helpers.getOuterHtmlSnippet(body)
+    : (body.outerHTML || '').slice(0, 200);
 
   return {
     ruleId: rule.ruleId,
     outcome: 'cantTell',
     severity: rule.defaultSeverity || 'minor',
-    occurrences: [{
-      selector: stableSelector,
-      html,
-      summary: 'This page has no main landmark.',
-      hint: 'Add a main landmark (<main> or role="main") around the page\'s primary content.',
-      i18n: {
-        summaryKey: 'landmarkOneMain_summary_cantTell_missing',
-        hintKey: 'landmarkOneMain_hint_cantTell_missing',
-        params: {}
-      },
-      data: {
-        details: { reasonCode: 'LANDMARK_MAIN_MISSING' }
+    occurrences: [
+      {
+        selector: stableSelector,
+        html,
+        summary: 'This page has no main landmark.',
+        hint: 'Add a main landmark (<main> or role="main") around the page\'s primary content.',
+        i18n: {
+          summaryKey: 'landmarkOneMain_summary_cantTell_missing',
+          hintKey: 'landmarkOneMain_hint_cantTell_missing',
+          params: {}
+        },
+        data: {
+          details: { reasonCode: 'LANDMARK_MAIN_MISSING' }
+        }
       }
-    }]
+    ]
   };
 }
 

package/src/checks/manual/landmark-unique-manual.js

@@ -1,10 +1,12 @@
+/* SPDX-License-Identifier: MPL-2.0 */
+
 'use strict';
 
 /**
  * @check landmark-unique
  * @atomic true
  * @summary Landmarks sharing the same role must have unique accessible names
- * @standard Best Practices (a widely-used reference engine's classification; no formal WCAG Success Criterion — see ROADMAP.md Tier 1b)
+ * @standard Best Practices (no formal WCAG Success Criterion — see ROADMAP.md Tier 1b)
  * @applicability
  *   Applies whenever two or more landmark regions on the page share the
  *   same landmark role (banner, contentinfo, main, navigation,
@@ -31,7 +33,8 @@ const id = 'landmark-unique';
 
 const meta = {
   title: 'Landmarks with the same role must have unique names',
-  description: 'Checks that when two or more landmarks share the same role, each has a distinct accessible name.',
+  description:
+    'Checks that when two or more landmarks share the same role, each has a distinct accessible name.',
   i18n: {
     titleKey: 'landmarkUnique_title',
     descriptionKey: 'landmarkUnique_description'
@@ -51,14 +54,14 @@ function runInPage(ctx) {
   const { document, helpers, rule } = ctx;
 
   function normalizeWs(s) {
-    return String(s || '').replace(/\s+/g, ' ').trim();
+    return String(s || '')
+      .replace(/\s+/g, ' ')
+      .trim();
   }
 
   // Delegates to the shared helpers.getLandmarkNameInfo (aria-label -> aria-labelledby, via the
   // target's own accessible name, not raw textContent -> title attribute fallback) rather than a
-  // local copy -- see that function's header comment in src/core/dom-helpers.js for the real bug
-  // (missing title fallback) this replaced across all 7 landmark rule files that had their own
-  // copy of this logic.
+  // local copy -- see that function's header comment in src/core/dom-helpers.js.
   function getAccessibleLandmarkName(el) {
     try {
       if (helpers && typeof helpers.getLandmarkNameInfo === 'function') {
@@ -78,27 +81,21 @@ function runInPage(ctx) {
   // Delegates to the shared helpers.hasLandmarkScopingAncestor (role-aware:
   // an ancestor's bare TAG only counts when it carries no role attribute at
   // all; an explicit role="dialog"-style override no longer suppresses —
-  // see that function's header comment in src/core/aria-helpers.js) rather
-  // than the two local tag-only Sets this file used to carry. Two distinct
-  // ancestor scopes, verified 2026-07-20 against a widely-used reference
-  // engine's own implicit-role functions directly rather than assumed from
-  // one shared list: <header>/<footer> use "sectioning content PLUS <main>"
-  // (includeMain: true) to decide banner/contentinfo suppression, but
-  // <aside> uses PLAIN sectioning content only — NOT main (includeMain:
-  // false) — to decide complementary suppression. The old single
-  // SECTIONING_ANCESTORS set (which included 'main') was correct for
-  // header/footer but wrong for aside — found via a real page: Know Your
-  // Meme's two unnamed <aside class="extra-large-only"> elements are direct
-  // children of <main>, which incorrectly suppressed their implicit
-  // "complementary" role entirely, hiding a real duplicate-landmark
-  // violation that reference engine correctly flags. The tag-only
-  // (non-role-aware) half of this bug was separately found and fixed
-  // 2026-07-30 via the cross-engine comparisons project, on
-  // handsontable.com's docs-assistant side panel: an <aside role="dialog">
-  // containing its own <header> — role="dialog" isn't one of the four
-  // scoping roles, so the nested <header> keeps "banner" per spec, but a
-  // tag-only check unconditionally suppressed it just because the ancestor
-  // TAG was <aside>.
+  // see that function's header comment in src/core/aria-helpers.js), using
+  // two distinct ancestor scopes rather than one shared list: <header>/
+  // <footer> use "sectioning content PLUS <main>" (includeMain: true) to
+  // decide banner/contentinfo suppression, but <aside> uses PLAIN
+  // sectioning content only — NOT main (includeMain: false) — to decide
+  // complementary suppression. A single shared sectioning-ancestors set
+  // that includes 'main' is correct for header/footer but wrong for aside:
+  // e.g. two unnamed <aside> elements that are direct children of <main>
+  // would have their implicit "complementary" role incorrectly suppressed,
+  // hiding a real duplicate-landmark violation. The role-aware half matters
+  // too: e.g. an <aside role="dialog"> containing its own <header> —
+  // role="dialog" isn't one of the four scoping roles, so the nested
+  // <header> keeps "banner" per spec, but a tag-only (non-role-aware)
+  // check would unconditionally suppress it just because the ancestor TAG
+  // was <aside>.
   function hasSectioningAncestor(el, includeMain) {
     return helpers && typeof helpers.hasLandmarkScopingAncestor === 'function'
       ? helpers.hasLandmarkScopingAncestor(el, { includeMain })
@@ -112,10 +109,9 @@ function runInPage(ctx) {
     if (tag === 'main') return 'main';
     if (tag === 'nav') return 'navigation';
     if (tag === 'aside') {
-      // Per a widely-used reference engine's own `aside` implicit-role function: suppressed by a
-      // sectioning-content ancestor ONLY when the <aside> also has no
-      // accessible name — a named <aside> is never suppressed, even when
-      // nested.
+      // An <aside> is suppressed by a sectioning-content ancestor ONLY
+      // when it also has no accessible name — a named <aside> is never
+      // suppressed, even when nested.
       if (!hasSectioningAncestor(el, false)) return 'complementary';
       return getAccessibleLandmarkName(el) ? 'complementary' : '';
     }
@@ -124,7 +120,16 @@ function runInPage(ctx) {
     return '';
   }
 
-  const LANDMARK_ROLES = new Set(['banner', 'contentinfo', 'main', 'navigation', 'complementary', 'region', 'form', 'search']);
+  const LANDMARK_ROLES = new Set([
+    'banner',
+    'contentinfo',
+    'main',
+    'navigation',
+    'complementary',
+    'region',
+    'form',
+    'search'
+  ]);
 
   function getLandmarkRole(el) {
     if (!el || !el.getAttribute) return '';
@@ -134,15 +139,12 @@ function runInPage(ctx) {
       // <form>/<section> only count as landmarks when they have an
       // accessible name — a property of the ELEMENT, not of how the role
       // got there. This applies whether the role is implicit (already
-      // handled in getImplicitLandmarkRole below) or explicit, but an
-      // explicit role bypassed the check entirely before this fix. Verified
-      // against a widely-used reference engine's isLandmarkVirtual (checks
-      // nodeName === 'section' || 'form' unconditionally, regardless of role source) and the W3C
+      // handled in getImplicitLandmarkRole below) or explicit. Per the W3C
       // ARIA-in-HTML spec ("a form is not exposed as a landmark region
-      // unless it has been provided an accessible name"). Found via a real
-      // page: europa.eu's unnamed <form role="search"> nested inside an
-      // unnamed <div role="search"> was wrongly counted as a second
-      // distinct "search" landmark.
+      // unless it has been provided an accessible name"). Otherwise an
+      // unnamed <form role="search"> nested inside an unnamed
+      // <div role="search"> gets wrongly counted as a second distinct
+      // "search" landmark.
       const tag = el.tagName ? el.tagName.toLowerCase() : '';
       if (tag === 'form' || tag === 'section') {
         return getAccessibleLandmarkName(el) ? explicit : '';
@@ -152,7 +154,8 @@ function runInPage(ctx) {
     return getImplicitLandmarkRole(el);
   }
 
-  const isAccTreeEligible = helpers && typeof helpers.isAccTreeEligible === 'function' ? helpers.isAccTreeEligible : null;
+  const isAccTreeEligible =
+    helpers && typeof helpers.isAccTreeEligible === 'function' ? helpers.isAccTreeEligible : null;
 
   function isExposedToAt(el) {
     if (!isAccTreeEligible) return true;
@@ -166,30 +169,26 @@ function runInPage(ctx) {
   }
 
   // queryAllSmart (shadow-DOM-aware, includeShadowDom defaults true) instead of a plain
-  // document.querySelectorAll -- a real page (Airtable's homepage, 2026-07-23) has a
-  // third-party Transcend cookie-consent widget rendering its own unnamed <nav>/<footer>
-  // inside a shadow root (#transcend-shadow-root), which a widely-used reference engine's
-  // own landmark-unique (a real browser DOM, shadow roots included by design) correctly sees as colliding
-  // with the page's own unnamed header <nav>/page <footer> -- a real, confirmed surea11y
-  // false-negative miss, invisible to plain querySelectorAll's light-DOM-only reach.
-  let nodes = [];
+  // document.querySelectorAll -- a third-party widget rendering its own
+  // unnamed <nav>/<footer> inside a shadow root collides with the page's
+  // own unnamed header <nav>/page <footer>, but is invisible to plain
+  // querySelectorAll's light-DOM-only reach.
+  let nodes;
   try {
-    nodes = helpers && typeof helpers.queryAllSmart === 'function'
-      ? helpers.queryAllSmart('header, footer, main, nav, aside, section, form, [role]')
-      : document.querySelectorAll('header, footer, main, nav, aside, section, form, [role]');
+    nodes =
+      helpers && typeof helpers.queryAllSmart === 'function'
+        ? helpers.queryAllSmart('header, footer, main, nav, aside, section, form, [role]')
+        : document.querySelectorAll('header, footer, main, nav, aside, section, form, [role]');
   } catch {
     nodes = [];
   }
 
-  // Only landmarks actually exposed to assistive technology can collide —
-  // matches a widely-used reference engine's own `landmarkUniqueMatches` gate
-  // (`_isVisibleToScreenReaders`), confirmed by reading its source
-  // directly. Without this, responsive layouts that render both a
-  // desktop and a mobile copy of the same named nav (one hidden via CSS
-  // at any given viewport — found on real sites: BuzzFeed, Kraken,
-  // weather.com) were wrongly flagged as duplicate landmarks, since the
-  // hidden copy is never actually reachable by AT and can't really
-  // collide with the visible one.
+  // Only landmarks actually exposed to assistive technology can collide.
+  // Without this, responsive layouts that render both a desktop and a
+  // mobile copy of the same named nav (one hidden via CSS at any given
+  // viewport) are wrongly flagged as duplicate landmarks, since the hidden
+  // copy is never reachable by AT and can't really collide with the
+  // visible one.
   const byRole = new Map(); // role -> [{el, name}]
   const seen = new Set();
   for (const el of nodes) {
@@ -221,24 +220,31 @@ function runInPage(ctx) {
 
       for (const { el } of group) {
         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: normalizedName
-              ? `This ${role} landmark shares its accessible name with another ${role} landmark.`
-              : `This ${role} landmark has no accessible name, and more than one unnamed ${role} landmark exists on this page.`,
+            ? `This ${role} landmark shares its accessible name with another ${role} landmark.`
+            : `This ${role} landmark has no accessible name, and more than one unnamed ${role} landmark exists on this page.`,
           hint: `Give each ${role} landmark a distinct name via aria-label or aria-labelledby.`,
           i18n: {
             summaryKey: normalizedName
-                ? 'landmarkUnique_summary_cantTell_duplicateName'
-                : 'landmarkUnique_summary_cantTell_bothUnnamed',
+              ? 'landmarkUnique_summary_cantTell_duplicateName'
+              : 'landmarkUnique_summary_cantTell_bothUnnamed',
             hintKey: 'landmarkUnique_hint_cantTell',
             params: { role }
           },
           data: {
-            details: { reasonCode: 'LANDMARK_NOT_UNIQUE', role, name: normalizedName, groupSize: group.length }
+            details: {
+              reasonCode: 'LANDMARK_NOT_UNIQUE',
+              role,
+              name: normalizedName,
+              groupSize: group.length
+            }
           }
         });
       }
@@ -248,7 +254,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 };