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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (198) hide show
  1. package/DESIGN_TOKENS_GUIDE.md +185 -0
  2. package/DESIGN_TOKENS_SPEC.md +565 -0
  3. package/dist/build/filters/hasLlmExtensions.d.ts +7 -0
  4. package/dist/build/filters/hasLlmExtensions.js +11 -0
  5. package/dist/build/filters/index.d.ts +1 -0
  6. package/dist/build/filters/index.js +1 -0
  7. package/dist/build/formats/index.d.ts +1 -0
  8. package/dist/build/formats/index.js +1 -0
  9. package/dist/build/formats/markdownLlmGuidelines.d.ts +11 -0
  10. package/dist/build/formats/markdownLlmGuidelines.js +1168 -0
  11. package/dist/build/platforms/index.d.ts +1 -0
  12. package/dist/build/platforms/index.js +1 -0
  13. package/dist/build/platforms/llmGuidelines.d.ts +2 -0
  14. package/dist/build/platforms/llmGuidelines.js +17 -0
  15. package/dist/build/preprocessors/inheritGroupProperties.d.ts +7 -0
  16. package/dist/build/preprocessors/inheritGroupProperties.js +70 -0
  17. package/dist/build/primerStyleDictionary.js +7 -1
  18. package/dist/build/schemas/borderToken.d.ts +22 -2
  19. package/dist/build/schemas/borderToken.js +6 -0
  20. package/dist/build/schemas/colorToken.d.ts +4 -0
  21. package/dist/build/schemas/colorToken.js +2 -0
  22. package/dist/build/schemas/cubicBezierToken.d.ts +6 -0
  23. package/dist/build/schemas/cubicBezierToken.js +10 -2
  24. package/dist/build/schemas/designToken.d.ts +1 -1
  25. package/dist/build/schemas/designToken.js +113 -21
  26. package/dist/build/schemas/dimensionToken.d.ts +14 -3
  27. package/dist/build/schemas/dimensionToken.js +6 -2
  28. package/dist/build/schemas/dimensionValue.d.ts +24 -1
  29. package/dist/build/schemas/dimensionValue.js +20 -1
  30. package/dist/build/schemas/durationToken.d.ts +13 -1
  31. package/dist/build/schemas/durationToken.js +6 -0
  32. package/dist/build/schemas/durationValue.d.ts +11 -1
  33. package/dist/build/schemas/durationValue.js +13 -3
  34. package/dist/build/schemas/fontFamilyToken.d.ts +4 -0
  35. package/dist/build/schemas/fontFamilyToken.js +2 -0
  36. package/dist/build/schemas/fontWeightToken.d.ts +4 -0
  37. package/dist/build/schemas/fontWeightToken.js +2 -0
  38. package/dist/build/schemas/gradientToken.d.ts +4 -0
  39. package/dist/build/schemas/gradientToken.js +2 -0
  40. package/dist/build/schemas/llmExtension.d.ts +9 -0
  41. package/dist/build/schemas/llmExtension.js +11 -0
  42. package/dist/build/schemas/numberToken.d.ts +4 -0
  43. package/dist/build/schemas/numberToken.js +2 -0
  44. package/dist/build/schemas/shadowToken.d.ts +676 -84
  45. package/dist/build/schemas/shadowToken.js +2 -0
  46. package/dist/build/schemas/stringToken.d.ts +6 -0
  47. package/dist/build/schemas/stringToken.js +6 -0
  48. package/dist/build/schemas/transitionToken.d.ts +20 -2
  49. package/dist/build/schemas/transitionToken.js +6 -0
  50. package/dist/build/schemas/typographyToken.d.ts +38 -4
  51. package/dist/build/schemas/typographyToken.js +6 -0
  52. package/dist/build/schemas/validTokenType.d.ts +5 -1
  53. package/dist/build/schemas/validTokenType.js +71 -17
  54. package/dist/build/schemas/viewportRangeToken.d.ts +6 -0
  55. package/dist/build/schemas/viewportRangeToken.js +6 -0
  56. package/dist/build/transformers/dimensionToPixelUnitless.d.ts +3 -2
  57. package/dist/build/transformers/dimensionToPixelUnitless.js +22 -26
  58. package/dist/build/transformers/dimensionToRem.d.ts +2 -1
  59. package/dist/build/transformers/dimensionToRem.js +21 -22
  60. package/dist/build/transformers/dimensionToRemPxArray.d.ts +2 -1
  61. package/dist/build/transformers/dimensionToRemPxArray.js +21 -22
  62. package/dist/build/transformers/durationToCss.d.ts +2 -1
  63. package/dist/build/transformers/durationToCss.js +18 -11
  64. package/dist/build/transformers/utilities/parseDimension.d.ts +12 -0
  65. package/dist/build/transformers/utilities/parseDimension.js +31 -0
  66. package/dist/build/types/dimensionTokenValue.d.ts +9 -0
  67. package/dist/css/base/motion/motion.css +5 -4
  68. package/dist/css/functional/size/border.css +9 -14
  69. package/dist/css/functional/size/radius.css +7 -0
  70. package/dist/css/functional/size/size-coarse.css +3 -3
  71. package/dist/css/functional/size/size-fine.css +3 -3
  72. package/dist/css/functional/size/viewport.css +1 -1
  73. package/dist/css/functional/themes/dark-colorblind-high-contrast.css +194 -190
  74. package/dist/css/functional/themes/dark-colorblind.css +194 -190
  75. package/dist/css/functional/themes/dark-dimmed-high-contrast.css +194 -190
  76. package/dist/css/functional/themes/dark-dimmed.css +194 -190
  77. package/dist/css/functional/themes/dark-high-contrast.css +194 -190
  78. package/dist/css/functional/themes/dark-tritanopia-high-contrast.css +194 -190
  79. package/dist/css/functional/themes/dark-tritanopia.css +194 -190
  80. package/dist/css/functional/themes/dark.css +194 -190
  81. package/dist/css/functional/themes/light-colorblind-high-contrast.css +194 -190
  82. package/dist/css/functional/themes/light-colorblind.css +194 -190
  83. package/dist/css/functional/themes/light-high-contrast.css +194 -190
  84. package/dist/css/functional/themes/light-tritanopia-high-contrast.css +194 -190
  85. package/dist/css/functional/themes/light-tritanopia.css +194 -190
  86. package/dist/css/functional/themes/light.css +194 -190
  87. package/dist/css/functional/typography/typography.css +4 -4
  88. package/dist/css/primitives.css +5 -0
  89. package/dist/docs/base/motion/motion.json +181 -32
  90. package/dist/docs/base/size/size.json +76 -19
  91. package/dist/docs/base/typography/typography.json +24 -6
  92. package/dist/docs/functional/size/border.json +62 -182
  93. package/dist/docs/functional/size/breakpoints.json +24 -6
  94. package/dist/docs/functional/size/radius.json +221 -0
  95. package/dist/docs/functional/size/size-coarse.json +45 -3
  96. package/dist/docs/functional/size/size-fine.json +45 -3
  97. package/dist/docs/functional/size/size.json +60 -15
  98. package/dist/docs/functional/size/viewport.json +2 -2
  99. package/dist/docs/functional/themes/dark-colorblind-high-contrast.json +1043 -97
  100. package/dist/docs/functional/themes/dark-colorblind.json +1043 -97
  101. package/dist/docs/functional/themes/dark-dimmed-high-contrast.json +1043 -97
  102. package/dist/docs/functional/themes/dark-dimmed.json +1081 -135
  103. package/dist/docs/functional/themes/dark-high-contrast.json +1043 -97
  104. package/dist/docs/functional/themes/dark-tritanopia-high-contrast.json +1043 -97
  105. package/dist/docs/functional/themes/dark-tritanopia.json +1043 -97
  106. package/dist/docs/functional/themes/dark.json +1043 -97
  107. package/dist/docs/functional/themes/light-colorblind-high-contrast.json +1049 -103
  108. package/dist/docs/functional/themes/light-colorblind.json +1049 -103
  109. package/dist/docs/functional/themes/light-high-contrast.json +1049 -103
  110. package/dist/docs/functional/themes/light-tritanopia-high-contrast.json +1049 -103
  111. package/dist/docs/functional/themes/light-tritanopia.json +1049 -103
  112. package/dist/docs/functional/themes/light.json +1049 -103
  113. package/dist/docs/functional/typography/typography.json +180 -10
  114. package/dist/fallbacks/base/motion/motion.json +49 -12
  115. package/dist/fallbacks/functional/size/border.json +0 -5
  116. package/dist/fallbacks/functional/size/radius.json +7 -0
  117. package/dist/fallbacks/functional/size/viewport.json +1 -1
  118. package/dist/figma/dimension/dimension.json +30 -20
  119. package/dist/figma/themes/dark-colorblind.json +85 -0
  120. package/dist/figma/themes/dark-dimmed.json +134 -49
  121. package/dist/figma/themes/dark-high-contrast.json +85 -0
  122. package/dist/figma/themes/dark-tritanopia.json +85 -0
  123. package/dist/figma/themes/dark.json +85 -0
  124. package/dist/figma/themes/light-colorblind.json +89 -4
  125. package/dist/figma/themes/light-high-contrast.json +89 -4
  126. package/dist/figma/themes/light-tritanopia.json +89 -4
  127. package/dist/figma/themes/light.json +89 -4
  128. package/dist/figma/typography/typography.json +44 -40
  129. package/dist/internalCss/dark-colorblind-high-contrast.css +208 -218
  130. package/dist/internalCss/dark-colorblind.css +208 -218
  131. package/dist/internalCss/dark-dimmed-high-contrast.css +208 -218
  132. package/dist/internalCss/dark-dimmed.css +208 -218
  133. package/dist/internalCss/dark-high-contrast.css +208 -218
  134. package/dist/internalCss/dark-tritanopia-high-contrast.css +208 -218
  135. package/dist/internalCss/dark-tritanopia.css +208 -218
  136. package/dist/internalCss/dark.css +208 -218
  137. package/dist/internalCss/light-colorblind-high-contrast.css +208 -218
  138. package/dist/internalCss/light-colorblind.css +208 -218
  139. package/dist/internalCss/light-high-contrast.css +208 -218
  140. package/dist/internalCss/light-tritanopia-high-contrast.css +208 -218
  141. package/dist/internalCss/light-tritanopia.css +208 -218
  142. package/dist/internalCss/light.css +208 -218
  143. package/dist/styleLint/base/motion/motion.json +181 -32
  144. package/dist/styleLint/base/size/size.json +76 -19
  145. package/dist/styleLint/base/typography/typography.json +30 -12
  146. package/dist/styleLint/functional/size/border.json +55 -175
  147. package/dist/styleLint/functional/size/breakpoints.json +24 -6
  148. package/dist/styleLint/functional/size/radius.json +221 -0
  149. package/dist/styleLint/functional/size/size-coarse.json +45 -3
  150. package/dist/styleLint/functional/size/size-fine.json +45 -3
  151. package/dist/styleLint/functional/size/size.json +111 -66
  152. package/dist/styleLint/functional/size/viewport.json +2 -2
  153. package/dist/styleLint/functional/themes/dark-colorblind-high-contrast.json +975 -29
  154. package/dist/styleLint/functional/themes/dark-colorblind.json +975 -29
  155. package/dist/styleLint/functional/themes/dark-dimmed-high-contrast.json +975 -29
  156. package/dist/styleLint/functional/themes/dark-dimmed.json +1013 -67
  157. package/dist/styleLint/functional/themes/dark-high-contrast.json +975 -29
  158. package/dist/styleLint/functional/themes/dark-tritanopia-high-contrast.json +975 -29
  159. package/dist/styleLint/functional/themes/dark-tritanopia.json +975 -29
  160. package/dist/styleLint/functional/themes/dark.json +975 -29
  161. package/dist/styleLint/functional/themes/light-colorblind-high-contrast.json +981 -35
  162. package/dist/styleLint/functional/themes/light-colorblind.json +981 -35
  163. package/dist/styleLint/functional/themes/light-high-contrast.json +981 -35
  164. package/dist/styleLint/functional/themes/light-tritanopia-high-contrast.json +981 -35
  165. package/dist/styleLint/functional/themes/light-tritanopia.json +981 -35
  166. package/dist/styleLint/functional/themes/light.json +981 -35
  167. package/dist/styleLint/functional/typography/typography.json +196 -26
  168. package/package.json +6 -3
  169. package/src/tokens/base/motion/easing.json5 +39 -4
  170. package/src/tokens/base/motion/timing.json5 +12 -12
  171. package/src/tokens/base/size/size.json5 +19 -19
  172. package/src/tokens/base/typography/typography.json5 +6 -6
  173. package/src/tokens/functional/border/border.json5 +25 -0
  174. package/src/tokens/functional/color/bgColor.json5 +165 -0
  175. package/src/tokens/functional/color/borderColor.json5 +146 -0
  176. package/src/tokens/functional/color/control.json5 +24 -0
  177. package/src/tokens/functional/color/data-vis.json5 +7 -0
  178. package/src/tokens/functional/color/display.json5 +7 -0
  179. package/src/tokens/functional/color/fgColor.json5 +101 -1
  180. package/src/tokens/functional/color/focus.json5 +5 -0
  181. package/src/tokens/functional/color/selection.json5 +5 -0
  182. package/src/tokens/functional/color/syntax.json5 +14 -0
  183. package/src/tokens/functional/shadow/shadow.json5 +49 -4
  184. package/src/tokens/functional/size/border.json5 +22 -74
  185. package/src/tokens/functional/size/breakpoints.json5 +6 -6
  186. package/src/tokens/functional/size/radius.json5 +90 -0
  187. package/src/tokens/functional/size/size-coarse.json5 +24 -3
  188. package/src/tokens/functional/size/size-fine.json5 +45 -24
  189. package/src/tokens/functional/size/size.json5 +50 -15
  190. package/src/tokens/functional/size/viewport.json5 +1 -1
  191. package/src/tokens/functional/typography/font-stack.json5 +60 -0
  192. package/src/tokens/functional/typography/typography.json5 +71 -44
  193. package/dist/build/parsers/index.d.ts +0 -1
  194. package/dist/build/parsers/index.js +0 -1
  195. package/dist/build/parsers/w3cJsonParser.d.ts +0 -6
  196. package/dist/build/parsers/w3cJsonParser.js +0 -25
  197. package/dist/removed/testing.json5 +0 -4
  198. package/src/tokens/removed/testing.json5 +0 -4
