@primer/primitives 11.4.0 → 11.4.1-rc.4e2d1de5

package/dist/styleLint/functional/themes/light.json

@@ -546,6 +546,10 @@
       },
       "org.primer.overrides": {
         "dark": "#ffffff"
+      },
+      "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",
@@ -562,6 +566,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}"
@@ -2438,6 +2446,10 @@
       },
       "org.primer.overrides": {
         "dark": "#1f2328"
+      },
+      "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",
@@ -2454,6 +2466,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}"
@@ -2464,7 +2480,7 @@
   },
   "border-accent-emphasis": {
     "key": "{border.accent.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #0969da",
+    "$value": "0.0625rem,1px solid #0969da",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2483,7 +2499,7 @@
   },
   "border-accent-muted": {
     "key": "{border.accent.muted}",
-    "$value": "0.00390625rem,0.0625px solid #54aeff66",
+    "$value": "0.0625rem,1px solid #54aeff66",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2502,7 +2518,7 @@
   },
   "border-attention-emphasis": {
     "key": "{border.attention.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #9a6700",
+    "$value": "0.0625rem,1px solid #9a6700",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2521,7 +2537,7 @@
   },
   "border-attention-muted": {
     "key": "{border.attention.muted}",
-    "$value": "0.00390625rem,0.0625px solid #d4a72c66",
+    "$value": "0.0625rem,1px solid #d4a72c66",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2540,7 +2556,7 @@
   },
   "border-closed-emphasis": {
     "key": "{border.closed.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #cf222e",
+    "$value": "0.0625rem,1px solid #cf222e",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2555,7 +2571,7 @@
   },
   "border-closed-muted": {
     "key": "{border.closed.muted}",
-    "$value": "0.00390625rem,0.0625px solid #ff818266",
+    "$value": "0.0625rem,1px solid #ff818266",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2570,7 +2586,7 @@
   },
   "border-danger-emphasis": {
     "key": "{border.danger.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #cf222e",
+    "$value": "0.0625rem,1px solid #cf222e",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2589,7 +2605,7 @@
   },
   "border-danger-muted": {
     "key": "{border.danger.muted}",
-    "$value": "0.00390625rem,0.0625px solid #ff818266",
+    "$value": "0.0625rem,1px solid #ff818266",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2608,7 +2624,7 @@
   },
   "border-default": {
     "key": "{border.default}",
-    "$value": "0.00390625rem,0.0625px solid #d1d9e0",
+    "$value": "0.0625rem,1px solid #d1d9e0",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2627,7 +2643,7 @@
   },
   "border-disabled": {
     "key": "{border.disabled}",
-    "$value": "0.00390625rem,0.0625px solid #818b981a",
+    "$value": "0.0625rem,1px solid #818b981a",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2646,7 +2662,7 @@
   },
   "border-done-emphasis": {
     "key": "{border.done.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #8250df",
+    "$value": "0.0625rem,1px solid #8250df",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2665,7 +2681,7 @@
   },
   "border-done-muted": {
     "key": "{border.done.muted}",
-    "$value": "0.00390625rem,0.0625px solid #c297ff66",
+    "$value": "0.0625rem,1px solid #c297ff66",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2684,7 +2700,7 @@
   },
   "border-emphasis": {
     "key": "{border.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #818b98",
+    "$value": "0.0625rem,1px solid #818b98",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2703,7 +2719,7 @@
   },
   "border-muted": {
     "key": "{border.muted}",
-    "$value": "0.00390625rem,0.0625px solid #d1d9e0b3",
+    "$value": "0.0625rem,1px solid #d1d9e0b3",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2722,7 +2738,7 @@
   },
   "border-neutral-emphasis": {
     "key": "{border.neutral.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #59636e",
+    "$value": "0.0625rem,1px solid #59636e",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2741,7 +2757,7 @@
   },
   "border-neutral-muted": {
     "key": "{border.neutral.muted}",
-    "$value": "0.00390625rem,0.0625px solid #d1d9e0b3",
+    "$value": "0.0625rem,1px solid #d1d9e0b3",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2760,7 +2776,7 @@
   },
   "border-open-emphasis": {
     "key": "{border.open.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #1a7f37",
+    "$value": "0.0625rem,1px solid #1a7f37",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2775,7 +2791,7 @@
   },
   "border-open-muted": {
     "key": "{border.open.muted}",
-    "$value": "0.00390625rem,0.0625px solid #4ac26b66",
+    "$value": "0.0625rem,1px solid #4ac26b66",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2790,7 +2806,7 @@
   },
   "border-severe-emphasis": {
     "key": "{border.severe.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #bc4c00",
+    "$value": "0.0625rem,1px solid #bc4c00",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2809,7 +2825,7 @@
   },
   "border-severe-muted": {
     "key": "{border.severe.muted}",
-    "$value": "0.00390625rem,0.0625px solid #fb8f4466",
+    "$value": "0.0625rem,1px solid #fb8f4466",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2828,7 +2844,7 @@
   },
   "border-sponsors-emphasis": {
     "key": "{border.sponsors.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #bf3989",
+    "$value": "0.0625rem,1px solid #bf3989",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2847,7 +2863,7 @@
   },
   "border-sponsors-muted": {
     "key": "{border.sponsors.muted}",
-    "$value": "0.00390625rem,0.0625px solid #ff80c866",
+    "$value": "0.0625rem,1px solid #ff80c866",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2866,7 +2882,7 @@
   },
   "border-success-emphasis": {
     "key": "{border.success.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #1a7f37",
+    "$value": "0.0625rem,1px solid #1a7f37",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2885,7 +2901,7 @@
   },
   "border-success-muted": {
     "key": "{border.success.muted}",
-    "$value": "0.00390625rem,0.0625px solid #4ac26b66",
+    "$value": "0.0625rem,1px solid #4ac26b66",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2904,7 +2920,7 @@
   },
   "border-transparent": {
     "key": "{border.transparent}",
-    "$value": "0.00390625rem,0.0625px solid #ffffff00",
+    "$value": "0.0625rem,1px solid #ffffff00",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2923,7 +2939,7 @@
   },
   "border-upsell-emphasis": {
     "key": "{border.upsell.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #8250df",
+    "$value": "0.0625rem,1px solid #8250df",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2942,7 +2958,7 @@
   },
   "border-upsell-muted": {
     "key": "{border.upsell.muted}",
-    "$value": "0.00390625rem,0.0625px solid #c297ff66",
+    "$value": "0.0625rem,1px solid #c297ff66",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -37214,6 +37230,10 @@
       },
       "org.primer.overrides": {
         "dark": "#ffffff"
+      },
+      "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",
@@ -37230,6 +37250,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}"
@@ -38203,6 +38227,10 @@
       },
       "org.primer.overrides": {
         "dark": "#1f2328"
+      },
+      "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",
@@ -38219,6 +38247,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}"
@@ -47501,6 +47533,7 @@
     "key": "{shadow.floating.legacy}",
     "$value": "0px 6px 12px -3px #25292e0a, 0px 6px 18px 0px #25292e1f",
     "$type": "shadow",
