@primer/primitives 11.4.0 → 11.4.1-rc.24c79953

package/dist/styleLint/functional/themes/dark-dimmed.json

@@ -167,7 +167,7 @@
   },
   "avatar-shadow": {
     "key": "{avatar.shadow}",
-    "$value": "0px 0px 0px 2px #0d1117",
+    "$value": "0 0 0 2px #0d1117",
     "$type": "shadow",
     "$extensions": {
       "org.primer.figma": {
@@ -180,10 +180,22 @@
             {
               "color": "#0d1117",
               "alpha": 1,
-              "offsetX": "0px",
-              "offsetY": "0px",
-              "blur": "0px",
-              "spread": "2px"
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 0,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 0,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 2,
+                "unit": "px"
+              }
             }
           ],
           "filePath": "src/tokens/component/avatar.json5",
@@ -199,10 +211,22 @@
         {
           "color": "{base.color.neutral.1}",
           "alpha": 1,
-          "offsetX": "0px",
-          "offsetY": "0px",
-          "blur": "0px",
-          "spread": "2px"
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 0,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 0,
+            "unit": "px"
+          },
+          "spread": {
+            "value": 2,
+            "unit": "px"
+          }
         }
       ],
       "$type": "shadow",
@@ -217,10 +241,22 @@
               {
                 "color": "{base.color.neutral.1}",
                 "alpha": 1,
-                "offsetX": "0px",
-                "offsetY": "0px",
-                "blur": "0px",
-                "spread": "2px"
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 2,
+                  "unit": "px"
+                }
               }
             ],
             "filePath": "src/tokens/component/avatar.json5",
@@ -552,6 +588,10 @@
       },
       "org.primer.overrides": {
         "dark": "#010409"
+      },
+      "org.primer.llm": {
+        "doNotUse": true,
+        "rules": "Avoid using raw black. Use semantic alternatives: bgColor.emphasis for dark backgrounds, bgColor.inverse for inverted contexts. Raw black/white ignore theme preferences and accessibility settings."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -568,6 +608,10 @@
         },
         "org.primer.overrides": {
           "dark": "{base.color.neutral.0}"
+        },
+        "org.primer.llm": {
+          "doNotUse": true,
+          "rules": "Avoid using raw black. Use semantic alternatives: bgColor.emphasis for dark backgrounds, bgColor.inverse for inverted contexts. Raw black/white ignore theme preferences and accessibility settings."
         }
       },
       "key": "{bgColor.black}"
@@ -2454,6 +2498,10 @@
       },
       "org.primer.overrides": {
         "dark": "#cdd9e5"
+      },
+      "org.primer.llm": {
+        "doNotUse": true,
+        "rules": "Avoid using raw white. Use semantic alternatives: bgColor.default for standard backgrounds, bgColor.inset for recessed areas, or bgColor.inverse for inverted contexts. Raw black/white ignore theme preferences and accessibility settings."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -2470,6 +2518,10 @@
         },
         "org.primer.overrides": {
           "dark": "{base.color.neutral.13}"
+        },
+        "org.primer.llm": {
+          "doNotUse": true,
+          "rules": "Avoid using raw white. Use semantic alternatives: bgColor.default for standard backgrounds, bgColor.inset for recessed areas, or bgColor.inverse for inverted contexts. Raw black/white ignore theme preferences and accessibility settings."
         }
       },
       "key": "{bgColor.white}"