package/dist/figma/themes/light-high-contrast.json CHANGED
@@ -91,7 +91,7 @@
91
91
  "r": 0.00392156862745098,
92
92
  "g": 0.01568627450980392,
93
93
  "b": 0.03529411764705882,
94
- "a": 0.06
94
+ "a": 0.05
95
95
  },
96
96
  "type": "COLOR",
97
97
  "scopes": ["EFFECT_COLOR"],
@@ -141,7 +141,7 @@
141
141
  "r": 0.00392156862745098,
142
142
  "g": 0.01568627450980392,
143
143
  "b": 0.03529411764705882,
144
- "a": 0.06
144
+ "a": 0.04
145
145
  },
146
146
  "type": "COLOR",
147
147
  "scopes": ["EFFECT_COLOR"],
@@ -169,7 +169,7 @@
169
169
  },
170
170
  {
171
171
  "name": "shadow/resting/small/2/blur",
172
- "value": 3,
172
+ "value": 2,
173
173
  "type": "FLOAT",
174
174
  "scopes": ["EFFECT_FLOAT"],
175
175
  "mode": "light high contrast",
@@ -191,7 +191,7 @@
191
191
  "r": 0.00392156862745098,
192
192
  "g": 0.01568627450980392,
193
193
  "b": 0.03529411764705882,
194
- "a": 0.06
194
+ "a": 0.03
195
195
  },
