@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.2,
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/blue/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/blue/5",
1180
1196
  "collection": "mode",
@@ -1195,6 +1211,7 @@
1195
1211
  },
1196
1212
  "type": "COLOR",
1197
1213
  "alpha": 0.1,
1214
+ "description": "Subtle background for open state indicators (issues, PRs)",
1198
1215
  "refId": "mode/bgColor/open-muted",
1199
1216
  "reference": "base/color/dark/base/color/orange/4",
1200
1217
  "collection": "mode",
@@ -1214,6 +1231,7 @@
1214
1231
  "a": 1
1215
1232
  },
1216
1233
  "type": "COLOR",
1234
+ "description": "Strong background for open state badges and labels",
1217
1235
  "refId": "mode/bgColor/open-emphasis",
1218
1236
  "reference": "base/color/dark/base/color/orange/5",
1219
1237
  "collection": "mode",
@@ -1234,6 +1252,7 @@
1234
1252
  },
1235
1253
  "type": "COLOR",
1236
1254
  "alpha": 0.15,
1255
+ "description": "Subtle attention background for warnings and caution states",
1237
1256
  "refId": "mode/bgColor/attention-muted",
1238
1257
  "reference": "base/color/dark/base/color/yellow/4",
1239
1258
  "collection": "mode",
@@ -1253,6 +1272,7 @@
1253
1272
  "a": 1
1254
1273
  },
1255
1274
  "type": "COLOR",
1275
+ "description": "Strong attention background for prominent warnings",
1256
1276
  "refId": "mode/bgColor/attention-emphasis",
1257
1277
  "reference": "base/color/dark/base/color/yellow/5",
1258
1278
  "collection": "mode",
@@ -1273,6 +1293,7 @@
1273
1293
  },
1274
1294
  "type": "COLOR",
1275
1295
  "alpha": 0.1,
1296
+ "description": "Subtle severe background for high-priority warnings",
1276
1297
  "refId": "mode/bgColor/severe-muted",
1277
1298
  "reference": "base/color/dark/base/color/orange/4",
1278
1299
  "collection": "mode",
@@ -1292,6 +1313,7 @@
1292
1313
  "a": 1
1293
1314
  },
1294
1315
  "type": "COLOR",
1316
+ "description": "Strong severe background for prominent high-priority warnings",
1295
1317
  "refId": "mode/bgColor/severe-emphasis",
1296
1318
  "reference": "base/color/dark/base/color/orange/5",
1297
1319
  "collection": "mode",
@@ -1312,6 +1334,7 @@
1312
1334
  },
1313
1335
  "type": "COLOR",
1314
1336
  "alpha": 0.1,
1337
+ "description": "Muted danger background for error states and destructive action contexts",
1315
1338
  "refId": "mode/bgColor/danger-muted",
1316
1339
  "reference": "base/color/dark/base/color/orange/4",
1317
1340
  "collection": "mode",
@@ -1331,6 +1354,7 @@
1331
1354
  "a": 1
1332
1355
  },
1333
1356
  "type": "COLOR",
1357
+ "description": "Emphasized danger background for critical errors and delete confirmations",
1334
1358
  "refId": "mode/bgColor/danger-emphasis",
1335
1359
  "reference": "base/color/dark/base/color/orange/5",
1336
1360
  "collection": "mode",
@@ -1351,6 +1375,7 @@
1351
1375
  },
1352
1376
  "type": "COLOR",
1353
1377
  "alpha": 0.1,
1378
+ "description": "Subtle background for closed state indicators (issues, PRs)",
1354
1379
  "refId": "mode/bgColor/closed-muted",
1355
1380
  "reference": "mode/bgColor/neutral-muted",
1356
1381
  "collection": "mode",
@@ -1370,6 +1395,7 @@
1370
1395
  "a": 1
1371
1396
  },
1372
1397
  "type": "COLOR",
1398
+ "description": "Strong background for closed state badges and labels",
1373
1399
  "refId": "mode/bgColor/closed-emphasis",
1374
1400
  "reference": "mode/bgColor/neutral-emphasis",
1375
1401
  "collection": "mode",
@@ -1390,6 +1416,7 @@
1390
1416
  },
1391
1417
  "type": "COLOR",
1392
1418
  "alpha": 0.1,
1419
+ "description": "Subtle background for draft state indicators",
1393
1420
  "refId": "mode/bgColor/draft-muted",
1394
1421
  "reference": "mode/bgColor/neutral-muted",
