From a910144009d643ea352e71f0afc5e8a3af990e7b Mon Sep 17 00:00:00 2001
From: Siddharth Kshetrapal <siddharthkp@github.com>
Date: Fri, 17 Jul 2026 14:29:00 +0200
Subject: [PATCH] CounterLabel, StateLabel: sync docs.json with deprecated
 props

Mark CounterLabel scheme and StateLabel variant as deprecated and document their replacements (variant, size)
---
 packages/react/src/CounterLabel/CounterLabel.docs.json | 9 ++++++++-
 packages/react/src/StateLabel/StateLabel.docs.json     | 9 ++++++++-
 2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/packages/react/src/CounterLabel/CounterLabel.docs.json b/packages/react/src/CounterLabel/CounterLabel.docs.json
index 74f7e60a7fe..2a54c90331c 100644
--- a/packages/react/src/CounterLabel/CounterLabel.docs.json
+++ b/packages/react/src/CounterLabel/CounterLabel.docs.json
@@ -16,11 +16,18 @@
   ],
   "importPath": "@primer/react",
   "props": [
+    {
+      "name": "variant",
+      "type": "'primary' | 'secondary'",
+      "defaultValue": "",
+      "description": "Pass in 'primary' for a darker background and inverse text, or 'secondary' for a lighter background and primary text. Omitting the variant prop renders the default counter scheme"
+    },
     {
       "name": "scheme",
       "type": "'primary' | 'secondary'",
       "defaultValue": "",
-      "description": "Pass in 'primary' for a darker background and inverse text, or 'secondary' for a lighter background and primary text. Omitting the scheme prop renders the default counter scheme"
+      "description": "Use `variant` instead.",
+      "deprecated": true
     },
     {
       "name": "className",
diff --git a/packages/react/src/StateLabel/StateLabel.docs.json b/packages/react/src/StateLabel/StateLabel.docs.json
index 49d61f1b4ae..8dfacd7efab 100644
--- a/packages/react/src/StateLabel/StateLabel.docs.json
+++ b/packages/react/src/StateLabel/StateLabel.docs.json
@@ -64,10 +64,17 @@
   ],
   "importPath": "@primer/react",
   "props": [
+    {
+      "name": "size",
+      "type": "'small' | 'medium'",
+      "defaultValue": "'medium'"
+    },
     {
       "name": "variant",
       "type": "'small' | 'normal'",
-      "defaultValue": "'normal'"
+      "defaultValue": "'normal'",
+      "description": "Use `size` instead.",
+      "deprecated": true
     },
     {
       "name": "status",