@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
@@ -91,7 +91,7 @@
91
91
  "r": 0.12156862745098039,
92
92
  "g": 0.13725490196078433,
93
93
  "b": 0.1568627450980392,
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.12156862745098039,
142
142
  "g": 0.13725490196078433,
143
143
  "b": 0.1568627450980392,
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 tritanopia",
@@ -191,7 +191,7 @@
191
191
  "r": 0.12156862745098039,
192
192
  "g": 0.13725490196078433,
193
193
  "b": 0.1568627450980392,
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/1",
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": "mode/bgColor/muted",
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/2",
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",
@@ -1084,6 +1094,7 @@
1084
1094
  },
1085
1095
  "type": "COLOR",
1086
1096
  "alpha": 0.12,
1097
+ "description": "Subtle neutral background for tags, labels, and secondary UI elements",
1087
1098
  "refId": "mode/bgColor/neutral-muted",
1088
1099
  "reference": "base/color/light/base/color/neutral/8",
1089
1100
  "collection": "mode",
@@ -1100,6 +1111,7 @@
1100
1111
  "a": 1
1101
1112
  },
1102
1113
  "type": "COLOR",
1114
+ "description": "Strong neutral background for prominent neutral elements",
1103
1115
  "refId": "mode/bgColor/neutral-emphasis",
1104
1116
  "reference": "base/color/light/base/color/neutral/9",
1105
1117
  "collection": "mode",
@@ -1116,6 +1128,7 @@
1116
1128
  "a": 1
1117
1129
  },
1118
1130
  "type": "COLOR",
1131
+ "description": "Subtle accent background for informational or selected elements",
1119
1132
  "refId": "mode/bgColor/accent-muted",
1120
1133
  "reference": "base/color/light/base/color/blue/0",
1121
1134
  "collection": "mode",
@@ -1135,6 +1148,7 @@
1135
1148
  "a": 1
1136
1149
  },
1137
1150
  "type": "COLOR",
1151
+ "description": "Strong accent background for active states and focused states",
1138
1152
  "refId": "mode/bgColor/accent-emphasis",
1139
1153
  "reference": "base/color/light/base/color/blue/5",
1140
1154
  "collection": "mode",
@@ -1154,6 +1168,7 @@
1154
1168
  "a": 1
1155
1169
  },
1156
1170
  "type": "COLOR",
1171
+ "description": "Subtle success background for positive feedback and completed states",
1157
1172
  "refId": "mode/bgColor/success-muted",
1158
1173
  "reference": "base/color/light/base/color/blue/0",
1159
1174
  "collection": "mode",
@@ -1173,6 +1188,7 @@
1173
1188
  "a": 1
1174
1189
  },
1175
1190
  "type": "COLOR",
1191
+ "description": "Strong success background for prominent positive actions",
1176
1192
  "refId": "mode/bgColor/success-emphasis",
1177
1193
  "reference": "base/color/light/base/color/blue/5",
1178
1194
  "collection": "mode",
@@ -1192,6 +1208,7 @@
1192
1208
  "a": 1
1193
1209
  },
1194
1210
  "type": "COLOR",
1211
+ "description": "Subtle background for open state indicators (issues, PRs)",
1195
1212
  "refId": "mode/bgColor/open-muted",
1196
1213
  "reference": "base/color/light/base/color/red/0",
1197
1214
  "collection": "mode",
@@ -1211,6 +1228,7 @@
1211
1228
  "a": 1
1212
1229
  },
1213
1230
  "type": "COLOR",
1231
+ "description": "Strong background for open state badges and labels",
1214
1232
  "refId": "mode/bgColor/open-emphasis",
1215
1233
  "reference": "base/color/light/base/color/red/5",
1216
1234
  "collection": "mode",
@@ -1230,6 +1248,7 @@
1230
1248
  "a": 1
1231
1249
  },
1232
1250
  "type": "COLOR",
1251
+ "description": "Subtle attention background for warnings and caution states",
1233
1252
  "refId": "mode/bgColor/attention-muted",
1234
1253
  "reference": "base/color/light/base/color/yellow/0",
1235
1254
  "collection": "mode",
@@ -1249,6 +1268,7 @@
1249
1268
  "a": 1