1395
1422
  "collection": "mode",
@@ -1409,6 +1436,7 @@
1409
1436
  "a": 1
1410
1437
  },
1411
1438
  "type": "COLOR",
1439
+ "description": "Strong background for draft state badges and labels",
1412
1440
  "refId": "mode/bgColor/draft-emphasis",
1413
1441
  "reference": "mode/bgColor/neutral-emphasis",
1414
1442
  "collection": "mode",
@@ -1429,6 +1457,7 @@
1429
1457
  },
1430
1458
  "type": "COLOR",
1431
1459
  "alpha": 0.15,
1460
+ "description": "Subtle background for completed/done state indicators",
1432
1461
  "refId": "mode/bgColor/done-muted",
1433
1462
  "reference": "base/color/dark/base/color/purple/4",
1434
1463
  "collection": "mode",
@@ -1448,6 +1477,7 @@
1448
1477
  "a": 1
1449
1478
  },
1450
1479
  "type": "COLOR",
1480
+ "description": "Strong background for completed/done state badges and labels",
1451
1481
  "refId": "mode/bgColor/done-emphasis",
1452
1482
  "reference": "base/color/dark/base/color/purple/5",
1453
1483
  "collection": "mode",
@@ -1467,6 +1497,7 @@
1467
1497
  "a": 0.15
1468
1498
  },
1469
1499
  "type": "COLOR",
1500
+ "description": "Subtle background for upsell and promotional content",
1470
1501
  "refId": "mode/bgColor/upsell-muted",
1471
1502
  "reference": "mode/bgColor/done-muted",
1472
1503
  "collection": "mode",
@@ -1486,6 +1517,7 @@
1486
1517
  "a": 1
1487
1518
  },
1488
1519
  "type": "COLOR",
1520
+ "description": "Strong background for prominent upsell elements",
1489
1521
  "refId": "mode/bgColor/upsell-emphasis",
1490
1522
  "reference": "mode/bgColor/done-emphasis",
1491
1523
  "collection": "mode",
@@ -1506,6 +1538,7 @@
1506
1538
  },
1507
1539
  "type": "COLOR",
1508
1540
  "alpha": 0.1,
1541
+ "description": "Subtle background for GitHub Sponsors content",
1509
1542
  "refId": "mode/bgColor/sponsors-muted",
1510
1543
  "reference": "base/color/dark/base/color/pink/4",
1511
1544
  "collection": "mode",
@@ -1525,6 +1558,7 @@
1525
1558
  "a": 1
1526
1559
  },
1527
1560
  "type": "COLOR",
1561
+ "description": "Strong background for prominent GitHub Sponsors elements",
1528
1562
  "refId": "mode/bgColor/sponsors-emphasis",
1529
1563
  "reference": "base/color/dark/base/color/pink/5",
1530
1564
  "collection": "mode",
@@ -1544,6 +1578,7 @@
1544
1578
  "a": 1
1545
1579
  },
1546
1580
  "type": "COLOR",
1581
+ "description": "Default border color for most UI elements",
1547
1582
  "refId": "mode/borderColor/default",
1548
1583
  "reference": "base/color/dark/base/color/neutral/7",
1549
1584
  "collection": "mode",
@@ -1564,6 +1599,7 @@
1564
1599
  },
1565
1600
  "type": "COLOR",
1566
1601
  "alpha": 0.7,
1602
+ "description": "Subtle border for secondary elements and light separators",
1567
1603
  "refId": "mode/borderColor/muted",
1568
1604
  "reference": "mode/borderColor/default",
1569
1605
  "collection": "mode",
@@ -1583,6 +1619,7 @@
1583
1619
  "a": 1
1584
1620
  },
1585
1621
  "type": "COLOR",
1622
+ "description": "Strong border for emphasis and visual weight",
1586
1623
  "refId": "mode/borderColor/emphasis",
1587
1624
  "reference": "base/color/dark/base/color/neutral/8",
1588
1625
  "collection": "mode",
@@ -1600,6 +1637,7 @@
1600
1637
  },
1601
1638
  "type": "COLOR",
1602
1639
  "alpha": 0.1,
1640
+ "description": "Border color for disabled interactive elements",
1603
1641
  "refId": "mode/borderColor/disabled",
1604
1642
  "reference": "base/color/dark/base/color/neutral/8",
1605
1643
  "collection": "mode",
@@ -1616,6 +1654,7 @@
1616
1654
  "a": 0
1617
1655
  },
1618
1656
  "type": "COLOR",
