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

package/dist/docs/base/motion/motion.json

@@ -4,14 +4,20 @@
     "filePath": "src/tokens/base/motion/timing.json5",
     "isSource": true,
     "original": {
-      "$value": "0ms",
+      "$value": {
+        "value": 0,
+        "unit": "ms"
+      },
       "$type": "duration",
       "key": "{base.duration.0}"
     },
     "name": "base-duration-0",
     "attributes": {},
     "path": ["base", "duration", "0"],
-    "value": "0ms",
+    "value": {
+      "value": 0,
+      "unit": "ms"
+    },
     "type": "duration"
   },
   "base-duration-100": {
@@ -19,14 +25,20 @@
     "filePath": "src/tokens/base/motion/timing.json5",
     "isSource": true,
     "original": {
-      "$value": "100ms",
+      "$value": {
+        "value": 100,
+        "unit": "ms"
+      },
       "$type": "duration",
       "key": "{base.duration.100}"
     },
     "name": "base-duration-100",
     "attributes": {},
     "path": ["base", "duration", "100"],
-    "value": "100ms",
+    "value": {
+      "value": 100,
+      "unit": "ms"
+    },
     "type": "duration"
   },
   "base-duration-1000": {
@@ -34,14 +46,20 @@
     "filePath": "src/tokens/base/motion/timing.json5",
     "isSource": true,
     "original": {
-      "$value": "1000ms",
+      "$value": {
+        "value": 1000,
+        "unit": "ms"
+      },
       "$type": "duration",
       "key": "{base.duration.1000}"
     },
     "name": "base-duration-1000",
     "attributes": {},
     "path": ["base", "duration", "1000"],
-    "value": "1000ms",
+    "value": {
+      "value": 1000,
+      "unit": "ms"
+    },
     "type": "duration"
   },
   "base-duration-200": {
@@ -49,14 +67,20 @@
     "filePath": "src/tokens/base/motion/timing.json5",
     "isSource": true,
     "original": {
-      "$value": "200ms",
+      "$value": {
+        "value": 200,
+        "unit": "ms"
+      },
       "$type": "duration",
       "key": "{base.duration.200}"
     },
     "name": "base-duration-200",
     "attributes": {},
     "path": ["base", "duration", "200"],
-    "value": "200ms",
+    "value": {
+      "value": 200,
+      "unit": "ms"
+    },
     "type": "duration"
   },
   "base-duration-300": {
@@ -64,14 +88,20 @@
     "filePath": "src/tokens/base/motion/timing.json5",
     "isSource": true,
     "original": {
-      "$value": "300ms",
+      "$value": {
+        "value": 300,
+        "unit": "ms"
+      },
       "$type": "duration",
       "key": "{base.duration.300}"
     },
     "name": "base-duration-300",
     "attributes": {},
     "path": ["base", "duration", "300"],
-    "value": "300ms",
+    "value": {
+      "value": 300,
+      "unit": "ms"
+    },
     "type": "duration"
   },
   "base-duration-400": {
@@ -79,14 +109,20 @@
     "filePath": "src/tokens/base/motion/timing.json5",
     "isSource": true,
     "original": {
-      "$value": "400ms",
+      "$value": {
+        "value": 400,
+        "unit": "ms"
+      },
       "$type": "duration",
       "key": "{base.duration.400}"
     },
     "name": "base-duration-400",
     "attributes": {},
     "path": ["base", "duration", "400"],
-    "value": "400ms",
+    "value": {
+      "value": 400,
+      "unit": "ms"
+    },
     "type": "duration"
   },
   "base-duration-50": {
@@ -94,14 +130,20 @@
     "filePath": "src/tokens/base/motion/timing.json5",
     "isSource": true,
     "original": {
-      "$value": "50ms",
+      "$value": {
+        "value": 50,
+        "unit": "ms"
+      },
       "$type": "duration",
       "key": "{base.duration.50}"
     },
     "name": "base-duration-50",
     "attributes": {},
     "path": ["base", "duration", "50"],
-    "value": "50ms",
+    "value": {
+      "value": 50,
+      "unit": "ms"
+    },
     "type": "duration"
   },
   "base-duration-500": {
@@ -109,14 +151,20 @@
     "filePath": "src/tokens/base/motion/timing.json5",
     "isSource": true,
     "original": {
-      "$value": "500ms",
+      "$value": {
+        "value": 500,
+        "unit": "ms"
+      },
       "$type": "duration",
       "key": "{base.duration.500}"
     },
     "name": "base-duration-500",
     "attributes": {},
     "path": ["base", "duration", "500"],
-    "value": "500ms",
+    "value": {
+      "value": 500,
+      "unit": "ms"
+    },
     "type": "duration"
   },
   "base-duration-600": {
@@ -124,14 +172,20 @@
     "filePath": "src/tokens/base/motion/timing.json5",
     "isSource": true,
     "original": {
-      "$value": "600ms",
+      "$value": {
+        "value": 600,
+        "unit": "ms"
+      },
       "$type": "duration",
       "key": "{base.duration.600}"
     },
     "name": "base-duration-600",
     "attributes": {},
     "path": ["base", "duration", "600"],
-    "value": "600ms",
+    "value": {
+      "value": 600,
+      "unit": "ms"
+    },
     "type": "duration"
   },
   "base-duration-700": {
@@ -139,14 +193,20 @@
     "filePath": "src/tokens/base/motion/timing.json5",
     "isSource": true,
     "original": {
-      "$value": "700ms",
+      "$value": {
+        "value": 700,
+        "unit": "ms"
+      },
       "$type": "duration",
       "key": "{base.duration.700}"
     },
     "name": "base-duration-700",
     "attributes": {},
     "path": ["base", "duration", "700"],
-    "value": "700ms",
+    "value": {
+      "value": 700,
+      "unit": "ms"
+    },
     "type": "duration"
   },
   "base-duration-800": {
@@ -154,14 +214,20 @@
     "filePath": "src/tokens/base/motion/timing.json5",
     "isSource": true,
     "original": {
-      "$value": "800ms",
+      "$value": {
+        "value": 800,
+        "unit": "ms"
+      },
       "$type": "duration",
       "key": "{base.duration.800}"
     },
     "name": "base-duration-800",
     "attributes": {},
     "path": ["base", "duration", "800"],
-    "value": "800ms",
+    "value": {
+      "value": 800,
+      "unit": "ms"
+    },
     "type": "duration"
   },
   "base-duration-900": {
@@ -169,24 +235,71 @@
     "filePath": "src/tokens/base/motion/timing.json5",
     "isSource": true,
     "original": {
-      "$value": "900ms",
+      "$value": {
+        "value": 900,
+        "unit": "ms"
+      },
       "$type": "duration",
       "key": "{base.duration.900}"
     },
     "name": "base-duration-900",
     "attributes": {},
     "path": ["base", "duration", "900"],
-    "value": "900ms",
+    "value": {
+      "value": 900,
+      "unit": "ms"
+    },
     "type": "duration"
   },
