@webability/core 1.3.0 → 1.4.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { P as PageLike, a as ScanOptions, S as ScanResult, b as SiteTheme, D as DetectedIssue, c as ScanIssue } from './types-10iqML3X.cjs';
-export { B as BrowserDetector, F as FixDetector, d as FixIssueType, I as IssueImpact, e as IssueSource, V as VIEWPORT_SIZES, f as ViewportPreset, W as WCAG_BY_ISSUE, g as WcagLevel } from './types-10iqML3X.cjs';
+import { P as PageLike, a as ScanOptions, S as ScanResult, b as SiteTheme, D as DetectedIssue, c as ScanIssue } from './types-CznpCIVi.cjs';
+export { B as BrowserDetector, F as FixDetector, d as FixIssueType, I as IssueImpact, e as IssueSource, V as VIEWPORT_SIZES, f as ViewportPreset, W as WCAG_BY_ISSUE, g as WcagLevel } from './types-CznpCIVi.cjs';
 
 declare function scan(target: string | PageLike, options?: ScanOptions): Promise<ScanResult>;
 
@@ -13,7 +13,17 @@ type TruncationEntry = {
  * injection blocked by CSP) that silently disable a category of checks.
  * Both arrays are per-invocation (caller-owned), never module state.
  */
-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>;
 
 interface AxeViolation {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as PageLike, a as ScanOptions, S as ScanResult, b as SiteTheme, D as DetectedIssue, c as ScanIssue } from './types-10iqML3X.js';
-export { B as BrowserDetector, F as FixDetector, d as FixIssueType, I as IssueImpact, e as IssueSource, V as VIEWPORT_SIZES, f as ViewportPreset, W as WCAG_BY_ISSUE, g as WcagLevel } from './types-10iqML3X.js';
+import { P as PageLike, a as ScanOptions, S as ScanResult, b as SiteTheme, D as DetectedIssue, c as ScanIssue } from './types-CznpCIVi.js';
+export { B as BrowserDetector, F as FixDetector, d as FixIssueType, I as IssueImpact, e as IssueSource, V as VIEWPORT_SIZES, f as ViewportPreset, W as WCAG_BY_ISSUE, g as WcagLevel } from './types-CznpCIVi.js';
 
 declare function scan(target: string | PageLike, options?: ScanOptions): Promise<ScanResult>;
 
@@ -13,7 +13,17 @@ type TruncationEntry = {
  * injection blocked by CSP) that silently disable a category of checks.
  * Both arrays are per-invocation (caller-owned), never module state.
  */
-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>;
 
 interface AxeViolation {