1657
+ "description": "Fully transparent border",
1619
1658
  "refId": "mode/borderColor/transparent",
1620
1659
  "reference": "base/color/dark/base/color/transparent",
1621
1660
  "collection": "mode",
@@ -1633,6 +1672,7 @@
1633
1672
  },
1634
1673
  "type": "COLOR",
1635
1674
  "alpha": 0.15,
1675
+ "description": "Semi-transparent border for overlays and layered elements",
1636
1676
  "refId": "mode/borderColor/translucent",
1637
1677
  "reference": "base/color/dark/base/color/neutral/13",
1638
1678
  "collection": "mode",
@@ -1649,6 +1689,7 @@
1649
1689
  "a": 0.7
1650
1690
  },
1651
1691
  "type": "COLOR",
1692
+ "description": "Subtle neutral semantic border",
1652
1693
  "refId": "mode/borderColor/neutral-muted",
1653
1694
  "reference": "mode/borderColor/muted",
1654
1695
  "collection": "mode",
@@ -1665,6 +1706,7 @@
1665
1706
  "a": 1
1666
1707
  },
1667
1708
  "type": "COLOR",
1709
+ "description": "Strong neutral semantic border",
1668
1710
  "refId": "mode/borderColor/neutral-emphasis",
1669
1711
  "reference": "mode/borderColor/emphasis",
1670
1712
  "collection": "mode",
@@ -1682,6 +1724,7 @@
1682
1724
  },
1683
1725
  "type": "COLOR",
1684
1726
  "alpha": 0.4,
1727
+ "description": "Subtle accent border for selected or focused elements",
1685
1728
  "refId": "mode/borderColor/accent-muted",
1686
1729
  "reference": "base/color/dark/base/color/blue/4",
1687
1730
  "collection": "mode",
@@ -1701,6 +1744,7 @@
1701
1744
  "a": 1
1702
1745
  },
1703
1746
  "type": "COLOR",
1747
+ "description": "Strong accent border for selected or focused elements",
1704
1748
  "refId": "mode/borderColor/accent-emphasis",
1705
1749
  "reference": "base/color/dark/base/color/blue/5",
1706
1750
  "collection": "mode",
@@ -1721,6 +1765,7 @@
1721
1765
  },
1722
1766
  "type": "COLOR",
1723
1767
  "alpha": 0.4,
1768
+ "description": "Subtle success border for positive feedback elements",
1724
1769
  "refId": "mode/borderColor/success-muted",
1725
1770
  "reference": "base/color/dark/base/color/blue/4",
1726
1771
  "collection": "mode",
@@ -1740,6 +1785,7 @@
1740
1785
  "a": 1
1741
1786
  },
1742
1787
  "type": "COLOR",
1788
+ "description": "Strong success border for prominent positive elements",
1743
1789
  "refId": "mode/borderColor/success-emphasis",
1744
1790
  "reference": "base/color/dark/base/color/blue/5",
1745
1791
  "collection": "mode",
@@ -1760,6 +1806,7 @@
1760
1806
  },
1761
1807
  "type": "COLOR",
1762
1808
  "alpha": 0.4,
1809
+ "description": "Subtle border for open state indicators",
1763
1810
  "refId": "mode/borderColor/open-muted",
1764
1811
  "reference": "base/color/dark/base/color/orange/4",
1765
1812
  "collection": "mode",
@@ -1779,6 +1826,7 @@
1779
1826
  "a": 1
1780
1827
  },
1781
1828
  "type": "COLOR",
1829
+ "description": "Strong border for open state badges",
1782
1830
  "refId": "mode/borderColor/open-emphasis",
1783
1831
  "reference": "base/color/dark/base/color/orange/5",
1784
1832
  "collection": "mode",
@@ -1799,6 +1847,7 @@
1799
1847
  },
1800
1848
  "type": "COLOR",
1801
1849
  "alpha": 0.4,
1850
+ "description": "Subtle attention border for warnings and caution states",
1802
1851
  "refId": "mode/borderColor/attention-muted",
1803
1852
  "reference": "base/color/dark/base/color/yellow/4",
1804
1853
  "collection": "mode",
@@ -1818,6 +1867,7 @@
1818
1867
  "a": 1
1819
1868
  },
1820
1869
  "type": "COLOR",
1870
+ "description": "Strong attention border for prominent warnings",
1821
1871
  "refId": "mode/borderColor/attention-emphasis",
1822
1872
  "reference": "base/color/dark/base/color/yellow/5",