+  "base-easing-ease": {
+    "key": "{base.easing.ease}",
+    "$extensions": {
+      "org.primer.llm": {
+        "usage": ["hover-state", "micro-interaction", "button-hover", "link-hover"],
+        "rules": "Use for hover state changes."
+      }
+    },
+    "filePath": "src/tokens/base/motion/easing.json5",
+    "isSource": true,
+    "original": {
+      "$value": [0.25, 0.1, 0.25, 1],
+      "$type": "cubicBezier",
+      "$description": "CSS default easing. Use for hover state changes and micro-interactions.",
+      "$extensions": {
+        "org.primer.llm": {
+          "usage": ["hover-state", "micro-interaction", "button-hover", "link-hover"],
+          "rules": "Use for hover state changes."
+        }
+      },
+      "key": "{base.easing.ease}"
+    },
+    "name": "base-easing-ease",
+    "attributes": {},
+    "path": ["base", "easing", "ease"],
+    "value": [0.25, 0.1, 0.25, 1],
+    "type": "cubicBezier",
+    "description": "CSS default easing. Use for hover state changes and micro-interactions."
+  },
   "base-easing-easeIn": {
     "key": "{base.easing.easeIn}",
+    "$extensions": {
+      "org.primer.llm": {
+        "usage": ["exit-animation", "element-leaving", "off-screen-motion"],
+        "rules": "Rarely used alone. Prefer ease-out for most exit animations."
+      }
+    },
     "filePath": "src/tokens/base/motion/easing.json5",
     "isSource": true,
     "original": {
       "$value": [0.7, 0.1, 0.75, 0.9],
       "$type": "cubicBezier",
-      "$description": "Ideal for movement that starts on the page and ends off the page.",
+      "$description": "Accelerating motion. Use for elements exiting the viewport (moving off-screen).",
+      "$extensions": {
+        "org.primer.llm": {
+          "usage": ["exit-animation", "element-leaving", "off-screen-motion"],
+          "rules": "Rarely used alone. Prefer ease-out for most exit animations."
+        }
+      },
       "key": "{base.easing.easeIn}"
     },
     "name": "base-easing-easeIn",
@@ -194,16 +307,28 @@
     "path": ["base", "easing", "easeIn"],
     "value": [0.7, 0.1, 0.75, 0.9],
     "type": "cubicBezier",
-    "description": "Ideal for movement that starts on the page and ends off the page."
+    "description": "Accelerating motion. Use for elements exiting the viewport (moving off-screen)."
   },
   "base-easing-easeInOut": {
     "key": "{base.easing.easeInOut}",
+    "$extensions": {
+      "org.primer.llm": {
+        "usage": ["position-change", "size-change", "morph-animation", "expand-collapse", "slide-transition"],
+        "rules": "Use if an element moves or morphs on screen."
+      }
+    },
     "filePath": "src/tokens/base/motion/easing.json5",
     "isSource": true,
     "original": {
       "$value": [0.6, 0, 0.2, 1],
       "$type": "cubicBezier",
-      "$description": "Ideal for movement that starts and ends on the page.",
+      "$description": "Smooth acceleration and deceleration. Use for elements moving or morphing within the viewport.",
+      "$extensions": {
+        "org.primer.llm": {
+          "usage": ["position-change", "size-change", "morph-animation", "expand-collapse", "slide-transition"],
+          "rules": "Use if an element moves or morphs on screen."
+        }
+      },
       "key": "{base.easing.easeInOut}"
     },
     "name": "base-easing-easeInOut",
@@ -211,16 +336,28 @@
     "path": ["base", "easing", "easeInOut"],
     "value": [0.6, 0, 0.2, 1],
     "type": "cubicBezier",
-    "description": "Ideal for movement that starts and ends on the page."
+    "description": "Smooth acceleration and deceleration. Use for elements moving or morphing within the viewport."
   },
   "base-easing-easeOut": {
     "key": "{base.easing.easeOut}",
+    "$extensions": {
+      "org.primer.llm": {
+        "usage": ["enter-animation", "element-appearing", "modal-open", "dropdown-open", "tooltip-appear"],
+        "rules": "RECOMMENDED default. Use if an element enters or exits the viewport."
+      }
+    },
     "filePath": "src/tokens/base/motion/easing.json5",
     "isSource": true,
     "original": {
       "$value": [0.3, 0.8, 0.6, 1],
       "$type": "cubicBezier",
-      "$description": "Ideal for movement that starts off the page and ends on the page.",
+      "$description": "Decelerating motion. Use for elements entering the viewport or appearing on screen.",
+      "$extensions": {
+        "org.primer.llm": {
+          "usage": ["enter-animation", "element-appearing", "modal-open", "dropdown-open", "tooltip-appear"],
+          "rules": "RECOMMENDED default. Use if an element enters or exits the viewport."
+        }
+      },
       "key": "{base.easing.easeOut}"
     },
     "name": "base-easing-easeOut",
@@ -228,16 +365,28 @@
     "path": ["base", "easing", "easeOut"],
     "value": [0.3, 0.8, 0.6, 1],
     "type": "cubicBezier",
-    "description": "Ideal for movement that starts off the page and ends on the page."
+    "description": "Decelerating motion. Use for elements entering the viewport or appearing on screen."
   },
   "base-easing-linear": {
     "key": "{base.easing.linear}",
+    "$extensions": {
+      "org.primer.llm": {
+        "usage": ["progress-bar", "loader", "continuous-animation", "scrolling"],
+        "rules": "Use if the motion is constant."
+      }
+    },
     "filePath": "src/tokens/base/motion/easing.json5",
     "isSource": true,
     "original": {
       "$value": [0, 0, 1, 1],
       "$type": "cubicBezier",
-      "$description": "Ideal for non-movement properties, like opacity or background color.",
+      "$description": "Constant motion with no acceleration. Use for continuous animations like progress bars or loaders.",
+      "$extensions": {
+        "org.primer.llm": {
+          "usage": ["progress-bar", "loader", "continuous-animation", "scrolling"],
+          "rules": "Use if the motion is constant."
+        }
+      },
       "key": "{base.easing.linear}"
     },
     "name": "base-easing-linear",
@@ -245,6 +394,6 @@
     "path": ["base", "easing", "linear"],
     "value": [0, 0, 1, 1],
     "type": "cubicBezier",
-    "description": "Ideal for non-movement properties, like opacity or background color."
+    "description": "Constant motion with no acceleration. Use for continuous animations like progress bars or loaders."
   }
 }

