@webability/core 1.14.0 → 1.15.0

package/dist/engine.d.cts

@@ -1,4 +1,5 @@
 import { c as ScanIssue, m as JudgeOptions, I as InternalBug, q as JudgedEntry, P as PageLike } from './types-gjAJ8j0I.cjs';
+import { d as FixJudgeTransport, f as FixJudgeVerdictKind } from './hostedFixJudge-DXYes7X1.cjs';
 
 /**
  * Visitor HTML (`input: { html, baseURL }`): what the page may fetch while the
@@ -217,6 +218,25 @@ interface EngineOptions {
      * structural fixes, `verification` absent.
      */
     verify?: boolean;
+    /**
+     * Hosted fix judge: the fixes the engine emits are sent to this injected
+     * transport (see `hostedFixJudgeTransport`) and come back as
+     * `EngineResult.judgedFixes`, one verdict per fix. The judge runs behind the
+     * transport, never in core. `fixes` itself is unchanged: the caller decides
+     * what an `apply: false` verdict means. Only for a page the engine loaded by
+     * URL (`{ url }` or `{ loaded: true }`): the judge loads that public URL
+     * itself, so html/snapshot input is skipped with a warning. `timeoutMs` bounds
+     * each call (up to ceil(fixes / 20) sequential calls), not the whole stage;
+     * default 160 s.
+     */
+    fixJudge?: {
+        transport: FixJudgeTransport;
+        viewport?: {
+            width: number;
+            height: number;
+        };
+        timeoutMs?: number;
+    };
     /** Axe runs verification may spend isolating regressions. Default 40. */
     verifyMaxAxeRuns?: number;
     /** HTTP status of the main document when the caller navigated. */
@@ -384,6 +404,18 @@ interface EngineStats {
     /** Capabilities the injected Page lacked and what was skipped because of it. */
     warnings: string[];
 }