1823
1873
  "collection": "mode",
@@ -1838,6 +1888,7 @@
1838
1888
  },
1839
1889
  "type": "COLOR",
1840
1890
  "alpha": 0.4,
1891
+ "description": "Subtle severe border for high-priority warnings",
1841
1892
  "refId": "mode/borderColor/severe-muted",
1842
1893
  "reference": "base/color/dark/base/color/orange/4",
1843
1894
  "collection": "mode",
@@ -1857,6 +1908,7 @@
1857
1908
  "a": 1
1858
1909
  },
1859
1910
  "type": "COLOR",
1911
+ "description": "Strong severe border for prominent high-priority warnings",
1860
1912
  "refId": "mode/borderColor/severe-emphasis",
1861
1913
  "reference": "base/color/dark/base/color/orange/5",
1862
1914
  "collection": "mode",
@@ -1877,6 +1929,7 @@
1877
1929
  },
1878
1930
  "type": "COLOR",
1879
1931
  "alpha": 0.4,
1932
+ "description": "Subtle danger border for errors and destructive contexts",
1880
1933
  "refId": "mode/borderColor/danger-muted",
1881
1934
  "reference": "base/color/dark/base/color/orange/4",
1882
1935
  "collection": "mode",
@@ -1896,6 +1949,7 @@
1896
1949
  "a": 1
1897
1950
  },
1898
1951
  "type": "COLOR",
1952
+ "description": "Strong danger border for destructive actions and errors",
1899
1953
  "refId": "mode/borderColor/danger-emphasis",
1900
1954
  "reference": "base/color/dark/base/color/orange/5",
1901
1955
  "collection": "mode",
@@ -1916,6 +1970,7 @@
1916
1970
  },
1917
1971
  "type": "COLOR",
1918
1972
  "alpha": 0.4,
1973
+ "description": "Subtle border for closed state indicators",
1919
1974
  "refId": "mode/borderColor/closed-muted",
1920
1975
  "reference": "mode/borderColor/default",
1921
1976
  "collection": "mode",
@@ -1935,6 +1990,7 @@
1935
1990
  "a": 1
1936
1991
  },
1937
1992
  "type": "COLOR",
1993
+ "description": "Strong border for closed state badges",
1938
1994
  "refId": "mode/borderColor/closed-emphasis",
1939
1995
  "reference": "mode/borderColor/emphasis",
1940
1996
  "collection": "mode",
@@ -1955,6 +2011,7 @@
1955
2011
  },
1956
2012
  "type": "COLOR",
1957
2013
  "alpha": 0.4,
2014
+ "description": "Subtle border for draft state indicators",
1958
2015
  "refId": "mode/borderColor/draft-muted",
1959
2016
  "reference": "mode/borderColor/default",
1960
2017
  "collection": "mode",
@@ -1974,6 +2031,7 @@
1974
2031
  "a": 1
1975
2032
  },
1976
2033
  "type": "COLOR",
2034
+ "description": "Strong border for draft state badges",
1977
2035
  "refId": "mode/borderColor/draft-emphasis",
1978
2036
  "reference": "mode/borderColor/neutral-emphasis",
1979
2037
  "collection": "mode",
@@ -1994,6 +2052,7 @@
1994
2052
  },
1995
2053
  "type": "COLOR",
1996
2054
  "alpha": 0.4,
2055
+ "description": "Subtle border for completed/done state indicators",
1997
2056
  "refId": "mode/borderColor/done-muted",
1998
2057
  "reference": "base/color/dark/base/color/purple/4",
1999
2058
  "collection": "mode",
@@ -2013,6 +2072,7 @@
2013
2072
  "a": 1
2014
2073
  },
2015
2074
  "type": "COLOR",
2075
+ "description": "Strong border for completed/done state badges",
2016
2076
  "refId": "mode/borderColor/done-emphasis",
2017
2077
  "reference": "base/color/dark/base/color/purple/5",
2018
2078
  "collection": "mode",
@@ -2032,6 +2092,7 @@
2032
2092
  "a": 0.4
2033
2093
  },
2034
2094
  "type": "COLOR",
2095
+ "description": "Subtle border for upsell and promotional content",
2035
2096
  "refId": "mode/borderColor/upsell-muted",
2036
2097
  "reference": "mode/borderColor/done-muted",
2037
2098
  "collection": "mode",
@@ -2051,6 +2112,7 @@
2051
2112
  "a": 1
2052
2113
  },
2053
2114
  "type": "COLOR",