@@ -2480,7 +2532,11 @@
   },
   "border-accent-emphasis": {
     "key": "{border.accent.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #316dca",
+    "$value": {
+      "color": "#316dca",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2499,7 +2555,11 @@
   },
   "border-accent-muted": {
     "key": "{border.accent.muted}",
-    "$value": "0.00390625rem,0.0625px solid #4184e466",
+    "$value": {
+      "color": "#4184e466",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2518,7 +2578,11 @@
   },
   "border-attention-emphasis": {
     "key": "{border.attention.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #966600",
+    "$value": {
+      "color": "#966600",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2537,7 +2601,11 @@
   },
   "border-attention-muted": {
     "key": "{border.attention.muted}",
-    "$value": "0.00390625rem,0.0625px solid #ae7c1466",
+    "$value": {
+      "color": "#ae7c1466",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2556,7 +2624,11 @@
   },
   "border-closed-emphasis": {
     "key": "{border.closed.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #c93c37",
+    "$value": {
+      "color": "#c93c37",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2571,7 +2643,11 @@
   },
   "border-closed-muted": {
     "key": "{border.closed.muted}",
-    "$value": "0.00390625rem,0.0625px solid #e5534b66",
+    "$value": {
+      "color": "#e5534b66",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2586,7 +2662,11 @@
   },
   "border-danger-emphasis": {
     "key": "{border.danger.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #c93c37",
+    "$value": {
+      "color": "#c93c37",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2605,7 +2685,11 @@
   },
   "border-danger-muted": {
     "key": "{border.danger.muted}",
-    "$value": "0.00390625rem,0.0625px solid #e5534b66",
+    "$value": {
+      "color": "#e5534b66",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2624,7 +2708,11 @@
   },
   "border-default": {
     "key": "{border.default}",
-    "$value": "0.00390625rem,0.0625px solid #3d444d",
+    "$value": {
+      "color": "#3d444d",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2643,7 +2731,11 @@
   },
   "border-disabled": {
     "key": "{border.disabled}",
-    "$value": "0.00390625rem,0.0625px solid #656c761a",
+    "$value": {
+      "color": "#656c761a",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2662,7 +2754,11 @@
   },
   "border-done-emphasis": {
     "key": "{border.done.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #8256d0",
+    "$value": {
+      "color": "#8256d0",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2681,7 +2777,11 @@
   },
   "border-done-muted": {
     "key": "{border.done.muted}",
-    "$value": "0.00390625rem,0.0625px solid #986ee266",
+    "$value": {
+      "color": "#986ee266",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2700,7 +2800,11 @@
   },
   "border-emphasis": {
     "key": "{border.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #656c76",
+    "$value": {
+      "color": "#656c76",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2719,7 +2823,11 @@
   },
   "border-muted": {
     "key": "{border.muted}",
-    "$value": "0.00390625rem,0.0625px solid #3d444db3",
+    "$value": {
+      "color": "#3d444db3",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2738,7 +2846,11 @@
   },
   "border-neutral-emphasis": {
     "key": "{border.neutral.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #656c76",
+    "$value": {
+      "color": "#656c76",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2757,7 +2869,11 @@
   },
   "border-neutral-muted": {
     "key": "{border.neutral.muted}",
-    "$value": "0.00390625rem,0.0625px solid #3d444db3",
+    "$value": {
+      "color": "#3d444db3",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2776,7 +2892,11 @@
   },
   "border-open-emphasis": {
     "key": "{border.open.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #347d39",
+    "$value": {
+      "color": "#347d39",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2791,7 +2911,11 @@
   },
   "border-open-muted": {
     "key": "{border.open.muted}",
-    "$value": "0.00390625rem,0.0625px solid #46954a66",
+    "$value": {
+      "color": "#46954a66",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2806,7 +2930,11 @@
   },
   "border-severe-emphasis": {
     "key": "{border.severe.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #ae5622",
+    "$value": {
+      "color": "#ae5622",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2825,7 +2953,11 @@
   },
   "border-severe-muted": {
     "key": "{border.severe.muted}",
-    "$value": "0.00390625rem,0.0625px solid #cc6b2c66",
+    "$value": {
+      "color": "#cc6b2c66",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2844,7 +2976,11 @@
   },
   "border-sponsors-emphasis": {
     "key": "{border.sponsors.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #ae4c82",
+    "$value": {
+      "color": "#ae4c82",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2863,7 +2999,11 @@
   },
   "border-sponsors-muted": {
     "key": "{border.sponsors.muted}",
-    "$value": "0.00390625rem,0.0625px solid #c9619866",
+    "$value": {
+      "color": "#c9619866",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2882,7 +3022,11 @@
   },
   "border-success-emphasis": {
     "key": "{border.success.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #347d39",
+    "$value": {
+      "color": "#347d39",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2901,7 +3045,11 @@
   },
   "border-success-muted": {
     "key": "{border.success.muted}",
-    "$value": "0.00390625rem,0.0625px solid #46954a66",
+    "$value": {
+      "color": "#46954a66",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2920,7 +3068,11 @@
   },
   "border-transparent": {
     "key": "{border.transparent}",
-    "$value": "0.00390625rem,0.0625px solid #00000000",
+    "$value": {
+      "color": "#00000000",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2939,7 +3091,11 @@
   },
   "border-upsell-emphasis": {
     "key": "{border.upsell.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #8256d0",
+    "$value": {
+      "color": "#8256d0",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2958,7 +3114,11 @@
   },
   "border-upsell-muted": {
     "key": "{border.upsell.muted}",
-    "$value": "0.00390625rem,0.0625px solid #986ee266",
+    "$value": {
+      "color": "#986ee266",
+      "style": "solid",
+      "width": ["0.0625rem", "1px"]
+    },
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -6946,7 +7106,7 @@
   },
   "button-danger-shadow-selected": {
     "key": "{button.danger.shadow.selected}",
-    "$value": "0px 0px 0px 0px #000000",
+    "$value": "0 0 0 0 #000000",
     "$type": "shadow",
     "$extensions": {
       "org.primer.figma": {
@@ -6959,10 +7119,22 @@
             {
               "color": "#4d210c",
               "alpha": 0.2,
-              "offsetX": "0px",
-              "offsetY": "1px",
-              "blur": "0px",
-              "spread": "0px",
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 1,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 0,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 0,
+                "unit": "px"
+              },
               "inset": true
             }
           ],
@@ -6975,10 +7147,22 @@
             {
               "color": "#00000000",
               "alpha": 0,
-              "offsetX": "0px",
-              "offsetY": "0px",
-              "blur": "0px",
-              "spread": "0px",
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 0,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 0,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 0,
+                "unit": "px"
+              },
               "inset": false
             }
           ],
@@ -6995,10 +7179,22 @@
         {
           "color": "{base.color.transparent}",
           "alpha": 0,
-          "offsetX": "0px",
-          "offsetY": "0px",
-          "blur": "0px",
-          "spread": "0px",
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 0,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 0,
+            "unit": "px"
+          },
+          "spread": {
+            "value": 0,
+            "unit": "px"
+          },
           "inset": false
         }
       ],
@@ -7014,10 +7210,22 @@
               {
                 "color": "{base.color.orange.9}",
                 "alpha": 0.2,
-                "offsetX": "0px",
-                "offsetY": "1px",
-                "blur": "0px",
-                "spread": "0px",
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 1,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 0,
+                  "unit": "px"
+                },
                 "inset": true
               }
             ],
@@ -7030,10 +7238,22 @@
               {
                 "color": "{base.color.transparent}",
                 "alpha": 0,
-                "offsetX": "0px",
-                "offsetY": "0px",
-                "blur": "0px",
-                "spread": "0px",
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 0,
+                  "unit": "px"
+                },
                 "inset": false
               }
             ],
@@ -7409,7 +7629,7 @@
   },
   "button-default-shadow-resting": {
     "key": "{button.default.shadow.resting}",
-    "$value": "0px 0px 0px 0px #000000",
+    "$value": "0 0 0 0 #000000",
     "$type": "shadow",
     "$extensions": {
       "org.primer.figma": {
@@ -7422,10 +7642,22 @@
             {
               "color": "#00000000",
               "alpha": 0,
-              "offsetX": "0px",
-              "offsetY": "0px",
-              "blur": "0px",
-              "spread": "0px",
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 0,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 0,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 0,
+                "unit": "px"
+              },
               "inset": false
             }
           ],
@@ -7442,10 +7674,22 @@
         {
           "color": "{base.color.transparent}",
           "alpha": 0,
-          "offsetX": "0px",
-          "offsetY": "0px",
-          "blur": "0px",
-          "spread": "0px",
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 0,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 0,
+            "unit": "px"
+          },
+          "spread": {
+            "value": 0,
+            "unit": "px"
+          },
           "inset": false
         }
       ],
@@ -7461,10 +7705,22 @@
               {
                 "color": "{base.color.transparent}",
                 "alpha": 0,
-                "offsetX": "0px",
-                "offsetY": "0px",
-                "blur": "0px",
-                "spread": "0px",
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 0,
+                  "unit": "px"
+                },
                 "inset": false
               }
             ],
@@ -9168,7 +9424,7 @@
   },
   "button-outline-shadow-selected": {
     "key": "{button.outline.shadow.selected}",
-    "$value": "0px 0px 0px 0px #000000",
+    "$value": "0 0 0 0 #000000",
     "$type": "shadow",
     "$extensions": {
       "org.primer.figma": {
@@ -9181,10 +9437,22 @@
             {
               "color": "#00000000",
               "alpha": 0,
-              "offsetX": "0px",
-              "offsetY": "0px",
-              "blur": "0px",
-              "spread": "0px",
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 0,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 0,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 0,
+                "unit": "px"
+              },
               "inset": false
             }
           ],
@@ -9201,10 +9469,22 @@
         {
           "color": "{base.color.transparent}",
           "alpha": 0,
-          "offsetX": "0px",
-          "offsetY": "0px",
-          "blur": "0px",
-          "spread": "0px",
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 0,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 0,
+            "unit": "px"
+          },
+          "spread": {
+            "value": 0,
+            "unit": "px"
+          },
           "inset": false
         }
       ],
@@ -9220,10 +9500,22 @@
               {
                 "color": "{base.color.transparent}",
                 "alpha": 0,
-                "offsetX": "0px",
-                "offsetY": "0px",
-                "blur": "0px",
-                "spread": "0px",
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 0,
+                  "unit": "px"
+                },
                 "inset": false
               }
             ],
@@ -10374,7 +10666,7 @@
   },
   "button-primary-shadow-selected": {
     "key": "{button.primary.shadow.selected}",
-    "$value": "0px 0px 0px 0px #000000",
+    "$value": "0 0 0 0 #000000",
     "$type": "shadow",
     "$extensions": {
       "org.primer.figma": {
@@ -10387,10 +10679,22 @@
             {
               "color": "#0f2d5c",
               "alpha": 0.3,
-              "offsetX": "0px",
-              "offsetY": "1px",
-              "blur": "0px",
-              "spread": "0px",
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 1,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 0,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 0,
+                "unit": "px"
+              },
               "inset": true
             }
           ],
@@ -10403,10 +10707,22 @@
             {
               "color": "#0f2d5c",
               "alpha": 0.3,
-              "offsetX": "0px",
-              "offsetY": "1px",
-              "blur": "0px",
-              "spread": "0px",
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 1,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 0,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 0,
+                "unit": "px"
+              },
               "inset": true
             }
           ],
@@ -10419,10 +10735,22 @@
             {
               "color": "#00000000",
               "alpha": 0,
-              "offsetX": "0px",
-              "offsetY": "0px",
-              "blur": "0px",
-              "spread": "0px",
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 0,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 0,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 0,
+                "unit": "px"
+              },
               "inset": false
             }
           ],
@@ -10439,10 +10767,22 @@
         {
           "color": "{base.color.transparent}",
           "alpha": 0,
-          "offsetX": "0px",
-          "offsetY": "0px",
-          "blur": "0px",
-          "spread": "0px",
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 0,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 0,
+            "unit": "px"
+          },
+          "spread": {
+            "value": 0,
+            "unit": "px"
+          },
           "inset": false
         }
       ],
@@ -10458,10 +10798,22 @@
               {
                 "color": "{base.color.blue.9}",
                 "alpha": 0.3,
-                "offsetX": "0px",
-                "offsetY": "1px",
-                "blur": "0px",
-                "spread": "0px",
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 1,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 0,
+                  "unit": "px"
+                },
                 "inset": true
               }
             ],
@@ -10474,10 +10826,22 @@
               {
                 "color": "{base.color.blue.9}",
                 "alpha": 0.3,
-                "offsetX": "0px",
-                "offsetY": "1px",
-                "blur": "0px",
-                "spread": "0px",
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 1,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 0,
+                  "unit": "px"
+                },
                 "inset": true
               }
             ],
@@ -10490,10 +10854,22 @@
               {
                 "color": "{base.color.transparent}",
                 "alpha": 0,
-                "offsetX": "0px",
-                "offsetY": "0px",
-                "blur": "0px",
-                "spread": "0px",
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 0,
+                  "unit": "px"
+                },
                 "inset": false
               }
             ],
