@surea11y/core 1.1.2 → 1.3.0

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

@@ -35,7 +35,8 @@ const id = 'landmark-no-duplicate-banner';
 
 const meta = {
   title: 'Page must not have more than one banner landmark',
-  description: 'Checks that at most one banner landmark (role="banner" or a non-nested <header>) exists on the page.',
+  description:
+    'Checks that at most one banner landmark (role="banner" or a non-nested <header>) exists on the page.',
   i18n: {
     titleKey: 'landmarkNoDuplicateBanner_title',
     descriptionKey: 'landmarkNoDuplicateBanner_description'
@@ -55,7 +56,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();
   }
 
   // Delegates to the shared helpers.getLandmarkNameInfo (aria-label -> aria-labelledby, via the
@@ -79,31 +82,52 @@ function runInPage(ctx) {
     return raw.split(/\s+/)[0].toLowerCase();
   }
 
-  const SECTIONING_ANCESTORS = new Set(['article', 'aside', 'main', 'nav', 'section']);
-
-  function isSuppressedBySectioningAncestor(el) {
-    let p = el.parentElement;
-    while (p) {
-      const tag = p.tagName ? p.tagName.toLowerCase() : '';
-      if (SECTIONING_ANCESTORS.has(tag)) return true;
-      p = p.parentElement;
-    }
-    return false;
+  // Delegates to the shared helpers.hasLandmarkScopingAncestor for the
+  // question "does this element sit inside a sectioning-content/<main>
+  // ancestor that suppresses its conditional implicit role" — 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)
+  // 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.
+  function hasSectioningAncestor(el, includeMain) {
+    return helpers && typeof helpers.hasLandmarkScopingAncestor === 'function'
+      ? helpers.hasLandmarkScopingAncestor(el, { includeMain })
+      : false;
   }
 
   function getImplicitLandmarkRole(el) {
     const tag = el.tagName ? el.tagName.toLowerCase() : '';
-    if (tag === 'header') return isSuppressedBySectioningAncestor(el) ? '' : 'banner';
-    if (tag === 'footer') return isSuppressedBySectioningAncestor(el) ? '' : 'contentinfo';
+    if (tag === 'header') return hasSectioningAncestor(el, true) ? '' : 'banner';
+    if (tag === 'footer') return hasSectioningAncestor(el, true) ? '' : 'contentinfo';
     if (tag === 'main') return 'main';
     if (tag === 'nav') return 'navigation';
-    if (tag === 'aside') return isSuppressedBySectioningAncestor(el) ? '' : 'complementary';
+    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.
+      if (!hasSectioningAncestor(el, false)) return 'complementary';
+      return getAccessibleLandmarkName(el) ? 'complementary' : '';
+    }
     if (tag === 'section') return getAccessibleLandmarkName(el) ? 'region' : '';
     if (tag === 'form') return getAccessibleLandmarkName(el) ? 'form' : '';
     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 '';
@@ -116,16 +140,18 @@ function runInPage(ctx) {
   // 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 = [];
+  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;
@@ -153,7 +179,7 @@ function runInPage(ctx) {
 
   const occurrences = banners.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,
@@ -171,7 +197,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-contentinfo-manual.js

@@ -27,7 +27,8 @@ 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,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();
   }
 
   // Delegates to the shared helpers.getLandmarkNameInfo (aria-label -> aria-labelledby, via the
@@ -71,31 +74,52 @@ function runInPage(ctx) {
     return raw.split(/\s+/)[0].toLowerCase();
   }
 
-  const SECTIONING_ANCESTORS = new Set(['article', 'aside', 'main', 'nav', 'section']);
-
-  function isSuppressedBySectioningAncestor(el) {
-    let p = el.parentElement;
-    while (p) {
-      const tag = p.tagName ? p.tagName.toLowerCase() : '';
-      if (SECTIONING_ANCESTORS.has(tag)) return true;
-      p = p.parentElement;
-    }
-    return false;
+  // Delegates to the shared helpers.hasLandmarkScopingAncestor for the
+  // question "does this element sit inside a sectioning-content/<main>
+  // ancestor that suppresses its conditional implicit role" — 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)
+  // 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.
+  function hasSectioningAncestor(el, includeMain) {
+    return helpers && typeof helpers.hasLandmarkScopingAncestor === 'function'
+      ? helpers.hasLandmarkScopingAncestor(el, { includeMain })
+      : false;
   }
 
   function getImplicitLandmarkRole(el) {
     const tag = el.tagName ? el.tagName.toLowerCase() : '';
-    if (tag === 'header') return isSuppressedBySectioningAncestor(el) ? '' : 'banner';
-    if (tag === 'footer') return isSuppressedBySectioningAncestor(el) ? '' : 'contentinfo';
+    if (tag === 'header') return hasSectioningAncestor(el, true) ? '' : 'banner';
+    if (tag === 'footer') return hasSectioningAncestor(el, true) ? '' : 'contentinfo';
     if (tag === 'main') return 'main';
     if (tag === 'nav') return 'navigation';
-    if (tag === 'aside') return isSuppressedBySectioningAncestor(el) ? '' : 'complementary';
+    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.
+      if (!hasSectioningAncestor(el, false)) return 'complementary';
+      return getAccessibleLandmarkName(el) ? 'complementary' : '';
+    }
     if (tag === 'section') return getAccessibleLandmarkName(el) ? 'region' : '';
     if (tag === 'form') return getAccessibleLandmarkName(el) ? 'form' : '';
     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 '';
@@ -108,16 +132,18 @@ function runInPage(ctx) {
   // 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 = [];
+  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;
@@ -145,7 +171,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,
@@ -163,7 +189,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

@@ -50,7 +50,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) {
@@ -71,16 +73,18 @@ function runInPage(ctx) {
   // 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 = [];
+  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 +112,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 +130,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

@@ -61,6 +61,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;
 
@@ -70,7 +78,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();
   }
@@ -83,7 +91,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;
@@ -100,11 +109,12 @@ function runInPage(ctx) {
   // 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 = [];
+  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 = [];
   }
@@ -125,27 +135,31 @@ 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' }
+        }
       }
-    }]
+    ]
   };
 }
 
