@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
@@ -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/dark/base/color/neutral/1",
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/dark/base/color/neutral/2",
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/dark/base/color/neutral/0",
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/dark/base/color/neutral/7",
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/dark/base/color/neutral/13",
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/dark/base/color/neutral/13",
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/dark/base/color/neutral/0",
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/dark/base/color/neutral/3",
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/dark/base/color/transparent",
1069
1079
  "collection": "mode",
@@ -1084,6 +1094,7 @@
1084
1094
  },
1085
1095
  "type": "COLOR",
1086
1096
  "alpha": 0.2,
1097
+ "description": "Subtle neutral background for tags, labels, and secondary UI elements",
1087
1098
  "refId": "mode/bgColor/neutral-muted",
1088
1099
  "reference": "base/color/dark/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/dark/base/color/neutral/8",
1105
1117
  "collection": "mode",
@@ -1117,6 +1129,7 @@
1117
1129
  },
1118
1130
  "type": "COLOR",
1119
1131
  "alpha": 0.1,
1132
+ "description": "Subtle accent background for informational or selected elements",
1120
1133
  "refId": "mode/bgColor/accent-muted",
1121
1134
  "reference": "base/color/dark/base/color/blue/4",
1122
1135
  "collection": "mode",
@@ -1136,6 +1149,7 @@
1136
1149
  "a": 1
1137
1150
  },
1138
1151
  "type": "COLOR",
1152
+ "description": "Strong accent background for active states and focused states",
1139
1153
  "refId": "mode/bgColor/accent-emphasis",
1140
1154
  "reference": "base/color/dark/base/color/blue/5",
1141
1155
  "collection": "mode",
@@ -1156,6 +1170,7 @@
1156
1170
  },
1157
1171
  "type": "COLOR",
1158
1172
  "alpha": 0.15,
1173
+ "description": "Subtle success background for positive feedback and completed states",
1159
1174
  "refId": "mode/bgColor/success-muted",
1160
1175
  "reference": "base/color/dark/base/color/green/4",
1161
1176
  "collection": "mode",
@@ -1175,6 +1190,7 @@
1175
1190
  "a": 1
1176
1191
  },
1177
1192
  "type": "COLOR",
1193
+ "description": "Strong success background for prominent positive actions",
1178
1194
  "refId": "mode/bgColor/success-emphasis",
1179
1195
  "reference": "base/color/dark/base/color/green/5",
1180
1196
  "collection": "mode",
@@ -1194,6 +1210,7 @@
1194
1210
  "a": 0.15
1195
1211
  },
1196
1212
  "type": "COLOR",
1213
+ "description": "Subtle background for open state indicators (issues, PRs)",
1197
1214
  "refId": "mode/bgColor/open-muted",
1198
1215
  "reference": "mode/bgColor/success-muted",
1199
1216
  "collection": "mode",
@@ -1213,6 +1230,7 @@
1213
1230
  "a": 1
1214
1231
  },
1215
1232
  "type": "COLOR",
1233
+ "description": "Strong background for open state badges and labels",
1216
1234
  "refId": "mode/bgColor/open-emphasis",
1217
1235
  "reference": "mode/bgColor/success-emphasis",
1218
1236
  "collection": "mode",
@@ -1233,6 +1251,7 @@
1233
1251
  },
1234
1252
  "type": "COLOR",
1235
1253
  "alpha": 0.15,
1254
+ "description": "Subtle attention background for warnings and caution states",
1236
1255
  "refId": "mode/bgColor/attention-muted",
1237
1256
  "reference": "base/color/dark/base/color/yellow/4",
1238
1257
  "collection": "mode",
@@ -1252,6 +1271,7 @@
1252
1271
  "a": 1
1253
1272
  },
1254
1273
  "type": "COLOR",
1274
+ "description": "Strong attention background for prominent warnings",
1255
1275
  "refId": "mode/bgColor/attention-emphasis",
1256
1276
  "reference": "base/color/dark/base/color/yellow/5",
1257
1277
  "collection": "mode",
@@ -1272,6 +1292,7 @@
1272
1292
  },
1273
1293
  "type": "COLOR",
1274
1294
  "alpha": 0.1,