@@ -37246,6 +37622,10 @@
       },
       "org.primer.overrides": {
         "dark": "#010409"
+      },
+      "org.primer.llm": {
+        "doNotUse": true,
+        "rules": "Avoid using raw black. Use semantic alternatives: fgColor.default for standard text, fgColor.muted for secondary text. Raw black/white ignore theme preferences and accessibility settings."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -37262,6 +37642,10 @@
         },
         "org.primer.overrides": {
           "dark": "{base.color.neutral.0}"
+        },
+        "org.primer.llm": {
+          "doNotUse": true,
+          "rules": "Avoid using raw black. Use semantic alternatives: fgColor.default for standard text, fgColor.muted for secondary text. Raw black/white ignore theme preferences and accessibility settings."
         }
       },
       "key": "{fgColor.black}"
@@ -38235,6 +38619,10 @@
       },
       "org.primer.overrides": {
         "dark": "#cdd9e5"
+      },
+      "org.primer.llm": {
+        "doNotUse": true,
+        "rules": "Avoid using raw white. Use semantic alternatives: fgColor.onEmphasis for text on dark backgrounds, fgColor.onInverse for inverted contexts. Raw black/white ignore theme preferences and accessibility settings."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -38251,6 +38639,10 @@
         },
         "org.primer.overrides": {
           "dark": "{base.color.neutral.13}"
+        },
+        "org.primer.llm": {
+          "doNotUse": true,
+          "rules": "Avoid using raw white. Use semantic alternatives: fgColor.onEmphasis for text on dark backgrounds, fgColor.onInverse for inverted contexts. Raw black/white ignore theme preferences and accessibility settings."
         }
       },
       "key": "{fgColor.white}"
@@ -38276,7 +38668,10 @@
       "$value": {
         "color": "{focus.outlineColor}",
         "style": "solid",
-        "width": "2px"
+        "width": {
+          "value": 2,
+          "unit": "px"
+        }
       },
       "$type": "border",
       "$description": "Focus ring outline for keyboard navigation and accessibility.",