-module.exports = { id, meta, runInPage };
+module.exports = { id, meta, runInPage, applicability };

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

@@ -31,7 +31,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,7 +52,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();
   }
 
   // Delegates to the shared helpers.getLandmarkNameInfo (aria-label -> aria-labelledby, via the
@@ -75,46 +78,48 @@ function runInPage(ctx) {
     return raw.split(/\s+/)[0].toLowerCase();
   }
 
-  // Two distinct ancestor sets, 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>" (that engine's getSectioningContentPlusMainSelector) to decide
-  // banner/contentinfo suppression, but <aside> uses PLAIN sectioning
-  // content only (article/aside/nav/section — NOT main) 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.
-  const SECTIONING_ANCESTORS_PLUS_MAIN = new Set(['article', 'aside', 'main', 'nav', 'section']);
-  const SECTIONING_ANCESTORS = new Set(['article', 'aside', 'nav', 'section']);
-
-  function hasSectioningAncestorFrom(el, set) {
-    let p = el.parentElement;
-    while (p) {
-      const tag = p.tagName ? p.tagName.toLowerCase() : '';
-      if (set.has(tag)) return true;
-      p = p.parentElement;
-    }
-    return false;
+  // 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>.
+  function hasSectioningAncestor(el, includeMain) {
+    return helpers && typeof helpers.hasLandmarkScopingAncestor === 'function'
+      ? helpers.hasLandmarkScopingAncestor(el, { includeMain })
+      : false;
   }
 
   function getImplicitLandmarkRole(el) {
     const tag = el.tagName ? el.tagName.toLowerCase() : '';
-    if (tag === 'header') return hasSectioningAncestorFrom(el, SECTIONING_ANCESTORS_PLUS_MAIN) ? '' : 'banner';
-    if (tag === 'footer') return hasSectioningAncestorFrom(el, SECTIONING_ANCESTORS_PLUS_MAIN) ? '' : 'contentinfo';
+    if (tag === 'header') return hasSectioningAncestor(el, true) ? '' : 'banner';
+    if (tag === 'footer') return hasSectioningAncestor(el, true) ? '' : 'contentinfo';
     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. Not yet evidenced by a real page in this corpus, but
-      // implemented to match the verified source exactly rather than
-      // leaving a known partial fix in place.
-      if (!hasSectioningAncestorFrom(el, SECTIONING_ANCESTORS)) return 'complementary';
+      // nested.
+      if (!hasSectioningAncestor(el, false)) return 'complementary';
       return getAccessibleLandmarkName(el) ? 'complementary' : '';
     }
     if (tag === 'section') return getAccessibleLandmarkName(el) ? 'region' : '';
@@ -122,7 +127,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 '';
@@ -150,7 +164,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;
@@ -170,11 +185,12 @@ function runInPage(ctx) {
   // 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 = [];
+  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 = [];
   }
@@ -219,24 +235,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
+            }
           }
         });
       }
@@ -246,7 +269,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 };