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

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

@@ -543,6 +543,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",
@@ -559,6 +563,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}"
@@ -2435,6 +2443,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",
@@ -2451,6 +2463,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}"
@@ -37211,6 +37227,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",
@@ -37227,6 +37247,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}"
@@ -38200,6 +38224,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",
@@ -38216,6 +38244,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}"
@@ -47525,6 +47557,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",
@@ -47549,6 +47585,7 @@
         }
       ],
       "$type": "shadow",
+      "$description": "Legacy floating shadow for backward compatibility",
       "$extensions": {
         "org.primer.figma": {},
         "org.primer.overrides": {
@@ -47575,6 +47612,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}"
@@ -47583,7 +47624,8 @@
     "attributes": {},
     "path": ["shadow", "floating", "legacy"],
     "value": "0px 6px 12px -3px #25292e0a, 0px 6px 18px 0px #25292e1f",
-    "type": "shadow"
+    "type": "shadow",
+    "description": "Legacy floating shadow for backward compatibility"
   },
   "shadow-floating-medium": {
     "key": "{shadow.floating.medium}",
@@ -47640,6 +47682,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",
@@ -47688,6 +47734,7 @@
         }
       ],
       "$type": "shadow",
+      "$description": "Medium floating shadow for popovers and action menus",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -47741,6 +47788,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}"
@@ -47749,7 +47800,8 @@
     "attributes": {},
     "path": ["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"
+    "type": "shadow",
+    "description": "Medium floating shadow for popovers and action menus"
   },
   "shadow-floating-small": {
     "key": "{shadow.floating.small}",
@@ -47910,6 +47962,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",
@@ -47934,6 +47990,7 @@
         }
       ],
       "$type": "shadow",
+      "$description": "Extra large floating shadow for full-screen overlays and sheets",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -47963,6 +48020,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}"
@@ -47971,7 +48032,8 @@
     "attributes": {},
     "path": ["shadow", "floating", "xlarge"],
     "value": "0px 0px 0px 1px #d1d9e0, 0px 56px 112px 0px #25292e52",
-    "type": "shadow"
+    "type": "shadow",
+    "description": "Extra large floating shadow for full-screen overlays and sheets"
   },
   "shadow-inset": {
     "key": "{shadow.inset}",
@@ -47995,6 +48057,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",
@@ -48010,6 +48076,7 @@
         "inset": true
       },
       "$type": "shadow",
+      "$description": "Inset shadow for recessed elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -48030,6 +48097,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}"
@@ -48038,7 +48109,8 @@
     "attributes": {},
     "path": ["shadow", "inset"],
     "value": "inset 0px 1px 0px 0px #1f23280a",
-    "type": "shadow"
+    "type": "shadow",
+    "description": "Inset shadow for recessed elements"
   },
   "shadow-resting-medium": {
     "key": "{shadow.resting.medium}",
@@ -48071,6 +48143,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",
@@ -48095,6 +48171,7 @@
         }
       ],
       "$type": "shadow",
+      "$description": "Medium resting shadow for cards and elevated surfaces",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -48124,6 +48201,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}"
@@ -48132,7 +48213,8 @@
     "attributes": {},
     "path": ["shadow", "resting", "medium"],
     "value": "0px 1px 1px 0px #25292e1a, 0px 3px 6px 0px #25292e1f",