1295
+ "description": "Subtle severe background for high-priority warnings",
1275
1296
  "refId": "mode/bgColor/severe-muted",
1276
1297
  "reference": "base/color/dark/base/color/orange/4",
1277
1298
  "collection": "mode",
@@ -1291,6 +1312,7 @@
1291
1312
  "a": 1
1292
1313
  },
1293
1314
  "type": "COLOR",
1315
+ "description": "Strong severe background for prominent high-priority warnings",
1294
1316
  "refId": "mode/bgColor/severe-emphasis",
1295
1317
  "reference": "base/color/dark/base/color/orange/5",
1296
1318
  "collection": "mode",
@@ -1311,6 +1333,7 @@
1311
1333
  },
1312
1334
  "type": "COLOR",
1313
1335
  "alpha": 0.1,
1336
+ "description": "Muted danger background for error states and destructive action contexts",
1314
1337
  "refId": "mode/bgColor/danger-muted",
1315
1338
  "reference": "base/color/dark/base/color/red/4",
1316
1339
  "collection": "mode",
@@ -1330,6 +1353,7 @@
1330
1353
  "a": 1
1331
1354
  },
1332
1355
  "type": "COLOR",
1356
+ "description": "Emphasized danger background for critical errors and delete confirmations",
1333
1357
  "refId": "mode/bgColor/danger-emphasis",
1334
1358
  "reference": "base/color/dark/base/color/red/5",
1335
1359
  "collection": "mode",
@@ -1349,6 +1373,7 @@
1349
1373
  "a": 0.1
1350
1374
  },
1351
1375
  "type": "COLOR",
1376
+ "description": "Subtle background for closed state indicators (issues, PRs)",
1352
1377
  "refId": "mode/bgColor/closed-muted",
1353
1378
  "reference": "mode/bgColor/danger-muted",
1354
1379
  "collection": "mode",
@@ -1368,6 +1393,7 @@
1368
1393
  "a": 1
1369
1394
  },
1370
1395
  "type": "COLOR",
1396
+ "description": "Strong background for closed state badges and labels",
1371
1397
  "refId": "mode/bgColor/closed-emphasis",
1372
1398
  "reference": "mode/bgColor/danger-emphasis",
1373
1399
  "collection": "mode",
@@ -1387,6 +1413,7 @@
1387
1413
  "a": 0.2
1388
1414
  },
1389
1415
  "type": "COLOR",
1416
+ "description": "Subtle background for draft state indicators",
1390
1417
  "refId": "mode/bgColor/draft-muted",
1391
1418
  "reference": "mode/bgColor/neutral-muted",
1392
1419
  "collection": "mode",
@@ -1406,6 +1433,7 @@
1406
1433
  "a": 1
1407
1434
  },
1408
1435
  "type": "COLOR",
1436
+ "description": "Strong background for draft state badges and labels",
1409
1437
  "refId": "mode/bgColor/draft-emphasis",
1410
1438
  "reference": "mode/bgColor/neutral-emphasis",
1411
1439
  "collection": "mode",
@@ -1426,6 +1454,7 @@
1426
1454
  },
1427
1455
  "type": "COLOR",
1428
1456
  "alpha": 0.15,
1457
+ "description": "Subtle background for completed/done state indicators",
1429
1458
  "refId": "mode/bgColor/done-muted",
1430
1459
  "reference": "base/color/dark/base/color/purple/4",
1431
1460
  "collection": "mode",
@@ -1445,6 +1474,7 @@
1445
1474
  "a": 1
1446
1475
  },
1447
1476
  "type": "COLOR",
1477
+ "description": "Strong background for completed/done state badges and labels",
1448
1478
  "refId": "mode/bgColor/done-emphasis",
1449
1479
  "reference": "base/color/dark/base/color/purple/5",
1450
1480
  "collection": "mode",
@@ -1464,6 +1494,7 @@
1464
1494
  "a": 0.15
1465
1495
  },
1466
1496
  "type": "COLOR",
1497
+ "description": "Subtle background for upsell and promotional content",
1467
1498
  "refId": "mode/bgColor/upsell-muted",
1468
1499
  "reference": "mode/bgColor/done-muted",