package/dist/docs/base/size/size.json

@@ -10,7 +10,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "112px",
+      "$value": {
+        "value": 112,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -37,7 +40,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "12px",
+      "$value": {
+        "value": 12,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -64,7 +70,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "128px",
+      "$value": {
+        "value": 128,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -91,7 +100,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "16px",
+      "$value": {
+        "value": 16,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -118,7 +130,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "2px",
+      "$value": {
+        "value": 2,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -145,7 +160,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "20px",
+      "$value": {
+        "value": 20,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -172,7 +190,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "24px",
+      "$value": {
+        "value": 24,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -199,7 +220,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "28px",
+      "$value": {
+        "value": 28,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -226,7 +250,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "32px",
+      "$value": {
+        "value": 32,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -253,7 +280,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "36px",
+      "$value": {
+        "value": 36,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -280,7 +310,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "4px",
+      "$value": {
+        "value": 4,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -307,7 +340,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "40px",
+      "$value": {
+        "value": 40,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -334,7 +370,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "44px",
+      "$value": {
+        "value": 44,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -361,7 +400,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "48px",
+      "$value": {
+        "value": 48,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -388,7 +430,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "6px",
+      "$value": {
+        "value": 6,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -415,7 +460,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "64px",
+      "$value": {
+        "value": 64,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -442,7 +490,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "8px",
+      "$value": {
+        "value": 8,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -469,7 +520,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "80px",
+      "$value": {
+        "value": 80,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {
@@ -496,7 +550,10 @@
     "filePath": "src/tokens/base/size/size.json5",
     "isSource": true,
     "original": {
-      "$value": "96px",
+      "$value": {
+        "value": 96,
+        "unit": "px"
+      },
       "$type": "dimension",
       "$extensions": {
         "org.primer.figma": {