196
196
  "type": "COLOR",
197
197
  "scopes": ["EFFECT_COLOR"],
@@ -908,6 +908,7 @@
908
908
  "a": 1
909
909
  },
910
910
  "type": "COLOR",
911
+ "description": "Outline color for focus states on interactive elements",
911
912
  "refId": "mode/focus/outlineColor",
912
913
  "reference": "mode/borderColor/accent-emphasis",
913
914
  "collection": "mode",
@@ -924,6 +925,7 @@
924
925
  "a": 1
925
926
  },
926
927
  "type": "COLOR",
928
+ "description": "Default background color for pages and main content areas",
927
929
  "refId": "mode/bgColor/default",
928
930
  "reference": "base/color/light/base/color/neutral/0",
929
931
  "collection": "mode",
@@ -943,6 +945,7 @@
943
945
  "a": 1
944
946
  },
945
947
  "type": "COLOR",
948
+ "description": "Muted background for secondary content areas and subtle grouping",
946
949
  "refId": "mode/bgColor/muted",
947
950
  "reference": "base/color/light/base/color/neutral/3",
948
951
  "collection": "mode",
@@ -962,6 +965,7 @@
962
965
  "a": 1
963
966
  },
964
967
  "type": "COLOR",
968
+ "description": "Inset background for recessed content areas like wells or sunken panels",
965
969
  "refId": "mode/bgColor/inset",
966
970
  "reference": "base/color/light/base/color/neutral/2",
967
971
  "collection": "mode",
@@ -981,6 +985,7 @@
981
985
  "a": 1
982
986
  },
983
987
  "type": "COLOR",
988
+ "description": "High-emphasis dark background for strong visual contrast",
984
989
  "refId": "mode/bgColor/emphasis",
985
990
  "reference": "base/color/light/base/color/neutral/12",
986
991
  "collection": "mode",
@@ -1000,6 +1005,7 @@
1000
1005
  "a": 1
1001
1006
  },
1002
1007
  "type": "COLOR",
1008
+ "description": "Inverse background that flips between light and dark modes",
1003
1009
  "refId": "mode/bgColor/inverse",
1004
1010
  "reference": "base/color/light/base/color/neutral/12",
1005
1011
  "collection": "mode",