-    "type": "shadow"
+    "type": "shadow",
+    "description": "Medium resting shadow for cards and elevated surfaces"
   },
   "shadow-resting-small": {
     "key": "{shadow.resting.small}",
@@ -48167,6 +48249,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",
@@ -48175,7 +48261,7 @@
       "$value": [
         {
           "color": "{base.color.neutral.13}",
-          "alpha": 0.06,
+          "alpha": 0.04,
           "offsetX": "0px",
           "offsetY": "1px",
           "blur": "1px",
@@ -48184,15 +48270,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",
@@ -48224,6 +48311,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}"
@@ -48231,8 +48322,9 @@
     "name": "shadow-resting-small",
     "attributes": {},
     "path": ["shadow", "resting", "small"],
-    "value": "0px 1px 1px 0px #1f23280f, 0px 1px 3px 0px #1f23280f",
-    "type": "shadow"
+    "value": "0px 1px 1px 0px #1f23280a, 0px 1px 2px 0px #1f232808",
+    "type": "shadow",
+    "description": "Small resting shadow for buttons and interactive elements"
   },
   "shadow-resting-xsmall": {
     "key": "{shadow.resting.xsmall}",
@@ -48256,6 +48348,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",
@@ -48263,7 +48359,7 @@
     "original": {
       "$value": {
         "color": "{base.color.neutral.13}",
-        "alpha": 0.06,
+        "alpha": 0.05,
         "offsetX": "0px",
         "offsetY": "1px",
         "blur": "1px",
@@ -48271,6 +48367,7 @@
         "inset": false
       },
       "$type": "shadow",
+      "$description": "Extra small resting shadow for minimal elevation",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -48291,6 +48388,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}"
@@ -48298,8 +48399,9 @@
     "name": "shadow-resting-xsmall",
     "attributes": {},
     "path": ["shadow", "resting", "xsmall"],
-    "value": "0px 1px 1px 0px #1f23280f",
-    "type": "shadow"
+    "value": "0px 1px 1px 0px #1f23280d",
+    "type": "shadow",
+    "description": "Extra small resting shadow for minimal elevation"
   },
   "sideNav-bgColor-selected": {
     "key": "{sideNav.bgColor.selected}",

package/dist/docs/functional/typography/typography.json

@@ -647,7 +647,10 @@
     "filePath": "src/tokens/functional/typography/typography.json5",
     "isSource": true,
     "original": {
-      "$value": "13px",
+      "$value": {
+        "value": 13,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -734,7 +737,10 @@
     "filePath": "src/tokens/functional/typography/typography.json5",
     "isSource": true,
     "original": {
-      "$value": "0.9285em",
+      "$value": {
+        "value": 0.9285,
+        "unit": "em"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {

package/dist/fallbacks/base/motion/motion.json

@@ -4,16 +4,52 @@
   "--base-easing-easeIn": [0.7, 0.1, 0.75, 0.9],
   "--base-easing-easeOut": [0.3, 0.8, 0.6, 1],
   "--base-easing-easeInOut": [0.6, 0, 0.2, 1],
-  "--base-duration-0": "0ms",
-  "--base-duration-50": "50ms",
-  "--base-duration-100": "100ms",
-  "--base-duration-200": "200ms",
-  "--base-duration-300": "300ms",
-  "--base-duration-400": "400ms",
-  "--base-duration-500": "500ms",
-  "--base-duration-600": "600ms",
-  "--base-duration-700": "700ms",
-  "--base-duration-800": "800ms",
-  "--base-duration-900": "900ms",
-  "--base-duration-1000": "1000ms"
+  "--base-duration-0": {
+    "value": 0,
+    "unit": "ms"
+  },
+  "--base-duration-50": {
+    "value": 50,
+    "unit": "ms"
+  },
+  "--base-duration-100": {
+    "value": 100,
+    "unit": "ms"
+  },
+  "--base-duration-200": {
+    "value": 200,
+    "unit": "ms"
+  },
+  "--base-duration-300": {
+    "value": 300,
+    "unit": "ms"
+  },
+  "--base-duration-400": {
+    "value": 400,
+    "unit": "ms"
+  },
+  "--base-duration-500": {
+    "value": 500,
+    "unit": "ms"
+  },
+  "--base-duration-600": {
+    "value": 600,
+    "unit": "ms"
+  },
+  "--base-duration-700": {
+    "value": 700,
+    "unit": "ms"
+  },
+  "--base-duration-800": {
+    "value": 800,
+    "unit": "ms"
+  },
+  "--base-duration-900": {
+    "value": 900,
+    "unit": "ms"
+  },
+  "--base-duration-1000": {
+    "value": 1000,
+    "unit": "ms"
+  }
 }

package/dist/figma/themes/light-colorblind.json

@@ -91,7 +91,7 @@
       "r": 0.12156862745098039,
       "g": 0.13725490196078433,
       "b": 0.1568627450980392,
-      "a": 0.06
+      "a": 0.05
     },
     "type": "COLOR",
     "scopes": ["EFFECT_COLOR"],
@@ -141,7 +141,7 @@
       "r": 0.12156862745098039,
       "g": 0.13725490196078433,
       "b": 0.1568627450980392,
-      "a": 0.06
+      "a": 0.04
     },
     "type": "COLOR",
     "scopes": ["EFFECT_COLOR"],
@@ -169,7 +169,7 @@
   },
   {
     "name": "shadow/resting/small/2/blur",
-    "value": 3,
+    "value": 2,
     "type": "FLOAT",
     "scopes": ["EFFECT_FLOAT"],
     "mode": "light protanopia deuteranopia",
@@ -191,7 +191,7 @@
       "r": 0.12156862745098039,
       "g": 0.13725490196078433,
       "b": 0.1568627450980392,
-      "a": 0.06
+      "a": 0.03
     },
     "type": "COLOR",
     "scopes": ["EFFECT_COLOR"],

package/dist/figma/themes/light-high-contrast.json

@@ -91,7 +91,7 @@
       "r": 0.00392156862745098,
       "g": 0.01568627450980392,
       "b": 0.03529411764705882,
-      "a": 0.06
+      "a": 0.05
     },
     "type": "COLOR",
     "scopes": ["EFFECT_COLOR"],
@@ -141,7 +141,7 @@
       "r": 0.00392156862745098,
       "g": 0.01568627450980392,
       "b": 0.03529411764705882,
-      "a": 0.06
+      "a": 0.04
     },
     "type": "COLOR",
     "scopes": ["EFFECT_COLOR"],
@@ -169,7 +169,7 @@
   },
   {
     "name": "shadow/resting/small/2/blur",
-    "value": 3,
+    "value": 2,
     "type": "FLOAT",
     "scopes": ["EFFECT_FLOAT"],
     "mode": "light high contrast",
@@ -191,7 +191,7 @@
       "r": 0.00392156862745098,
       "g": 0.01568627450980392,
       "b": 0.03529411764705882,
-      "a": 0.06
+      "a": 0.03
     },
     "type": "COLOR",
     "scopes": ["EFFECT_COLOR"],