1250
1269
  },
1251
1270
  "type": "COLOR",
1271
+ "description": "Strong attention background for prominent warnings",
1252
1272
  "refId": "mode/bgColor/attention-emphasis",
1253
1273
  "reference": "base/color/light/base/color/yellow/5",
1254
1274
  "collection": "mode",
@@ -1268,6 +1288,7 @@
1268
1288
  "a": 1
1269
1289
  },
1270
1290
  "type": "COLOR",
1291
+ "description": "Subtle severe background for high-priority warnings",
1271
1292
  "refId": "mode/bgColor/severe-muted",
1272
1293
  "reference": "base/color/light/base/color/red/0",
1273
1294
  "collection": "mode",
@@ -1287,6 +1308,7 @@
1287
1308
  "a": 1
1288
1309
  },
1289
1310
  "type": "COLOR",
1311
+ "description": "Strong severe background for prominent high-priority warnings",
1290
1312
  "refId": "mode/bgColor/severe-emphasis",
1291
1313
  "reference": "base/color/light/base/color/red/5",
1292
1314
  "collection": "mode",
@@ -1306,6 +1328,7 @@
1306
1328
  "a": 1
1307
1329
  },
1308
1330
  "type": "COLOR",
1331
+ "description": "Muted danger background for error states and destructive action contexts",
1309
1332
  "refId": "mode/bgColor/danger-muted",
1310
1333
  "reference": "base/color/light/base/color/red/0",
1311
1334
  "collection": "mode",
@@ -1325,6 +1348,7 @@
1325
1348
  "a": 1
1326
1349
  },
1327
1350
  "type": "COLOR",
1351
+ "description": "Emphasized danger background for critical errors and delete confirmations",
1328
1352
  "refId": "mode/bgColor/danger-emphasis",
1329
1353
  "reference": "base/color/light/base/color/red/5",
1330
1354
  "collection": "mode",
@@ -1344,6 +1368,7 @@
1344
1368
  "a": 0.12
1345
1369
  },
1346
1370
  "type": "COLOR",
1371
+ "description": "Subtle background for closed state indicators (issues, PRs)",
1347
1372
  "refId": "mode/bgColor/closed-muted",
1348
1373
  "reference": "mode/bgColor/neutral-muted",
1349
1374
  "collection": "mode",
@@ -1363,6 +1388,7 @@
1363
1388
  "a": 1
1364
1389
  },
1365
1390
  "type": "COLOR",
1391
+ "description": "Strong background for closed state badges and labels",
1366
1392
  "refId": "mode/bgColor/closed-emphasis",
1367
1393
  "reference": "mode/bgColor/neutral-emphasis",
1368
1394
  "collection": "mode",
@@ -1382,6 +1408,7 @@
1382
1408
  "a": 0.12
1383
1409
  },
1384
1410
  "type": "COLOR",
1411
+ "description": "Subtle background for draft state indicators",
1385
1412
  "refId": "mode/bgColor/draft-muted",
1386
1413
  "reference": "mode/bgColor/neutral-muted",
1387
1414
  "collection": "mode",
@@ -1401,6 +1428,7 @@
1401
1428
  "a": 1
1402
1429
  },
1403
1430
  "type": "COLOR",
1431
+ "description": "Strong background for draft state badges and labels",
1404
1432
  "refId": "mode/bgColor/draft-emphasis",
1405
1433
  "reference": "mode/bgColor/neutral-emphasis",
1406
1434
  "collection": "mode",
@@ -1420,6 +1448,7 @@
1420
1448
  "a": 1
1421
1449
  },
1422
1450
  "type": "COLOR",
1451
+ "description": "Subtle background for completed/done state indicators",
1423
1452
  "refId": "mode/bgColor/done-muted",
1424
1453
  "reference": "base/color/light/base/color/purple/0",
1425
1454
  "collection": "mode",
@@ -1439,6 +1468,7 @@
1439
1468
  "a": 1
1440
1469
  },
1441
1470
  "type": "COLOR",
1471
+ "description": "Strong background for completed/done state badges and labels",
1442
1472
  "refId": "mode/bgColor/done-emphasis",
1443
1473
  "reference": "base/color/light/base/color/purple/5",
1444
1474
  "collection": "mode",