+    "$description": "Legacy floating shadow for backward compatibility",
     "$extensions": {
       "org.primer.figma": {},
       "org.primer.overrides": {
@@ -47527,6 +47560,10 @@
           "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",
@@ -47551,6 +47588,7 @@
         }
       ],
       "$type": "shadow",
+      "$description": "Legacy floating shadow for backward compatibility",
       "$extensions": {
         "org.primer.figma": {},
         "org.primer.overrides": {
@@ -47577,6 +47615,10 @@
             "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}"
@@ -47589,6 +47631,7 @@
     "key": "{shadow.floating.medium}",
     "$value": "0px 0px 0px 1px #d1d9e0, 0px 8px 16px -4px #25292e14, 0px 4px 32px -4px #25292e14, 0px 24px 48px -12px #25292e14, 0px 48px 96px -24px #25292e14",
     "$type": "shadow",
+    "$description": "Medium floating shadow for popovers and action menus",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -47642,6 +47685,10 @@
           "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",
@@ -47690,6 +47737,7 @@
         }
       ],
       "$type": "shadow",
+      "$description": "Medium floating shadow for popovers and action menus",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -47743,6 +47791,10 @@
             "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}"
@@ -47883,6 +47935,7 @@
     "key": "{shadow.floating.xlarge}",
     "$value": "0px 0px 0px 1px #d1d9e0, 0px 56px 112px 0px #25292e52",
     "$type": "shadow",