@@ -47435,7 +47830,7 @@
   },
   "shadow-floating-large": {
     "key": "{shadow.floating.large}",
-    "$value": "0px 0px 0px 1px #3d444d, 0px 24px 48px 0px #010409",
+    "$value": "0 0 0 1px #3d444d, 0 24px 48px 0 #010409",
     "$type": "shadow",
     "$description": "Large floating shadow for modals and dialogs",
     "$extensions": {
@@ -47449,18 +47844,42 @@
             {
               "color": "#3d444db3",
               "alpha": 1,
-              "offsetX": "0px",
-              "offsetY": "0px",
-              "blur": "0px",
-              "spread": "1px"
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 0,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 0,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 1,
+                "unit": "px"
+              }
             },
             {
               "color": "#010409",
               "alpha": 1,
-              "offsetX": "0px",
-              "offsetY": "24px",
-              "blur": "48px",
-              "spread": "0px"
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 24,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 48,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 0,
+                "unit": "px"
+              }
             }
           ],
           "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -47480,18 +47899,42 @@
         {
           "color": "{overlay.borderColor}",
           "alpha": 1,
-          "offsetX": "0px",
-          "offsetY": "0px",
-          "blur": "0px",
-          "spread": "1px"
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 0,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 0,
+            "unit": "px"
+          },
+          "spread": {
+            "value": 1,
+            "unit": "px"
+          }
         },
         {
           "color": "{base.color.neutral.0}",
           "alpha": 1,
-          "offsetX": "0px",
-          "offsetY": "24px",
-          "blur": "48px",
-          "spread": "0px"
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 24,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 48,
+            "unit": "px"
+          },
+          "spread": {
+            "value": 0,
+            "unit": "px"
+          }
         }
       ],
       "$type": "shadow",
@@ -47507,18 +47950,42 @@
               {
                 "color": "{overlay.borderColor}",
                 "alpha": 1,
-                "offsetX": "0px",
-                "offsetY": "0px",
-                "blur": "0px",
-                "spread": "1px"
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 1,
+                  "unit": "px"
+                }
               },
               {
                 "color": "{base.color.neutral.0}",
                 "alpha": 1,
-                "offsetX": "0px",
-                "offsetY": "24px",
-                "blur": "48px",
-                "spread": "0px"
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 24,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 48,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 0,
+                  "unit": "px"
+                }
               }
             ],
             "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -47539,8 +48006,9 @@
   },
   "shadow-floating-legacy": {
     "key": "{shadow.floating.legacy}",
-    "$value": "0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966",
+    "$value": "0 6px 12px -3px #01040966, 0 6px 18px 0 #01040966",
     "$type": "shadow",
+    "$description": "Legacy floating shadow for backward compatibility",
     "$extensions": {
       "org.primer.figma": {},
       "org.primer.overrides": {
@@ -47549,24 +48017,52 @@
             {
               "color": "#010409",
               "alpha": 0.4,
-              "offsetX": "0px",
-              "offsetY": "6px",
-              "blur": "12px",
-              "spread": "-3px"
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 6,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 12,
+                "unit": "px"
+              },
+              "spread": {
+                "value": -3,
+                "unit": "px"
+              }
             },
             {
               "color": "#010409",
               "alpha": 0.4,
-              "offsetX": "0px",
-              "offsetY": "6px",
-              "blur": "18px",
-              "spread": "0px"
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 6,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 18,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 0,
+                "unit": "px"
+              }
             }
           ],
           "filePath": "src/tokens/functional/shadow/shadow.json5",
           "isSource": true,
           "$type": "shadow"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["legacy-component", "backward-compatibility"],
+        "rules": "DEPRECATED: Use shadow-floating-small instead. Only use for maintaining backward compatibility with existing implementations."
       }
     },
     "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -47576,21 +48072,46 @@
         {
           "color": "{base.color.neutral.0}",
           "alpha": 0.4,
-          "offsetX": "0px",
-          "offsetY": "6px",
-          "blur": "12px",
-          "spread": "-3px"
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 6,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 12,
+            "unit": "px"
+          },
+          "spread": {
+            "value": -3,
+            "unit": "px"
+          }
         },
         {
           "color": "{base.color.neutral.0}",
           "alpha": 0.4,
-          "offsetX": "0px",
-          "offsetY": "6px",
-          "blur": "18px",
-          "spread": "0px"
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 6,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 18,
+            "unit": "px"
+          },
+          "spread": {
+            "value": 0,
+            "unit": "px"
+          }
         }
       ],
       "$type": "shadow",
+      "$description": "Legacy floating shadow for backward compatibility",
       "$extensions": {
         "org.primer.figma": {},
         "org.primer.overrides": {
@@ -47599,24 +48120,52 @@
               {
                 "color": "{base.color.neutral.0}",
                 "alpha": 0.4,
-                "offsetX": "0px",
-                "offsetY": "6px",
-                "blur": "12px",
-                "spread": "-3px"
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 6,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 12,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": -3,
+                  "unit": "px"
+                }
               },
               {
                 "color": "{base.color.neutral.0}",
                 "alpha": 0.4,
-                "offsetX": "0px",
-                "offsetY": "6px",
-                "blur": "18px",
-                "spread": "0px"
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 6,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 18,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 0,
+                  "unit": "px"
+                }
               }
             ],
             "filePath": "src/tokens/functional/shadow/shadow.json5",
             "isSource": true,
             "$type": "shadow"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["legacy-component", "backward-compatibility"],
+          "rules": "DEPRECATED: Use shadow-floating-small instead. Only use for maintaining backward compatibility with existing implementations."
         }
       },
       "key": "{shadow.floating.legacy}"