+/** One emitted fix with the hosted judge's verdict. `apply` is true only for `correct_needed`; every failure is `unclear` + `apply: false`. */
+interface JudgedFix {
+    sel: string;
+    attr: string;
+    val: string;
+    issueType: string;
+    verdict: FixJudgeVerdictKind;
+    apply: boolean;
+    /** wrong_value only: the value the judge says would be right. */
+    suggestedValue?: string;
+    reason: string;
+}
 interface EngineResult {
     url: string;
     issues: EngineIssue[];
@@ -393,6 +425,8 @@ interface EngineResult {
     findings: EngineFinding[];
     internal_bugs: InternalBug[];
     stats: EngineStats;
+    /** The hosted fix judge's verdict on each emitted fix, in `fixes` order (`opts.fixJudge`). Absent when no judge was set or it was skipped (see `stats.warnings`). */
+    judgedFixes?: JudgedFix[];
     /** 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. */
@@ -843,4 +877,4 @@ interface SelectorQualityResult {
 declare const BARE_TAGS: Set<string>;
 declare function scoreSelectorQuality(selector: string): SelectorQualityResult;
 
-export { BARE_TAGS, type EngineFinding, type EngineFix, type EngineInput, type EngineIssue, type EngineOptions, type EngineResult, type EngineStats, FORM_CONTROL_ROLES, type HazardElementView, type HtmlDecision, type HtmlRequest, type HtmlRequestPolicy, InternalBug, LABEL_IN_NAME_JS, type Model, type ModelRequest, type ModelResponse, type Page, type PlaywrightPageLike, type ProtectedScope, type PuppeteerPageLike, SERVED_FIX_KEYS, TOKEN_QUERY_KEY, classifyFixRisk, detectPageLanguage, dropHazardousHidingFixes, foldContains, foldLabel, fromPlaywright, fromPuppeteer, htmlRequestPolicy, isHidingFix, isHtmlLangFix, isInteractiveOrContainsFocusable, isLabelText, labelContainsText, labelInNameCheck, languageFromText, languageFromUrl, loadSnapshot, normalizeVisibleText, parseContext, primaryLanguage, runEngine, scoreSelectorQuality, selectorParses, toPageLike, validateAttribute, validateFix, validateRoleValue, validateSelector, validateSelectorForAttribute, validateTextValue };
+export { BARE_TAGS, type EngineFinding, type EngineFix, type EngineInput, type EngineIssue, type EngineOptions, type EngineResult, type EngineStats, FORM_CONTROL_ROLES, type HazardElementView, type HtmlDecision, type HtmlRequest, type HtmlRequestPolicy, InternalBug, type JudgedFix, LABEL_IN_NAME_JS, type Model, type ModelRequest, type ModelResponse, type Page, type PlaywrightPageLike, type ProtectedScope, type PuppeteerPageLike, SERVED_FIX_KEYS, TOKEN_QUERY_KEY, classifyFixRisk, detectPageLanguage, dropHazardousHidingFixes, foldContains, foldLabel, fromPlaywright, fromPuppeteer, htmlRequestPolicy, isHidingFix, isHtmlLangFix, isInteractiveOrContainsFocusable, isLabelText, labelContainsText, labelInNameCheck, languageFromText, languageFromUrl, loadSnapshot, normalizeVisibleText, parseContext, primaryLanguage, runEngine, scoreSelectorQuality, selectorParses, toPageLike, validateAttribute, validateFix, validateRoleValue, validateSelector, validateSelectorForAttribute, validateTextValue };

package/dist/engine.d.ts

@@ -1,4 +1,5 @@
 import { c as ScanIssue, m as JudgeOptions, I as InternalBug, q as JudgedEntry, P as PageLike } from './types-gjAJ8j0I.js';
+import { d as FixJudgeTransport, f as FixJudgeVerdictKind } from './hostedFixJudge-DXYes7X1.js';
 
 /**
  * Visitor HTML (`input: { html, baseURL }`): what the page may fetch while the
@@ -217,6 +218,25 @@ interface EngineOptions {
      * structural fixes, `verification` absent.
      */
     verify?: boolean;
+    /**
+     * Hosted fix judge: the fixes the engine emits are sent to this injected
+     * transport (see `hostedFixJudgeTransport`) and come back as
+     * `EngineResult.judgedFixes`, one verdict per fix. The judge runs behind the
+     * transport, never in core. `fixes` itself is unchanged: the caller decides
+     * what an `apply: false` verdict means. Only for a page the engine loaded by
+     * URL (`{ url }` or `{ loaded: true }`): the judge loads that public URL
+     * itself, so html/snapshot input is skipped with a warning. `timeoutMs` bounds
+     * each call (up to ceil(fixes / 20) sequential calls), not the whole stage;
+     * default 160 s.
+     */
+    fixJudge?: {
+        transport: FixJudgeTransport;
+        viewport?: {
+            width: number;
+            height: number;
+        };
+        timeoutMs?: number;
+    };
     /** Axe runs verification may spend isolating regressions. Default 40. */
     verifyMaxAxeRuns?: number;
     /** HTTP status of the main document when the caller navigated. */
@@ -384,6 +404,18 @@ interface EngineStats {
     /** Capabilities the injected Page lacked and what was skipped because of it. */
     warnings: string[];
 }
+/** One emitted fix with the hosted judge's verdict. `apply` is true only for `correct_needed`; every failure is `unclear` + `apply: false`. */
+interface JudgedFix {
+    sel: string;
+    attr: string;
+    val: string;
+    issueType: string;
+    verdict: FixJudgeVerdictKind;
+    apply: boolean;
+    /** wrong_value only: the value the judge says would be right. */
+    suggestedValue?: string;
+    reason: string;
+}
 interface EngineResult {
     url: string;
     issues: EngineIssue[];
@@ -393,6 +425,8 @@ interface EngineResult {
     findings: EngineFinding[];
     internal_bugs: InternalBug[];
     stats: EngineStats;
+    /** The hosted fix judge's verdict on each emitted fix, in `fixes` order (`opts.fixJudge`). Absent when no judge was set or it was skipped (see `stats.warnings`). */
+    judgedFixes?: JudgedFix[];
     /** 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. */
@@ -843,4 +877,4 @@ interface SelectorQualityResult {
 declare const BARE_TAGS: Set<string>;
 declare function scoreSelectorQuality(selector: string): SelectorQualityResult;
 
-export { BARE_TAGS, type EngineFinding, type EngineFix, type EngineInput, type EngineIssue, type EngineOptions, type EngineResult, type EngineStats, FORM_CONTROL_ROLES, type HazardElementView, type HtmlDecision, type HtmlRequest, type HtmlRequestPolicy, InternalBug, LABEL_IN_NAME_JS, type Model, type ModelRequest, type ModelResponse, type Page, type PlaywrightPageLike, type ProtectedScope, type PuppeteerPageLike, SERVED_FIX_KEYS, TOKEN_QUERY_KEY, classifyFixRisk, detectPageLanguage, dropHazardousHidingFixes, foldContains, foldLabel, fromPlaywright, fromPuppeteer, htmlRequestPolicy, isHidingFix, isHtmlLangFix, isInteractiveOrContainsFocusable, isLabelText, labelContainsText, labelInNameCheck, languageFromText, languageFromUrl, loadSnapshot, normalizeVisibleText, parseContext, primaryLanguage, runEngine, scoreSelectorQuality, selectorParses, toPageLike, validateAttribute, validateFix, validateRoleValue, validateSelector, validateSelectorForAttribute, validateTextValue };
+export { BARE_TAGS, type EngineFinding, type EngineFix, type EngineInput, type EngineIssue, type EngineOptions, type EngineResult, type EngineStats, FORM_CONTROL_ROLES, type HazardElementView, type HtmlDecision, type HtmlRequest, type HtmlRequestPolicy, InternalBug, type JudgedFix, LABEL_IN_NAME_JS, type Model, type ModelRequest, type ModelResponse, type Page, type PlaywrightPageLike, type ProtectedScope, type PuppeteerPageLike, SERVED_FIX_KEYS, TOKEN_QUERY_KEY, classifyFixRisk, detectPageLanguage, dropHazardousHidingFixes, foldContains, foldLabel, fromPlaywright, fromPuppeteer, htmlRequestPolicy, isHidingFix, isHtmlLangFix, isInteractiveOrContainsFocusable, isLabelText, labelContainsText, labelInNameCheck, languageFromText, languageFromUrl, loadSnapshot, normalizeVisibleText, parseContext, primaryLanguage, runEngine, scoreSelectorQuality, selectorParses, toPageLike, validateAttribute, validateFix, validateRoleValue, validateSelector, validateSelectorForAttribute, validateTextValue };