@@ -1458,6 +1488,7 @@
1458
1488
  "a": 1
1459
1489
  },
1460
1490
  "type": "COLOR",
1491
+ "description": "Subtle background for upsell and promotional content",
1461
1492
  "refId": "mode/bgColor/upsell-muted",
1462
1493
  "reference": "mode/bgColor/done-muted",
1463
1494
  "collection": "mode",
@@ -1477,6 +1508,7 @@
1477
1508
  "a": 1
1478
1509
  },
1479
1510
  "type": "COLOR",
1511
+ "description": "Strong background for prominent upsell elements",
1480
1512
  "refId": "mode/bgColor/upsell-emphasis",
1481
1513
  "reference": "mode/bgColor/done-emphasis",
1482
1514
  "collection": "mode",
@@ -1496,6 +1528,7 @@
1496
1528
  "a": 1
1497
1529
  },
1498
1530
  "type": "COLOR",
1531
+ "description": "Subtle background for GitHub Sponsors content",
1499
1532
  "refId": "mode/bgColor/sponsors-muted",
1500
1533
  "reference": "base/color/light/base/color/pink/0",
1501
1534
  "collection": "mode",
@@ -1515,6 +1548,7 @@
1515
1548
  "a": 1
1516
1549
  },
1517
1550
  "type": "COLOR",
1551
+ "description": "Strong background for prominent GitHub Sponsors elements",
1518
1552
  "refId": "mode/bgColor/sponsors-emphasis",
1519
1553
  "reference": "base/color/light/base/color/pink/5",
1520
1554
  "collection": "mode",
@@ -1534,6 +1568,7 @@
1534
1568
  "a": 1
1535
1569
  },
1536
1570
  "type": "COLOR",
1571
+ "description": "Default border color for most UI elements",
1537
1572
  "refId": "mode/borderColor/default",
1538
1573
  "reference": "base/color/light/base/color/neutral/6",
1539
1574
  "collection": "mode",
@@ -1554,6 +1589,7 @@
1554
1589
  },
1555
1590
  "type": "COLOR",
1556
1591
  "alpha": 0.7,
1592
+ "description": "Subtle border for secondary elements and light separators",
1557
1593
  "refId": "mode/borderColor/muted",
1558
1594
  "reference": "mode/borderColor/default",
1559
1595
  "collection": "mode",
@@ -1573,6 +1609,7 @@
1573
1609
  "a": 1
1574
1610
  },
1575
1611
  "type": "COLOR",
1612
+ "description": "Strong border for emphasis and visual weight",
1576
1613
  "refId": "mode/borderColor/emphasis",
1577
1614
  "reference": "base/color/light/base/color/neutral/8",
1578
1615
  "collection": "mode",
@@ -1590,6 +1627,7 @@
1590
1627
  },
1591
1628
  "type": "COLOR",
1592
1629
  "alpha": 0.1,
1630
+ "description": "Border color for disabled interactive elements",
1593
1631
  "refId": "mode/borderColor/disabled",
1594
1632
  "reference": "base/color/light/base/color/neutral/8",
1595
1633
  "collection": "mode",
@@ -1606,6 +1644,7 @@
1606
1644
  "a": 0
1607
1645
  },
1608
1646
  "type": "COLOR",
1647
+ "description": "Fully transparent border",
1609
1648
  "refId": "mode/borderColor/transparent",
1610
1649
  "reference": "base/color/light/base/color/transparent",
1611
1650
  "collection": "mode",
@@ -1623,6 +1662,7 @@
1623
1662
  },
1624
1663
  "type": "COLOR",
1625
1664
  "alpha": 0.15,
1665
+ "description": "Semi-transparent border for overlays and layered elements",
1626
1666
  "refId": "mode/borderColor/translucent",
1627
1667
  "reference": "base/color/light/base/color/neutral/13",
1628
1668
  "collection": "mode",
@@ -1639,6 +1679,7 @@
1639
1679
  "a": 0.7
1640
1680
  },
1641
1681
  "type": "COLOR",
1682
+ "description": "Subtle neutral semantic border",
1642
1683
  "refId": "mode/borderColor/neutral-muted",
1643
1684
  "reference": "mode/borderColor/muted",