@@ -47627,8 +48176,9 @@
   },
   "shadow-floating-medium": {
     "key": "{shadow.floating.medium}",
-    "$value": "0px 0px 0px 1px #3d444d, 0px 8px 16px -4px #01040966, 0px 4px 32px -4px #01040966, 0px 24px 48px -12px #01040966, 0px 48px 96px -24px #01040966",
+    "$value": "0 0 0 1px #3d444d, 0 8px 16px -4px #01040966, 0 4px 32px -4px #01040966, 0 24px 48px -12px #01040966, 0 48px 96px -24px #01040966",
     "$type": "shadow",
+    "$description": "Medium floating shadow for popovers and action menus",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -47640,48 +48190,112 @@
             {
               "color": "#3d444db3",
               "alpha": 1,
-              "offsetX": "0px",
-              "offsetY": "0px",
-              "blur": "0px",
-              "spread": "1px"
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 0,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 0,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 1,
+                "unit": "px"
+              }
             },
             {
               "color": "#010409",
               "alpha": 0.4,
-              "offsetX": "0px",
-              "offsetY": "8px",
-              "blur": "16px",
-              "spread": "-4px"
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 8,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 16,
+                "unit": "px"
+              },
+              "spread": {
+                "value": -4,
+                "unit": "px"
+              }
             },
             {
               "color": "#010409",
               "alpha": 0.4,
-              "offsetX": "0px",
-              "offsetY": "4px",
-              "blur": "32px",
-              "spread": "-4px"
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 4,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 32,
+                "unit": "px"
+              },
+              "spread": {
+                "value": -4,
+                "unit": "px"
+              }
             },
             {
               "color": "#010409",
               "alpha": 0.4,
-              "offsetX": "0px",
-              "offsetY": "24px",
-              "blur": "48px",
-              "spread": "-12px"
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 24,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 48,
+                "unit": "px"
+              },
+              "spread": {
+                "value": -12,
+                "unit": "px"
+              }
             },
             {
               "color": "#010409",
               "alpha": 0.4,
-              "offsetX": "0px",
-              "offsetY": "48px",
-              "blur": "96px",
-              "spread": "-24px"
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 48,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 96,
+                "unit": "px"
+              },
+              "spread": {
+                "value": -24,
+                "unit": "px"
+              }
             }
           ],
           "filePath": "src/tokens/functional/shadow/shadow.json5",
           "isSource": true,
           "$type": "shadow"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["popover", "action-menu", "select-panel", "autocomplete"],
+        "rules": "Use for medium-sized floating elements like popovers and action menus. More prominent than small but less than dialogs. Do NOT use for full modals."
       }
     },
     "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -47691,45 +48305,106 @@
         {
           "color": "{overlay.borderColor}",
           "alpha": 1,
-          "offsetX": "0px",
-          "offsetY": "0px",
-          "blur": "0px",
-          "spread": "1px"
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 0,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 0,
+            "unit": "px"
+          },
+          "spread": {
+            "value": 1,
+            "unit": "px"
+          }
         },
         {
           "color": "{base.color.neutral.0}",
           "alpha": 0.4,
-          "offsetX": "0px",
-          "offsetY": "8px",
-          "blur": "16px",
-          "spread": "-4px"
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 8,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 16,
+            "unit": "px"
+          },
+          "spread": {
+            "value": -4,
+            "unit": "px"
+          }
         },
         {
           "color": "{base.color.neutral.0}",
           "alpha": 0.4,
-          "offsetX": "0px",
-          "offsetY": "4px",
-          "blur": "32px",
-          "spread": "-4px"
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 4,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 32,
+            "unit": "px"
+          },
+          "spread": {
+            "value": -4,
+            "unit": "px"
+          }
         },
         {
           "color": "{base.color.neutral.0}",
           "alpha": 0.4,
-          "offsetX": "0px",
-          "offsetY": "24px",
-          "blur": "48px",
-          "spread": "-12px"
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 24,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 48,
+            "unit": "px"
+          },
+          "spread": {
+            "value": -12,
+            "unit": "px"
+          }
         },
         {
           "color": "{base.color.neutral.0}",
           "alpha": 0.4,
-          "offsetX": "0px",
-          "offsetY": "48px",
-          "blur": "96px",
-          "spread": "-24px"
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 48,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 96,
+            "unit": "px"
+          },
+          "spread": {
+            "value": -24,
+            "unit": "px"
+          }
         }
       ],
       "$type": "shadow",
+      "$description": "Medium floating shadow for popovers and action menus",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -47741,48 +48416,112 @@
               {
                 "color": "{overlay.borderColor}",
                 "alpha": 1,
-                "offsetX": "0px",
-                "offsetY": "0px",
-                "blur": "0px",
-                "spread": "1px"
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 1,
+                  "unit": "px"
+                }
               },
               {
                 "color": "{base.color.neutral.0}",
                 "alpha": 0.4,
-                "offsetX": "0px",
-                "offsetY": "8px",
-                "blur": "16px",
-                "spread": "-4px"
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 8,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 16,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": -4,
+                  "unit": "px"
+                }
               },
               {
                 "color": "{base.color.neutral.0}",
                 "alpha": 0.4,
-                "offsetX": "0px",
-                "offsetY": "4px",
-                "blur": "32px",
-                "spread": "-4px"
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 4,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 32,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": -4,
+                  "unit": "px"
+                }
               },
               {
                 "color": "{base.color.neutral.0}",
                 "alpha": 0.4,
-                "offsetX": "0px",
-                "offsetY": "24px",
-                "blur": "48px",
-                "spread": "-12px"
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 24,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 48,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": -12,
+                  "unit": "px"
+                }
               },
               {
                 "color": "{base.color.neutral.0}",
                 "alpha": 0.4,
-                "offsetX": "0px",
-                "offsetY": "48px",
-                "blur": "96px",
-                "spread": "-24px"
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 48,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 96,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": -24,
+                  "unit": "px"
+                }
               }
             ],
             "filePath": "src/tokens/functional/shadow/shadow.json5",
             "isSource": true,
             "$type": "shadow"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["popover", "action-menu", "select-panel", "autocomplete"],
+          "rules": "Use for medium-sized floating elements like popovers and action menus. More prominent than small but less than dialogs. Do NOT use for full modals."
         }
       },
       "key": "{shadow.floating.medium}"
