@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
@@ -1,6 +1,10 @@
1
+ /**
2
+ * @spec See /DESIGN_TOKENS_SPEC.md for naming logic and semantic pairings.
3
+ * @rule Never use raw values (hex/px). Use semantic tokens ONLY.
4
+ */
1
5
  [data-color-mode="dark"][data-dark-theme="dark_tritanopia"],
2
6
  [data-color-mode="auto"][data-light-theme="dark_tritanopia"] {
3
- --bgColor-sponsors-muted: #db61a21a;
7
+ --bgColor-sponsors-muted: #db61a21a; /** Subtle background for GitHub Sponsors content */
4
8
  --button-danger-fgColor-rest: #fa5e55;
5
9
  --button-outline-bgColor-active: #0d419d;
6
10
  --button-outline-bgColor-disabled: #212830;
@@ -13,53 +17,53 @@
13
17
  --color-ansi-cyan-bright: #56d4dd;
14
18
  --control-checked-bgColor-active: #3685f3;
15
19
  --control-checked-bgColor-hover: #2a7aef;
16
- --fgColor-accent: #4493f8;
20
+ --fgColor-accent: #4493f8; /** Accent text for links and interactive elements */
17
21
  --reactionButton-selected-bgColor-hover: #3a8cfd5c;
18
22
  --avatar-shadow: 0px 0px 0px 2px #0d1117;
19
23
  --avatarStack-fade-bgColor-default: #3d444d;
20
24
  --avatarStack-fade-bgColor-muted: #2a313c;
21
- --bgColor-accent-emphasis: #1f6feb;
22
- --bgColor-accent-muted: #388bfd1a;
23
- --bgColor-attention-emphasis: #9e6a03;
24
- --bgColor-attention-muted: #bb800926;
25
- --bgColor-danger-emphasis: #da3633;
26
- --bgColor-danger-muted: #f851491a;
27
- --bgColor-default: #0d1117;
28
- --bgColor-disabled: #212830;
29
- --bgColor-done-emphasis: #8957e5;
30
- --bgColor-done-muted: #ab7df826;
31
- --bgColor-emphasis: #3d444d;
32
- --bgColor-muted: #151b23;
33
- --bgColor-neutral-emphasis: #656c76;
34
- --bgColor-neutral-muted: #656c7633;
35
- --bgColor-open-emphasis: #da3633;
36
- --bgColor-open-muted: #f851491a;
37
- --bgColor-severe-emphasis: #da3633;
38
- --bgColor-severe-muted: #f851491a;
39
- --bgColor-sponsors-emphasis: #bf4b8a;
40
- --bgColor-success-emphasis: #1f6feb;
41
- --bgColor-success-muted: #388bfd26;
42
- --bgColor-transparent: #00000000;
43
- --borderColor-accent-emphasis: #1f6feb;
44
- --borderColor-accent-muted: #388bfd66;
45
- --borderColor-attention-emphasis: #9e6a03;
46
- --borderColor-attention-muted: #bb800966;
47
- --borderColor-danger-emphasis: #da3633;
48
- --borderColor-danger-muted: #f8514966;
49
- --borderColor-default: #3d444d;
50
- --borderColor-disabled: #656c761a;
51
- --borderColor-done-emphasis: #8957e5;
52
- --borderColor-done-muted: #ab7df866;
53
- --borderColor-emphasis: #656c76;
54
- --borderColor-open-emphasis: #da3633;
55
- --borderColor-open-muted: #f8514966;
56
- --borderColor-severe-emphasis: #da3633;
57
- --borderColor-severe-muted: #f8514966;
58
- --borderColor-sponsors-emphasis: #bf4b8a;
59
- --borderColor-sponsors-muted: #db61a266;
60
- --borderColor-success-emphasis: #1f6feb;
61
- --borderColor-success-muted: #388bfd66;
62
- --borderColor-transparent: #00000000;
25
+ --bgColor-accent-emphasis: #1f6feb; /** Strong accent background for active states and focused states */
26
+ --bgColor-accent-muted: #388bfd1a; /** Subtle accent background for informational or selected elements */
27
+ --bgColor-attention-emphasis: #9e6a03; /** Strong attention background for prominent warnings */
28
+ --bgColor-attention-muted: #bb800926; /** Subtle attention background for warnings and caution states */
29
+ --bgColor-danger-emphasis: #da3633; /** Emphasized danger background for critical errors and delete confirmations */
30
+ --bgColor-danger-muted: #f851491a; /** Muted danger background for error states and destructive action contexts */
31
+ --bgColor-default: #0d1117; /** Default background color for pages and main content areas */
32
+ --bgColor-disabled: #212830; /** Background for disabled interactive elements */
33
+ --bgColor-done-emphasis: #8957e5; /** Strong background for completed/done state badges and labels */
34
+ --bgColor-done-muted: #ab7df826; /** Subtle background for completed/done state indicators */
35
+ --bgColor-emphasis: #3d444d; /** High-emphasis dark background for strong visual contrast */
36
+ --bgColor-muted: #151b23; /** Muted background for secondary content areas and subtle grouping */
37
+ --bgColor-neutral-emphasis: #656c76; /** Strong neutral background for prominent neutral elements */
38
+ --bgColor-neutral-muted: #656c7633; /** Subtle neutral background for tags, labels, and secondary UI elements */
39
+ --bgColor-open-emphasis: #da3633; /** Strong background for open state badges and labels */
40
+ --bgColor-open-muted: #f851491a; /** Subtle background for open state indicators (issues, PRs) */
41
+ --bgColor-severe-emphasis: #da3633; /** Strong severe background for prominent high-priority warnings */
42
+ --bgColor-severe-muted: #f851491a; /** Subtle severe background for high-priority warnings */
43
+ --bgColor-sponsors-emphasis: #bf4b8a; /** Strong background for prominent GitHub Sponsors elements */
44
+ --bgColor-success-emphasis: #1f6feb; /** Strong success background for prominent positive actions */
45
+ --bgColor-success-muted: #388bfd26; /** Subtle success background for positive feedback and completed states */
46
+ --bgColor-transparent: #00000000; /** Fully transparent background */
47
+ --borderColor-accent-emphasis: #1f6feb; /** Strong accent border for selected or focused elements */
48
+ --borderColor-accent-muted: #388bfd66; /** Subtle accent border for selected or focused elements */
49
+ --borderColor-attention-emphasis: #9e6a03; /** Strong attention border for prominent warnings */
50
+ --borderColor-attention-muted: #bb800966; /** Subtle attention border for warnings and caution states */
51
+ --borderColor-danger-emphasis: #da3633; /** Strong danger border for destructive actions and errors */
52
+ --borderColor-danger-muted: #f8514966; /** Subtle danger border for errors and destructive contexts */
53
+ --borderColor-default: #3d444d; /** Default border color for most UI elements */
54
+ --borderColor-disabled: #656c761a; /** Border color for disabled interactive elements */
55
+ --borderColor-done-emphasis: #8957e5; /** Strong border for completed/done state badges */
56
+ --borderColor-done-muted: #ab7df866; /** Subtle border for completed/done state indicators */
57
+ --borderColor-emphasis: #656c76; /** Strong border for emphasis and visual weight */
58
+ --borderColor-open-emphasis: #da3633; /** Strong border for open state badges */
59
+ --borderColor-open-muted: #f8514966; /** Subtle border for open state indicators */
60
+ --borderColor-severe-emphasis: #da3633; /** Strong severe border for prominent high-priority warnings */
61
+ --borderColor-severe-muted: #f8514966; /** Subtle severe border for high-priority warnings */
62
+ --borderColor-sponsors-emphasis: #bf4b8a; /** Strong border for prominent GitHub Sponsors elements */
63
+ --borderColor-sponsors-muted: #db61a266; /** Subtle border for GitHub Sponsors content */
64
+ --borderColor-success-emphasis: #1f6feb; /** Strong success border for prominent positive elements */
65
+ --borderColor-success-muted: #388bfd66; /** Subtle success border for positive feedback elements */
66
+ --borderColor-transparent: #00000000; /** Fully transparent border */
63
67
  --button-danger-bgColor-hover: #b62324;
64
68
  --button-danger-iconColor-rest: var(--button-danger-fgColor-rest);
65
69
  --button-danger-shadow-selected: 0px 0px 0px 0px #000000;
@@ -497,18 +501,18 @@
497
501
  --display-yellow-scale-7: #df9e11;
498
502
  --display-yellow-scale-8: #edb431;
499
503
  --display-yellow-scale-9: #f0ca6a;
500
- --fgColor-attention: #d29922;
501
- --fgColor-danger: #f85149;
502
- --fgColor-default: #f0f6fc;
503
- --fgColor-disabled: #656c76;
504
- --fgColor-done: #ab7df8;
505
- --fgColor-link: var(--fgColor-accent);
506
- --fgColor-muted: #9198a1;
507
- --fgColor-neutral: #9198a1;
508
- --fgColor-open: #f85149;
509
- --fgColor-severe: #f85149;
510
- --fgColor-sponsors: #db61a2;
511
- --fgColor-success: #58a6ff;
504
+ --fgColor-attention: #d29922; /** Attention text for warnings and caution states */
505
+ --fgColor-danger: #f85149; /** Danger text for errors and destructive actions */
506
+ --fgColor-default: #f0f6fc; /** Default text color for primary content and headings */
507
+ --fgColor-disabled: #656c76; /** Text color for disabled interactive elements */
508
+ --fgColor-done: #ab7df8; /** Text color for completed/done state indicators */
509
+ --fgColor-link: var(--fgColor-accent); /** Text color for hyperlinks */
510
+ --fgColor-muted: #9198a1; /** Muted text for secondary content and less important information */
511
+ --fgColor-neutral: #9198a1; /** Neutral semantic text for icons and secondary elements */
512
+ --fgColor-open: #f85149; /** Text color for open state indicators (issues, PRs) */
513
+ --fgColor-severe: #f85149; /** Severe text for high-priority warnings */
514
+ --fgColor-sponsors: #db61a2; /** Text color for GitHub Sponsors content */
515
+ --fgColor-success: #58a6ff; /** Success text for positive feedback and completed states */
512
516
  --header-bgColor: #151b23f2;
513
517
  --header-borderColor-divider: #656c76;
514
518
  --header-fgColor-logo: #f0f6fc;
@@ -660,16 +664,16 @@
660
664
  --topicTag-borderColor: #00000000;
661
665
  --underlineNav-borderColor-active: #f78166;
662
666
  --avatar-bgColor: #ffffff1a;
663
- --bgColor-black: #010409;
664
- --bgColor-closed-emphasis: var(--bgColor-neutral-emphasis);
665
- --bgColor-closed-muted: #656c761a;
666
- --bgColor-draft-emphasis: var(--bgColor-neutral-emphasis);
667
- --bgColor-draft-muted: #656c761a;
668
- --bgColor-inset: #010409;
669
- --bgColor-inverse: #ffffff;
670
- --bgColor-upsell-emphasis: var(--bgColor-done-emphasis);
671
- --bgColor-upsell-muted: var(--bgColor-done-muted);
672
- --bgColor-white: #ffffff;
667
+ --bgColor-black: #010409; /** Pure black background */
668
+ --bgColor-closed-emphasis: var(--bgColor-neutral-emphasis); /** Strong background for closed state badges and labels */
669
+ --bgColor-closed-muted: #656c761a; /** Subtle background for closed state indicators (issues, PRs) */
670
+ --bgColor-draft-emphasis: var(--bgColor-neutral-emphasis); /** Strong background for draft state badges and labels */
671
+ --bgColor-draft-muted: #656c761a; /** Subtle background for draft state indicators */
672
+ --bgColor-inset: #010409; /** Inset background for recessed content areas like wells or sunken panels */
673
+ --bgColor-inverse: #ffffff; /** Inverse background that flips between light and dark modes */
674
+ --bgColor-upsell-emphasis: var(--bgColor-done-emphasis); /** Strong background for prominent upsell elements */
675
+ --bgColor-upsell-muted: var(--bgColor-done-muted); /** Subtle background for upsell and promotional content */
676
+ --bgColor-white: #ffffff; /** Pure white background */
673
677
  --border-accent-emphasis: 0.0625rem solid #1f6feb;
674
678
  --border-accent-muted: 0.0625rem solid #388bfd66;
675
679
  --border-attention-emphasis: 0.0625rem solid #9e6a03;
@@ -688,14 +692,14 @@
688
692
  --border-success-emphasis: 0.0625rem solid #1f6feb;
689
693
  --border-success-muted: 0.0625rem solid #388bfd66;
690
694
  --border-transparent: 0.0625rem solid #00000000;
691
- --borderColor-closed-emphasis: var(--borderColor-emphasis);
692
- --borderColor-closed-muted: #3d444d66;
693
- --borderColor-draft-muted: #3d444d66;
694
- --borderColor-muted: #3d444db3;
695
- --borderColor-neutral-emphasis: var(--borderColor-emphasis);
696
- --borderColor-translucent: #ffffff26;
697
- --borderColor-upsell-emphasis: var(--borderColor-done-emphasis);
698
- --borderColor-upsell-muted: var(--borderColor-done-muted);
695
+ --borderColor-closed-emphasis: var(--borderColor-emphasis); /** Strong border for closed state badges */
696
+ --borderColor-closed-muted: #3d444d66; /** Subtle border for closed state indicators */
697
+ --borderColor-draft-muted: #3d444d66; /** Subtle border for draft state indicators */
698
+ --borderColor-muted: #3d444db3; /** Subtle border for secondary elements and light separators */
699
+ --borderColor-neutral-emphasis: var(--borderColor-emphasis); /** Strong neutral semantic border */
700
+ --borderColor-translucent: #ffffff26; /** Semi-transparent border for overlays and layered elements */
701
+ --borderColor-upsell-emphasis: var(--borderColor-done-emphasis); /** Strong border for prominent upsell elements */
702
+ --borderColor-upsell-muted: var(--borderColor-done-muted); /** Subtle border for upsell and promotional content */
699
703
  --button-danger-bgColor-active: var(--bgColor-danger-emphasis);
700
704
  --button-danger-bgColor-rest: var(--control-bgColor-rest);
701
705
  --button-danger-fgColor-active: #ffffff;
@@ -794,14 +798,14 @@
794
798
  --diffBlob-expander-iconColor: var(--fgColor-muted);
795
799
  --diffBlob-hunkLine-fgColor: var(--fgColor-muted);
796
800
  --diffBlob-hunkNum-fgColor-rest: var(--fgColor-default);
797
- --fgColor-black: #010409;
798
- --fgColor-closed: var(--fgColor-muted);
799
- --fgColor-draft: var(--fgColor-neutral);
800
- --fgColor-onEmphasis: #ffffff;
801
- --fgColor-onInverse: #010409;
802
- --fgColor-upsell: var(--fgColor-done);
803
- --fgColor-white: #ffffff;
804
- --focus-outlineColor: var(--borderColor-accent-emphasis);
801
+ --fgColor-black: #010409; /** Pure black text */
802
+ --fgColor-closed: var(--fgColor-muted); /** Text color for closed state indicators (issues, PRs) */
803
+ --fgColor-draft: var(--fgColor-neutral); /** Text color for draft state indicators */
804
+ --fgColor-onEmphasis: #ffffff; /** Text color for use on emphasis backgrounds */
805
+ --fgColor-onInverse: #010409; /** Text color for use on inverse backgrounds */
806
+ --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
807
+ --fgColor-white: #ffffff; /** Pure white text */
808
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
805
809
  --header-fgColor-default: #ffffffb3;
806
810
  --overlay-bgColor: #010409;
807
811
  --page-header-bgColor: var(--bgColor-default);
@@ -816,12 +820,12 @@
816
820
  --progressBar-track-bgColor: var(--borderColor-default);
817
821
  --reactionButton-selected-fgColor-rest: var(--fgColor-link);
818
822
  --selectMenu-borderColor: var(--borderColor-default);
819
- --selection-bgColor: #1f6febb3;
820
- --shadow-floating-legacy: 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966;
821
- --shadow-inset: inset 0px 1px 0px 0px #0104093d;
822
- --shadow-resting-medium: 0px 1px 1px 0px #01040966, 0px 3px 6px 0px #010409cc;
823
- --shadow-resting-small: 0px 1px 1px 0px #01040999, 0px 1px 3px 0px #01040999;
824
- --shadow-resting-xsmall: 0px 1px 1px 0px #010409cc;
823
+ --selection-bgColor: #1f6febb3; /** Background color for text selection highlights */
824
+ --shadow-floating-legacy: 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966; /** Legacy floating shadow for backward compatibility */
825
+ --shadow-inset: inset 0px 1px 0px 0px #0104093d; /** Inset shadow for recessed elements */
826
+ --shadow-resting-medium: 0px 1px 1px 0px #01040966, 0px 3px 6px 0px #010409cc; /** Medium resting shadow for cards and elevated surfaces */
827
+ --shadow-resting-small: 0px 1px 1px 0px #01040999, 0px 1px 3px 0px #01040999; /** Small resting shadow for buttons and interactive elements */
828
+ --shadow-resting-xsmall: 0px 1px 1px 0px #010409cc; /** Extra small resting shadow for minimal elevation */
825
829
  --tooltip-bgColor: var(--bgColor-emphasis);
826
830
  --treeViewItem-leadingVisual-iconColor-rest: var(--fgColor-muted);
827
831
  --underlineNav-iconColor-rest: var(--fgColor-muted);
@@ -834,8 +838,8 @@
834
838
  --border-open-muted: var(--border-success-muted);
835
839
  --border-upsell-emphasis: 0.0625rem solid #8957e5;
836
840
  --border-upsell-muted: 0.0625rem solid #ab7df866;
837
- --borderColor-draft-emphasis: var(--borderColor-neutral-emphasis);
838
- --borderColor-neutral-muted: var(--borderColor-muted);
841
+ --borderColor-draft-emphasis: var(--borderColor-neutral-emphasis); /** Strong border for draft state badges */
842
+ --borderColor-neutral-muted: var(--borderColor-muted); /** Subtle neutral semantic border */
839
843
  --button-danger-bgColor-disabled: var(--control-bgColor-disabled);
840
844
  --button-danger-borderColor-rest: var(--control-borderColor-rest);
841
845
  --button-default-bgColor-disabled: var(--control-bgColor-disabled);
@@ -874,7 +878,7 @@
874
878
  --controlTrack-fgColor-disabled: var(--fgColor-onEmphasis);
875
879
  --dashboard-bgColor: var(--bgColor-inset);
876
880
  --diffBlob-hunkNum-fgColor-hover: var(--fgColor-onEmphasis);
877
- --focus-outline: 2px solid #1f6feb;
881
+ --focus-outline: 2px solid #1f6feb; /** Focus ring outline for keyboard navigation and accessibility. */
878
882
  --overlay-borderColor: var(--borderColor-muted);
879
883
  --tooltip-fgColor: var(--fgColor-onEmphasis);
880
884
  --border-neutral-muted: 0.0625rem solid #3d444db3;
@@ -886,10 +890,10 @@
886
890
  --buttonKeybindingHint-danger-borderColor-disabled: var(--buttonKeybindingHint-default-borderColor-disabled);
887
891
  --buttonKeybindingHint-danger-borderColor-rest: var(--buttonKeybindingHint-default-borderColor-rest);
888
892
  --buttonKeybindingHint-danger-fgColor-disabled: var(--buttonKeybindingHint-default-fgColor-disabled);
889
- --shadow-floating-large: 0px 0px 0px 1px #3d444d, 0px 24px 48px 0px #010409;
890
- --shadow-floating-medium: 0px 0px 0px 1px #3d444d, 0px 8px 16px -4px #01040966, 0px 4px 32px -4px #01040966, 0px 24px 48px -12px #01040966, 0px 48px 96px -24px #01040966;
891
- --shadow-floating-small: 0px 0px 0px 1px #3d444d, 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966;
892
- --shadow-floating-xlarge: 0px 0px 0px 1px #3d444d, 0px 32px 64px 0px #010409;
893
+ --shadow-floating-large: 0px 0px 0px 1px #3d444d, 0px 24px 48px 0px #010409; /** Large floating shadow for modals and dialogs */
894
+ --shadow-floating-medium: 0px 0px 0px 1px #3d444d, 0px 8px 16px -4px #01040966, 0px 4px 32px -4px #01040966, 0px 24px 48px -12px #01040966, 0px 48px 96px -24px #01040966; /** Medium floating shadow for popovers and action menus */
895
+ --shadow-floating-small: 0px 0px 0px 1px #3d444d, 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966; /** Small floating shadow for dropdowns, tooltips, and small overlays */
896
+ --shadow-floating-xlarge: 0px 0px 0px 1px #3d444d, 0px 32px 64px 0px #010409; /** Extra large floating shadow for full-screen overlays and sheets */
893
897
  --underlineNav-borderColor-hover: var(--borderColor-neutral-muted);
894
898
  --button-danger-borderColor-active: var(--button-danger-borderColor-hover);
895
899
  --button-outline-borderColor-hover: var(--button-default-borderColor-hover);
@@ -897,7 +901,7 @@
897
901
  }