@@ -1016,6 +1022,7 @@
1016
1022
  "a": 1
1017
1023
  },
1018
1024
  "type": "COLOR",
1025
+ "description": "Pure white background",
1019
1026
  "refId": "mode/bgColor/white",
1020
1027
  "reference": "base/color/light/base/color/neutral/0",
1021
1028
  "collection": "mode",
@@ -1032,6 +1039,7 @@
1032
1039
  "a": 1
1033
1040
  },
1034
1041
  "type": "COLOR",
1042
+ "description": "Pure black background",
1035
1043
  "refId": "mode/bgColor/black",
1036
1044
  "reference": "base/color/light/base/color/neutral/13",
1037
1045
  "collection": "mode",
@@ -1048,6 +1056,7 @@
1048
1056
  "a": 1
1049
1057
  },
1050
1058
  "type": "COLOR",
1059
+ "description": "Background for disabled interactive elements",
1051
1060
  "refId": "mode/bgColor/disabled",
1052
1061
  "reference": "base/color/light/base/color/neutral/4",
1053
1062
  "collection": "mode",
@@ -1064,6 +1073,7 @@
1064
1073
  "a": 0
1065
1074
  },
1066
1075
  "type": "COLOR",
1076
+ "description": "Fully transparent background",
1067
1077
  "refId": "mode/bgColor/transparent",
1068
1078
  "reference": "base/color/light/base/color/transparent",
1069
1079
  "collection": "mode",
@@ -1083,6 +1093,7 @@
1083
1093
  "a": 1
1084
1094
  },
1085
1095
  "type": "COLOR",
1096
+ "description": "Subtle neutral background for tags, labels, and secondary UI elements",
1086
1097
  "refId": "mode/bgColor/neutral-muted",
1087
1098
  "reference": "base/color/light/base/color/neutral/4",
1088
1099
  "collection": "mode",
@@ -1099,6 +1110,7 @@
1099
1110
  "a": 1
1100
1111
  },
1101
1112
  "type": "COLOR",
1113
+ "description": "Strong neutral background for prominent neutral elements",
1102
1114
  "refId": "mode/bgColor/neutral-emphasis",
1103
1115
  "reference": "base/color/light/base/color/neutral/10",
1104
1116
  "collection": "mode",
@@ -1115,6 +1127,7 @@
1115
1127
  "a": 1
1116
1128
  },
1117
1129
  "type": "COLOR",
1130
+ "description": "Subtle accent background for informational or selected elements",
1118
1131
  "refId": "mode/bgColor/accent-muted",
1119
1132
  "reference": "base/color/light-high-contrast/base/color/blue/0",
1120
1133
  "collection": "mode",
@@ -1134,6 +1147,7 @@
1134
1147
  "a": 1
1135
1148
  },
1136
1149
  "type": "COLOR",
1150
+ "description": "Strong accent background for active states and focused states",
1137
1151
  "refId": "mode/bgColor/accent-emphasis",
1138
1152
  "reference": "base/color/light-high-contrast/base/color/blue/5",
1139
1153
  "collection": "mode",
@@ -1153,6 +1167,7 @@
1153
1167
  "a": 1
1154
1168
  },
1155
1169
  "type": "COLOR",
1170
+ "description": "Subtle success background for positive feedback and completed states",
1156
1171
  "refId": "mode/bgColor/success-muted",
1157
1172
  "reference": "base/color/light-high-contrast/base/color/green/0",
1158
1173
  "collection": "mode",
@@ -1172,6 +1187,7 @@
1172
1187
  "a": 1
1173
1188
  },
1174
1189
  "type": "COLOR",
1190
+ "description": "Strong success background for prominent positive actions",
1175
1191
  "refId": "mode/bgColor/success-emphasis",
1176
1192
  "reference": "base/color/light-high-contrast/base/color/green/5",
1177
1193
  "collection": "mode",
@@ -1191,6 +1207,7 @@
1191
1207
  "a": 1
1192
1208
  },
1193
1209
  "type": "COLOR",
1210
+ "description": "Subtle background for open state indicators (issues, PRs)",
1194
1211
  "refId": "mode/bgColor/open-muted",
1195
1212
  "reference": "mode/bgColor/success-muted",
1196
1213
  "collection": "mode",
@@ -1210,6 +1227,7 @@
1210
1227
  "a": 1
1211
1228
  },
1212
1229
  "type": "COLOR",
1230
+ "description": "Strong background for open state badges and labels",
1213
1231
  "refId": "mode/bgColor/open-emphasis",
1214
1232
  "reference": "mode/bgColor/success-emphasis",
1215
1233
  "collection": "mode",
@@ -1229,6 +1247,7 @@
1229
1247
  "a": 1
1230
1248
  },
1231
1249
  "type": "COLOR",
1250
+ "description": "Subtle attention background for warnings and caution states",
1232
1251
  "refId": "mode/bgColor/attention-muted",
1233
1252
  "reference": "base/color/light-high-contrast/base/color/yellow/0",
1234
1253
  "collection": "mode",
@@ -1248,6 +1267,7 @@
1248
1267
  "a": 1
1249
1268
  },
1250
1269
  "type": "COLOR",
1270
+ "description": "Strong attention background for prominent warnings",
1251
1271
  "refId": "mode/bgColor/attention-emphasis",
1252
1272
  "reference": "base/color/light-high-contrast/base/color/yellow/5",
1253
1273
  "collection": "mode",
@@ -1267,6 +1287,7 @@
1267
1287
  "a": 1
1268
1288
  },
1269
1289
  "type": "COLOR",
1290
+ "description": "Subtle severe background for high-priority warnings",
1270
1291
  "refId": "mode/bgColor/severe-muted",
1271
1292
  "reference": "base/color/light-high-contrast/base/color/orange/0",
1272
1293
  "collection": "mode",
@@ -1286,6 +1307,7 @@
1286
1307
  "a": 1
1287
1308
  },
1288
1309
  "type": "COLOR",
1310
+ "description": "Strong severe background for prominent high-priority warnings",
1289
1311
  "refId": "mode/bgColor/severe-emphasis",
