@webability/core 1.4.0 → 1.6.0

package/dist/{types-CznpCIVi.d.cts → types-CbNyAKbT.d.cts}

@@ -25,7 +25,7 @@ interface PageLike {
     };
 }
 /** All fix issue types the pipeline can detect and fix. */
-type FixIssueType = 'weak_button_name' | 'weak_link_name' | 'weak_heading' | 'weak_iframe_title' | 'weak_page_title' | 'weak_svg_name' | 'weak_skip_link' | 'missing_button_role' | 'missing_semantic_role' | 'missing_landmark' | 'heading_skip' | 'svg_missing_name' | 'aria_hidden_focusable' | 'adjacent_redundant_link' | 'contrast_insufficient' | 'non_text_contrast_insufficient' | 'target_too_small' | 'focus_not_visible' | 'empty_link' | 'unlabeled_button' | 'missing_label' | 'decorative_icon' | 'skip_link' | 'aria_live' | 'missing_alt' | 'identify_input_purpose' | 'redundant_role' | 'duplicate_id' | 'new_window_link' | 'missing_fieldset_legend' | 'missing_table_header' | 'missing_table_caption' | 'missing_table_scope' | 'external_link_warning' | 'download_link_warning' | 'broken_anchor' | 'placeholder_link' | 'missing_aria_required' | 'missing_pattern_title' | 'missing_autocomplete' | 'missing_media_controls' | 'unsafe_autoplay' | 'invalid_aria_role' | 'zoom_restriction' | 'missing_button_type' | 'link_consistency' | 'semantic_emphasis' | 'keyboard_trap' | 'focus_order_disruption' | 'missing_captions' | 'color_only_link' | 'label_in_name' | 'onfocus_context_change' | 'focus_obscured_by_sticky' | 'text_spacing_blocked' | 'nested_landmark' | 'combobox_name_missing' | 'landmark_duplicate_unlabeled' | 'motion_uncontrollable' | 'auto_refresh' | 'motion_without_reduced_motion' | 'flashing_content' | 'animated_gif_no_pause' | 'missing_required_indicator' | 'background_image_unlabeled' | 'missing_h1' | 'multiple_h1' | 'empty_heading' | 'javascript_link' | 'broken_aria_reference' | 'main_content_hidden' | 'scrollable_not_focusable' | 'meaningful_sequence' | 'sensory_characteristic' | 'orientation_lock' | 'image_of_text' | 'reflow_overflow' | 'missing_audio_description' | 'missing_transcript' | 'character_key_shortcut' | 'on_input_change' | 'pointer_gesture' | 'pointer_cancellation' | 'motion_actuation' | 'error_prevention_missing' | 'insufficient_navigation' | 'inconsistent_navigation';
+type FixIssueType = 'weak_button_name' | 'weak_link_name' | 'weak_heading' | 'weak_iframe_title' | 'weak_page_title' | 'weak_svg_name' | 'weak_skip_link' | 'missing_button_role' | 'missing_semantic_role' | 'missing_landmark' | 'heading_skip' | 'svg_missing_name' | 'aria_hidden_focusable' | 'adjacent_redundant_link' | 'contrast_insufficient' | 'non_text_contrast_insufficient' | 'target_too_small' | 'focus_not_visible' | 'empty_link' | 'unlabeled_button' | 'missing_label' | 'decorative_icon' | 'skip_link' | 'aria_live' | 'missing_alt' | 'identify_input_purpose' | 'redundant_role' | 'duplicate_id' | 'new_window_link' | 'missing_fieldset_legend' | 'missing_table_header' | 'missing_table_caption' | 'missing_table_scope' | 'external_link_warning' | 'download_link_warning' | 'broken_anchor' | 'placeholder_link' | 'missing_pattern_title' | 'missing_autocomplete' | 'missing_media_controls' | 'unsafe_autoplay' | 'invalid_aria_role' | 'zoom_restriction' | 'missing_button_type' | 'link_consistency' | 'semantic_emphasis' | 'keyboard_trap' | 'focus_order_disruption' | 'missing_captions' | 'color_only_link' | 'label_in_name' | 'onfocus_context_change' | 'focus_obscured_by_sticky' | 'text_spacing_blocked' | 'nested_landmark' | 'combobox_name_missing' | 'landmark_duplicate_unlabeled' | 'motion_uncontrollable' | 'auto_refresh' | 'motion_without_reduced_motion' | 'flashing_content' | 'animated_gif_no_pause' | 'missing_required_indicator' | 'background_image_unlabeled' | 'missing_h1' | 'multiple_h1' | 'empty_heading' | 'javascript_link' | 'broken_aria_reference' | 'main_content_hidden' | 'scrollable_not_focusable' | 'meaningful_sequence' | 'sensory_characteristic' | 'orientation_lock' | 'image_of_text' | 'reflow_overflow' | 'missing_audio_description' | 'missing_transcript' | 'character_key_shortcut' | 'on_input_change' | 'pointer_gesture' | 'pointer_cancellation' | 'motion_actuation' | 'error_prevention_missing' | 'insufficient_navigation' | 'inconsistent_navigation';
 /** WCAG criterion for each issue type. */
 declare const WCAG_BY_ISSUE: Record<FixIssueType, string>;
 /** A single accessibility issue detected on the page. */
