Merge branch 'production' into 2484-improvements-in-negative-containers

Author: aweell

.github/workflows/tokens-lint.yml

@@ -0,0 +1,32 @@
+name: Token Format Validation
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - production
+    paths:
+      - "tokens/*.json"
+
+jobs:
+  lint-tokens:
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        working-directory: tokens/linter
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run token format validation
+        run: npm run lint:tokens:format

tokens/linter/README.md

@@ -25,10 +25,12 @@ You'll be prompted to select which JSON file to validate.
 #### Option B: Pass a filename
 
 ```
-npm run linter my-tokens.json
+npm run linter my-tokens.json format
+npm run linter my-tokens.json contrast
 ```
 
-This runs the validation directly on a specific file inside tokens/.
+- format mode: checks description ↔ palette reference matches and invalid palette references, without skipping colors with alpha (rgba).
+- contrast mode: checks foreground/background pairs for WCAG contrast compliance, skipping gradients and alpha colors. Description mismatches are not shown.
 
 #### Option C: Validate contrast for a specific token