1469
1500
  "collection": "mode",
@@ -1483,6 +1514,7 @@
1483
1514
  "a": 1
1484
1515
  },
1485
1516
  "type": "COLOR",
1517
+ "description": "Strong background for prominent upsell elements",
1486
1518
  "refId": "mode/bgColor/upsell-emphasis",
1487
1519
  "reference": "mode/bgColor/done-emphasis",
1488
1520
  "collection": "mode",
@@ -1503,6 +1535,7 @@
1503
1535
  },
1504
1536
  "type": "COLOR",
1505
1537
  "alpha": 0.1,
1538
+ "description": "Subtle background for GitHub Sponsors content",
1506
1539
  "refId": "mode/bgColor/sponsors-muted",
1507
1540
  "reference": "base/color/dark/base/color/pink/4",
1508
1541
  "collection": "mode",
@@ -1522,6 +1555,7 @@
1522
1555
  "a": 1
1523
1556
  },
1524
1557
  "type": "COLOR",
1558
+ "description": "Strong background for prominent GitHub Sponsors elements",
1525
1559
  "refId": "mode/bgColor/sponsors-emphasis",
1526
1560
  "reference": "base/color/dark/base/color/pink/5",
1527
1561
  "collection": "mode",
@@ -1541,6 +1575,7 @@
1541
1575
  "a": 1
1542
1576
  },
1543
1577
  "type": "COLOR",
1578
+ "description": "Default border color for most UI elements",
1544
1579
  "refId": "mode/borderColor/default",
1545
1580
  "reference": "base/color/dark/base/color/neutral/7",
1546
1581
  "collection": "mode",
@@ -1561,6 +1596,7 @@
1561
1596
  },
1562
1597
  "type": "COLOR",
1563
1598
  "alpha": 0.7,
1599
+ "description": "Subtle border for secondary elements and light separators",
1564
1600
  "refId": "mode/borderColor/muted",
1565
1601
  "reference": "mode/borderColor/default",
1566
1602
  "collection": "mode",
@@ -1580,6 +1616,7 @@
1580
1616
  "a": 1
1581
1617
  },
1582
1618
  "type": "COLOR",
1619
+ "description": "Strong border for emphasis and visual weight",
1583
1620
  "refId": "mode/borderColor/emphasis",
1584
1621
  "reference": "base/color/dark/base/color/neutral/8",
1585
1622
  "collection": "mode",
@@ -1597,6 +1634,7 @@
1597
1634
  },
1598
1635
  "type": "COLOR",
1599
1636
  "alpha": 0.1,
1637
+ "description": "Border color for disabled interactive elements",
1600
1638
  "refId": "mode/borderColor/disabled",
1601
1639
  "reference": "base/color/dark/base/color/neutral/8",
1602
1640
  "collection": "mode",
@@ -1613,6 +1651,7 @@
1613
1651
  "a": 0
1614
1652
  },
1615
1653
  "type": "COLOR",
1654
+ "description": "Fully transparent border",
1616
1655
  "refId": "mode/borderColor/transparent",
1617
1656
  "reference": "base/color/dark/base/color/transparent",
1618
1657
  "collection": "mode",
@@ -1630,6 +1669,7 @@
1630
1669
  },
1631
1670
  "type": "COLOR",
1632
1671
  "alpha": 0.15,
1672
+ "description": "Semi-transparent border for overlays and layered elements",
1633
1673
  "refId": "mode/borderColor/translucent",
1634
1674
  "reference": "base/color/dark/base/color/neutral/13",
1635
1675
  "collection": "mode",
@@ -1646,6 +1686,7 @@
1646
1686
  "a": 0.7
1647
1687
  },
1648
1688
  "type": "COLOR",
1689
+ "description": "Subtle neutral semantic border",
1649
1690
  "refId": "mode/borderColor/neutral-muted",
1650
1691
  "reference": "mode/borderColor/muted",
1651
1692
  "collection": "mode",
@@ -1662,6 +1703,7 @@
1662
1703
  "a": 1
1663
1704
  },
1664
1705
  "type": "COLOR",
1706
+ "description": "Strong neutral semantic border",
1665
1707
  "refId": "mode/borderColor/neutral-emphasis",