@@ -47793,7 +48532,7 @@
   },
   "shadow-floating-small": {
     "key": "{shadow.floating.small}",
-    "$value": "0px 0px 0px 1px #3d444d, 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966",
+    "$value": "0 0 0 1px #3d444d, 0 6px 12px -3px #01040966, 0 6px 18px 0 #01040966",
     "$type": "shadow",
     "$description": "Small floating shadow for dropdowns, tooltips, and small overlays",
     "$extensions": {
@@ -47807,26 +48546,62 @@
             {
               "color": "#3d444db3",
               "alpha": 1,
-              "offsetX": "0px",
-              "offsetY": "0px",
-              "blur": "0px",
-              "spread": "1px"
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 0,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 0,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 1,
+                "unit": "px"
+              }
             },
             {
               "color": "#010409",
               "alpha": 0.4,
-              "offsetX": "0px",
-              "offsetY": "6px",
-              "blur": "12px",
-              "spread": "-3px"
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 6,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 12,
+                "unit": "px"
+              },
+              "spread": {
+                "value": -3,
+                "unit": "px"
+              }
             },
             {
               "color": "#010409",
               "alpha": 0.4,
-              "offsetX": "0px",
-              "offsetY": "6px",
-              "blur": "18px",
-              "spread": "0px"
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 6,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 18,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 0,
+                "unit": "px"
+              }
             }
           ],
           "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -47846,26 +48621,62 @@
         {
           "color": "{overlay.borderColor}",
           "alpha": 1,
-          "offsetX": "0px",
-          "offsetY": "0px",
-          "blur": "0px",
-          "spread": "1px"
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 0,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 0,
+            "unit": "px"
+          },
+          "spread": {
+            "value": 1,
+            "unit": "px"
+          }
         },
         {
           "color": "{base.color.neutral.0}",
           "alpha": 0.4,
-          "offsetX": "0px",
-          "offsetY": "6px",
-          "blur": "12px",
-          "spread": "-3px"
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 6,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 12,
+            "unit": "px"
+          },
+          "spread": {
+            "value": -3,
+            "unit": "px"
+          }
         },
         {
           "color": "{base.color.neutral.0}",
           "alpha": 0.4,
-          "offsetX": "0px",
-          "offsetY": "6px",
-          "blur": "18px",
-          "spread": "0px"
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 6,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 18,
+            "unit": "px"
+          },
+          "spread": {
+            "value": 0,
+            "unit": "px"
+          }
         }
       ],
       "$type": "shadow",
@@ -47881,26 +48692,62 @@
               {
                 "color": "{overlay.borderColor}",
                 "alpha": 1,
-                "offsetX": "0px",
-                "offsetY": "0px",
-                "blur": "0px",
-                "spread": "1px"
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 1,
+                  "unit": "px"
+                }
               },
               {
                 "color": "{base.color.neutral.0}",
                 "alpha": 0.4,
-                "offsetX": "0px",
-                "offsetY": "6px",
-                "blur": "12px",
-                "spread": "-3px"
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 6,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 12,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": -3,
+                  "unit": "px"
+                }
               },
               {
                 "color": "{base.color.neutral.0}",
                 "alpha": 0.4,
-                "offsetX": "0px",
-                "offsetY": "6px",
-                "blur": "18px",
-                "spread": "0px"
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 6,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 18,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 0,
+                  "unit": "px"
+                }
               }
             ],
             "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -47921,8 +48768,9 @@
   },
   "shadow-floating-xlarge": {
     "key": "{shadow.floating.xlarge}",
-    "$value": "0px 0px 0px 1px #3d444d, 0px 32px 64px 0px #010409",
+    "$value": "0 0 0 1px #3d444d, 0 32px 64px 0 #010409",
     "$type": "shadow",
+    "$description": "Extra large floating shadow for full-screen overlays and sheets",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -47934,24 +48782,52 @@
             {
               "color": "#3d444db3",
               "alpha": 1,
-              "offsetX": "0px",
-              "offsetY": "0px",
-              "blur": "0px",
-              "spread": "1px"
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 0,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 0,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 1,
+                "unit": "px"
+              }
             },
             {
               "color": "#010409",
               "alpha": 1,
-              "offsetX": "0px",
-              "offsetY": "32px",
-              "blur": "64px",
-              "spread": "0px"
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 32,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 64,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 0,
+                "unit": "px"
+              }
             }
           ],
           "filePath": "src/tokens/functional/shadow/shadow.json5",
           "isSource": true,
           "$type": "shadow"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["full-screen-overlay", "side-sheet", "drawer", "large-modal"],
+        "rules": "Use for full-screen or near-full-screen overlays like side sheets and drawers. Maximum elevation in the system. Do NOT use for small floating elements."
       }
     },
     "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -47961,21 +48837,46 @@
         {
           "color": "{overlay.borderColor}",
           "alpha": 1,
-          "offsetX": "0px",
-          "offsetY": "0px",
-          "blur": "0px",
-          "spread": "1px"
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 0,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 0,
+            "unit": "px"
+          },
+          "spread": {
+            "value": 1,
+            "unit": "px"
+          }
         },
         {
           "color": "{base.color.neutral.0}",
           "alpha": 1,
-          "offsetX": "0px",
-          "offsetY": "32px",
-          "blur": "64px",
-          "spread": "0px"
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 32,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 64,
+            "unit": "px"
+          },
+          "spread": {
+            "value": 0,
+            "unit": "px"
+          }
         }
       ],
       "$type": "shadow",
+      "$description": "Extra large floating shadow for full-screen overlays and sheets",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -47987,24 +48888,52 @@
               {
                 "color": "{overlay.borderColor}",
                 "alpha": 1,
-                "offsetX": "0px",
-                "offsetY": "0px",
-                "blur": "0px",
-                "spread": "1px"
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 1,
+                  "unit": "px"
+                }
               },
               {
                 "color": "{base.color.neutral.0}",
                 "alpha": 1,
-                "offsetX": "0px",
-                "offsetY": "32px",
-                "blur": "64px",
-                "spread": "0px"
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 32,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 64,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 0,
+                  "unit": "px"
+                }
               }
             ],
             "filePath": "src/tokens/functional/shadow/shadow.json5",
             "isSource": true,
             "$type": "shadow"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["full-screen-overlay", "side-sheet", "drawer", "large-modal"],
+          "rules": "Use for full-screen or near-full-screen overlays like side sheets and drawers. Maximum elevation in the system. Do NOT use for small floating elements."
         }
       },
       "key": "{shadow.floating.xlarge}"
