@webability/core 1.9.0 → 1.11.0

package/dist/engine.d.cts

@@ -1,4 +1,4 @@
-import { c as ScanIssue, I as InternalBug, P as PageLike } from './types-g-bI_MhR.cjs';
+import { c as ScanIssue, m as JudgeOptions, I as InternalBug, q as JudgedEntry, P as PageLike } from './types-jXnoW_NT.cjs';
 
 /**
  * The one engine's contract: two injected drivers in, one result out.
@@ -62,6 +62,11 @@ interface Page {
         content?: string;
         url?: string;
     }): Promise<unknown>;
+    /**
+     * The live Playwright Page. axe's frame-aware run (AxeBuilder) needs it to
+     * scan inside iframes. Absent: axe runs in the top document only.
+     */
+    playwrightPage?(): unknown;
 }
 /** One OpenAI-compatible chat call. `signal` aborts the HTTP request at the engine's deadline. */
 interface ModelRequest {
@@ -109,6 +114,22 @@ interface EngineOptions {
     level?: 'A' | 'AA' | 'AAA';
     /** HTTP status of the main document when the caller navigated. */
     mainStatus?: number;
+    /**
+     * Knobs of the deterministic layer (core scan()): scope to a subtree,
+     * dismiss cookie banners first (default false), the axe tags, the render
+     * settle, and core's in-scan AI judge for undecided findings. The judge
+     * makes its own HTTP calls (not through `Model`); leave it unset for a run
+     * with no model traffic.
+     */
+    scan?: {
+        rootSelector?: string;
+        dismissModals?: boolean;
+        judge?: JudgeOptions;
+        /** axe-core tags (default: core's WCAG A/AA set). */
+        wcagTags?: string[];
+        /** scan()'s render settle: false skips it (a DOM with no layout or animation). */
+        settle?: boolean;
+    };
 }
 /**
  * One fix record. The first five keys are the served manifest's wire keys
@@ -178,6 +199,8 @@ interface EngineResult {
     fixes: EngineFix[];
     internal_bugs: InternalBug[];
     stats: EngineStats;
+    /** Verdicts of core's in-scan judge (`opts.scan.judge`) on findings the engines could not decide. */
+    judged?: JudgedEntry[];
     /** Set when the target was a bot challenge, auth wall or HTTP error: nothing real was scanned. */
     blocked?: {
         reason: string;

package/dist/engine.d.ts

@@ -1,4 +1,4 @@
-import { c as ScanIssue, I as InternalBug, P as PageLike } from './types-g-bI_MhR.js';
+import { c as ScanIssue, m as JudgeOptions, I as InternalBug, q as JudgedEntry, P as PageLike } from './types-jXnoW_NT.js';
 
 /**
  * The one engine's contract: two injected drivers in, one result out.
@@ -62,6 +62,11 @@ interface Page {
         content?: string;
         url?: string;
     }): Promise<unknown>;
+    /**
+     * The live Playwright Page. axe's frame-aware run (AxeBuilder) needs it to
+     * scan inside iframes. Absent: axe runs in the top document only.
+     */
+    playwrightPage?(): unknown;
 }
 /** One OpenAI-compatible chat call. `signal` aborts the HTTP request at the engine's deadline. */
 interface ModelRequest {
@@ -109,6 +114,22 @@ interface EngineOptions {
     level?: 'A' | 'AA' | 'AAA';
     /** HTTP status of the main document when the caller navigated. */
     mainStatus?: number;
+    /**
+     * Knobs of the deterministic layer (core scan()): scope to a subtree,
+     * dismiss cookie banners first (default false), the axe tags, the render
+     * settle, and core's in-scan AI judge for undecided findings. The judge
+     * makes its own HTTP calls (not through `Model`); leave it unset for a run
+     * with no model traffic.
+     */
+    scan?: {
+        rootSelector?: string;
+        dismissModals?: boolean;
+        judge?: JudgeOptions;
+        /** axe-core tags (default: core's WCAG A/AA set). */
+        wcagTags?: string[];
+        /** scan()'s render settle: false skips it (a DOM with no layout or animation). */
+        settle?: boolean;
+    };
 }
 /**
  * One fix record. The first five keys are the served manifest's wire keys
@@ -178,6 +199,8 @@ interface EngineResult {
     fixes: EngineFix[];
     internal_bugs: InternalBug[];
     stats: EngineStats;
+    /** Verdicts of core's in-scan judge (`opts.scan.judge`) on findings the engines could not decide. */
+    judged?: JudgedEntry[];
     /** Set when the target was a bot challenge, auth wall or HTTP error: nothing real was scanned. */
     blocked?: {
         reason: string;