@designesy/score 0.7.1 → 0.7.2

package/dist/engine.d.ts

@@ -159,7 +159,7 @@ export declare function scoreFromParts(input: ScorePartsInput): Promise<ScoreRes
  * the site served v0.4.3; test/engine-1-2-0.test.mjs now reads the site's
  * contract source and fails when the two differ.
  */
-export declare const CONTRACT_VERSION = "v0.4.3";
+export declare const CONTRACT_VERSION = "v0.4.4";
 /**
  * The one verdict rule, shared by every emission format.
  *

package/dist/engine.js

@@ -500,12 +500,32 @@ function checkPaperToken(tokens) {
     return { id: 'v01', item: 'Token values match live site :root foundation', category: 'tokens', status: 'FAIL', detail: '--paper background token not declared in :root' };
 }
 function checkContrastSignal(tokens) {
-    // v22 — REAL WCAG 2.1 contrast between --signal (button fill) and the text
-    // on top of it. Contracts typically put --paper or --ink text on --signal.
-    // We test both --paper-on-signal and --ink-on-signal; the better ratio wins
-    // (designers choose the higher-contrast pairing). AA threshold: 4.5:1 for
-    // body text, 3:1 for large/UI — buttons are large text, but we hold the 4.5:1
-    // bar because button labels are often small (12-14px).
+    // v22 — REAL WCAG 2.1 contrast between the primary button's fill and its
+    // label. AA threshold: 4.5:1 for body text, 3:1 for large/UI — buttons are
+    // large text, but we hold the 4.5:1 bar because button labels are often
+    // small (12-14px).
+    //
+    // A contract that names its primary action pair (--action, the fill, and
+    // --on-action, the label) is measured on exactly that pair: it is what the
+    // button paints, so a better-contrast token elsewhere cannot stand in for a
+    // label that fails. Without both tokens the check reads the convention most
+    // contracts use: --paper or --ink text on --signal, the better ratio winning
+    // (designers choose the higher-contrast pairing).
+    const actionVal = tokens['--action'];
+    const onActionVal = tokens['--on-action'];
+    if (actionVal && onActionVal) {
+        const fillRgb = resolveColor(actionVal, tokens);
+        const labelRgb = resolveColor(onActionVal, tokens);
+        if (!fillRgb || !labelRgb)
+            return { id: 'v22', item: 'Primary button text passes WCAG AA contrast against --signal fill', category: 'accessibility', status: 'SKIP', detail: `--action ${actionVal} or --on-action ${onActionVal} unresolvable to RGB` };
+        const pairRatio = contrastRatio(labelRgb, fillRgb);
+        const pairStr = `${pairRatio.toFixed(2)}:1`;
+        if (pairRatio >= 4.5)
+            return { id: 'v22', item: 'Primary button text passes WCAG AA contrast against --signal fill', category: 'accessibility', status: 'PASS', detail: `--on-action on --action = ${pairStr} (≥ 4.5:1 AA)` };
+        if (pairRatio >= 3)
+            return { id: 'v22', item: 'Primary button text passes WCAG AA contrast against --signal fill', category: 'accessibility', status: 'WARN', detail: `--on-action on --action = ${pairStr} (passes 3:1 large-text, fails 4.5:1 body)` };
+        return { id: 'v22', item: 'Primary button text passes WCAG AA contrast against --signal fill', category: 'accessibility', status: 'FAIL', detail: `--on-action on --action = ${pairStr} (below 3:1, illegible)` };
+    }
     const signalVal = tokens['--signal'];
     if (!signalVal)
         return { id: 'v22', item: 'Primary button text passes WCAG AA contrast against --signal fill', category: 'accessibility', status: 'WARN', detail: '--signal accent token not declared' };
@@ -4586,7 +4606,7 @@ export async function scoreFromParts(input) {
  * the site served v0.4.3; test/engine-1-2-0.test.mjs now reads the site's
  * contract source and fails when the two differ.
  */
-export const CONTRACT_VERSION = 'v0.4.3';
+export const CONTRACT_VERSION = 'v0.4.4';
 /**
  * The one verdict rule, shared by every emission format.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@designesy/score",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Standalone 44-check design-contract scoring engine: fetches a URL, extracts CSS + tokens, and runs all checks locally. No required dependencies.",
   "license": "MIT",
   "author": "Designesy <hello@designesy.org>",