@webability/core 1.18.0 → 1.19.1

package/dist/{types-Bk-B2Y9X.d.cts → types-B_q8lTmv.d.cts}

@@ -28,6 +28,14 @@ interface PixelVerdict {
     bestRatio: number;
     /** Worst (lowest) contrast ratio found anywhere behind the text. */
     worstRatio: number;
+    /** Glyph-core measurement (text over an image or gradient): min, 2nd/5th/50th percentile, share of glyph pixels below the threshold. */
+    glyph?: {
+        min: number;
+        p02: number;
+        p05: number;
+        p50: number;
+        fractionBelow: number;
+    };
     /** The background pixel behind the text that gave `worstRatio`, as rgb(r,g,b). */
     worstBg?: string;
     /** The background pixel behind the text that gave `bestRatio`, as rgb(r,g,b). */
@@ -62,13 +70,14 @@ interface PixelVerdict {
  * verdict states a ratio the scanner measured, not one the model guessed.
  *
  * Models (local, via an OpenAI-compatible chat endpoint — OpenRouter by
- * default): vision `anthropic/claude-haiku-4.5`, text-only
+ * default): vision `qwen/qwen3.6-35b-a3b` (open weights), text-only
  * `deepseek/deepseek-v4-flash`. Hosted: POST `${apiUrl}/api/judge-incomplete`.
  */
 
 declare const JUDGE_DEFAULT_TIMEOUT_MS = 20000;
 declare const DEFAULT_JUDGE_BASE_URL = "https://openrouter.ai/api/v1";
-declare const DEFAULT_JUDGE_VISION_MODEL = "anthropic/claude-haiku-4.5";
+/** Open-weights vision model first (standing rule); Anthropic only when WEBABILITY_JUDGE_VISION_MODEL names it. */
+declare const DEFAULT_JUDGE_VISION_MODEL = "qwen/qwen3.6-35b-a3b";
 declare const DEFAULT_JUDGE_TEXT_MODEL = "deepseek/deepseek-v4-flash";
 type JudgeVerdictKind = 'pass' | 'violation';
 /** One judged finding, as recorded on `ScanResult.judged`. Small on purpose. */
@@ -97,6 +106,23 @@ interface JudgeRequest {
     level: WcagLevel;
     vision: boolean;
     items: JudgeItem[];
+    /**
+     * Rubric requests only (src/rubrics): the rubric's own system prompt and
+     * page-level evidence shared by every item. Undecided-finding batches leave
+     * both unset and get JUDGE_SYSTEM_PROMPT. The hosted endpoint ignores them.
+     */
+    system?: string;
+    page?: Record<string, unknown>;
+    /**
+     * Rubric requests only: which rubric this is and a hash of its prompt. The
+     * hosted transport sends this INSTEAD of `system`: the platform resolves the
+     * prompt from its own @webability/core and refuses a hash it does not have,
+     * so a client never chooses the prompt the paid model runs.
+     */
+    rubric?: {
+        id: string;
+        hash: string;
+    };
 }
 interface JudgeVerdict {
     id: string;
@@ -139,6 +165,11 @@ interface JudgeOptions {
      * the hosted path (the endpoint answers 413 above it, PNG only), none elsewhere.
      */
     maxCropChars?: number;
+    /**
+     * Opt-in rubric aspects (status: below-bar) to run as well as the default
+     * ones, by rubric id, e.g. ['heading-descriptive'].
+     */
+    rubrics?: string[];
 }
 interface JudgeRunOptions extends JudgeOptions {
     url: string;
@@ -172,6 +203,9 @@ interface JudgeChatBody {
  * text model. `disableTextModelReasoning`: the default text model reasons unless
  * told not to, and on a real 30-item batch spent all 4096 tokens reasoning (no
  * verdicts, 48 s); set it only for endpoints that accept the `reasoning` field.
+ * A rubric request (`req.system`) asks whichever model it uses not to reason:
+ * one bounded call per aspect batch, and a reasoning flash model spends ~30x
+ * the tokens of its answer on a one-line verdict.
  */
 declare function buildJudgeChatBody(req: JudgeRequest, cfg?: {
     visionModel?: string;
@@ -226,7 +260,7 @@ interface PageLike {
     axePage?(): unknown;
 }
 /** All fix issue types the pipeline can detect and fix. */
-type FixIssueType = 'weak_link_name' | 'weak_heading' | 'weak_iframe_title' | 'weak_page_title' | 'weak_svg_name' | 'missing_button_role' | 'missing_semantic_role' | 'missing_document_language' | 'svg_missing_name' | 'aria_hidden_focusable' | 'contrast_insufficient' | 'non_text_contrast_insufficient' | 'focus_not_visible' | 'empty_link' | 'unlabeled_button' | 'missing_label' | 'skip_link' | 'aria_live' | 'missing_alt' | 'identify_input_purpose' | 'redundant_role' | 'new_window_link' | 'missing_fieldset_legend' | 'missing_table_header' | 'missing_table_caption' | 'missing_table_scope' | 'external_link_warning' | 'download_link_warning' | 'form_missing_submit' | 'placeholder_link' | 'missing_autocomplete' | 'missing_media_controls' | 'unsafe_autoplay' | 'zoom_restriction' | 'resize_text_clipped' | 'link_consistency' | 'keyboard_trap' | 'keyboard_trap_self_focus' | 'focus_order_disruption' | 'missing_captions' | 'color_only_link' | 'label_in_name' | 'onfocus_context_change' | 'focus_obscured_by_sticky' | 'text_spacing_blocked' | 'motion_uncontrollable' | 'auto_refresh' | 'motion_without_reduced_motion' | 'flashing_content' | 'animated_gif_no_pause' | 'carousel_autoplay_no_pause' | 'missing_required_indicator' | 'background_image_unlabeled' | 'broken_aria_reference' | 'main_content_hidden' | 'meaningful_sequence' | 'sensory_characteristic' | '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' | 'inconsistent_navigation' | 'adjacent_redundant_link' | 'missing_button_type' | 'decorative_image_with_title' | 'nested_landmark';
+type FixIssueType = 'weak_link_name' | 'weak_heading' | 'weak_iframe_title' | 'weak_page_title' | 'weak_svg_name' | 'missing_button_role' | 'missing_semantic_role' | 'missing_document_language' | 'svg_missing_name' | 'aria_hidden_focusable' | 'contrast_insufficient' | 'non_text_contrast_insufficient' | 'focus_not_visible' | 'empty_link' | 'unlabeled_button' | 'missing_label' | 'skip_link' | 'aria_live' | 'missing_alt' | 'identify_input_purpose' | 'redundant_role' | 'new_window_link' | 'missing_fieldset_legend' | 'missing_table_header' | 'missing_table_caption' | 'missing_table_scope' | 'external_link_warning' | 'download_link_warning' | 'form_missing_submit' | 'placeholder_link' | 'missing_autocomplete' | 'missing_media_controls' | 'unsafe_autoplay' | 'zoom_restriction' | 'resize_text_clipped' | 'link_consistency' | 'keyboard_trap' | 'keyboard_trap_self_focus' | 'focus_order_disruption' | 'missing_captions' | 'color_only_link' | 'label_in_name' | 'onfocus_context_change' | 'focus_obscured_by_sticky' | 'text_spacing_blocked' | 'motion_uncontrollable' | 'auto_refresh' | 'motion_without_reduced_motion' | 'flashing_content' | 'animated_gif_no_pause' | 'carousel_autoplay_no_pause' | 'missing_required_indicator' | 'background_image_unlabeled' | 'broken_aria_reference' | 'main_content_hidden' | 'meaningful_sequence' | 'sensory_characteristic' | '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' | 'inconsistent_navigation' | 'image_name_not_descriptive' | 'hidden_image_not_decorative' | 'weak_form_label' | 'page_language_mismatch' | 'element_language_mismatch' | 'error_message_not_descriptive' | 'iframe_same_name_different_content' | 'identical_links_different_purpose' | 'auto_update_no_pause' | 'adjacent_redundant_link' | 'missing_button_type' | 'decorative_image_with_title' | 'nested_landmark';
 /** WCAG criterion for each issue type. */
 declare const WCAG_BY_ISSUE: Record<FixIssueType, string>;
 /** A single accessibility issue detected on the page. */
@@ -265,6 +299,12 @@ interface DetectedIssue {
     manualFix?: boolean;
     /** Why this finding needs review — surfaced to MCP/SDK consumers. */
     reviewReason?: string;
+    /**
+     * Measurements the detector took for an uncertain verdict (effective
+     * opacity, font weights, a ratio, a frame origin). Handed to the judge as
+     * context with the row; never a verdict by itself.
+     */
+    evidence?: Record<string, unknown>;
     /**
      * State pseudo-class the fix applies in (`:focus-visible` for
      * focus_not_visible). `selector` always names the element at rest; a
@@ -340,6 +380,8 @@ interface ScanIssue {
     confidence?: IssueConfidence;
     /** Internal: why the engine could not decide; handed to the judge as context, never reported. */
     reviewReason?: string;
+    /** Internal: the detector's measurements for the judge; never reported. */
+    evidence?: Record<string, unknown>;
     fix?: {
         attribute: string;
         currentValue: string;
@@ -548,4 +590,4 @@ interface ScanOptions {
     judge?: JudgeOptions;
 }
 
-export { type BrowserDetector as B, type DetectedIssue as D, type FixDetector as F, type InternalBug as I, JUDGE_DEFAULT_TIMEOUT_MS as J, type PageLike as P, type ScanOptions as S, VIEWPORT_SIZES as V, type WcagLevel as W, type ScanResult as a, type SiteTheme as b, type ScanIssue as c, DEFAULT_JUDGE_BASE_URL as d, DEFAULT_JUDGE_TEXT_MODEL as e, DEFAULT_JUDGE_VISION_MODEL as f, type FixIssueType as g, type IssueImpact as h, type IssueSource as i, JUDGE_SYSTEM_PROMPT as j, type JudgeChatBody as k, type JudgeItem as l, type JudgeOptions as m, type JudgeRequest as n, type JudgeTransport as o, type JudgeVerdict as p, type JudgedEntry as q, type ViewportPreset as r, WCAG_BY_ISSUE as s, buildJudgeChatBody as t, hostedJudgeTransport as u, judgeUndecided as v, openAiCompatibleTransport as w, resetJudgeCache as x };
+export { type BrowserDetector as B, type DetectedIssue as D, type FixDetector as F, type IssueImpact as I, type JudgeOptions as J, type PageLike as P, type ScanOptions as S, VIEWPORT_SIZES as V, type WcagLevel as W, type ScanResult as a, type ScanIssue as b, type InternalBug as c, type JudgeTransport as d, type SiteTheme as e, DEFAULT_JUDGE_BASE_URL as f, DEFAULT_JUDGE_TEXT_MODEL as g, DEFAULT_JUDGE_VISION_MODEL as h, type FixIssueType as i, type IssueSource as j, JUDGE_DEFAULT_TIMEOUT_MS as k, JUDGE_SYSTEM_PROMPT as l, type JudgeChatBody as m, type JudgeItem as n, type JudgeRequest as o, type JudgeVerdict as p, type JudgedEntry as q, type ViewportPreset as r, WCAG_BY_ISSUE as s, buildJudgeChatBody as t, hostedJudgeTransport as u, judgeUndecided as v, openAiCompatibleTransport as w, resetJudgeCache as x };

package/dist/{types-Bk-B2Y9X.d.ts → types-B_q8lTmv.d.ts}

@@ -28,6 +28,14 @@ interface PixelVerdict {
     bestRatio: number;
     /** Worst (lowest) contrast ratio found anywhere behind the text. */
     worstRatio: number;
+    /** Glyph-core measurement (text over an image or gradient): min, 2nd/5th/50th percentile, share of glyph pixels below the threshold. */
+    glyph?: {
+        min: number;
+        p02: number;
+        p05: number;
+        p50: number;
+        fractionBelow: number;
+    };
     /** The background pixel behind the text that gave `worstRatio`, as rgb(r,g,b). */
     worstBg?: string;
     /** The background pixel behind the text that gave `bestRatio`, as rgb(r,g,b). */
@@ -62,13 +70,14 @@ interface PixelVerdict {
  * verdict states a ratio the scanner measured, not one the model guessed.
  *
  * Models (local, via an OpenAI-compatible chat endpoint — OpenRouter by
- * default): vision `anthropic/claude-haiku-4.5`, text-only
+ * default): vision `qwen/qwen3.6-35b-a3b` (open weights), text-only
  * `deepseek/deepseek-v4-flash`. Hosted: POST `${apiUrl}/api/judge-incomplete`.
  */
 
 declare const JUDGE_DEFAULT_TIMEOUT_MS = 20000;
 declare const DEFAULT_JUDGE_BASE_URL = "https://openrouter.ai/api/v1";
-declare const DEFAULT_JUDGE_VISION_MODEL = "anthropic/claude-haiku-4.5";
+/** Open-weights vision model first (standing rule); Anthropic only when WEBABILITY_JUDGE_VISION_MODEL names it. */
+declare const DEFAULT_JUDGE_VISION_MODEL = "qwen/qwen3.6-35b-a3b";
 declare const DEFAULT_JUDGE_TEXT_MODEL = "deepseek/deepseek-v4-flash";
 type JudgeVerdictKind = 'pass' | 'violation';
 /** One judged finding, as recorded on `ScanResult.judged`. Small on purpose. */
@@ -97,6 +106,23 @@ interface JudgeRequest {
     level: WcagLevel;
     vision: boolean;
     items: JudgeItem[];
+    /**
+     * Rubric requests only (src/rubrics): the rubric's own system prompt and
+     * page-level evidence shared by every item. Undecided-finding batches leave
+     * both unset and get JUDGE_SYSTEM_PROMPT. The hosted endpoint ignores them.
+     */
+    system?: string;
+    page?: Record<string, unknown>;
+    /**
+     * Rubric requests only: which rubric this is and a hash of its prompt. The
+     * hosted transport sends this INSTEAD of `system`: the platform resolves the
+     * prompt from its own @webability/core and refuses a hash it does not have,
+     * so a client never chooses the prompt the paid model runs.
+     */
+    rubric?: {
+        id: string;
+        hash: string;
+    };
 }
 interface JudgeVerdict {
     id: string;
@@ -139,6 +165,11 @@ interface JudgeOptions {
      * the hosted path (the endpoint answers 413 above it, PNG only), none elsewhere.
      */
     maxCropChars?: number;
+    /**
+     * Opt-in rubric aspects (status: below-bar) to run as well as the default
+     * ones, by rubric id, e.g. ['heading-descriptive'].
+     */
+    rubrics?: string[];
 }
 interface JudgeRunOptions extends JudgeOptions {
     url: string;
@@ -172,6 +203,9 @@ interface JudgeChatBody {
  * text model. `disableTextModelReasoning`: the default text model reasons unless
  * told not to, and on a real 30-item batch spent all 4096 tokens reasoning (no
  * verdicts, 48 s); set it only for endpoints that accept the `reasoning` field.
+ * A rubric request (`req.system`) asks whichever model it uses not to reason:
+ * one bounded call per aspect batch, and a reasoning flash model spends ~30x
+ * the tokens of its answer on a one-line verdict.
  */
 declare function buildJudgeChatBody(req: JudgeRequest, cfg?: {
     visionModel?: string;
@@ -226,7 +260,7 @@ interface PageLike {
     axePage?(): unknown;
 }
 /** All fix issue types the pipeline can detect and fix. */
-type FixIssueType = 'weak_link_name' | 'weak_heading' | 'weak_iframe_title' | 'weak_page_title' | 'weak_svg_name' | 'missing_button_role' | 'missing_semantic_role' | 'missing_document_language' | 'svg_missing_name' | 'aria_hidden_focusable' | 'contrast_insufficient' | 'non_text_contrast_insufficient' | 'focus_not_visible' | 'empty_link' | 'unlabeled_button' | 'missing_label' | 'skip_link' | 'aria_live' | 'missing_alt' | 'identify_input_purpose' | 'redundant_role' | 'new_window_link' | 'missing_fieldset_legend' | 'missing_table_header' | 'missing_table_caption' | 'missing_table_scope' | 'external_link_warning' | 'download_link_warning' | 'form_missing_submit' | 'placeholder_link' | 'missing_autocomplete' | 'missing_media_controls' | 'unsafe_autoplay' | 'zoom_restriction' | 'resize_text_clipped' | 'link_consistency' | 'keyboard_trap' | 'keyboard_trap_self_focus' | 'focus_order_disruption' | 'missing_captions' | 'color_only_link' | 'label_in_name' | 'onfocus_context_change' | 'focus_obscured_by_sticky' | 'text_spacing_blocked' | 'motion_uncontrollable' | 'auto_refresh' | 'motion_without_reduced_motion' | 'flashing_content' | 'animated_gif_no_pause' | 'carousel_autoplay_no_pause' | 'missing_required_indicator' | 'background_image_unlabeled' | 'broken_aria_reference' | 'main_content_hidden' | 'meaningful_sequence' | 'sensory_characteristic' | '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' | 'inconsistent_navigation' | 'adjacent_redundant_link' | 'missing_button_type' | 'decorative_image_with_title' | 'nested_landmark';
+type FixIssueType = 'weak_link_name' | 'weak_heading' | 'weak_iframe_title' | 'weak_page_title' | 'weak_svg_name' | 'missing_button_role' | 'missing_semantic_role' | 'missing_document_language' | 'svg_missing_name' | 'aria_hidden_focusable' | 'contrast_insufficient' | 'non_text_contrast_insufficient' | 'focus_not_visible' | 'empty_link' | 'unlabeled_button' | 'missing_label' | 'skip_link' | 'aria_live' | 'missing_alt' | 'identify_input_purpose' | 'redundant_role' | 'new_window_link' | 'missing_fieldset_legend' | 'missing_table_header' | 'missing_table_caption' | 'missing_table_scope' | 'external_link_warning' | 'download_link_warning' | 'form_missing_submit' | 'placeholder_link' | 'missing_autocomplete' | 'missing_media_controls' | 'unsafe_autoplay' | 'zoom_restriction' | 'resize_text_clipped' | 'link_consistency' | 'keyboard_trap' | 'keyboard_trap_self_focus' | 'focus_order_disruption' | 'missing_captions' | 'color_only_link' | 'label_in_name' | 'onfocus_context_change' | 'focus_obscured_by_sticky' | 'text_spacing_blocked' | 'motion_uncontrollable' | 'auto_refresh' | 'motion_without_reduced_motion' | 'flashing_content' | 'animated_gif_no_pause' | 'carousel_autoplay_no_pause' | 'missing_required_indicator' | 'background_image_unlabeled' | 'broken_aria_reference' | 'main_content_hidden' | 'meaningful_sequence' | 'sensory_characteristic' | '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' | 'inconsistent_navigation' | 'image_name_not_descriptive' | 'hidden_image_not_decorative' | 'weak_form_label' | 'page_language_mismatch' | 'element_language_mismatch' | 'error_message_not_descriptive' | 'iframe_same_name_different_content' | 'identical_links_different_purpose' | 'auto_update_no_pause' | 'adjacent_redundant_link' | 'missing_button_type' | 'decorative_image_with_title' | 'nested_landmark';
 /** WCAG criterion for each issue type. */
 declare const WCAG_BY_ISSUE: Record<FixIssueType, string>;
 /** A single accessibility issue detected on the page. */
@@ -265,6 +299,12 @@ interface DetectedIssue {
     manualFix?: boolean;
     /** Why this finding needs review — surfaced to MCP/SDK consumers. */
     reviewReason?: string;
+    /**
+     * Measurements the detector took for an uncertain verdict (effective
+     * opacity, font weights, a ratio, a frame origin). Handed to the judge as
+     * context with the row; never a verdict by itself.
+     */
+    evidence?: Record<string, unknown>;
     /**
      * State pseudo-class the fix applies in (`:focus-visible` for
      * focus_not_visible). `selector` always names the element at rest; a
@@ -340,6 +380,8 @@ interface ScanIssue {
     confidence?: IssueConfidence;
     /** Internal: why the engine could not decide; handed to the judge as context, never reported. */
     reviewReason?: string;
+    /** Internal: the detector's measurements for the judge; never reported. */
+    evidence?: Record<string, unknown>;
     fix?: {
         attribute: string;
         currentValue: string;
@@ -548,4 +590,4 @@ interface ScanOptions {
     judge?: JudgeOptions;
 }
 
-export { type BrowserDetector as B, type DetectedIssue as D, type FixDetector as F, type InternalBug as I, JUDGE_DEFAULT_TIMEOUT_MS as J, type PageLike as P, type ScanOptions as S, VIEWPORT_SIZES as V, type WcagLevel as W, type ScanResult as a, type SiteTheme as b, type ScanIssue as c, DEFAULT_JUDGE_BASE_URL as d, DEFAULT_JUDGE_TEXT_MODEL as e, DEFAULT_JUDGE_VISION_MODEL as f, type FixIssueType as g, type IssueImpact as h, type IssueSource as i, JUDGE_SYSTEM_PROMPT as j, type JudgeChatBody as k, type JudgeItem as l, type JudgeOptions as m, type JudgeRequest as n, type JudgeTransport as o, type JudgeVerdict as p, type JudgedEntry as q, type ViewportPreset as r, WCAG_BY_ISSUE as s, buildJudgeChatBody as t, hostedJudgeTransport as u, judgeUndecided as v, openAiCompatibleTransport as w, resetJudgeCache as x };
+export { type BrowserDetector as B, type DetectedIssue as D, type FixDetector as F, type IssueImpact as I, type JudgeOptions as J, type PageLike as P, type ScanOptions as S, VIEWPORT_SIZES as V, type WcagLevel as W, type ScanResult as a, type ScanIssue as b, type InternalBug as c, type JudgeTransport as d, type SiteTheme as e, DEFAULT_JUDGE_BASE_URL as f, DEFAULT_JUDGE_TEXT_MODEL as g, DEFAULT_JUDGE_VISION_MODEL as h, type FixIssueType as i, type IssueSource as j, JUDGE_DEFAULT_TIMEOUT_MS as k, JUDGE_SYSTEM_PROMPT as l, type JudgeChatBody as m, type JudgeItem as n, type JudgeRequest as o, type JudgeVerdict as p, type JudgedEntry as q, type ViewportPreset as r, WCAG_BY_ISSUE as s, buildJudgeChatBody as t, hostedJudgeTransport as u, judgeUndecided as v, openAiCompatibleTransport as w, resetJudgeCache as x };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webability/core",
-  "version": "1.18.0",
+  "version": "1.19.1",
   "description": "Accessibility scanner engine — WCAG 2.2 AA compliance testing with 200+ rules",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -40,13 +40,14 @@
     "NOTICES.md"
   ],
   "scripts": {
-    "build": "npm run gen:dom-kernel && tsup",
+    "build": "npm run gen:dom-kernel && npm run gen:rubrics && tsup",
     "dev": "tsup --watch",
     "test": "WA_STRICT_STATE=1 vitest run --testTimeout=20000",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist",
-    "gen:dom-kernel": "node scripts/gen-dom-kernel.mjs"
+    "gen:dom-kernel": "node scripts/gen-dom-kernel.mjs",
+    "gen:rubrics": "node scripts/gen-rubrics.mjs"
   },
   "keywords": [
     "a11y",