@@ -51,12 +51,17 @@ interface DetectedIssue {
     /** Optional: outer HTML snippet (first 300 chars) for Claude context. */
     outerHtml?: string;
     /**
-     * Detector-side signal that the finding is ambiguous and should land in
-     * `ScanResult.incomplete[]` (e.g. contrast against a gradient). The scanner
-     * propagates this to ScanIssue.confidence so the confidence classifier
-     * doesn't have to reverse-engineer the situation from HTML strings.
+     * Detector-side signal that the VERDICT is uncertain (e.g. contrast against
+     * a gradient). The scanner never reports such a finding: it is resolved to a
+     * verdict by an engine resolver or dropped. For "verdict certain, fix not
+     * mechanical" use `manualFix`.
      */
     needsReview?: boolean;
+    /**
+     * The verdict is certain but the suggested fix cannot be applied
+     * mechanically. Sets `fix.needsManualReview`; never changes the verdict.
+     */
+    manualFix?: boolean;
     /** Why this finding needs review — surfaced to MCP/SDK consumers. */
     reviewReason?: string;
     /**
@@ -182,9 +187,9 @@ interface ScanResult {
     /** Engine (core package) version that produced this result — provenance */
     engine?: string;
     /**
-     * Findings the classifier or axe-core flagged as ambiguous. Show to the user
-     * for review — never auto-fix. Empty array (not omitted) when no incompletes,
-     * so consumers can rely on the field.
+     * @deprecated Always `[]`. The scanner judges uncertain findings itself:
+     * each becomes a verdict in `issues` or is dropped. The field stays only so
+     * existing consumers that read it keep compiling.
      */
     incomplete: ScanIssue[];
     summary: {
@@ -193,7 +198,7 @@ interface ScanResult {
         serious: number;
         moderate: number;
         minor: number;
-        /** Count of items in `incomplete[]`. */
+        /** @deprecated Always 0 — there is no incomplete bucket. */
         incomplete: number;
     };
     axeResults?: unknown;
@@ -205,6 +210,12 @@ declare const VIEWPORT_SIZES: Record<ViewportPreset, {
 }>;
 interface ScanOptions {
     wcagTags?: string[];
+    /**
+     * Highest WCAG conformance level to report. Default 'AA': findings whose
+     * criteria are all Level AAA are not reported anywhere (issues, incomplete,
+     * summary). 'AAA' opts in (and adds axe's wcag2aaa rules); 'A' keeps Level A only.
+     */
+    level?: WcagLevel;
     includeAxe?: boolean;
     deep?: boolean;
     deepApiUrl?: string;
@@ -243,4 +254,4 @@ interface ScanOptions {
     mainStatus?: number;
 }
 
-export { type BrowserDetector as B, type DetectedIssue as D, type FixDetector as F, type IssueImpact as I, type PageLike as P, type ScanResult as S, VIEWPORT_SIZES as V, WCAG_BY_ISSUE as W, type ScanOptions as a, type SiteTheme as b, type ScanIssue as c, type FixIssueType as d, type IssueSource as e, type ViewportPreset as f, type WcagLevel as g };
+export { type BrowserDetector as B, type DetectedIssue as D, type FixDetector as F, type IssueImpact as I, type PageLike as P, type ScanResult as S, VIEWPORT_SIZES as V, type WcagLevel as W, type ScanOptions as a, type SiteTheme as b, type ScanIssue as c, type FixIssueType as d, type IssueSource as e, type ViewportPreset as f, WCAG_BY_ISSUE as g };

package/dist/{types-CznpCIVi.d.ts → types-CbNyAKbT.d.ts}

@@ -25,7 +25,7 @@ interface PageLike {
     };
 }
 /** All fix issue types the pipeline can detect and fix. */
-type FixIssueType = 'weak_button_name' | 'weak_link_name' | 'weak_heading' | 'weak_iframe_title' | 'weak_page_title' | 'weak_svg_name' | 'weak_skip_link' | 'missing_button_role' | 'missing_semantic_role' | 'missing_landmark' | 'heading_skip' | 'svg_missing_name' | 'aria_hidden_focusable' | 'adjacent_redundant_link' | 'contrast_insufficient' | 'non_text_contrast_insufficient' | 'target_too_small' | 'focus_not_visible' | 'empty_link' | 'unlabeled_button' | 'missing_label' | 'decorative_icon' | 'skip_link' | 'aria_live' | 'missing_alt' | 'identify_input_purpose' | 'redundant_role' | 'duplicate_id' | 'new_window_link' | 'missing_fieldset_legend' | 'missing_table_header' | 'missing_table_caption' | 'missing_table_scope' | 'external_link_warning' | 'download_link_warning' | 'broken_anchor' | 'placeholder_link' | 'missing_aria_required' | 'missing_pattern_title' | 'missing_autocomplete' | 'missing_media_controls' | 'unsafe_autoplay' | 'invalid_aria_role' | 'zoom_restriction' | 'missing_button_type' | 'link_consistency' | 'semantic_emphasis' | 'keyboard_trap' | 'focus_order_disruption' | 'missing_captions' | 'color_only_link' | 'label_in_name' | 'onfocus_context_change' | 'focus_obscured_by_sticky' | 'text_spacing_blocked' | 'nested_landmark' | 'combobox_name_missing' | 'landmark_duplicate_unlabeled' | 'motion_uncontrollable' | 'auto_refresh' | 'motion_without_reduced_motion' | 'flashing_content' | 'animated_gif_no_pause' | 'missing_required_indicator' | 'background_image_unlabeled' | 'missing_h1' | 'multiple_h1' | 'empty_heading' | 'javascript_link' | 'broken_aria_reference' | 'main_content_hidden' | 'scrollable_not_focusable' | 'meaningful_sequence' | 'sensory_characteristic' | 'orientation_lock' | 'image_of_text' | 'reflow_overflow' | 'missing_audio_description' | 'missing_transcript' | 'character_key_shortcut' | 'on_input_change' | 'pointer_gesture' | 'pointer_cancellation' | 'motion_actuation' | 'error_prevention_missing' | 'insufficient_navigation' | 'inconsistent_navigation';
+type FixIssueType = 'weak_button_name' | 'weak_link_name' | 'weak_heading' | 'weak_iframe_title' | 'weak_page_title' | 'weak_svg_name' | 'weak_skip_link' | 'missing_button_role' | 'missing_semantic_role' | 'missing_landmark' | 'heading_skip' | 'svg_missing_name' | 'aria_hidden_focusable' | 'adjacent_redundant_link' | 'contrast_insufficient' | 'non_text_contrast_insufficient' | 'target_too_small' | 'focus_not_visible' | 'empty_link' | 'unlabeled_button' | 'missing_label' | 'decorative_icon' | 'skip_link' | 'aria_live' | 'missing_alt' | 'identify_input_purpose' | 'redundant_role' | 'duplicate_id' | 'new_window_link' | 'missing_fieldset_legend' | 'missing_table_header' | 'missing_table_caption' | 'missing_table_scope' | 'external_link_warning' | 'download_link_warning' | 'broken_anchor' | 'placeholder_link' | 'missing_pattern_title' | 'missing_autocomplete' | 'missing_media_controls' | 'unsafe_autoplay' | 'invalid_aria_role' | 'zoom_restriction' | 'missing_button_type' | 'link_consistency' | 'semantic_emphasis' | 'keyboard_trap' | 'focus_order_disruption' | 'missing_captions' | 'color_only_link' | 'label_in_name' | 'onfocus_context_change' | 'focus_obscured_by_sticky' | 'text_spacing_blocked' | 'nested_landmark' | 'combobox_name_missing' | 'landmark_duplicate_unlabeled' | 'motion_uncontrollable' | 'auto_refresh' | 'motion_without_reduced_motion' | 'flashing_content' | 'animated_gif_no_pause' | 'missing_required_indicator' | 'background_image_unlabeled' | 'missing_h1' | 'multiple_h1' | 'empty_heading' | 'javascript_link' | 'broken_aria_reference' | 'main_content_hidden' | 'scrollable_not_focusable' | 'meaningful_sequence' | 'sensory_characteristic' | 'orientation_lock' | 'image_of_text' | 'reflow_overflow' | 'missing_audio_description' | 'missing_transcript' | 'character_key_shortcut' | 'on_input_change' | 'pointer_gesture' | 'pointer_cancellation' | 'motion_actuation' | 'error_prevention_missing' | 'insufficient_navigation' | 'inconsistent_navigation';
 /** WCAG criterion for each issue type. */
 declare const WCAG_BY_ISSUE: Record<FixIssueType, string>;
 /** A single accessibility issue detected on the page. */
@@ -51,12 +51,17 @@ interface DetectedIssue {
     /** Optional: outer HTML snippet (first 300 chars) for Claude context. */
     outerHtml?: string;
     /**
-     * Detector-side signal that the finding is ambiguous and should land in
-     * `ScanResult.incomplete[]` (e.g. contrast against a gradient). The scanner
-     * propagates this to ScanIssue.confidence so the confidence classifier
-     * doesn't have to reverse-engineer the situation from HTML strings.
+     * Detector-side signal that the VERDICT is uncertain (e.g. contrast against
+     * a gradient). The scanner never reports such a finding: it is resolved to a
+     * verdict by an engine resolver or dropped. For "verdict certain, fix not
+     * mechanical" use `manualFix`.
      */
     needsReview?: boolean;
+    /**
+     * The verdict is certain but the suggested fix cannot be applied
+     * mechanically. Sets `fix.needsManualReview`; never changes the verdict.
+     */
+    manualFix?: boolean;
     /** Why this finding needs review — surfaced to MCP/SDK consumers. */
     reviewReason?: string;
     /**
@@ -182,9 +187,9 @@ interface ScanResult {
     /** Engine (core package) version that produced this result — provenance */
     engine?: string;
     /**
-     * Findings the classifier or axe-core flagged as ambiguous. Show to the user
-     * for review — never auto-fix. Empty array (not omitted) when no incompletes,
-     * so consumers can rely on the field.
+     * @deprecated Always `[]`. The scanner judges uncertain findings itself:
+     * each becomes a verdict in `issues` or is dropped. The field stays only so
+     * existing consumers that read it keep compiling.
      */
     incomplete: ScanIssue[];
     summary: {
@@ -193,7 +198,7 @@ interface ScanResult {
         serious: number;
         moderate: number;
         minor: number;
-        /** Count of items in `incomplete[]`. */
+        /** @deprecated Always 0 — there is no incomplete bucket. */
         incomplete: number;
     };
     axeResults?: unknown;
@@ -205,6 +210,12 @@ declare const VIEWPORT_SIZES: Record<ViewportPreset, {
 }>;
 interface ScanOptions {
     wcagTags?: string[];
+    /**
+     * Highest WCAG conformance level to report. Default 'AA': findings whose
+     * criteria are all Level AAA are not reported anywhere (issues, incomplete,
+     * summary). 'AAA' opts in (and adds axe's wcag2aaa rules); 'A' keeps Level A only.
+     */
+    level?: WcagLevel;
     includeAxe?: boolean;
     deep?: boolean;
     deepApiUrl?: string;
@@ -243,4 +254,4 @@ interface ScanOptions {
     mainStatus?: number;
 }
 
-export { type BrowserDetector as B, type DetectedIssue as D, type FixDetector as F, type IssueImpact as I, type PageLike as P, type ScanResult as S, VIEWPORT_SIZES as V, WCAG_BY_ISSUE as W, type ScanOptions as a, type SiteTheme as b, type ScanIssue as c, type FixIssueType as d, type IssueSource as e, type ViewportPreset as f, type WcagLevel as g };
+export { type BrowserDetector as B, type DetectedIssue as D, type FixDetector as F, type IssueImpact as I, type PageLike as P, type ScanResult as S, VIEWPORT_SIZES as V, type WcagLevel as W, type ScanOptions as a, type SiteTheme as b, type ScanIssue as c, type FixIssueType as d, type IssueSource as e, type ViewportPreset as f, WCAG_BY_ISSUE as g };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@webability/core",
-  "version": "1.4.0",
-  "description": "Accessibility scanner engine — WCAG 2.2 AA/AAA compliance testing with 200+ rules",
+  "version": "1.6.0",
+  "description": "Accessibility scanner engine \u2014 WCAG 2.2 AA compliance testing with 200+ rules",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -27,6 +27,15 @@
     "dist",
     "NOTICES.md"
   ],
+  "scripts": {
+    "build": "npm run gen:dom-kernel && tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "gen:dom-kernel": "node scripts/gen-dom-kernel.mjs"
+  },
   "keywords": [
     "a11y",
     "abilyo",
@@ -67,14 +76,5 @@
   "engines": {
     "node": ">=18"
   },
-  "homepage": "https://abilyo.com",
-  "scripts": {
-    "build": "npm run gen:dom-kernel && tsup",
-    "dev": "tsup --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "gen:dom-kernel": "node scripts/gen-dom-kernel.mjs"
-  }
-}
+  "homepage": "https://webability.io"
+}