1666
1708
  "reference": "mode/borderColor/emphasis",
1667
1709
  "collection": "mode",
@@ -1679,6 +1721,7 @@
1679
1721
  },
1680
1722
  "type": "COLOR",
1681
1723
  "alpha": 0.4,
1724
+ "description": "Subtle accent border for selected or focused elements",
1682
1725
  "refId": "mode/borderColor/accent-muted",
1683
1726
  "reference": "base/color/dark/base/color/blue/4",
1684
1727
  "collection": "mode",
@@ -1698,6 +1741,7 @@
1698
1741
  "a": 1
1699
1742
  },
1700
1743
  "type": "COLOR",
1744
+ "description": "Strong accent border for selected or focused elements",
1701
1745
  "refId": "mode/borderColor/accent-emphasis",
1702
1746
  "reference": "base/color/dark/base/color/blue/5",
1703
1747
  "collection": "mode",
@@ -1718,6 +1762,7 @@
1718
1762
  },
1719
1763
  "type": "COLOR",
1720
1764
  "alpha": 0.4,
1765
+ "description": "Subtle success border for positive feedback elements",
1721
1766
  "refId": "mode/borderColor/success-muted",
1722
1767
  "reference": "base/color/dark/base/color/green/4",
1723
1768
  "collection": "mode",
@@ -1737,6 +1782,7 @@
1737
1782
  "a": 1
1738
1783
  },
1739
1784
  "type": "COLOR",
1785
+ "description": "Strong success border for prominent positive elements",
1740
1786
  "refId": "mode/borderColor/success-emphasis",
1741
1787
  "reference": "base/color/dark/base/color/green/5",
1742
1788
  "collection": "mode",
@@ -1756,6 +1802,7 @@
1756
1802
  "a": 0.4
1757
1803
  },
1758
1804
  "type": "COLOR",
1805
+ "description": "Subtle border for open state indicators",
1759
1806
  "refId": "mode/borderColor/open-muted",
1760
1807
  "reference": "mode/borderColor/success-muted",
1761
1808
  "collection": "mode",
@@ -1775,6 +1822,7 @@
1775
1822
  "a": 1
1776
1823
  },
1777
1824
  "type": "COLOR",
1825
+ "description": "Strong border for open state badges",
1778
1826
  "refId": "mode/borderColor/open-emphasis",
1779
1827
  "reference": "mode/borderColor/success-emphasis",
1780
1828
  "collection": "mode",
@@ -1795,6 +1843,7 @@
1795
1843
  },
1796
1844
  "type": "COLOR",
1797
1845
  "alpha": 0.4,
1846
+ "description": "Subtle attention border for warnings and caution states",
1798
1847
  "refId": "mode/borderColor/attention-muted",
1799
1848
  "reference": "base/color/dark/base/color/yellow/4",
1800
1849
  "collection": "mode",
@@ -1814,6 +1863,7 @@
1814
1863
  "a": 1
1815
1864
  },
1816
1865
  "type": "COLOR",
1866
+ "description": "Strong attention border for prominent warnings",
1817
1867
  "refId": "mode/borderColor/attention-emphasis",
1818
1868
  "reference": "base/color/dark/base/color/yellow/5",
1819
1869
  "collection": "mode",
@@ -1834,6 +1884,7 @@
1834
1884
  },
1835
1885
  "type": "COLOR",
1836
1886
  "alpha": 0.4,
1887
+ "description": "Subtle severe border for high-priority warnings",
1837
1888
  "refId": "mode/borderColor/severe-muted",
1838
1889
  "reference": "base/color/dark/base/color/orange/4",
1839
1890
  "collection": "mode",
@@ -1853,6 +1904,7 @@
1853
1904
  "a": 1
1854
1905
  },
1855
1906
  "type": "COLOR",
1907
+ "description": "Strong severe border for prominent high-priority warnings",
1856
1908
  "refId": "mode/borderColor/severe-emphasis",
1857
1909
  "reference": "base/color/dark/base/color/orange/5",
1858
1910
  "collection": "mode",
@@ -1873,6 +1925,7 @@
1873
1925
  },
