@webability/core 1.10.0 → 1.12.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { P as PageLike, S as ScanOptions, a as ScanResult, W as WcagLevel, b as SiteTheme, F as FixDetector, I as InternalBug, D as DetectedIssue, c as ScanIssue } from './types-fjs6XhzQ.cjs';
-export { B as BrowserDetector, d as DEFAULT_JUDGE_BASE_URL, e as DEFAULT_JUDGE_TEXT_MODEL, f as DEFAULT_JUDGE_VISION_MODEL, g as FixIssueType, h as IssueImpact, i as IssueSource, J as JUDGE_DEFAULT_TIMEOUT_MS, j as JUDGE_SYSTEM_PROMPT, k as JudgeChatBody, l as JudgeItem, m as JudgeOptions, n as JudgeRequest, o as JudgeTransport, p as JudgeVerdict, q as JudgedEntry, V as VIEWPORT_SIZES, r as ViewportPreset, s as WCAG_BY_ISSUE, t as buildJudgeChatBody, u as hostedJudgeTransport, v as judgeUndecided, w as openAiCompatibleTransport, x as resetJudgeCache } from './types-fjs6XhzQ.cjs';
+import { P as PageLike, S as ScanOptions, a as ScanResult, W as WcagLevel, b as SiteTheme, F as FixDetector, I as InternalBug, D as DetectedIssue, c as ScanIssue } from './types-gjAJ8j0I.cjs';
+export { B as BrowserDetector, d as DEFAULT_JUDGE_BASE_URL, e as DEFAULT_JUDGE_TEXT_MODEL, f as DEFAULT_JUDGE_VISION_MODEL, g as FixIssueType, h as IssueImpact, i as IssueSource, J as JUDGE_DEFAULT_TIMEOUT_MS, j as JUDGE_SYSTEM_PROMPT, k as JudgeChatBody, l as JudgeItem, m as JudgeOptions, n as JudgeRequest, o as JudgeTransport, p as JudgeVerdict, q as JudgedEntry, V as VIEWPORT_SIZES, r as ViewportPreset, s as WCAG_BY_ISSUE, t as buildJudgeChatBody, u as hostedJudgeTransport, v as judgeUndecided, w as openAiCompatibleTransport, x as resetJudgeCache } from './types-gjAJ8j0I.cjs';
 
 declare function scan(target: string | PageLike, options?: ScanOptions): Promise<ScanResult>;
 
@@ -10,26 +10,29 @@ declare function scan(target: string | PageLike, options?: ScanOptions): Promise
  */
 
 /**
- * Conformance level of every WCAG 2.2 success criterion (plus the obsolete
- * 4.1.1, still reported by older engines). The ONE level table in core: the
- * default AA scan drops findings whose criteria are all AAA, so a missing or
- * wrong row here leaks AAA into AA reports — the set is pinned by a test.
+ * Conformance level of every WCAG 2.2 success criterion. The ONE level table
+ * in core, and it is strict: a criterion missing from it (4.1.1 Parsing,
+ * removed in WCAG 2.2, or a typo) has no level, and a finding that names only
+ * such criteria is dropped from every report instead of being read as AA.
+ * The set is pinned by a test.
  */
 declare const WCAG_LEVEL_MAP: Record<string, WcagLevel>;
-declare function getWcagLevel(criterion: string): WcagLevel;
+declare function getWcagLevel(criterion: string): WcagLevel | undefined;
 /**
  * The conformance level an issue belongs to: the LOWEST level among the
  * criteria it names ("2.4.4,2.4.9" is an A finding), or the engine's own
- * level when it names none.
+ * level when it names none. Criteria outside WCAG 2.2 are skipped; an issue
+ * that names only such criteria has no level (undefined).
  */
 declare function issueLevel(issue: {
     wcag?: string;
     level?: WcagLevel;
-}): WcagLevel;
+}): WcagLevel | undefined;
 /**
  * Keep findings at `level` and below. Default scans are AA: AAA criteria are
  * not reported at all (owner decision 2026-10-04 — not in issues[],
  * incomplete[] or the summary); a caller opts in with `level: 'AAA'`.
+ * Findings with no WCAG 2.2 level are never kept.
  */
 declare function withinLevel<T extends {
     wcag?: string;
@@ -59,6 +62,8 @@ interface RunDetectorsOptions {
     extraSerialDetectors?: FixDetector[];
     /** Out: invariant-P entries (state a detector left behind, unmarked injections). */
     internalBugs?: InternalBug[];
+    /** Also run EXPERIMENTAL_DETECTORS (best practice, not A/AA). Default false. */
+    experimental?: boolean;
 }
 declare function runDetectors(page: PageLike, outTruncated?: TruncationEntry[], outWarnings?: string[], options?: RunDetectorsOptions): Promise<DetectedIssue[]>;
 declare function extractSiteTheme(page: PageLike): Promise<SiteTheme>;
@@ -80,6 +85,8 @@ interface CoverageSources {
     detectorCriteria: () => readonly string[];
     /** Every rule id verify_fix accepts as `wcag` besides a criterion: axe ids + detector issue types. */
     ruleIds: () => readonly string[] | Promise<readonly string[]>;
+    /** The criteria a rule id can fail (axe tags, or WCAG_BY_ISSUE); [] when unknown. Optional for fakes. */
+    ruleCriteria?: (id: string) => readonly string[] | Promise<readonly string[]>;
 }
 /** Union of every engine's criteria. Throws if any registry cannot be read. */
 declare function coveredCriteria(sources?: CoverageSources): Promise<Set<string>>;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as PageLike, S as ScanOptions, a as ScanResult, W as WcagLevel, b as SiteTheme, F as FixDetector, I as InternalBug, D as DetectedIssue, c as ScanIssue } from './types-fjs6XhzQ.js';