@@ -48015,8 +48944,9 @@
   },
   "shadow-inset": {
     "key": "{shadow.inset}",
-    "$value": "inset 0px 1px 0px 0px #0104093d",
+    "$value": "inset 0 1px 0 0 #0104093d",
     "$type": "shadow",
+    "$description": "Inset shadow for recessed elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -48027,16 +48957,32 @@
           "$value": {
             "color": "#010409",
             "alpha": 0.24,
-            "offsetX": "0px",
-            "offsetY": "1px",
-            "blur": "0px",
-            "spread": "0px",
+            "offsetX": {
+              "value": 0,
+              "unit": "px"
+            },
+            "offsetY": {
+              "value": 1,
+              "unit": "px"
+            },
+            "blur": {
+              "value": 0,
+              "unit": "px"
+            },
+            "spread": {
+              "value": 0,
+              "unit": "px"
+            },
             "inset": true
           },
           "filePath": "src/tokens/functional/shadow/shadow.json5",
           "isSource": true,
           "$type": "shadow"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["input-field", "pressed-button", "recessed-area", "well"],
+        "rules": "Use for elements that appear pressed or inset into the surface. Commonly used for input fields and wells. Do NOT use for floating elements."
       }
     },
     "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -48045,13 +48991,26 @@
       "$value": {
         "color": "{base.color.neutral.0}",
         "alpha": 0.24,
-        "offsetX": "0px",
-        "offsetY": "1px",
-        "blur": "0px",
-        "spread": "0px",
+        "offsetX": {
+          "value": 0,
+          "unit": "px"
+        },
+        "offsetY": {
+          "value": 1,
+          "unit": "px"
+        },
+        "blur": {
+          "value": 0,
+          "unit": "px"
+        },
+        "spread": {
+          "value": 0,
+          "unit": "px"
+        },
         "inset": true
       },
       "$type": "shadow",
+      "$description": "Inset shadow for recessed elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -48062,16 +49021,32 @@
             "$value": {
               "color": "{base.color.neutral.0}",
               "alpha": 0.24,
-              "offsetX": "0px",
-              "offsetY": "1px",
-              "blur": "0px",
-              "spread": "0px",
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 1,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 0,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 0,
+                "unit": "px"
+              },
               "inset": true
             },
             "filePath": "src/tokens/functional/shadow/shadow.json5",
             "isSource": true,
             "$type": "shadow"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["input-field", "pressed-button", "recessed-area", "well"],
+          "rules": "Use for elements that appear pressed or inset into the surface. Commonly used for input fields and wells. Do NOT use for floating elements."
         }
       },
       "key": "{shadow.inset}"
@@ -48082,8 +49057,9 @@
   },
   "shadow-resting-medium": {
     "key": "{shadow.resting.medium}",
-    "$value": "0px 1px 1px 0px #01040966, 0px 3px 6px 0px #010409cc",
+    "$value": "0 1px 1px 0 #01040966, 0 3px 6px 0 #010409cc",
     "$type": "shadow",
+    "$description": "Medium resting shadow for cards and elevated surfaces",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -48095,24 +49071,52 @@
             {
               "color": "#010409",
               "alpha": 0.4,
-              "offsetX": "0px",
-              "offsetY": "1px",
-              "blur": "1px",
-              "spread": "0px"
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 1,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 1,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 0,
+                "unit": "px"
+              }
             },
             {
               "color": "#010409",
               "alpha": 0.8,
-              "offsetX": "0px",
-              "offsetY": "3px",
-              "blur": "6px",
-              "spread": "0px"
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 3,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 6,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 0,
+                "unit": "px"
+              }
             }
           ],
           "filePath": "src/tokens/functional/shadow/shadow.json5",
           "isSource": true,
           "$type": "shadow"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["card", "panel", "elevated-surface", "elevated-sidebar"],
+        "rules": "Use for cards and content panels that sit above the page surface. Provides moderate elevation without appearing to float. Do NOT use for overlays or modals."
       }
     },
     "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -48122,21 +49126,46 @@
         {
           "color": "{base.color.neutral.0}",
           "alpha": 0.4,
-          "offsetX": "0px",
-          "offsetY": "1px",
-          "blur": "1px",
-          "spread": "0px"
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 1,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 1,
+            "unit": "px"
+          },
+          "spread": {
+            "value": 0,
+            "unit": "px"
+          }
         },
         {
           "color": "{base.color.neutral.0}",
           "alpha": 0.8,
-          "offsetX": "0px",
-          "offsetY": "3px",
-          "blur": "6px",
-          "spread": "0px"
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 3,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 6,
+            "unit": "px"
+          },
+          "spread": {
+            "value": 0,
+            "unit": "px"
+          }
         }
       ],
       "$type": "shadow",
+      "$description": "Medium resting shadow for cards and elevated surfaces",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -48148,24 +49177,52 @@
               {
                 "color": "{base.color.neutral.0}",
                 "alpha": 0.4,
-                "offsetX": "0px",
-                "offsetY": "1px",
-                "blur": "1px",
-                "spread": "0px"
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 1,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 1,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 0,
+                  "unit": "px"
+                }
               },
               {
                 "color": "{base.color.neutral.0}",
                 "alpha": 0.8,
-                "offsetX": "0px",
-                "offsetY": "3px",
-                "blur": "6px",
-                "spread": "0px"
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 3,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 6,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 0,
+                  "unit": "px"
+                }
               }
             ],
             "filePath": "src/tokens/functional/shadow/shadow.json5",
             "isSource": true,
             "$type": "shadow"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["card", "panel", "elevated-surface", "elevated-sidebar"],
+          "rules": "Use for cards and content panels that sit above the page surface. Provides moderate elevation without appearing to float. Do NOT use for overlays or modals."
         }
       },
       "key": "{shadow.resting.medium}"