1290
1312
  "reference": "base/color/light-high-contrast/base/color/orange/5",
1291
1313
  "collection": "mode",
@@ -1305,6 +1327,7 @@
1305
1327
  "a": 1
1306
1328
  },
1307
1329
  "type": "COLOR",
1330
+ "description": "Muted danger background for error states and destructive action contexts",
1308
1331
  "refId": "mode/bgColor/danger-muted",
1309
1332
  "reference": "base/color/light-high-contrast/base/color/red/0",
1310
1333
  "collection": "mode",
@@ -1324,6 +1347,7 @@
1324
1347
  "a": 1
1325
1348
  },
1326
1349
  "type": "COLOR",
1350
+ "description": "Emphasized danger background for critical errors and delete confirmations",
1327
1351
  "refId": "mode/bgColor/danger-emphasis",
1328
1352
  "reference": "base/color/light-high-contrast/base/color/red/5",
1329
1353
  "collection": "mode",
@@ -1343,6 +1367,7 @@
1343
1367
  "a": 1
1344
1368
  },
1345
1369
  "type": "COLOR",
1370
+ "description": "Subtle background for closed state indicators (issues, PRs)",
1346
1371
  "refId": "mode/bgColor/closed-muted",
1347
1372
  "reference": "mode/bgColor/danger-muted",
1348
1373
  "collection": "mode",
@@ -1362,6 +1387,7 @@
1362
1387
  "a": 1
1363
1388
  },
1364
1389
  "type": "COLOR",
1390
+ "description": "Strong background for closed state badges and labels",
1365
1391
  "refId": "mode/bgColor/closed-emphasis",
1366
1392
  "reference": "mode/bgColor/danger-emphasis",
1367
1393
  "collection": "mode",
@@ -1381,6 +1407,7 @@
1381
1407
  "a": 1
1382
1408
  },
1383
1409
  "type": "COLOR",
1410
+ "description": "Subtle background for draft state indicators",
1384
1411
  "refId": "mode/bgColor/draft-muted",
1385
1412
  "reference": "mode/bgColor/neutral-muted",
1386
1413
  "collection": "mode",
@@ -1400,6 +1427,7 @@
1400
1427
  "a": 1
1401
1428
  },
1402
1429
  "type": "COLOR",
1430
+ "description": "Strong background for draft state badges and labels",
1403
1431
  "refId": "mode/bgColor/draft-emphasis",
1404
1432
  "reference": "mode/bgColor/neutral-emphasis",
1405
1433
  "collection": "mode",
@@ -1419,6 +1447,7 @@
1419
1447
  "a": 1
1420
1448
  },
1421
1449
  "type": "COLOR",
1450
+ "description": "Subtle background for completed/done state indicators",
1422
1451
  "refId": "mode/bgColor/done-muted",
1423
1452
  "reference": "base/color/light-high-contrast/base/color/purple/0",
1424
1453
  "collection": "mode",
@@ -1438,6 +1467,7 @@
1438
1467
  "a": 1
1439
1468
  },
1440
1469
  "type": "COLOR",
1470
+ "description": "Strong background for completed/done state badges and labels",
1441
1471
  "refId": "mode/bgColor/done-emphasis",
1442
1472
  "reference": "base/color/light-high-contrast/base/color/purple/5",
1443
1473
  "collection": "mode",
@@ -1457,6 +1487,7 @@
1457
1487
  "a": 1
1458
1488
  },
1459
1489
  "type": "COLOR",
1490
+ "description": "Subtle background for upsell and promotional content",
1460
1491
  "refId": "mode/bgColor/upsell-muted",
1461
1492
  "reference": "mode/bgColor/done-muted",
1462
1493
  "collection": "mode",
@@ -1476,6 +1507,7 @@
1476
1507
  "a": 1
1477
1508
  },
1478
1509
  "type": "COLOR",
1510
+ "description": "Strong background for prominent upsell elements",
1479
1511
  "refId": "mode/bgColor/upsell-emphasis",
1480
1512
  "reference": "mode/bgColor/done-emphasis",
1481
1513
  "collection": "mode",
@@ -1495,6 +1527,7 @@
1495
1527
  "a": 1
1496
1528
  },
1497
1529
  "type": "COLOR",
1530
+ "description": "Subtle background for GitHub Sponsors content",
1498
1531
  "refId": "mode/bgColor/sponsors-muted",
1499
1532
  "reference": "base/color/light-high-contrast/base/color/pink/0",
1500
1533
  "collection": "mode",
@@ -1514,6 +1547,7 @@
1514
1547
  "a": 1
1515
1548
  },
1516
1549
  "type": "COLOR",
1550
+ "description": "Strong background for prominent GitHub Sponsors elements",
1517
1551
  "refId": "mode/bgColor/sponsors-emphasis",
1518
1552
  "reference": "base/color/light-high-contrast/base/color/pink/5",
1519
1553
  "collection": "mode",
@@ -1533,6 +1567,7 @@
1533
1567
  "a": 1
1534
1568
  },
1535
1569
  "type": "COLOR",
1570
+ "description": "Default border color for most UI elements",
1536
1571
  "refId": "mode/borderColor/default",
1537
1572
  "reference": "base/color/light/base/color/neutral/10",
1538
1573
  "collection": "mode",
@@ -1553,6 +1588,7 @@
1553
1588
  },
1554
1589
  "type": "COLOR",
1555
1590
  "alpha": 1,
1591
+ "description": "Subtle border for secondary elements and light separators",
1556
1592
  "refId": "mode/borderColor/muted",
1557
1593
  "reference": "mode/borderColor/default",
1558
1594
  "collection": "mode",
@@ -1572,6 +1608,7 @@
1572
1608
  "a": 1
1573
1609
  },
1574
1610
  "type": "COLOR",
1611
+ "description": "Strong border for emphasis and visual weight",
1575
1612
  "refId": "mode/borderColor/emphasis",
1576
1613
  "reference": "mode/borderColor/default",
1577
1614
  "collection": "mode",
@@ -1589,6 +1626,7 @@
1589
1626
  },
1590
1627
  "type": "COLOR",
1591
1628
  "alpha": 0.12,