1874
1926
  "type": "COLOR",
1875
1927
  "alpha": 0.4,
1928
+ "description": "Subtle danger border for errors and destructive contexts",
1876
1929
  "refId": "mode/borderColor/danger-muted",
1877
1930
  "reference": "base/color/dark/base/color/red/4",
1878
1931
  "collection": "mode",
@@ -1892,6 +1945,7 @@
1892
1945
  "a": 1
1893
1946
  },
1894
1947
  "type": "COLOR",
1948
+ "description": "Strong danger border for destructive actions and errors",
1895
1949
  "refId": "mode/borderColor/danger-emphasis",
1896
1950
  "reference": "base/color/dark/base/color/red/5",
1897
1951
  "collection": "mode",
@@ -1911,6 +1965,7 @@
1911
1965
  "a": 0.4
1912
1966
  },
1913
1967
  "type": "COLOR",
1968
+ "description": "Subtle border for closed state indicators",
1914
1969
  "refId": "mode/borderColor/closed-muted",
1915
1970
  "reference": "mode/borderColor/danger-muted",
1916
1971
  "collection": "mode",
@@ -1930,6 +1985,7 @@
1930
1985
  "a": 1
1931
1986
  },
1932
1987
  "type": "COLOR",
1988
+ "description": "Strong border for closed state badges",
1933
1989
  "refId": "mode/borderColor/closed-emphasis",
1934
1990
  "reference": "mode/borderColor/danger-emphasis",
1935
1991
  "collection": "mode",
@@ -1949,6 +2005,7 @@
1949
2005
  "a": 0.7
1950
2006
  },
1951
2007
  "type": "COLOR",
2008
+ "description": "Subtle border for draft state indicators",
1952
2009
  "refId": "mode/borderColor/draft-muted",
1953
2010
  "reference": "mode/borderColor/neutral-muted",
1954
2011
  "collection": "mode",
@@ -1968,6 +2025,7 @@
1968
2025
  "a": 1
1969
2026
  },
1970
2027
  "type": "COLOR",
2028
+ "description": "Strong border for draft state badges",
1971
2029
  "refId": "mode/borderColor/draft-emphasis",
1972
2030
  "reference": "mode/borderColor/neutral-emphasis",
1973
2031
  "collection": "mode",
@@ -1988,6 +2046,7 @@
1988
2046
  },
1989
2047
  "type": "COLOR",
1990
2048
  "alpha": 0.4,
2049
+ "description": "Subtle border for completed/done state indicators",
1991
2050
  "refId": "mode/borderColor/done-muted",
1992
2051
  "reference": "base/color/dark/base/color/purple/4",
1993
2052
  "collection": "mode",
@@ -2007,6 +2066,7 @@
2007
2066
  "a": 1
2008
2067
  },
2009
2068
  "type": "COLOR",
2069
+ "description": "Strong border for completed/done state badges",
2010
2070
  "refId": "mode/borderColor/done-emphasis",
2011
2071
  "reference": "base/color/dark/base/color/purple/5",
2012
2072
  "collection": "mode",
@@ -2026,6 +2086,7 @@
2026
2086
  "a": 0.4
2027
2087
  },
2028
2088
  "type": "COLOR",
2089
+ "description": "Subtle border for upsell and promotional content",
2029
2090
  "refId": "mode/borderColor/upsell-muted",
2030
2091
  "reference": "mode/borderColor/done-muted",
2031
2092
  "collection": "mode",
@@ -2045,6 +2106,7 @@
2045
2106
  "a": 1
2046
2107
  },
2047
2108
  "type": "COLOR",
2109
+ "description": "Strong border for prominent upsell elements",
2048
2110
  "refId": "mode/borderColor/upsell-emphasis",
2049
2111
  "reference": "mode/borderColor/done-emphasis",
2050
2112
  "collection": "mode",
@@ -2065,6 +2127,7 @@
2065
2127
  },
2066
2128
  "type": "COLOR",
2067
2129
  "alpha": 0.4,
2130
+ "description": "Subtle border for GitHub Sponsors content",
2068
2131
  "refId": "mode/borderColor/sponsors-muted",
2069
2132
  "reference": "base/color/dark/base/color/pink/4",