1644
1685
  "collection": "mode",
@@ -1655,6 +1696,7 @@
1655
1696
  "a": 1
1656
1697
  },
1657
1698
  "type": "COLOR",
1699
+ "description": "Strong neutral semantic border",
1658
1700
  "refId": "mode/borderColor/neutral-emphasis",
1659
1701
  "reference": "base/color/light/base/color/neutral/9",
1660
1702
  "collection": "mode",
@@ -1672,6 +1714,7 @@
1672
1714
  },
1673
1715
  "type": "COLOR",
1674
1716
  "alpha": 0.4,
1717
+ "description": "Subtle accent border for selected or focused elements",
1675
1718
  "refId": "mode/borderColor/accent-muted",
1676
1719
  "reference": "base/color/light/base/color/blue/3",
1677
1720
  "collection": "mode",
@@ -1691,6 +1734,7 @@
1691
1734
  "a": 1
1692
1735
  },
1693
1736
  "type": "COLOR",
1737
+ "description": "Strong accent border for selected or focused elements",
1694
1738
  "refId": "mode/borderColor/accent-emphasis",
1695
1739
  "reference": "base/color/light/base/color/blue/5",
1696
1740
  "collection": "mode",
@@ -1711,6 +1755,7 @@
1711
1755
  },
1712
1756
  "type": "COLOR",
1713
1757
  "alpha": 0.4,
1758
+ "description": "Subtle success border for positive feedback elements",
1714
1759
  "refId": "mode/borderColor/success-muted",
1715
1760
  "reference": "base/color/light/base/color/blue/3",
1716
1761
  "collection": "mode",
@@ -1730,6 +1775,7 @@
1730
1775
  "a": 1
1731
1776
  },
1732
1777
  "type": "COLOR",
1778
+ "description": "Strong success border for prominent positive elements",
1733
1779
  "refId": "mode/borderColor/success-emphasis",
1734
1780
  "reference": "base/color/light/base/color/blue/5",
1735
1781
  "collection": "mode",
@@ -1750,6 +1796,7 @@
1750
1796
  },
1751
1797
  "type": "COLOR",
1752
1798
  "alpha": 0.4,
1799
+ "description": "Subtle border for open state indicators",
1753
1800
  "refId": "mode/borderColor/open-muted",
1754
1801
  "reference": "base/color/light/base/color/red/3",
1755
1802
  "collection": "mode",
@@ -1769,6 +1816,7 @@
1769
1816
  "a": 1
1770
1817
  },
1771
1818
  "type": "COLOR",
1819
+ "description": "Strong border for open state badges",
1772
1820
  "refId": "mode/borderColor/open-emphasis",
1773
1821
  "reference": "base/color/light/base/color/red/5",
1774
1822
  "collection": "mode",
@@ -1789,6 +1837,7 @@
1789
1837
  },
1790
1838
  "type": "COLOR",
1791
1839
  "alpha": 0.4,
1840
+ "description": "Subtle attention border for warnings and caution states",
1792
1841
  "refId": "mode/borderColor/attention-muted",
1793
1842
  "reference": "base/color/light/base/color/yellow/3",
1794
1843
  "collection": "mode",
@@ -1808,6 +1857,7 @@
1808
1857
  "a": 1
1809
1858
  },
1810
1859
  "type": "COLOR",
1860
+ "description": "Strong attention border for prominent warnings",
1811
1861
  "refId": "mode/borderColor/attention-emphasis",
1812
1862
  "reference": "base/color/light/base/color/yellow/5",
1813
1863
  "collection": "mode",
@@ -1828,6 +1878,7 @@
1828
1878
  },
1829
1879
  "type": "COLOR",
1830
1880
  "alpha": 0.4,
1881
+ "description": "Subtle severe border for high-priority warnings",
1831
1882
  "refId": "mode/borderColor/severe-muted",
1832
1883
  "reference": "base/color/light/base/color/red/3",
1833
1884
  "collection": "mode",
@@ -1847,6 +1898,7 @@
1847
1898
  "a": 1
1848
1899
  },
1849
1900
  "type": "COLOR",
1901
+ "description": "Strong severe border for prominent high-priority warnings",
1850
1902
  "refId": "mode/borderColor/severe-emphasis",