-export { B as BrowserDetector, d as DEFAULT_JUDGE_BASE_URL, e as DEFAULT_JUDGE_TEXT_MODEL, f as DEFAULT_JUDGE_VISION_MODEL, g as FixIssueType, h as IssueImpact, i as IssueSource, J as JUDGE_DEFAULT_TIMEOUT_MS, j as JUDGE_SYSTEM_PROMPT, k as JudgeChatBody, l as JudgeItem, m as JudgeOptions, n as JudgeRequest, o as JudgeTransport, p as JudgeVerdict, q as JudgedEntry, V as VIEWPORT_SIZES, r as ViewportPreset, s as WCAG_BY_ISSUE, t as buildJudgeChatBody, u as hostedJudgeTransport, v as judgeUndecided, w as openAiCompatibleTransport, x as resetJudgeCache } from './types-fjs6XhzQ.js';
+import { P as PageLike, S as ScanOptions, a as ScanResult, W as WcagLevel, b as SiteTheme, F as FixDetector, I as InternalBug, D as DetectedIssue, c as ScanIssue } from './types-gjAJ8j0I.js';
+export { B as BrowserDetector, d as DEFAULT_JUDGE_BASE_URL, e as DEFAULT_JUDGE_TEXT_MODEL, f as DEFAULT_JUDGE_VISION_MODEL, g as FixIssueType, h as IssueImpact, i as IssueSource, J as JUDGE_DEFAULT_TIMEOUT_MS, j as JUDGE_SYSTEM_PROMPT, k as JudgeChatBody, l as JudgeItem, m as JudgeOptions, n as JudgeRequest, o as JudgeTransport, p as JudgeVerdict, q as JudgedEntry, V as VIEWPORT_SIZES, r as ViewportPreset, s as WCAG_BY_ISSUE, t as buildJudgeChatBody, u as hostedJudgeTransport, v as judgeUndecided, w as openAiCompatibleTransport, x as resetJudgeCache } from './types-gjAJ8j0I.js';
 
 declare function scan(target: string | PageLike, options?: ScanOptions): Promise<ScanResult>;
 
@@ -10,26 +10,29 @@ declare function scan(target: string | PageLike, options?: ScanOptions): Promise
  */
 
 /**
- * Conformance level of every WCAG 2.2 success criterion (plus the obsolete
- * 4.1.1, still reported by older engines). The ONE level table in core: the
- * default AA scan drops findings whose criteria are all AAA, so a missing or
- * wrong row here leaks AAA into AA reports — the set is pinned by a test.
+ * Conformance level of every WCAG 2.2 success criterion. The ONE level table
+ * in core, and it is strict: a criterion missing from it (4.1.1 Parsing,
+ * removed in WCAG 2.2, or a typo) has no level, and a finding that names only
+ * such criteria is dropped from every report instead of being read as AA.
+ * The set is pinned by a test.
  */
 declare const WCAG_LEVEL_MAP: Record<string, WcagLevel>;
-declare function getWcagLevel(criterion: string): WcagLevel;
+declare function getWcagLevel(criterion: string): WcagLevel | undefined;
 /**
  * The conformance level an issue belongs to: the LOWEST level among the
  * criteria it names ("2.4.4,2.4.9" is an A finding), or the engine's own
- * level when it names none.
+ * level when it names none. Criteria outside WCAG 2.2 are skipped; an issue
+ * that names only such criteria has no level (undefined).
  */
 declare function issueLevel(issue: {
     wcag?: string;
     level?: WcagLevel;
-}): WcagLevel;
+}): WcagLevel | undefined;
 /**
  * Keep findings at `level` and below. Default scans are AA: AAA criteria are
  * not reported at all (owner decision 2026-10-04 — not in issues[],
  * incomplete[] or the summary); a caller opts in with `level: 'AAA'`.
+ * Findings with no WCAG 2.2 level are never kept.
  */
 declare function withinLevel<T extends {
     wcag?: string;
@@ -59,6 +62,8 @@ interface RunDetectorsOptions {
     extraSerialDetectors?: FixDetector[];
     /** Out: invariant-P entries (state a detector left behind, unmarked injections). */
     internalBugs?: InternalBug[];
+    /** Also run EXPERIMENTAL_DETECTORS (best practice, not A/AA). Default false. */
+    experimental?: boolean;
 }
 declare function runDetectors(page: PageLike, outTruncated?: TruncationEntry[], outWarnings?: string[], options?: RunDetectorsOptions): Promise<DetectedIssue[]>;
 declare function extractSiteTheme(page: PageLike): Promise<SiteTheme>;
@@ -80,6 +85,8 @@ interface CoverageSources {
     detectorCriteria: () => readonly string[];
     /** Every rule id verify_fix accepts as `wcag` besides a criterion: axe ids + detector issue types. */
     ruleIds: () => readonly string[] | Promise<readonly string[]>;
+    /** The criteria a rule id can fail (axe tags, or WCAG_BY_ISSUE); [] when unknown. Optional for fakes. */
+    ruleCriteria?: (id: string) => readonly string[] | Promise<readonly string[]>;
 }
 /** Union of every engine's criteria. Throws if any registry cannot be read. */
 declare function coveredCriteria(sources?: CoverageSources): Promise<Set<string>>;