@@ -48176,8 +49233,9 @@
   },
   "shadow-resting-small": {
     "key": "{shadow.resting.small}",
-    "$value": "0px 1px 1px 0px #01040999, 0px 1px 3px 0px #01040999",
+    "$value": "0 1px 1px 0 #01040999, 0 1px 3px 0 #01040999",
     "$type": "shadow",
+    "$description": "Small resting shadow for buttons and interactive elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -48189,19 +49247,43 @@
             {
               "color": "#010409",
               "alpha": 0.6,
-              "offsetX": "0px",
-              "offsetY": "1px",
-              "blur": "1px",
-              "spread": "0px",
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 1,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 1,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 0,
+                "unit": "px"
+              },
               "inset": false
             },
             {
               "color": "#010409",
               "alpha": 0.6,
-              "offsetX": "0px",
-              "offsetY": "1px",
-              "blur": "3px",
-              "spread": "0px",
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 1,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 3,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 0,
+                "unit": "px"
+              },
               "inset": false
             }
           ],
@@ -48209,6 +49291,10 @@
           "isSource": true,
           "$type": "shadow"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["button", "interactive-card", "clickable-element"],
+        "rules": "Use for buttons and small interactive elements at rest. Provides subtle depth and clickable affordance. RECOMMENDED for default button shadows."
       }
     },
     "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -48218,23 +49304,48 @@
         {
           "color": "{base.color.neutral.0}",
           "alpha": 0.6,
-          "offsetX": "0px",
-          "offsetY": "1px",
-          "blur": "1px",
-          "spread": "0px",
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 1,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 1,
+            "unit": "px"
+          },
+          "spread": {
+            "value": 0,
+            "unit": "px"
+          },
           "inset": false
         },
         {
           "color": "{base.color.neutral.0}",
           "alpha": 0.6,
-          "offsetX": "0px",
-          "offsetY": "1px",
-          "blur": "3px",
-          "spread": "0px",
+          "offsetX": {
+            "value": 0,
+            "unit": "px"
+          },
+          "offsetY": {
+            "value": 1,
+            "unit": "px"
+          },
+          "blur": {
+            "value": 3,
+            "unit": "px"
+          },
+          "spread": {
+            "value": 0,
+            "unit": "px"
+          },
           "inset": false
         }
       ],
       "$type": "shadow",
+      "$description": "Small resting shadow for buttons and interactive elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -48246,19 +49357,43 @@
               {
                 "color": "{base.color.neutral.0}",
                 "alpha": 0.6,
-                "offsetX": "0px",
-                "offsetY": "1px",
-                "blur": "1px",
-                "spread": "0px",
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 1,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 1,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 0,
+                  "unit": "px"
+                },
                 "inset": false
               },
               {
                 "color": "{base.color.neutral.0}",
                 "alpha": 0.6,
-                "offsetX": "0px",
-                "offsetY": "1px",
-                "blur": "3px",
-                "spread": "0px",
+                "offsetX": {
+                  "value": 0,
+                  "unit": "px"
+                },
+                "offsetY": {
+                  "value": 1,
+                  "unit": "px"
+                },
+                "blur": {
+                  "value": 3,
+                  "unit": "px"
+                },
+                "spread": {
+                  "value": 0,
+                  "unit": "px"
+                },
                 "inset": false
               }
             ],
@@ -48266,6 +49401,10 @@
             "isSource": true,
             "$type": "shadow"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["button", "interactive-card", "clickable-element"],
+          "rules": "Use for buttons and small interactive elements at rest. Provides subtle depth and clickable affordance. RECOMMENDED for default button shadows."
         }
       },
       "key": "{shadow.resting.small}"
@@ -48276,8 +49415,9 @@
   },
   "shadow-resting-xsmall": {
     "key": "{shadow.resting.xsmall}",
-    "$value": "0px 1px 1px 0px #010409cc",
+    "$value": "0 1px 1px 0 #010409cc",
     "$type": "shadow",
+    "$description": "Extra small resting shadow for minimal elevation",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -48288,16 +49428,32 @@
           "$value": {
             "color": "#010409",
             "alpha": 0.8,
-            "offsetX": "0px",
-            "offsetY": "1px",
-            "blur": "1px",
-            "spread": "0px",
+            "offsetX": {
+              "value": 0,
+              "unit": "px"
+            },
+            "offsetY": {
+              "value": 1,
+              "unit": "px"
+            },
+            "blur": {
+              "value": 1,
+              "unit": "px"
+            },
+            "spread": {
+              "value": 0,
+              "unit": "px"
+            },
             "inset": false
           },
           "filePath": "src/tokens/functional/shadow/shadow.json5",
           "isSource": true,
           "$type": "shadow"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["badge", "chip", "small-card", "subtle-elevation"],
+        "rules": "Use for very subtle elevation on small elements. Provides minimal lift from surface. Do NOT use for interactive elements needing clear affordance."
       }
     },
     "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -48306,13 +49462,26 @@
       "$value": {
         "color": "{base.color.neutral.0}",
         "alpha": 0.8,
-        "offsetX": "0px",
-        "offsetY": "1px",
-        "blur": "1px",
-        "spread": "0px",
+        "offsetX": {
+          "value": 0,
+          "unit": "px"
+        },
+        "offsetY": {
+          "value": 1,
+          "unit": "px"
+        },
+        "blur": {
+          "value": 1,
+          "unit": "px"
+        },
+        "spread": {
+          "value": 0,
+          "unit": "px"
+        },
         "inset": false
       },
       "$type": "shadow",
+      "$description": "Extra small resting shadow for minimal elevation",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -48323,16 +49492,32 @@
             "$value": {
               "color": "{base.color.neutral.0}",
               "alpha": 0.8,
-              "offsetX": "0px",
-              "offsetY": "1px",
-              "blur": "1px",
-              "spread": "0px",
+              "offsetX": {
+                "value": 0,
+                "unit": "px"
+              },
+              "offsetY": {
+                "value": 1,
+                "unit": "px"
+              },
+              "blur": {
+                "value": 1,
+                "unit": "px"
+              },
+              "spread": {
+                "value": 0,
+                "unit": "px"
+              },
               "inset": false
             },
             "filePath": "src/tokens/functional/shadow/shadow.json5",
             "isSource": true,
             "$type": "shadow"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["badge", "chip", "small-card", "subtle-elevation"],
+          "rules": "Use for very subtle elevation on small elements. Provides minimal lift from surface. Do NOT use for interactive elements needing clear affordance."
         }
       },
       "key": "{shadow.resting.xsmall}"