1851
1903
  "reference": "base/color/light/base/color/red/5",
1852
1904
  "collection": "mode",
@@ -1867,6 +1919,7 @@
1867
1919
  },
1868
1920
  "type": "COLOR",
1869
1921
  "alpha": 0.4,
1922
+ "description": "Subtle danger border for errors and destructive contexts",
1870
1923
  "refId": "mode/borderColor/danger-muted",
1871
1924
  "reference": "base/color/light/base/color/red/3",
1872
1925
  "collection": "mode",
@@ -1886,6 +1939,7 @@
1886
1939
  "a": 1
1887
1940
  },
1888
1941
  "type": "COLOR",
1942
+ "description": "Strong danger border for destructive actions and errors",
1889
1943
  "refId": "mode/borderColor/danger-emphasis",
1890
1944
  "reference": "base/color/light/base/color/red/5",
1891
1945
  "collection": "mode",
@@ -1906,6 +1960,7 @@
1906
1960
  },
1907
1961
  "type": "COLOR",
1908
1962
  "alpha": 0.4,
1963
+ "description": "Subtle border for closed state indicators",
1909
1964
  "refId": "mode/borderColor/closed-muted",
1910
1965
  "reference": "mode/borderColor/default",
1911
1966
  "collection": "mode",
@@ -1925,6 +1980,7 @@
1925
1980
  "a": 1
1926
1981
  },
1927
1982
  "type": "COLOR",
1983
+ "description": "Strong border for closed state badges",
1928
1984
  "refId": "mode/borderColor/closed-emphasis",
1929
1985
  "reference": "mode/borderColor/emphasis",
1930
1986
  "collection": "mode",
@@ -1945,6 +2001,7 @@
1945
2001
  },
1946
2002
  "type": "COLOR",
1947
2003
  "alpha": 0.4,
2004
+ "description": "Subtle border for draft state indicators",
1948
2005
  "refId": "mode/borderColor/draft-muted",
1949
2006
  "reference": "mode/borderColor/default",
1950
2007
  "collection": "mode",
@@ -1964,6 +2021,7 @@
1964
2021
  "a": 1
1965
2022
  },
1966
2023
  "type": "COLOR",
2024
+ "description": "Strong border for draft state badges",
1967
2025
  "refId": "mode/borderColor/draft-emphasis",
1968
2026
  "reference": "mode/borderColor/neutral-emphasis",
1969
2027
  "collection": "mode",
@@ -1984,6 +2042,7 @@
1984
2042
  },
1985
2043
  "type": "COLOR",
1986
2044
  "alpha": 0.4,
2045
+ "description": "Subtle border for completed/done state indicators",
1987
2046
  "refId": "mode/borderColor/done-muted",
1988
2047
  "reference": "base/color/light/base/color/purple/3",
1989
2048
  "collection": "mode",
@@ -2003,6 +2062,7 @@
2003
2062
  "a": 1
2004
2063
  },
2005
2064
  "type": "COLOR",
2065
+ "description": "Strong border for completed/done state badges",
2006
2066
  "refId": "mode/borderColor/done-emphasis",
2007
2067
  "reference": "base/color/light/base/color/purple/5",
2008
2068
  "collection": "mode",
@@ -2022,6 +2082,7 @@
2022
2082
  "a": 0.4
2023
2083
  },
2024
2084
  "type": "COLOR",
2085
+ "description": "Subtle border for upsell and promotional content",
2025
2086
  "refId": "mode/borderColor/upsell-muted",
2026
2087
  "reference": "mode/borderColor/done-muted",
2027
2088
  "collection": "mode",
@@ -2041,6 +2102,7 @@
2041
2102
  "a": 1
2042
2103
  },
2043
2104
  "type": "COLOR",
2105
+ "description": "Strong border for prominent upsell elements",
2044
2106
  "refId": "mode/borderColor/upsell-emphasis",
2045
2107
  "reference": "mode/borderColor/done-emphasis",
2046
2108
  "collection": "mode",
@@ -2061,6 +2123,7 @@
2061
2123
  },
2062
2124
  "type": "COLOR",
2063
2125
  "alpha": 0.4,