1629
+ "description": "Border color for disabled interactive elements",
1592
1630
  "refId": "mode/borderColor/disabled",
1593
1631
  "reference": "base/color/light/base/color/neutral/9",
1594
1632
  "collection": "mode",
@@ -1605,6 +1643,7 @@
1605
1643
  "a": 0
1606
1644
  },
1607
1645
  "type": "COLOR",
1646
+ "description": "Fully transparent border",
1608
1647
  "refId": "mode/borderColor/transparent",
1609
1648
  "reference": "base/color/light/base/color/transparent",
1610
1649
  "collection": "mode",
@@ -1622,6 +1661,7 @@
1622
1661
  },
1623
1662
  "type": "COLOR",
1624
1663
  "alpha": 1,
1664
+ "description": "Semi-transparent border for overlays and layered elements",
1625
1665
  "refId": "mode/borderColor/translucent",
1626
1666
  "reference": "base/color/light/base/color/neutral/9",
1627
1667
  "collection": "mode",
@@ -1638,6 +1678,7 @@
1638
1678
  "a": 1
1639
1679
  },
1640
1680
  "type": "COLOR",
1681
+ "description": "Subtle neutral semantic border",
1641
1682
  "refId": "mode/borderColor/neutral-muted",
1642
1683
  "reference": "mode/borderColor/muted",
1643
1684
  "collection": "mode",
@@ -1654,6 +1695,7 @@
1654
1695
  "a": 1
1655
1696
  },
1656
1697
  "type": "COLOR",
1698
+ "description": "Strong neutral semantic border",
1657
1699
  "refId": "mode/borderColor/neutral-emphasis",
1658
1700
  "reference": "base/color/light/base/color/neutral/9",
1659
1701
  "collection": "mode",
@@ -1671,6 +1713,7 @@
1671
1713
  },
1672
1714
  "type": "COLOR",
1673
1715
  "alpha": 1,
1716
+ "description": "Subtle accent border for selected or focused elements",
1674
1717
  "refId": "mode/borderColor/accent-muted",
1675
1718
  "reference": "base/color/light-high-contrast/base/color/blue/3",
1676
1719
  "collection": "mode",
@@ -1690,6 +1733,7 @@
1690
1733
  "a": 1
1691
1734
  },
1692
1735
  "type": "COLOR",
1736
+ "description": "Strong accent border for selected or focused elements",
1693
1737
  "refId": "mode/borderColor/accent-emphasis",
1694
1738
  "reference": "base/color/light-high-contrast/base/color/blue/5",
1695
1739
  "collection": "mode",
@@ -1710,6 +1754,7 @@
1710
1754
  },
1711
1755
  "type": "COLOR",
1712
1756
  "alpha": 1,
1757
+ "description": "Subtle success border for positive feedback elements",
1713
1758
  "refId": "mode/borderColor/success-muted",
1714
1759
  "reference": "base/color/light-high-contrast/base/color/green/3",
1715
1760
  "collection": "mode",
@@ -1729,6 +1774,7 @@
1729
1774
  "a": 1
1730
1775
  },
1731
1776
  "type": "COLOR",
1777
+ "description": "Strong success border for prominent positive elements",
1732
1778
  "refId": "mode/borderColor/success-emphasis",
1733
1779
  "reference": "base/color/light-high-contrast/base/color/green/5",
1734
1780
  "collection": "mode",
@@ -1748,6 +1794,7 @@
1748
1794
  "a": 1
1749
1795
  },
1750
1796
  "type": "COLOR",
1797
+ "description": "Subtle border for open state indicators",
1751
1798
  "refId": "mode/borderColor/open-muted",
1752
1799
  "reference": "mode/borderColor/success-muted",
1753
1800
  "collection": "mode",
@@ -1767,6 +1814,7 @@
1767
1814
  "a": 1
1768
1815
  },
1769
1816
  "type": "COLOR",
1817
+ "description": "Strong border for open state badges",
1770
1818
  "refId": "mode/borderColor/open-emphasis",
1771
1819
  "reference": "mode/borderColor/success-emphasis",
1772
1820
  "collection": "mode",
@@ -1787,6 +1835,7 @@
1787
1835
  },
1788
1836
  "type": "COLOR",
1789
1837
  "alpha": 1,
1838
+ "description": "Subtle attention border for warnings and caution states",
1790
1839
  "refId": "mode/borderColor/attention-muted",
1791
1840
  "reference": "base/color/light-high-contrast/base/color/yellow/3",
1792
1841
  "collection": "mode",
@@ -1806,6 +1855,7 @@
1806
1855
  "a": 1
1807
1856
  },
1808
1857
  "type": "COLOR",
1858
+ "description": "Strong attention border for prominent warnings",
1809
1859
  "refId": "mode/borderColor/attention-emphasis",
1810
1860
  "reference": "base/color/light-high-contrast/base/color/yellow/5",
1811
1861
  "collection": "mode",
@@ -1826,6 +1876,7 @@
1826
1876
  },
1827
1877
  "type": "COLOR",
1828
1878
  "alpha": 1,
1879
+ "description": "Subtle severe border for high-priority warnings",
1829
1880
  "refId": "mode/borderColor/severe-muted",
1830
1881
  "reference": "base/color/light-high-contrast/base/color/orange/3",
1831
1882
  "collection": "mode",
@@ -1845,6 +1896,7 @@
1845
1896
  "a": 1
1846
1897
  },
1847
1898
  "type": "COLOR",
1899
+ "description": "Strong severe border for prominent high-priority warnings",
1848
1900
  "refId": "mode/borderColor/severe-emphasis",
1849
1901
  "reference": "base/color/light-high-contrast/base/color/orange/5",
1850
1902
  "collection": "mode",
@@ -1865,6 +1917,7 @@
1865
1917
  },
1866
1918
  "type": "COLOR",
1867
1919
  "alpha": 1,
1920
+ "description": "Subtle danger border for errors and destructive contexts",
1868
1921
  "refId": "mode/borderColor/danger-muted",
1869
1922
  "reference": "base/color/light-high-contrast/base/color/red/3",
1870
1923
  "collection": "mode",