898
902
  @media (prefers-color-scheme: dark) {
899
903
  [data-color-mode][data-color-mode="auto"][data-dark-theme="dark_tritanopia"] {
900
- --bgColor-sponsors-muted: #db61a21a;
904
+ --bgColor-sponsors-muted: #db61a21a; /** Subtle background for GitHub Sponsors content */
901
905
  --button-danger-fgColor-rest: #fa5e55;
902
906
  --button-outline-bgColor-active: #0d419d;
903
907
  --button-outline-bgColor-disabled: #212830;
@@ -910,53 +914,53 @@
910
914
  --color-ansi-cyan-bright: #56d4dd;
911
915
  --control-checked-bgColor-active: #3685f3;
912
916
  --control-checked-bgColor-hover: #2a7aef;
913
- --fgColor-accent: #4493f8;
917
+ --fgColor-accent: #4493f8; /** Accent text for links and interactive elements */
914
918
  --reactionButton-selected-bgColor-hover: #3a8cfd5c;
915
919
  --avatar-shadow: 0px 0px 0px 2px #0d1117;
916
920
  --avatarStack-fade-bgColor-default: #3d444d;
917
921
  --avatarStack-fade-bgColor-muted: #2a313c;
918
- --bgColor-accent-emphasis: #1f6feb;
919
- --bgColor-accent-muted: #388bfd1a;
920
- --bgColor-attention-emphasis: #9e6a03;
921
- --bgColor-attention-muted: #bb800926;
922
- --bgColor-danger-emphasis: #da3633;
923
- --bgColor-danger-muted: #f851491a;
924
- --bgColor-default: #0d1117;
925
- --bgColor-disabled: #212830;
926
- --bgColor-done-emphasis: #8957e5;
927
- --bgColor-done-muted: #ab7df826;
928
- --bgColor-emphasis: #3d444d;
929
- --bgColor-muted: #151b23;
930
- --bgColor-neutral-emphasis: #656c76;
931
- --bgColor-neutral-muted: #656c7633;
932
- --bgColor-open-emphasis: #da3633;
933
- --bgColor-open-muted: #f851491a;
934
- --bgColor-severe-emphasis: #da3633;
935
- --bgColor-severe-muted: #f851491a;
936
- --bgColor-sponsors-emphasis: #bf4b8a;
937
- --bgColor-success-emphasis: #1f6feb;
938
- --bgColor-success-muted: #388bfd26;
939
- --bgColor-transparent: #00000000;
940
- --borderColor-accent-emphasis: #1f6feb;
941
- --borderColor-accent-muted: #388bfd66;
942
- --borderColor-attention-emphasis: #9e6a03;
943
- --borderColor-attention-muted: #bb800966;
944
- --borderColor-danger-emphasis: #da3633;
945
- --borderColor-danger-muted: #f8514966;
946
- --borderColor-default: #3d444d;
947
- --borderColor-disabled: #656c761a;
948
- --borderColor-done-emphasis: #8957e5;
949
- --borderColor-done-muted: #ab7df866;
950
- --borderColor-emphasis: #656c76;
951
- --borderColor-open-emphasis: #da3633;
952
- --borderColor-open-muted: #f8514966;
953
- --borderColor-severe-emphasis: #da3633;
954
- --borderColor-severe-muted: #f8514966;
955
- --borderColor-sponsors-emphasis: #bf4b8a;
956
- --borderColor-sponsors-muted: #db61a266;
957
- --borderColor-success-emphasis: #1f6feb;
958
- --borderColor-success-muted: #388bfd66;
959
- --borderColor-transparent: #00000000;
922
+ --bgColor-accent-emphasis: #1f6feb; /** Strong accent background for active states and focused states */
923
+ --bgColor-accent-muted: #388bfd1a; /** Subtle accent background for informational or selected elements */
924
+ --bgColor-attention-emphasis: #9e6a03; /** Strong attention background for prominent warnings */
925
+ --bgColor-attention-muted: #bb800926; /** Subtle attention background for warnings and caution states */
926
+ --bgColor-danger-emphasis: #da3633; /** Emphasized danger background for critical errors and delete confirmations */
927
+ --bgColor-danger-muted: #f851491a; /** Muted danger background for error states and destructive action contexts */
928
+ --bgColor-default: #0d1117; /** Default background color for pages and main content areas */
929
+ --bgColor-disabled: #212830; /** Background for disabled interactive elements */
930
+ --bgColor-done-emphasis: #8957e5; /** Strong background for completed/done state badges and labels */
931
+ --bgColor-done-muted: #ab7df826; /** Subtle background for completed/done state indicators */
932
+ --bgColor-emphasis: #3d444d; /** High-emphasis dark background for strong visual contrast */
933
+ --bgColor-muted: #151b23; /** Muted background for secondary content areas and subtle grouping */
934
+ --bgColor-neutral-emphasis: #656c76; /** Strong neutral background for prominent neutral elements */
935
+ --bgColor-neutral-muted: #656c7633; /** Subtle neutral background for tags, labels, and secondary UI elements */
936
+ --bgColor-open-emphasis: #da3633; /** Strong background for open state badges and labels */
937
+ --bgColor-open-muted: #f851491a; /** Subtle background for open state indicators (issues, PRs) */
938
+ --bgColor-severe-emphasis: #da3633; /** Strong severe background for prominent high-priority warnings */
939
+ --bgColor-severe-muted: #f851491a; /** Subtle severe background for high-priority warnings */
940
+ --bgColor-sponsors-emphasis: #bf4b8a; /** Strong background for prominent GitHub Sponsors elements */
941
+ --bgColor-success-emphasis: #1f6feb; /** Strong success background for prominent positive actions */
942
+ --bgColor-success-muted: #388bfd26; /** Subtle success background for positive feedback and completed states */
943
+ --bgColor-transparent: #00000000; /** Fully transparent background */
944
+ --borderColor-accent-emphasis: #1f6feb; /** Strong accent border for selected or focused elements */
945
+ --borderColor-accent-muted: #388bfd66; /** Subtle accent border for selected or focused elements */
946
+ --borderColor-attention-emphasis: #9e6a03; /** Strong attention border for prominent warnings */
947
+ --borderColor-attention-muted: #bb800966; /** Subtle attention border for warnings and caution states */
948
+ --borderColor-danger-emphasis: #da3633; /** Strong danger border for destructive actions and errors */
949
+ --borderColor-danger-muted: #f8514966; /** Subtle danger border for errors and destructive contexts */
950
+ --borderColor-default: #3d444d; /** Default border color for most UI elements */
951
+ --borderColor-disabled: #656c761a; /** Border color for disabled interactive elements */
952
+ --borderColor-done-emphasis: #8957e5; /** Strong border for completed/done state badges */
953
+ --borderColor-done-muted: #ab7df866; /** Subtle border for completed/done state indicators */
954
+ --borderColor-emphasis: #656c76; /** Strong border for emphasis and visual weight */
955
+ --borderColor-open-emphasis: #da3633; /** Strong border for open state badges */
956
+ --borderColor-open-muted: #f8514966; /** Subtle border for open state indicators */
957
+ --borderColor-severe-emphasis: #da3633; /** Strong severe border for prominent high-priority warnings */
958
+ --borderColor-severe-muted: #f8514966; /** Subtle severe border for high-priority warnings */
959
+ --borderColor-sponsors-emphasis: #bf4b8a; /** Strong border for prominent GitHub Sponsors elements */
960
+ --borderColor-sponsors-muted: #db61a266; /** Subtle border for GitHub Sponsors content */
961
+ --borderColor-success-emphasis: #1f6feb; /** Strong success border for prominent positive elements */
962
+ --borderColor-success-muted: #388bfd66; /** Subtle success border for positive feedback elements */
963
+ --borderColor-transparent: #00000000; /** Fully transparent border */
960
964
  --button-danger-bgColor-hover: #b62324;
961
965
  --button-danger-iconColor-rest: var(--button-danger-fgColor-rest);
962
966
  --button-danger-shadow-selected: 0px 0px 0px 0px #000000;
@@ -1394,18 +1398,18 @@
1394
1398
  --display-yellow-scale-7: #df9e11;
1395
1399
  --display-yellow-scale-8: #edb431;
1396
1400
  --display-yellow-scale-9: #f0ca6a;
1397
- --fgColor-attention: #d29922;
1398
- --fgColor-danger: #f85149;
1399
- --fgColor-default: #f0f6fc;
1400
- --fgColor-disabled: #656c76;
1401
- --fgColor-done: #ab7df8;
1402
- --fgColor-link: var(--fgColor-accent);
1403
- --fgColor-muted: #9198a1;
1404
- --fgColor-neutral: #9198a1;
1405
- --fgColor-open: #f85149;
1406
- --fgColor-severe: #f85149;
1407
- --fgColor-sponsors: #db61a2;
1408
- --fgColor-success: #58a6ff;
1401
+ --fgColor-attention: #d29922; /** Attention text for warnings and caution states */
1402
+ --fgColor-danger: #f85149; /** Danger text for errors and destructive actions */
1403
+ --fgColor-default: #f0f6fc; /** Default text color for primary content and headings */
1404
+ --fgColor-disabled: #656c76; /** Text color for disabled interactive elements */
1405
+ --fgColor-done: #ab7df8; /** Text color for completed/done state indicators */
1406
+ --fgColor-link: var(--fgColor-accent); /** Text color for hyperlinks */
1407
+ --fgColor-muted: #9198a1; /** Muted text for secondary content and less important information */
1408
+ --fgColor-neutral: #9198a1; /** Neutral semantic text for icons and secondary elements */
1409
+ --fgColor-open: #f85149; /** Text color for open state indicators (issues, PRs) */
1410
+ --fgColor-severe: #f85149; /** Severe text for high-priority warnings */
1411
+ --fgColor-sponsors: #db61a2; /** Text color for GitHub Sponsors content */
1412
+ --fgColor-success: #58a6ff; /** Success text for positive feedback and completed states */
1409
1413
  --header-bgColor: #151b23f2;
1410
1414
  --header-borderColor-divider: #656c76;
1411
1415
  --header-fgColor-logo: #f0f6fc;
@@ -1557,16 +1561,16 @@
1557
1561
  --topicTag-borderColor: #00000000;
1558
1562
  --underlineNav-borderColor-active: #f78166;
1559
1563
  --avatar-bgColor: #ffffff1a;
1560
- --bgColor-black: #010409;
1561
- --bgColor-closed-emphasis: var(--bgColor-neutral-emphasis);
1562
- --bgColor-closed-muted: #656c761a;
1563
- --bgColor-draft-emphasis: var(--bgColor-neutral-emphasis);
1564
- --bgColor-draft-muted: #656c761a;
1565
- --bgColor-inset: #010409;
1566
- --bgColor-inverse: #ffffff;
1567
- --bgColor-upsell-emphasis: var(--bgColor-done-emphasis);
1568
- --bgColor-upsell-muted: var(--bgColor-done-muted);
1569
- --bgColor-white: #ffffff;
1564
+ --bgColor-black: #010409; /** Pure black background */
1565
+ --bgColor-closed-emphasis: var(--bgColor-neutral-emphasis); /** Strong background for closed state badges and labels */
1566
+ --bgColor-closed-muted: #656c761a; /** Subtle background for closed state indicators (issues, PRs) */
1567
+ --bgColor-draft-emphasis: var(--bgColor-neutral-emphasis); /** Strong background for draft state badges and labels */
1568
+ --bgColor-draft-muted: #656c761a; /** Subtle background for draft state indicators */
1569
+ --bgColor-inset: #010409; /** Inset background for recessed content areas like wells or sunken panels */
1570
+ --bgColor-inverse: #ffffff; /** Inverse background that flips between light and dark modes */
1571
+ --bgColor-upsell-emphasis: var(--bgColor-done-emphasis); /** Strong background for prominent upsell elements */
1572
+ --bgColor-upsell-muted: var(--bgColor-done-muted); /** Subtle background for upsell and promotional content */
1573
+ --bgColor-white: #ffffff; /** Pure white background */
1570
1574
  --border-accent-emphasis: 0.0625rem solid #1f6feb;
1571
1575
  --border-accent-muted: 0.0625rem solid #388bfd66;
1572
1576
  --border-attention-emphasis: 0.0625rem solid #9e6a03;
@@ -1585,14 +1589,14 @@
1585
1589
  --border-success-emphasis: 0.0625rem solid #1f6feb;
1586
1590
  --border-success-muted: 0.0625rem solid #388bfd66;
1587
1591
  --border-transparent: 0.0625rem solid #00000000;
1588
- --borderColor-closed-emphasis: var(--borderColor-emphasis);
1589
- --borderColor-closed-muted: #3d444d66;
1590
- --borderColor-draft-muted: #3d444d66;
1591
- --borderColor-muted: #3d444db3;
1592
- --borderColor-neutral-emphasis: var(--borderColor-emphasis);
1593
- --borderColor-translucent: #ffffff26;
1594
- --borderColor-upsell-emphasis: var(--borderColor-done-emphasis);
1595
- --borderColor-upsell-muted: var(--borderColor-done-muted);
1592
+ --borderColor-closed-emphasis: var(--borderColor-emphasis); /** Strong border for closed state badges */
1593
+ --borderColor-closed-muted: #3d444d66; /** Subtle border for closed state indicators */
1594
+ --borderColor-draft-muted: #3d444d66; /** Subtle border for draft state indicators */
1595
+ --borderColor-muted: #3d444db3; /** Subtle border for secondary elements and light separators */
1596
+ --borderColor-neutral-emphasis: var(--borderColor-emphasis); /** Strong neutral semantic border */
1597
+ --borderColor-translucent: #ffffff26; /** Semi-transparent border for overlays and layered elements */
1598
+ --borderColor-upsell-emphasis: var(--borderColor-done-emphasis); /** Strong border for prominent upsell elements */
1599
+ --borderColor-upsell-muted: var(--borderColor-done-muted); /** Subtle border for upsell and promotional content */
1596
1600
  --button-danger-bgColor-active: var(--bgColor-danger-emphasis);
1597
1601
  --button-danger-bgColor-rest: var(--control-bgColor-rest);
1598
1602
  --button-danger-fgColor-active: #ffffff;
@@ -1691,14 +1695,14 @@
1691
1695
  --diffBlob-expander-iconColor: var(--fgColor-muted);
1692
1696
  --diffBlob-hunkLine-fgColor: var(--fgColor-muted);
1693
1697
  --diffBlob-hunkNum-fgColor-rest: var(--fgColor-default);
1694
- --fgColor-black: #010409;
1695
- --fgColor-closed: var(--fgColor-muted);
1696
- --fgColor-draft: var(--fgColor-neutral);
1697
- --fgColor-onEmphasis: #ffffff;
1698
- --fgColor-onInverse: #010409;
1699
- --fgColor-upsell: var(--fgColor-done);
1700
- --fgColor-white: #ffffff;
1701
- --focus-outlineColor: var(--borderColor-accent-emphasis);
1698
+ --fgColor-black: #010409; /** Pure black text */
1699
+ --fgColor-closed: var(--fgColor-muted); /** Text color for closed state indicators (issues, PRs) */
1700
+ --fgColor-draft: var(--fgColor-neutral); /** Text color for draft state indicators */
1701
+ --fgColor-onEmphasis: #ffffff; /** Text color for use on emphasis backgrounds */
1702
+ --fgColor-onInverse: #010409; /** Text color for use on inverse backgrounds */
1703
+ --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
1704
+ --fgColor-white: #ffffff; /** Pure white text */
1705
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
1702
1706
  --header-fgColor-default: #ffffffb3;
1703
1707
  --overlay-bgColor: #010409;
1704
1708
  --page-header-bgColor: var(--bgColor-default);
@@ -1713,12 +1717,12 @@
1713
1717
  --progressBar-track-bgColor: var(--borderColor-default);
1714
1718
  --reactionButton-selected-fgColor-rest: var(--fgColor-link);
1715
1719
  --selectMenu-borderColor: var(--borderColor-default);
1716
- --selection-bgColor: #1f6febb3;
1717
- --shadow-floating-legacy: 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966;
1718
- --shadow-inset: inset 0px 1px 0px 0px #0104093d;
1719
- --shadow-resting-medium: 0px 1px 1px 0px #01040966, 0px 3px 6px 0px #010409cc;
1720
- --shadow-resting-small: 0px 1px 1px 0px #01040999, 0px 1px 3px 0px #01040999;
1721
- --shadow-resting-xsmall: 0px 1px 1px 0px #010409cc;
1720
+ --selection-bgColor: #1f6febb3; /** Background color for text selection highlights */
1721
+ --shadow-floating-legacy: 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966; /** Legacy floating shadow for backward compatibility */
1722
+ --shadow-inset: inset 0px 1px 0px 0px #0104093d; /** Inset shadow for recessed elements */
1723
+ --shadow-resting-medium: 0px 1px 1px 0px #01040966, 0px 3px 6px 0px #010409cc; /** Medium resting shadow for cards and elevated surfaces */
1724
+ --shadow-resting-small: 0px 1px 1px 0px #01040999, 0px 1px 3px 0px #01040999; /** Small resting shadow for buttons and interactive elements */
1725
+ --shadow-resting-xsmall: 0px 1px 1px 0px #010409cc; /** Extra small resting shadow for minimal elevation */
1722
1726
  --tooltip-bgColor: var(--bgColor-emphasis);
1723
1727
  --treeViewItem-leadingVisual-iconColor-rest: var(--fgColor-muted);
1724
1728
  --underlineNav-iconColor-rest: var(--fgColor-muted);
@@ -1731,8 +1735,8 @@
1731
1735
  --border-open-muted: var(--border-success-muted);
1732
1736
  --border-upsell-emphasis: 0.0625rem solid #8957e5;
1733
1737
  --border-upsell-muted: 0.0625rem solid #ab7df866;
1734
- --borderColor-draft-emphasis: var(--borderColor-neutral-emphasis);
1735
- --borderColor-neutral-muted: var(--borderColor-muted);
1738
+ --borderColor-draft-emphasis: var(--borderColor-neutral-emphasis); /** Strong border for draft state badges */
1739
+ --borderColor-neutral-muted: var(--borderColor-muted); /** Subtle neutral semantic border */
1736
1740
  --button-danger-bgColor-disabled: var(--control-bgColor-disabled);
1737
1741
  --button-danger-borderColor-rest: var(--control-borderColor-rest);
1738
1742
  --button-default-bgColor-disabled: var(--control-bgColor-disabled);
@@ -1771,7 +1775,7 @@
1771
1775
  --controlTrack-fgColor-disabled: var(--fgColor-onEmphasis);
1772
1776
  --dashboard-bgColor: var(--bgColor-inset);
1773
1777
  --diffBlob-hunkNum-fgColor-hover: var(--fgColor-onEmphasis);
1774
- --focus-outline: 2px solid #1f6feb;
1778
+ --focus-outline: 2px solid #1f6feb; /** Focus ring outline for keyboard navigation and accessibility. */
1775
1779
  --overlay-borderColor: var(--borderColor-muted);
1776
1780
  --tooltip-fgColor: var(--fgColor-onEmphasis);
1777
1781
  --border-neutral-muted: 0.0625rem solid #3d444db3;
@@ -1783,10 +1787,10 @@
1783
1787
  --buttonKeybindingHint-danger-borderColor-disabled: var(--buttonKeybindingHint-default-borderColor-disabled);
1784
1788
  --buttonKeybindingHint-danger-borderColor-rest: var(--buttonKeybindingHint-default-borderColor-rest);
1785
1789
  --buttonKeybindingHint-danger-fgColor-disabled: var(--buttonKeybindingHint-default-fgColor-disabled);
1786
- --shadow-floating-large: 0px 0px 0px 1px #3d444d, 0px 24px 48px 0px #010409;
1787
- --shadow-floating-medium: 0px 0px 0px 1px #3d444d, 0px 8px 16px -4px #01040966, 0px 4px 32px -4px #01040966, 0px 24px 48px -12px #01040966, 0px 48px 96px -24px #01040966;
1788
- --shadow-floating-small: 0px 0px 0px 1px #3d444d, 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966;
1789
- --shadow-floating-xlarge: 0px 0px 0px 1px #3d444d, 0px 32px 64px 0px #010409;
1790
+ --shadow-floating-large: 0px 0px 0px 1px #3d444d, 0px 24px 48px 0px #010409; /** Large floating shadow for modals and dialogs */
1791
+ --shadow-floating-medium: 0px 0px 0px 1px #3d444d, 0px 8px 16px -4px #01040966, 0px 4px 32px -4px #01040966, 0px 24px 48px -12px #01040966, 0px 48px 96px -24px #01040966; /** Medium floating shadow for popovers and action menus */
1792
+ --shadow-floating-small: 0px 0px 0px 1px #3d444d, 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966; /** Small floating shadow for dropdowns, tooltips, and small overlays */
1793
+ --shadow-floating-xlarge: 0px 0px 0px 1px #3d444d, 0px 32px 64px 0px #010409; /** Extra large floating shadow for full-screen overlays and sheets */
1790
1794
  --underlineNav-borderColor-hover: var(--borderColor-neutral-muted);
1791
1795
  --button-danger-borderColor-active: var(--button-danger-borderColor-hover);
1792
1796
  --button-outline-borderColor-hover: var(--button-default-borderColor-hover);