2126
+ "description": "Subtle border for GitHub Sponsors content",
2064
2127
  "refId": "mode/borderColor/sponsors-muted",
2065
2128
  "reference": "base/color/light/base/color/pink/3",
2066
2129
  "collection": "mode",
@@ -2080,6 +2143,7 @@
2080
2143
  "a": 1
2081
2144
  },
2082
2145
  "type": "COLOR",
2146
+ "description": "Strong border for prominent GitHub Sponsors elements",
2083
2147
  "refId": "mode/borderColor/sponsors-emphasis",
2084
2148
  "reference": "base/color/light/base/color/pink/5",
2085
2149
  "collection": "mode",
@@ -8037,6 +8101,7 @@
8037
8101
  "a": 1
8038
8102
  },
8039
8103
  "type": "COLOR",
8104
+ "description": "Default text color for primary content and headings",
8040
8105
  "refId": "mode/fgColor/default",
8041
8106
  "reference": "base/color/light/base/color/neutral/13",
8042
8107
  "collection": "mode",
@@ -8056,6 +8121,7 @@
8056
8121
  "a": 1
8057
8122
  },
8058
8123
  "type": "COLOR",
8124
+ "description": "Muted text for secondary content and less important information",
8059
8125
  "refId": "mode/fgColor/muted",
8060
8126
  "reference": "base/color/light/base/color/neutral/9",
8061
8127
  "collection": "mode",
@@ -8075,6 +8141,7 @@
8075
8141
  "a": 1
8076
8142
  },
8077
8143
  "type": "COLOR",
8144
+ "description": "Text color for use on emphasis backgrounds",
8078
8145
  "refId": "mode/fgColor/onEmphasis",
8079
8146
  "reference": "base/color/light/base/color/neutral/0",
8080
8147
  "collection": "mode",
@@ -8094,6 +8161,7 @@
8094
8161
  "a": 1
8095
8162
  },
8096
8163
  "type": "COLOR",
8164
+ "description": "Text color for use on inverse backgrounds",
8097
8165
  "refId": "mode/fgColor/onInverse",
8098
8166
  "reference": "base/color/light/base/color/neutral/0",
8099
8167
  "collection": "mode",
@@ -8110,6 +8178,7 @@
8110
8178
  "a": 1
8111
8179
  },
8112
8180
  "type": "COLOR",
8181
+ "description": "Pure white text",
8113
8182
  "refId": "mode/fgColor/white",
8114
8183
  "reference": "base/color/light/base/color/neutral/0",
8115
8184
  "collection": "mode",
@@ -8126,6 +8195,7 @@
8126
8195
  "a": 1
8127
8196
  },
8128
8197
  "type": "COLOR",
8198
+ "description": "Pure black text",
8129
8199
  "refId": "mode/fgColor/black",
8130
8200
  "reference": "base/color/light/base/color/neutral/13",
8131
8201
  "collection": "mode",
@@ -8142,6 +8212,7 @@
8142
8212
  "a": 1
8143
8213
  },
8144
8214
  "type": "COLOR",
8215
+ "description": "Text color for disabled interactive elements",
8145
8216
  "refId": "mode/fgColor/disabled",
8146
8217
  "reference": "base/color/light/base/color/neutral/8",
8147
8218
  "collection": "mode",
@@ -8158,6 +8229,7 @@
8158
8229
  "a": 1
8159
8230
  },
8160
8231
  "type": "COLOR",
8232
+ "description": "Text color for hyperlinks",
8161
8233
  "refId": "mode/fgColor/link",
8162
8234
  "reference": "mode/fgColor/accent",
8163
8235
  "collection": "mode",
@@ -8177,6 +8249,7 @@
8177
8249
  "a": 1
8178
8250
  },
8179
8251
  "type": "COLOR",
8252
+ "description": "Neutral semantic text for icons and secondary elements",
8180
8253
  "refId": "mode/fgColor/neutral",
8181
8254
  "reference": "base/color/light/base/color/neutral/9",
8182
8255
  "collection": "mode",
@@ -8193,6 +8266,7 @@
8193
8266
  "a": 1
8194
8267
  },
8195
8268
  "type": "COLOR",
8269
+ "description": "Accent text for links and interactive elements",
8196
8270
  "refId": "mode/fgColor/accent",