2070
2133
  "collection": "mode",
@@ -2084,6 +2147,7 @@
2084
2147
  "a": 1
2085
2148
  },
2086
2149
  "type": "COLOR",
2150
+ "description": "Strong border for prominent GitHub Sponsors elements",
2087
2151
  "refId": "mode/borderColor/sponsors-emphasis",
2088
2152
  "reference": "base/color/dark/base/color/pink/5",
2089
2153
  "collection": "mode",
@@ -8041,6 +8105,7 @@
8041
8105
  "a": 1
8042
8106
  },
8043
8107
  "type": "COLOR",
8108
+ "description": "Default text color for primary content and headings",
8044
8109
  "refId": "mode/fgColor/default",
8045
8110
  "reference": "base/color/dark/base/color/neutral/12",
8046
8111
  "collection": "mode",
@@ -8060,6 +8125,7 @@
8060
8125
  "a": 1
8061
8126
  },
8062
8127
  "type": "COLOR",
8128
+ "description": "Muted text for secondary content and less important information",
8063
8129
  "refId": "mode/fgColor/muted",
8064
8130
  "reference": "base/color/dark/base/color/neutral/9",
8065
8131
  "collection": "mode",
@@ -8079,6 +8145,7 @@
8079
8145
  "a": 1
8080
8146
  },
8081
8147
  "type": "COLOR",
8148
+ "description": "Text color for use on emphasis backgrounds",
8082
8149
  "refId": "mode/fgColor/onEmphasis",
8083
8150
  "reference": "base/color/dark/base/color/neutral/13",
8084
8151
  "collection": "mode",
@@ -8098,6 +8165,7 @@
8098
8165
  "a": 1
8099
8166
  },
8100
8167
  "type": "COLOR",
8168
+ "description": "Text color for use on inverse backgrounds",
8101
8169
  "refId": "mode/fgColor/onInverse",
8102
8170
  "reference": "base/color/dark/base/color/neutral/0",
8103
8171
  "collection": "mode",
@@ -8114,6 +8182,7 @@
8114
8182
  "a": 1
8115
8183
  },
8116
8184
  "type": "COLOR",
8185
+ "description": "Pure white text",
8117
8186
  "refId": "mode/fgColor/white",
8118
8187
  "reference": "base/color/dark/base/color/neutral/13",
8119
8188
  "collection": "mode",
@@ -8130,6 +8199,7 @@
8130
8199
  "a": 1
8131
8200
  },
8132
8201
  "type": "COLOR",
8202
+ "description": "Pure black text",
8133
8203
  "refId": "mode/fgColor/black",
8134
8204
  "reference": "base/color/dark/base/color/neutral/0",
8135
8205
  "collection": "mode",
@@ -8146,6 +8216,7 @@
8146
8216
  "a": 1
8147
8217
  },
8148
8218
  "type": "COLOR",
8219
+ "description": "Text color for disabled interactive elements",
8149
8220
  "refId": "mode/fgColor/disabled",
8150
8221
  "reference": "base/color/dark/base/color/neutral/8",
8151
8222
  "collection": "mode",
@@ -8162,6 +8233,7 @@
8162
8233
  "a": 1
8163
8234
  },
8164
8235
  "type": "COLOR",
8236
+ "description": "Text color for hyperlinks",
8165
8237
  "refId": "mode/fgColor/link",
8166
8238
  "reference": "mode/fgColor/accent",
8167
8239
  "collection": "mode",
@@ -8181,6 +8253,7 @@
8181
8253
  "a": 1
8182
8254
  },
8183
8255
  "type": "COLOR",
8256
+ "description": "Neutral semantic text for icons and secondary elements",
8184
8257
  "refId": "mode/fgColor/neutral",
8185
8258
  "reference": "base/color/dark/base/color/neutral/9",
8186
8259
  "collection": "mode",
@@ -8197,6 +8270,7 @@
8197
8270
  "a": 1
8198
8271
  },
8199
8272
  "type": "COLOR",
8273
+ "description": "Accent text for links and interactive elements",
8200
8274
  "refId": "mode/fgColor/accent",
8201
8275
  "collection": "mode",
