@webability/core - npm Package Compare versions

Comparing version 1.3.0 to 1.3.1

dist/dom.d.cts

@@ -25,4 +25,15 @@ import { P as PageLike, S as ScanResult } from './types-10iqML3X.cjs';
     wcagTags?: string[];
-    /** Window to scan. Default the ambient `window`. */
+    /**
+     * Window to scan. Default the ambient `window`. SAME-REALM only: detector
+     * code executes in the realm this module was loaded into, so a cross-realm
+     * window (an iframe's contentWindow) is not supported — load the bundle
+     * inside that frame instead.
+     */
     window?: Window & typeof globalThis;
+    /**
+     * Run the focus-mutating checks (focus visibility/obscured). Default FALSE
+     * in DOM mode: they steal focus and scroll the page the user is looking
+     * at. Opt in for detached/offscreen documents only.
+     */
+    interactiveChecks?: boolean;
 }
@@ -29,0 +40,0 @@ /**

dist/dom.d.ts

@@ -25,4 +25,15 @@ import { P as PageLike, S as ScanResult } from './types-10iqML3X.js';
     wcagTags?: string[];
-    /** Window to scan. Default the ambient `window`. */
+    /**
+     * Window to scan. Default the ambient `window`. SAME-REALM only: detector
+     * code executes in the realm this module was loaded into, so a cross-realm
+     * window (an iframe's contentWindow) is not supported — load the bundle
+     * inside that frame instead.
+     */
     window?: Window & typeof globalThis;
+    /**
+     * Run the focus-mutating checks (focus visibility/obscured). Default FALSE
+     * in DOM mode: they steal focus and scroll the page the user is looking
+     * at. Opt in for detached/offscreen documents only.
+     */
+    interactiveChecks?: boolean;
 }
@@ -29,0 +40,0 @@ /**

dist/index.d.cts

@@ -16,3 +16,13 @@ import { P as PageLike, a as ScanOptions, S as ScanResult, b as SiteTheme, D as DetectedIssue, c as ScanIssue } from './types-10iqML3X.cjs';
  */
-declare function runDetectors(page: PageLike, outTruncated?: TruncationEntry[], outWarnings?: string[]): Promise<DetectedIssue[]>;
+interface RunDetectorsOptions {
+    /**
+     * Skip the two serial FOCUS-MUTATING detectors (focusVisible moves real
+     * focus element-by-element; focusObscured scrolls anchor targets). Set by
+     * DOM-mode consumers scanning a page the user is LOOKING AT — stealing
+     * focus and scrolling their live tab is not acceptable there, and without
+     * page.keyboard those checks mostly land in needs-review anyway.
+     */
+    skipFocusMutating?: boolean;
+}
+declare function runDetectors(page: PageLike, outTruncated?: TruncationEntry[], outWarnings?: string[], options?: RunDetectorsOptions): Promise<DetectedIssue[]>;
 declare function extractSiteTheme(page: PageLike): Promise<SiteTheme>;
@@ -19,0 +29,0 @@

dist/index.d.ts

@@ -16,3 +16,13 @@ import { P as PageLike, a as ScanOptions, S as ScanResult, b as SiteTheme, D as DetectedIssue, c as ScanIssue } from './types-10iqML3X.js';
  */
-declare function runDetectors(page: PageLike, outTruncated?: TruncationEntry[], outWarnings?: string[]): Promise<DetectedIssue[]>;
+interface RunDetectorsOptions {
+    /**
+     * Skip the two serial FOCUS-MUTATING detectors (focusVisible moves real
+     * focus element-by-element; focusObscured scrolls anchor targets). Set by
+     * DOM-mode consumers scanning a page the user is LOOKING AT — stealing
+     * focus and scrolling their live tab is not acceptable there, and without
+     * page.keyboard those checks mostly land in needs-review anyway.
+     */
+    skipFocusMutating?: boolean;
+}
+declare function runDetectors(page: PageLike, outTruncated?: TruncationEntry[], outWarnings?: string[], options?: RunDetectorsOptions): Promise<DetectedIssue[]>;
 declare function extractSiteTheme(page: PageLike): Promise<SiteTheme>;
@@ -19,0 +29,0 @@

package.json

 {
   "name": "@webability/core",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Accessibility scanner engine \u2014 WCAG 2.2 AA/AAA compliance testing with 200+ rules",
@@ -32,3 +32,3 @@ "type": "module",
     "clean": "rm -rf dist",
-    "gen:dom-kernel": "node --experimental-strip-types scripts/gen-dom-kernel.mjs"
+    "gen:dom-kernel": "node scripts/gen-dom-kernel.mjs"
   },
@@ -35,0 +35,0 @@ "keywords": [

New alerts

Unidentified License

License

Something that seems like a license was found, but its contents could not be matched with a known license.

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Fixed alerts

Unidentified License

License

Something that seems like a license was found, but its contents could not be matched with a known license.

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Improved metrics

Total package byte prevSize

3226237

0.08%

Lines of code

13817

0.18%

No dependency changes