@@ -1884,6 +1937,7 @@
1884
1937
  "a": 1
1885
1938
  },
1886
1939
  "type": "COLOR",
1940
+ "description": "Strong danger border for destructive actions and errors",
1887
1941
  "refId": "mode/borderColor/danger-emphasis",
1888
1942
  "reference": "base/color/light-high-contrast/base/color/red/5",
1889
1943
  "collection": "mode",
@@ -1903,6 +1957,7 @@
1903
1957
  "a": 1
1904
1958
  },
1905
1959
  "type": "COLOR",
1960
+ "description": "Subtle border for closed state indicators",
1906
1961
  "refId": "mode/borderColor/closed-muted",
1907
1962
  "reference": "mode/borderColor/danger-muted",
1908
1963
  "collection": "mode",
@@ -1922,6 +1977,7 @@
1922
1977
  "a": 1
1923
1978
  },
1924
1979
  "type": "COLOR",
1980
+ "description": "Strong border for closed state badges",
1925
1981
  "refId": "mode/borderColor/closed-emphasis",
1926
1982
  "reference": "mode/borderColor/danger-emphasis",
1927
1983
  "collection": "mode",
@@ -1941,6 +1997,7 @@
1941
1997
  "a": 1
1942
1998
  },
1943
1999
  "type": "COLOR",
2000
+ "description": "Subtle border for draft state indicators",
1944
2001
  "refId": "mode/borderColor/draft-muted",
1945
2002
  "reference": "mode/borderColor/neutral-muted",
1946
2003
  "collection": "mode",
@@ -1960,6 +2017,7 @@
1960
2017
  "a": 1
1961
2018
  },
1962
2019
  "type": "COLOR",
2020
+ "description": "Strong border for draft state badges",
1963
2021
  "refId": "mode/borderColor/draft-emphasis",
1964
2022
  "reference": "mode/borderColor/neutral-emphasis",
1965
2023
  "collection": "mode",
@@ -1980,6 +2038,7 @@
1980
2038
  },
1981
2039
  "type": "COLOR",
1982
2040
  "alpha": 1,
2041
+ "description": "Subtle border for completed/done state indicators",
1983
2042
  "refId": "mode/borderColor/done-muted",
1984
2043
  "reference": "base/color/light-high-contrast/base/color/purple/3",
1985
2044
  "collection": "mode",
@@ -1999,6 +2058,7 @@
1999
2058
  "a": 1
2000
2059
  },
2001
2060
  "type": "COLOR",
2061
+ "description": "Strong border for completed/done state badges",
2002
2062
  "refId": "mode/borderColor/done-emphasis",
2003
2063
  "reference": "base/color/light-high-contrast/base/color/purple/5",
2004
2064
  "collection": "mode",
@@ -2018,6 +2078,7 @@
2018
2078
  "a": 1
2019
2079
  },
2020
2080
  "type": "COLOR",
2081
+ "description": "Subtle border for upsell and promotional content",
2021
2082
  "refId": "mode/borderColor/upsell-muted",
2022
2083
  "reference": "mode/borderColor/done-muted",
2023
2084
  "collection": "mode",
@@ -2037,6 +2098,7 @@
2037
2098
  "a": 1
2038
2099
  },
2039
2100
  "type": "COLOR",
2101
+ "description": "Strong border for prominent upsell elements",
2040
2102
  "refId": "mode/borderColor/upsell-emphasis",
2041
2103
  "reference": "mode/borderColor/done-emphasis",
2042
2104
  "collection": "mode",
@@ -2057,6 +2119,7 @@
2057
2119
  },
2058
2120
  "type": "COLOR",
2059
2121
  "alpha": 1,
2122
+ "description": "Subtle border for GitHub Sponsors content",
2060
2123
  "refId": "mode/borderColor/sponsors-muted",
2061
2124
  "reference": "base/color/light-high-contrast/base/color/pink/3",
2062
2125
  "collection": "mode",
@@ -2076,6 +2139,7 @@
2076
2139
  "a": 1
2077
2140
  },
2078
2141
  "type": "COLOR",
2142
+ "description": "Strong border for prominent GitHub Sponsors elements",
2079
2143
  "refId": "mode/borderColor/sponsors-emphasis",
2080
2144
  "reference": "base/color/light-high-contrast/base/color/pink/5",
2081
2145
  "collection": "mode",
@@ -8030,6 +8094,7 @@
8030
8094
  "a": 1
8031
8095
  },
8032
8096
  "type": "COLOR",
8097
+ "description": "Default text color for primary content and headings",
8033
8098
  "refId": "mode/fgColor/default",
8034
8099
  "reference": "base/color/light/base/color/neutral/13",
8035
8100
  "collection": "mode",
@@ -8049,6 +8114,7 @@
8049
8114
  "a": 1
8050
8115
  },
8051
8116
  "type": "COLOR",
8117
+ "description": "Muted text for secondary content and less important information",
8052
8118
  "refId": "mode/fgColor/muted",
8053
8119
  "reference": "base/color/light/base/color/neutral/10",
8054
8120
  "collection": "mode",
@@ -8068,6 +8134,7 @@
8068
8134
  "a": 1
8069
8135
  },
8070
8136
  "type": "COLOR",
8137
+ "description": "Text color for use on emphasis backgrounds",
8071
8138
  "refId": "mode/fgColor/onEmphasis",
8072
8139
  "reference": "base/color/light/base/color/neutral/0",
8073
8140
  "collection": "mode",
@@ -8087,6 +8154,7 @@
8087
8154
  "a": 1
8088
8155
  },
8089
8156
  "type": "COLOR",
8157
+ "description": "Text color for use on inverse backgrounds",
8090
8158
  "refId": "mode/fgColor/onInverse",
8091
8159
  "reference": "base/color/light/base/color/neutral/0",
8092
8160
  "collection": "mode",
@@ -8103,6 +8171,7 @@
8103
8171
  "a": 1
8104
8172
  },
8105
8173
  "type": "COLOR",
8174
+ "description": "Pure white text",
8106
8175
  "refId": "mode/fgColor/white",
