@surea11y/core 1.1.0 → 1.1.2

package/src/core/dom-runner.js

@@ -48,6 +48,9 @@ function runCore(pageUrl, contextSelector, engineOptions, runOnly, CHECK_DEFS, R
 
     // Default on: opt OUT with `includeShadowDom: false`, not opt in.
     const includeShadowDom = !(engineOptionsResolved && engineOptionsResolved.includeShadowDom === false);
+    // Default off: hidden/collapsed content is excluded from rule evaluation
+    // unless the caller explicitly opts in.
+    const includeHiddenElements = !!(engineOptionsResolved && engineOptionsResolved.includeHiddenElements === true);
     const excludeSelectors = normalizeSelectorList(engineOptionsResolved && engineOptionsResolved.excludeSelectors);
 
     const url = pageUrl || (document.location && document.location.href) || null;
@@ -58,11 +61,27 @@ function runCore(pageUrl, contextSelector, engineOptions, runOnly, CHECK_DEFS, R
             ? engineOptionsResolved.timestamp.trim()
             : null;
 
+    // createDomHelpers()/createContrastHelpers() persist their element-keyed
+    // caches (outerHtmlCache, selectorCache, etc.) on window.__a11ycoreSharedCache
+    // so multiple helper instances created *within this run* can share them
+    // deterministically. But a window/document is frequently reused across
+    // SEPARATE runs -- e.g. Jest's jsdom environment creates one window per
+    // test file, and mutating document.body between it() blocks is standard.
+    // Those caches are keyed by element reference, not content, so a run that
+    // reuses an already-cached element (document.body never changes identity)
+    // would otherwise read stale data cached by an earlier, unrelated run on
+    // the same window. Clearing at the start of every run keeps sharing scoped
+    // to "this run" as intended, without leaking across runs.
+    try {
+        if (window && window.__a11ycoreSharedCache) window.__a11ycoreSharedCache = {};
+    } catch {}
+
     const sharedHelpers = createDomHelpers({
         document,
         window,
         root: roots,
         includeShadowDom,
+        includeHiddenElements,
         excludeSelectors,
         // Optional perf counters (bench/debug only). Deterministic and per-run.
         perfStats: !!(engineOptionsResolved && engineOptionsResolved.perfStats)