@webability/core 1.5.0 → 1.7.0

package/dist/index.d.cts

@@ -1,8 +1,41 @@
-import { P as PageLike, a as ScanOptions, S as ScanResult, b as SiteTheme, D as DetectedIssue, c as ScanIssue } from './types-C6Lhzod6.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-C6Lhzod6.cjs';
+import { P as PageLike, a as ScanOptions, S as ScanResult, W as WcagLevel, b as SiteTheme, D as DetectedIssue, c as ScanIssue } from './types-CbNyAKbT.cjs';
+export { B as BrowserDetector, F as FixDetector, d as FixIssueType, I as IssueImpact, e as IssueSource, V as VIEWPORT_SIZES, f as ViewportPreset, g as WCAG_BY_ISSUE } from './types-CbNyAKbT.cjs';
 
 declare function scan(target: string | PageLike, options?: ScanOptions): Promise<ScanResult>;
 
+/**
+ * Pure issue-shaping utilities shared by the Playwright scan path
+ * (scanner.ts) and the in-DOM scan path (dom.ts). Moved verbatim from
+ * scanner.ts — no behavior changes.
+ */
+
+/**
+ * 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.
+ */
+declare const WCAG_LEVEL_MAP: Record<string, WcagLevel>;
+declare function getWcagLevel(criterion: string): WcagLevel;
+/**
+ * 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.
+ */
+declare function issueLevel(issue: {
+    wcag?: string;
+    level?: WcagLevel;
+}): WcagLevel;
+/**
+ * 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'`.
+ */
+declare function withinLevel<T extends {
+    wcag?: string;
+    level?: WcagLevel;
+}>(issues: T[], level?: WcagLevel): T[];
+
 type TruncationEntry = {
     detector: string;
     cap: number;
@@ -37,6 +70,11 @@ interface AxeViolation {
         html: string;
         target: string[];
         failureSummary?: string;
+        any?: Array<{
+            data?: {
+                messageKey?: string;
+            };
+        }>;
     }>;
 }
 interface AxeRunResult {
@@ -125,4 +163,4 @@ interface DevSuggestion {
 }
 declare function generateDevSuggestion(issue: ScanIssue, framework: Framework, elementClasses?: string, fgColor?: string, bgColor?: string): DevSuggestion;
 
-export { type ContrastSuggestion, DetectedIssue, type DevSuggestion, type Framework, type FrameworkInfo, PageLike, ScanIssue, ScanOptions, ScanResult, SiteTheme, type TailwindSuggestion, detectFramework, dismissModals, extractSiteTheme, generateDevSuggestion, getContrastRatio, runAxe, runDetectors, scan, solveContrast, suggestTailwindFix, toHtmlReport };
+export { type ContrastSuggestion, DetectedIssue, type DevSuggestion, type Framework, type FrameworkInfo, PageLike, ScanIssue, ScanOptions, ScanResult, SiteTheme, type TailwindSuggestion, WCAG_LEVEL_MAP, WcagLevel, detectFramework, dismissModals, extractSiteTheme, generateDevSuggestion, getContrastRatio, getWcagLevel, issueLevel, runAxe, runDetectors, scan, solveContrast, suggestTailwindFix, toHtmlReport, withinLevel };

package/dist/index.d.ts

@@ -1,8 +1,41 @@
-import { P as PageLike, a as ScanOptions, S as ScanResult, b as SiteTheme, D as DetectedIssue, c as ScanIssue } from './types-C6Lhzod6.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-C6Lhzod6.js';
+import { P as PageLike, a as ScanOptions, S as ScanResult, W as WcagLevel, b as SiteTheme, D as DetectedIssue, c as ScanIssue } from './types-CbNyAKbT.js';
+export { B as BrowserDetector, F as FixDetector, d as FixIssueType, I as IssueImpact, e as IssueSource, V as VIEWPORT_SIZES, f as ViewportPreset, g as WCAG_BY_ISSUE } from './types-CbNyAKbT.js';
 
 declare function scan(target: string | PageLike, options?: ScanOptions): Promise<ScanResult>;
 
+/**
+ * Pure issue-shaping utilities shared by the Playwright scan path
+ * (scanner.ts) and the in-DOM scan path (dom.ts). Moved verbatim from
+ * scanner.ts — no behavior changes.
+ */
+
+/**
+ * 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.
+ */
+declare const WCAG_LEVEL_MAP: Record<string, WcagLevel>;
+declare function getWcagLevel(criterion: string): WcagLevel;
+/**
+ * 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.
+ */
+declare function issueLevel(issue: {
+    wcag?: string;
+    level?: WcagLevel;
+}): WcagLevel;
+/**
+ * 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'`.
+ */
+declare function withinLevel<T extends {
+    wcag?: string;
+    level?: WcagLevel;
+}>(issues: T[], level?: WcagLevel): T[];
+
 type TruncationEntry = {
     detector: string;
     cap: number;
@@ -37,6 +70,11 @@ interface AxeViolation {
         html: string;
         target: string[];
         failureSummary?: string;
+        any?: Array<{
+            data?: {
+                messageKey?: string;
+            };
+        }>;
     }>;
 }
 interface AxeRunResult {
@@ -125,4 +163,4 @@ interface DevSuggestion {
 }
 declare function generateDevSuggestion(issue: ScanIssue, framework: Framework, elementClasses?: string, fgColor?: string, bgColor?: string): DevSuggestion;
 
-export { type ContrastSuggestion, DetectedIssue, type DevSuggestion, type Framework, type FrameworkInfo, PageLike, ScanIssue, ScanOptions, ScanResult, SiteTheme, type TailwindSuggestion, detectFramework, dismissModals, extractSiteTheme, generateDevSuggestion, getContrastRatio, runAxe, runDetectors, scan, solveContrast, suggestTailwindFix, toHtmlReport };
+export { type ContrastSuggestion, DetectedIssue, type DevSuggestion, type Framework, type FrameworkInfo, PageLike, ScanIssue, ScanOptions, ScanResult, SiteTheme, type TailwindSuggestion, WCAG_LEVEL_MAP, WcagLevel, detectFramework, dismissModals, extractSiteTheme, generateDevSuggestion, getContrastRatio, getWcagLevel, issueLevel, runAxe, runDetectors, scan, solveContrast, suggestTailwindFix, toHtmlReport, withinLevel };