8202
8276
  "mode": "dark",
@@ -8215,6 +8289,7 @@
8215
8289
  "a": 1
8216
8290
  },
8217
8291
  "type": "COLOR",
8292
+ "description": "Success text for positive feedback and completed states",
8218
8293
  "refId": "mode/fgColor/success",
8219
8294
  "reference": "base/color/dark/base/color/green/3",
8220
8295
  "collection": "mode",
@@ -8234,6 +8309,7 @@
8234
8309
  "a": 1
8235
8310
  },
8236
8311
  "type": "COLOR",
8312
+ "description": "Text color for open state indicators (issues, PRs)",
8237
8313
  "refId": "mode/fgColor/open",
8238
8314
  "reference": "mode/fgColor/success",
8239
8315
  "collection": "mode",
@@ -8253,6 +8329,7 @@
8253
8329
  "a": 1
8254
8330
  },
8255
8331
  "type": "COLOR",
8332
+ "description": "Attention text for warnings and caution states",
8256
8333
  "refId": "mode/fgColor/attention",
8257
8334
  "reference": "base/color/dark/base/color/yellow/3",
8258
8335
  "collection": "mode",
@@ -8272,6 +8349,7 @@
8272
8349
  "a": 1
8273
8350
  },
8274
8351
  "type": "COLOR",
8352
+ "description": "Severe text for high-priority warnings",
8275
8353
  "refId": "mode/fgColor/severe",
8276
8354
  "reference": "base/color/dark/base/color/orange/4",
8277
8355
  "collection": "mode",
@@ -8291,6 +8369,7 @@
8291
8369
  "a": 1
8292
8370
  },
8293
8371
  "type": "COLOR",
8372
+ "description": "Danger text for errors and destructive actions",
8294
8373
  "refId": "mode/fgColor/danger",
8295
8374
  "reference": "base/color/dark/base/color/red/4",
8296
8375
  "collection": "mode",
@@ -8310,6 +8389,7 @@
8310
8389
  "a": 1
8311
8390
  },
8312
8391
  "type": "COLOR",
8392
+ "description": "Text color for closed state indicators (issues, PRs)",
8313
8393
  "refId": "mode/fgColor/closed",
8314
8394
  "reference": "mode/fgColor/danger",
8315
8395
  "collection": "mode",
@@ -8329,6 +8409,7 @@
8329
8409
  "a": 1
8330
8410
  },
8331
8411
  "type": "COLOR",
8412
+ "description": "Text color for draft state indicators",
8332
8413
  "refId": "mode/fgColor/draft",
8333
8414
  "reference": "mode/fgColor/neutral",
8334
8415
  "collection": "mode",
@@ -8348,6 +8429,7 @@
8348
8429
  "a": 1
8349
8430
  },
8350
8431
  "type": "COLOR",
8432
+ "description": "Text color for completed/done state indicators",
8351
8433
  "refId": "mode/fgColor/done",
8352
8434
  "reference": "base/color/dark/base/color/purple/4",
8353
8435
  "collection": "mode",
@@ -8367,6 +8449,7 @@
8367
8449
  "a": 1
8368
8450
  },
8369
8451
  "type": "COLOR",
8452
+ "description": "Text color for upsell and promotional content",
8370
8453
  "refId": "mode/fgColor/upsell",
8371
8454
  "reference": "mode/fgColor/done",
8372
8455
  "collection": "mode",
@@ -8386,6 +8469,7 @@
8386
8469
  "a": 1
8387
8470
  },
8388
8471
  "type": "COLOR",
8472
+ "description": "Text color for GitHub Sponsors content",
8389
8473
  "refId": "mode/fgColor/sponsors",
8390
8474
  "reference": "base/color/dark/base/color/pink/4",
8391
8475
  "collection": "mode",
@@ -8406,6 +8490,7 @@
8406
8490
  },
8407
8491
  "type": "COLOR",
8408
8492
  "alpha": 0.7,
8493
+ "description": "Background color for text selection highlights",
8409
8494
  "refId": "mode/selection/bgColor",
8410
8495
  "reference": "mode/bgColor/accent-emphasis",
8411
8496
  "collection": "mode",