+    "$description": "Extra large floating shadow for full-screen overlays and sheets",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -47912,6 +47965,10 @@
           "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",
@@ -47936,6 +47993,7 @@
         }
       ],
       "$type": "shadow",
+      "$description": "Extra large floating shadow for full-screen overlays and sheets",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -47965,6 +48023,10 @@
             "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}"
@@ -47977,6 +48039,7 @@
     "key": "{shadow.inset}",
     "$value": "inset 0px 1px 0px 0px #1f23280a",
     "$type": "shadow",
+    "$description": "Inset shadow for recessed elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -47997,6 +48060,10 @@
           "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",
@@ -48012,6 +48079,7 @@
         "inset": true
       },
       "$type": "shadow",
+      "$description": "Inset shadow for recessed elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -48032,6 +48100,10 @@
             "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}"
@@ -48044,6 +48116,7 @@
     "key": "{shadow.resting.medium}",
     "$value": "0px 1px 1px 0px #25292e1a, 0px 3px 6px 0px #25292e1f",
     "$type": "shadow",
+    "$description": "Medium resting shadow for cards and elevated surfaces",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -48073,6 +48146,10 @@
           "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",
@@ -48097,6 +48174,7 @@
         }
       ],
       "$type": "shadow",
+      "$description": "Medium resting shadow for cards and elevated surfaces",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -48126,6 +48204,10 @@
             "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}"
@@ -48136,8 +48218,9 @@
   },
   "shadow-resting-small": {
     "key": "{shadow.resting.small}",
-    "$value": "0px 1px 1px 0px #1f23280f, 0px 1px 3px 0px #1f23280f",
+    "$value": "0px 1px 1px 0px #1f23280a, 0px 1px 2px 0px #1f232808",
     "$type": "shadow",
+    "$description": "Small resting shadow for buttons and interactive elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -48169,6 +48252,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",
@@ -48177,7 +48264,7 @@
       "$value": [
         {
           "color": "{base.color.neutral.13}",
-          "alpha": 0.06,
+          "alpha": 0.04,
           "offsetX": "0px",
           "offsetY": "1px",
           "blur": "1px",
@@ -48186,15 +48273,16 @@
         },
         {
           "color": "{base.color.neutral.13}",
-          "alpha": 0.06,
+          "alpha": 0.03,
           "offsetX": "0px",
           "offsetY": "1px",
-          "blur": "3px",
+          "blur": "2px",
           "spread": "0px",
           "inset": false
         }
       ],
       "$type": "shadow",
+      "$description": "Small resting shadow for buttons and interactive elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -48226,6 +48314,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}"
@@ -48236,8 +48328,9 @@
   },
   "shadow-resting-xsmall": {
     "key": "{shadow.resting.xsmall}",
-    "$value": "0px 1px 1px 0px #1f23280f",
+    "$value": "0px 1px 1px 0px #1f23280d",
     "$type": "shadow",
+    "$description": "Extra small resting shadow for minimal elevation",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -48258,6 +48351,10 @@
           "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",
@@ -48265,7 +48362,7 @@
     "original": {
       "$value": {
         "color": "{base.color.neutral.13}",
-        "alpha": 0.06,
+        "alpha": 0.05,
         "offsetX": "0px",
         "offsetY": "1px",
         "blur": "1px",
@@ -48273,6 +48370,7 @@
         "inset": false
       },
       "$type": "shadow",
+      "$description": "Extra small resting shadow for minimal elevation",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -48293,6 +48391,10 @@
             "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}"