2115
+ "description": "Strong border for prominent upsell elements",
2054
2116
  "refId": "mode/borderColor/upsell-emphasis",
2055
2117
  "reference": "mode/borderColor/done-emphasis",
2056
2118
  "collection": "mode",
@@ -2071,6 +2133,7 @@
2071
2133
  },
2072
2134
  "type": "COLOR",
2073
2135
  "alpha": 0.4,
2136
+ "description": "Subtle border for GitHub Sponsors content",
2074
2137
  "refId": "mode/borderColor/sponsors-muted",
2075
2138
  "reference": "base/color/dark/base/color/pink/4",
2076
2139
  "collection": "mode",
@@ -2090,6 +2153,7 @@
2090
2153
  "a": 1
2091
2154
  },
2092
2155
  "type": "COLOR",
2156
+ "description": "Strong border for prominent GitHub Sponsors elements",
2093
2157
  "refId": "mode/borderColor/sponsors-emphasis",
2094
2158
  "reference": "base/color/dark/base/color/pink/5",
2095
2159
  "collection": "mode",
@@ -8047,6 +8111,7 @@
8047
8111
  "a": 1
8048
8112
  },
8049
8113
  "type": "COLOR",
8114
+ "description": "Default text color for primary content and headings",
8050
8115
  "refId": "mode/fgColor/default",
8051
8116
  "reference": "base/color/dark/base/color/neutral/12",
8052
8117
  "collection": "mode",
@@ -8066,6 +8131,7 @@
8066
8131
  "a": 1
8067
8132
  },
8068
8133
  "type": "COLOR",
8134
+ "description": "Muted text for secondary content and less important information",
8069
8135
  "refId": "mode/fgColor/muted",
8070
8136
  "reference": "base/color/dark/base/color/neutral/9",
8071
8137
  "collection": "mode",
@@ -8085,6 +8151,7 @@
8085
8151
  "a": 1
8086
8152
  },
8087
8153
  "type": "COLOR",
8154
+ "description": "Text color for use on emphasis backgrounds",
8088
8155
  "refId": "mode/fgColor/onEmphasis",
8089
8156
  "reference": "base/color/dark/base/color/neutral/13",
8090
8157
  "collection": "mode",
@@ -8104,6 +8171,7 @@
8104
8171
  "a": 1
8105
8172
  },
8106
8173
  "type": "COLOR",
8174
+ "description": "Text color for use on inverse backgrounds",
8107
8175
  "refId": "mode/fgColor/onInverse",
8108
8176
  "reference": "base/color/dark/base/color/neutral/0",
8109
8177
  "collection": "mode",
@@ -8120,6 +8188,7 @@
8120
8188
  "a": 1
8121
8189
  },
8122
8190
  "type": "COLOR",
8191
+ "description": "Pure white text",
8123
8192
  "refId": "mode/fgColor/white",
8124
8193
  "reference": "base/color/dark/base/color/neutral/13",
8125
8194
  "collection": "mode",
@@ -8136,6 +8205,7 @@
8136
8205
  "a": 1
8137
8206
  },
8138
8207
  "type": "COLOR",
8208
+ "description": "Pure black text",
8139
8209
  "refId": "mode/fgColor/black",
8140
8210
  "reference": "base/color/dark/base/color/neutral/0",
8141
8211
  "collection": "mode",
@@ -8152,6 +8222,7 @@
8152
8222
  "a": 1
8153
8223
  },
8154
8224
  "type": "COLOR",
8225
+ "description": "Text color for disabled interactive elements",
8155
8226
  "refId": "mode/fgColor/disabled",
8156
8227
  "reference": "base/color/dark/base/color/neutral/8",
8157
8228
  "collection": "mode",
@@ -8168,6 +8239,7 @@
8168
8239
  "a": 1
8169
8240
  },
8170
8241
  "type": "COLOR",
8242
+ "description": "Text color for hyperlinks",
8171
8243
  "refId": "mode/fgColor/link",
8172
8244
  "reference": "mode/fgColor/accent",
8173
8245
  "collection": "mode",
@@ -8187,6 +8259,7 @@
8187
8259
  "a": 1
8188
8260
  },
8189
8261
  "type": "COLOR",
8262
+ "description": "Neutral semantic text for icons and secondary elements",
8190
8263
  "refId": "mode/fgColor/neutral",
8191
8264
  "reference": "base/color/dark/base/color/neutral/9",
8192
8265
  "collection": "mode",