8107
8176
  "reference": "base/color/light/base/color/neutral/0",
8108
8177
  "collection": "mode",
@@ -8119,6 +8188,7 @@
8119
8188
  "a": 1
8120
8189
  },
8121
8190
  "type": "COLOR",
8191
+ "description": "Pure black text",
8122
8192
  "refId": "mode/fgColor/black",
8123
8193
  "reference": "base/color/light/base/color/neutral/13",
8124
8194
  "collection": "mode",
@@ -8135,6 +8205,7 @@
8135
8205
  "a": 1
8136
8206
  },
8137
8207
  "type": "COLOR",
8208
+ "description": "Text color for disabled interactive elements",
8138
8209
  "refId": "mode/fgColor/disabled",
8139
8210
  "reference": "base/color/light/base/color/neutral/9",
8140
8211
  "collection": "mode",
@@ -8151,6 +8222,7 @@
8151
8222
  "a": 1
8152
8223
  },
8153
8224
  "type": "COLOR",
8225
+ "description": "Text color for hyperlinks",
8154
8226
  "refId": "mode/fgColor/link",
8155
8227
  "reference": "mode/fgColor/accent",
8156
8228
  "collection": "mode",
@@ -8170,6 +8242,7 @@
8170
8242
  "a": 1
8171
8243
  },
8172
8244
  "type": "COLOR",
8245
+ "description": "Neutral semantic text for icons and secondary elements",
8173
8246
  "refId": "mode/fgColor/neutral",
8174
8247
  "reference": "base/color/light/base/color/neutral/11",
8175
8248
  "collection": "mode",
@@ -8186,6 +8259,7 @@
8186
8259
  "a": 1
8187
8260
  },
8188
8261
  "type": "COLOR",
8262
+ "description": "Accent text for links and interactive elements",
8189
8263
  "refId": "mode/fgColor/accent",
8190
8264
  "reference": "base/color/light-high-contrast/base/color/blue/6",
8191
8265
  "collection": "mode",
@@ -8205,6 +8279,7 @@
8205
8279
  "a": 1
8206
8280
  },
8207
8281
  "type": "COLOR",
8282
+ "description": "Success text for positive feedback and completed states",
8208
8283
  "refId": "mode/fgColor/success",
8209
8284
  "reference": "base/color/light-high-contrast/base/color/green/6",
8210
8285
  "collection": "mode",
@@ -8224,6 +8299,7 @@
8224
8299
  "a": 1
8225
8300
  },
8226
8301
  "type": "COLOR",
8302
+ "description": "Text color for open state indicators (issues, PRs)",
8227
8303
  "refId": "mode/fgColor/open",
8228
8304
  "reference": "mode/fgColor/success",
8229
8305
  "collection": "mode",
@@ -8243,6 +8319,7 @@
8243
8319
  "a": 1
8244
8320
  },
8245
8321
  "type": "COLOR",
8322
+ "description": "Attention text for warnings and caution states",
8246
8323
  "refId": "mode/fgColor/attention",
8247
8324
  "reference": "base/color/light-high-contrast/base/color/yellow/6",
8248
8325
  "collection": "mode",
@@ -8262,6 +8339,7 @@
8262
8339
  "a": 1
8263
8340
  },
8264
8341
  "type": "COLOR",
8342
+ "description": "Severe text for high-priority warnings",
8265
8343
  "refId": "mode/fgColor/severe",
8266
8344
  "reference": "base/color/light-high-contrast/base/color/orange/6",
8267
8345
  "collection": "mode",
@@ -8281,6 +8359,7 @@
8281
8359
  "a": 1
8282
8360
  },
8283
8361
  "type": "COLOR",
8362
+ "description": "Danger text for errors and destructive actions",
8284
8363
  "refId": "mode/fgColor/danger",
8285
8364
  "reference": "base/color/light-high-contrast/base/color/red/6",
8286
8365
  "collection": "mode",
@@ -8300,6 +8379,7 @@
8300
8379
  "a": 1
8301
8380
  },
8302
8381
  "type": "COLOR",
8382
+ "description": "Text color for closed state indicators (issues, PRs)",
8303
8383
  "refId": "mode/fgColor/closed",
8304
8384
  "reference": "mode/fgColor/danger",
8305
8385
  "collection": "mode",
@@ -8319,6 +8399,7 @@
8319
8399
  "a": 1
8320
8400
  },
8321
8401
  "type": "COLOR",
8402
+ "description": "Text color for draft state indicators",
8322
8403
  "refId": "mode/fgColor/draft",
8323
8404
  "reference": "mode/fgColor/neutral",
8324
8405
  "collection": "mode",
@@ -8338,6 +8419,7 @@
8338
8419
  "a": 1
8339
8420
  },
8340
8421
  "type": "COLOR",
8422
+ "description": "Text color for completed/done state indicators",
8341
8423
  "refId": "mode/fgColor/done",
8342
8424
  "reference": "base/color/light-high-contrast/base/color/purple/6",
8343
8425
  "collection": "mode",
@@ -8357,6 +8439,7 @@
8357
8439
  "a": 1
8358
8440
  },
8359
8441
  "type": "COLOR",
8442
+ "description": "Text color for upsell and promotional content",
8360
8443
  "refId": "mode/fgColor/upsell",
8361
8444
  "reference": "mode/fgColor/done",
8362
8445
  "collection": "mode",
@@ -8376,6 +8459,7 @@
8376
8459
  "a": 1
8377
8460
  },
8378
8461
  "type": "COLOR",
8462
+ "description": "Text color for GitHub Sponsors content",
8379
8463
  "refId": "mode/fgColor/sponsors",
8380
8464
  "reference": "base/color/light-high-contrast/base/color/pink/6",
8381
8465
  "collection": "mode",
@@ -8396,6 +8480,7 @@
8396
8480
  },
8397
8481
  "type": "COLOR",
8398
8482
  "alpha": 0.2,
8483
+ "description": "Background color for text selection highlights",
8399
8484
  "refId": "mode/selection/bgColor",
8400
8485
  "reference": "mode/bgColor/accent-emphasis",
8401
8486
  "collection": "mode",