package/dist/figma/themes/light-tritanopia.json

@@ -91,7 +91,7 @@
       "r": 0.12156862745098039,
       "g": 0.13725490196078433,
       "b": 0.1568627450980392,
-      "a": 0.06
+      "a": 0.05
     },
     "type": "COLOR",
     "scopes": ["EFFECT_COLOR"],
@@ -141,7 +141,7 @@
       "r": 0.12156862745098039,
       "g": 0.13725490196078433,
       "b": 0.1568627450980392,
-      "a": 0.06
+      "a": 0.04
     },
     "type": "COLOR",
     "scopes": ["EFFECT_COLOR"],
@@ -169,7 +169,7 @@
   },
   {
     "name": "shadow/resting/small/2/blur",
-    "value": 3,
+    "value": 2,
     "type": "FLOAT",
     "scopes": ["EFFECT_FLOAT"],
     "mode": "light tritanopia",
@@ -191,7 +191,7 @@
       "r": 0.12156862745098039,
       "g": 0.13725490196078433,
       "b": 0.1568627450980392,
-      "a": 0.06
+      "a": 0.03
     },
     "type": "COLOR",
     "scopes": ["EFFECT_COLOR"],

package/dist/figma/themes/light.json

@@ -91,7 +91,7 @@
       "r": 0.12156862745098039,
       "g": 0.13725490196078433,
       "b": 0.1568627450980392,
-      "a": 0.06
+      "a": 0.05
     },
     "type": "COLOR",
     "scopes": ["EFFECT_COLOR"],
@@ -141,7 +141,7 @@
       "r": 0.12156862745098039,
       "g": 0.13725490196078433,
       "b": 0.1568627450980392,
-      "a": 0.06
+      "a": 0.04
     },
     "type": "COLOR",
     "scopes": ["EFFECT_COLOR"],
@@ -169,7 +169,7 @@
   },
   {
     "name": "shadow/resting/small/2/blur",
-    "value": 3,
+    "value": 2,
     "type": "FLOAT",
     "scopes": ["EFFECT_FLOAT"],
     "mode": "light",
@@ -191,7 +191,7 @@
       "r": 0.12156862745098039,
       "g": 0.13725490196078433,
       "b": 0.1568627450980392,
-      "a": 0.06
+      "a": 0.03
     },
     "type": "COLOR",
     "scopes": ["EFFECT_COLOR"],