@@ -8203,6 +8276,7 @@
8203
8276
  "a": 1
8204
8277
  },
8205
8278
  "type": "COLOR",
8279
+ "description": "Accent text for links and interactive elements",
8206
8280
  "refId": "mode/fgColor/accent",
8207
8281
  "collection": "mode",
8208
8282
  "mode": "dark protanopia deuteranopia",
@@ -8221,6 +8295,7 @@
8221
8295
  "a": 1
8222
8296
  },
8223
8297
  "type": "COLOR",
8298
+ "description": "Success text for positive feedback and completed states",
8224
8299
  "refId": "mode/fgColor/success",
8225
8300
  "reference": "base/color/dark/base/color/blue/3",
8226
8301
  "collection": "mode",
@@ -8240,6 +8315,7 @@
8240
8315
  "a": 1
8241
8316
  },
8242
8317
  "type": "COLOR",
8318
+ "description": "Text color for open state indicators (issues, PRs)",
8243
8319
  "refId": "mode/fgColor/open",
8244
8320
  "reference": "base/color/dark/base/color/orange/4",
8245
8321
  "collection": "mode",
@@ -8259,6 +8335,7 @@
8259
8335
  "a": 1
8260
8336
  },
8261
8337
  "type": "COLOR",
8338
+ "description": "Attention text for warnings and caution states",
8262
8339
  "refId": "mode/fgColor/attention",
8263
8340
  "reference": "base/color/dark/base/color/yellow/3",
8264
8341
  "collection": "mode",
@@ -8278,6 +8355,7 @@
8278
8355
  "a": 1
8279
8356
  },
8280
8357
  "type": "COLOR",
8358
+ "description": "Severe text for high-priority warnings",
8281
8359
  "refId": "mode/fgColor/severe",
8282
8360
  "reference": "base/color/dark/base/color/orange/4",
8283
8361
  "collection": "mode",
@@ -8297,6 +8375,7 @@
8297
8375
  "a": 1
8298
8376
  },
8299
8377
  "type": "COLOR",
8378
+ "description": "Danger text for errors and destructive actions",
8300
8379
  "refId": "mode/fgColor/danger",
8301
8380
  "reference": "base/color/dark/base/color/orange/3",
8302
8381
  "collection": "mode",
@@ -8316,6 +8395,7 @@
8316
8395
  "a": 1
8317
8396
  },
8318
8397
  "type": "COLOR",
8398
+ "description": "Text color for closed state indicators (issues, PRs)",
8319
8399
  "refId": "mode/fgColor/closed",
8320
8400
  "reference": "mode/fgColor/muted",
8321
8401
  "collection": "mode",
@@ -8335,6 +8415,7 @@
8335
8415
  "a": 1
8336
8416
  },
8337
8417
  "type": "COLOR",
8418
+ "description": "Text color for draft state indicators",
8338
8419
  "refId": "mode/fgColor/draft",
8339
8420
  "reference": "mode/fgColor/neutral",
8340
8421
  "collection": "mode",
@@ -8354,6 +8435,7 @@
8354
8435
  "a": 1
8355
8436
  },
8356
8437
  "type": "COLOR",
8438
+ "description": "Text color for completed/done state indicators",
8357
8439
  "refId": "mode/fgColor/done",
8358
8440
  "reference": "base/color/dark/base/color/purple/4",
8359
8441
  "collection": "mode",
@@ -8373,6 +8455,7 @@
8373
8455
  "a": 1
8374
8456
  },
8375
8457
  "type": "COLOR",
8458
+ "description": "Text color for upsell and promotional content",
8376
8459
  "refId": "mode/fgColor/upsell",
8377
8460
  "reference": "mode/fgColor/done",
8378
8461
  "collection": "mode",
@@ -8392,6 +8475,7 @@
8392
8475
  "a": 1
8393
8476
  },
8394
8477
  "type": "COLOR",
8478
+ "description": "Text color for GitHub Sponsors content",
8395
8479
  "refId": "mode/fgColor/sponsors",
8396
8480
  "reference": "base/color/dark/base/color/pink/4",
8397
8481
  "collection": "mode",
@@ -8412,6 +8496,7 @@
8412
8496
  },
8413
8497
  "type": "COLOR",
8414
8498
  "alpha": 0.7,
8499
+ "description": "Background color for text selection highlights",
8415
8500
  "refId": "mode/selection/bgColor",
8416
8501
  "reference": "mode/bgColor/accent-emphasis",
8417
8502
  "collection": "mode",