8197
8271
  "reference": "base/color/light/base/color/blue/5",
8198
8272
  "collection": "mode",
@@ -8212,6 +8286,7 @@
8212
8286
  "a": 1
8213
8287
  },
8214
8288
  "type": "COLOR",
8289
+ "description": "Success text for positive feedback and completed states",
8215
8290
  "refId": "mode/fgColor/success",
8216
8291
  "reference": "base/color/light/base/color/blue/5",
8217
8292
  "collection": "mode",
@@ -8231,6 +8306,7 @@
8231
8306
  "a": 1
8232
8307
  },
8233
8308
  "type": "COLOR",
8309
+ "description": "Text color for open state indicators (issues, PRs)",
8234
8310
  "refId": "mode/fgColor/open",
8235
8311
  "reference": "base/color/light/base/color/red/5",
8236
8312
  "collection": "mode",
@@ -8250,6 +8326,7 @@
8250
8326
  "a": 1
8251
8327
  },
8252
8328
  "type": "COLOR",
8329
+ "description": "Attention text for warnings and caution states",
8253
8330
  "refId": "mode/fgColor/attention",
8254
8331
  "reference": "base/color/light/base/color/yellow/5",
8255
8332
  "collection": "mode",
@@ -8269,6 +8346,7 @@
8269
8346
  "a": 1
8270
8347
  },
8271
8348
  "type": "COLOR",
8349
+ "description": "Severe text for high-priority warnings",
8272
8350
  "refId": "mode/fgColor/severe",
8273
8351
  "reference": "base/color/light/base/color/red/5",
8274
8352
  "collection": "mode",
@@ -8288,6 +8366,7 @@
8288
8366
  "a": 1
8289
8367
  },
8290
8368
  "type": "COLOR",
8369
+ "description": "Danger text for errors and destructive actions",
8291
8370
  "refId": "mode/fgColor/danger",
8292
8371
  "collection": "mode",
8293
8372
  "mode": "light tritanopia",
@@ -8306,6 +8385,7 @@
8306
8385
  "a": 1
8307
8386
  },
8308
8387
  "type": "COLOR",
8388
+ "description": "Text color for closed state indicators (issues, PRs)",
8309
8389
  "refId": "mode/fgColor/closed",
8310
8390
  "reference": "mode/fgColor/muted",
8311
8391
  "collection": "mode",
@@ -8325,6 +8405,7 @@
8325
8405
  "a": 1
8326
8406
  },
8327
8407
  "type": "COLOR",
8408
+ "description": "Text color for draft state indicators",
8328
8409
  "refId": "mode/fgColor/draft",
8329
8410
  "reference": "mode/fgColor/neutral",
8330
8411
  "collection": "mode",
@@ -8344,6 +8425,7 @@
8344
8425
  "a": 1
8345
8426
  },
8346
8427
  "type": "COLOR",
8428
+ "description": "Text color for completed/done state indicators",
8347
8429
  "refId": "mode/fgColor/done",
8348
8430
  "reference": "base/color/light/base/color/purple/5",
8349
8431
  "collection": "mode",
@@ -8363,6 +8445,7 @@
8363
8445
  "a": 1
8364
8446
  },
8365
8447
  "type": "COLOR",
8448
+ "description": "Text color for upsell and promotional content",
8366
8449
  "refId": "mode/fgColor/upsell",
8367
8450
  "reference": "mode/fgColor/done",
8368
8451
  "collection": "mode",
@@ -8382,6 +8465,7 @@
8382
8465
  "a": 1
8383
8466
  },
8384
8467
  "type": "COLOR",
8468
+ "description": "Text color for GitHub Sponsors content",
8385
8469
  "refId": "mode/fgColor/sponsors",
8386
8470
  "reference": "base/color/light/base/color/pink/5",
8387
8471
  "collection": "mode",
@@ -8402,6 +8486,7 @@
8402
8486
  },
8403
8487
  "type": "COLOR",
8404
8488
  "alpha": 0.2,
8489
+ "description": "Background color for text selection highlights",
8405
8490
  "refId": "mode/selection/bgColor",
8406
8491
  "reference": "mode/bgColor/accent-emphasis",
8407
8492
  "collection": "mode",