@primer/primitives 11.4.0-rc.daff2d10 → 11.4.0-rc.e472be0d

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 (90) hide show
  1. package/dist/build/formats/markdownLlmGuidelines.d.ts +3 -1
  2. package/dist/build/formats/markdownLlmGuidelines.js +53 -10
  3. package/dist/build/platforms/llmGuidelines.js +1 -0
  4. package/dist/build/preprocessors/inheritGroupProperties.d.ts +7 -0
  5. package/dist/build/preprocessors/inheritGroupProperties.js +70 -0
  6. package/dist/build/primerStyleDictionary.js +2 -0
  7. package/dist/build/schemas/designToken.d.ts +1 -1
  8. package/dist/build/schemas/designToken.js +113 -21
  9. package/dist/build/schemas/dimensionToken.d.ts +2 -2
  10. package/dist/build/schemas/dimensionToken.js +4 -2
  11. package/dist/build/schemas/validTokenType.d.ts +5 -1
  12. package/dist/build/schemas/validTokenType.js +71 -17
  13. package/dist/css/functional/size/size-coarse.css +3 -3
  14. package/dist/css/functional/size/size-fine.css +3 -3
  15. package/dist/css/functional/themes/dark-colorblind-high-contrast.css +4 -4
  16. package/dist/css/functional/themes/dark-colorblind.css +4 -4
  17. package/dist/css/functional/themes/dark-dimmed-high-contrast.css +4 -4
  18. package/dist/css/functional/themes/dark-dimmed.css +4 -4
  19. package/dist/css/functional/themes/dark-high-contrast.css +4 -4
  20. package/dist/css/functional/themes/dark-tritanopia-high-contrast.css +4 -4
  21. package/dist/css/functional/themes/dark-tritanopia.css +4 -4
  22. package/dist/css/functional/themes/dark.css +4 -4
  23. package/dist/css/functional/themes/light-colorblind-high-contrast.css +4 -4
  24. package/dist/css/functional/themes/light-colorblind.css +4 -4
  25. package/dist/css/functional/themes/light-high-contrast.css +4 -4
  26. package/dist/css/functional/themes/light-tritanopia-high-contrast.css +4 -4
  27. package/dist/css/functional/themes/light-tritanopia.css +4 -4
  28. package/dist/css/functional/themes/light.css +4 -4
  29. package/dist/docs/functional/size/size-coarse.json +45 -3
  30. package/dist/docs/functional/size/size-fine.json +45 -3
  31. package/dist/docs/functional/themes/dark-colorblind-high-contrast.json +22 -2
  32. package/dist/docs/functional/themes/dark-colorblind.json +22 -2
  33. package/dist/docs/functional/themes/dark-dimmed-high-contrast.json +22 -2
  34. package/dist/docs/functional/themes/dark-dimmed.json +22 -2
  35. package/dist/docs/functional/themes/dark-high-contrast.json +22 -2
  36. package/dist/docs/functional/themes/dark-tritanopia-high-contrast.json +22 -2
  37. package/dist/docs/functional/themes/dark-tritanopia.json +22 -2
  38. package/dist/docs/functional/themes/dark.json +22 -2
  39. package/dist/docs/functional/themes/light-colorblind-high-contrast.json +22 -2
  40. package/dist/docs/functional/themes/light-colorblind.json +22 -2
  41. package/dist/docs/functional/themes/light-high-contrast.json +22 -2
  42. package/dist/docs/functional/themes/light-tritanopia-high-contrast.json +22 -2
  43. package/dist/docs/functional/themes/light-tritanopia.json +22 -2
  44. package/dist/docs/functional/themes/light.json +22 -2
  45. package/dist/figma/themes/dark-colorblind.json +2 -0
  46. package/dist/figma/themes/dark-dimmed.json +2 -0
  47. package/dist/figma/themes/dark-high-contrast.json +2 -0
  48. package/dist/figma/themes/dark-tritanopia.json +2 -0
  49. package/dist/figma/themes/dark.json +2 -0
  50. package/dist/figma/themes/light-colorblind.json +2 -0
  51. package/dist/figma/themes/light-high-contrast.json +2 -0
  52. package/dist/figma/themes/light-tritanopia.json +2 -0
  53. package/dist/figma/themes/light.json +2 -0
  54. package/dist/internalCss/dark-colorblind-high-contrast.css +4 -4
  55. package/dist/internalCss/dark-colorblind.css +4 -4
  56. package/dist/internalCss/dark-dimmed-high-contrast.css +4 -4
  57. package/dist/internalCss/dark-dimmed.css +4 -4
  58. package/dist/internalCss/dark-high-contrast.css +4 -4
  59. package/dist/internalCss/dark-tritanopia-high-contrast.css +4 -4
  60. package/dist/internalCss/dark-tritanopia.css +4 -4
  61. package/dist/internalCss/dark.css +4 -4
  62. package/dist/internalCss/light-colorblind-high-contrast.css +4 -4
  63. package/dist/internalCss/light-colorblind.css +4 -4
  64. package/dist/internalCss/light-high-contrast.css +4 -4
  65. package/dist/internalCss/light-tritanopia-high-contrast.css +4 -4
  66. package/dist/internalCss/light-tritanopia.css +4 -4
  67. package/dist/internalCss/light.css +4 -4
  68. package/dist/styleLint/functional/size/size-coarse.json +42 -0
  69. package/dist/styleLint/functional/size/size-fine.json +42 -0
  70. package/dist/styleLint/functional/themes/dark-colorblind-high-contrast.json +20 -0
  71. package/dist/styleLint/functional/themes/dark-colorblind.json +20 -0
  72. package/dist/styleLint/functional/themes/dark-dimmed-high-contrast.json +20 -0
  73. package/dist/styleLint/functional/themes/dark-dimmed.json +20 -0
  74. package/dist/styleLint/functional/themes/dark-high-contrast.json +20 -0
  75. package/dist/styleLint/functional/themes/dark-tritanopia-high-contrast.json +20 -0
  76. package/dist/styleLint/functional/themes/dark-tritanopia.json +20 -0
  77. package/dist/styleLint/functional/themes/dark.json +20 -0
  78. package/dist/styleLint/functional/themes/light-colorblind-high-contrast.json +20 -0
  79. package/dist/styleLint/functional/themes/light-colorblind.json +20 -0
  80. package/dist/styleLint/functional/themes/light-high-contrast.json +20 -0
  81. package/dist/styleLint/functional/themes/light-tritanopia-high-contrast.json +20 -0
  82. package/dist/styleLint/functional/themes/light-tritanopia.json +20 -0
  83. package/dist/styleLint/functional/themes/light.json +20 -0
  84. package/package.json +1 -1
  85. package/src/tokens/functional/color/data-vis.json5 +7 -0
  86. package/src/tokens/functional/color/focus.json5 +5 -0
  87. package/src/tokens/functional/color/selection.json5 +5 -0
  88. package/src/tokens/functional/size/size-coarse.json5 +24 -3
  89. package/src/tokens/functional/size/size-fine.json5 +45 -24
  90. package/token-guidelines.llm.md +109 -86
@@ -826,7 +826,7 @@
826
826
  --fgColor-open: var(--fgColor-success); /** Text color for open state indicators (issues, PRs) */
827
827
  --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
828
828
  --fgColor-white: #cdd9e5; /** Pure white text */
829
- --focus-outlineColor: var(--borderColor-accent-emphasis);
829
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
830
830
  --header-fgColor-default: #cdd9e5b3;
831
831
  --page-header-bgColor: var(--bgColor-default);
832
832
  --progressBar-bgColor-accent: var(--bgColor-accent-emphasis);
@@ -840,7 +840,7 @@
840
840
  --progressBar-track-bgColor: var(--borderColor-default);
841
841
  --reactionButton-selected-fgColor-rest: var(--fgColor-link);
842
842
  --selectMenu-borderColor: var(--borderColor-default);
843
- --selection-bgColor: #316dcab3;
843
+ --selection-bgColor: #316dcab3; /** Background color for text selection highlights */
844
844
  --shadow-floating-large: 0px 0px 0px 1px #3d444d, 0px 24px 48px 0px #010409; /** Large floating shadow for modals and dialogs */
845
845
  --shadow-floating-legacy: 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966;
846
846
  --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;
@@ -1723,7 +1723,7 @@
1723
1723
  --fgColor-open: var(--fgColor-success); /** Text color for open state indicators (issues, PRs) */
1724
1724
  --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
1725
1725
  --fgColor-white: #cdd9e5; /** Pure white text */
1726
- --focus-outlineColor: var(--borderColor-accent-emphasis);
1726
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
1727
1727
  --header-fgColor-default: #cdd9e5b3;
1728
1728
  --page-header-bgColor: var(--bgColor-default);
1729
1729
  --progressBar-bgColor-accent: var(--bgColor-accent-emphasis);
@@ -1737,7 +1737,7 @@
1737
1737
  --progressBar-track-bgColor: var(--borderColor-default);
1738
1738
  --reactionButton-selected-fgColor-rest: var(--fgColor-link);
1739
1739
  --selectMenu-borderColor: var(--borderColor-default);
1740
- --selection-bgColor: #316dcab3;
1740
+ --selection-bgColor: #316dcab3; /** Background color for text selection highlights */
1741
1741
  --shadow-floating-large: 0px 0px 0px 1px #3d444d, 0px 24px 48px 0px #010409; /** Large floating shadow for modals and dialogs */
1742
1742
  --shadow-floating-legacy: 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966;
1743
1743
  --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;
@@ -759,7 +759,7 @@
759
759
  --fgColor-onEmphasis: #ffffff; /** Text color for use on emphasis backgrounds */
760
760
  --fgColor-onInverse: #010409; /** Text color for use on inverse backgrounds */
761
761
  --fgColor-white: #ffffff; /** Pure white text */
762
- --focus-outlineColor: var(--borderColor-accent-emphasis);
762
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
763
763
  --header-fgColor-default: #ffffffb3;
764
764
  --label-auburn-borderColor: var(--label-auburn-fgColor-rest);
765
765
  --label-blue-borderColor: var(--label-blue-fgColor-rest);
@@ -791,7 +791,7 @@
791
791
  --progressBar-bgColor-success: var(--bgColor-success-emphasis);
792
792
  --reactionButton-selected-fgColor-rest: var(--fgColor-link);
793
793
  --selectMenu-borderColor: var(--borderColor-default);
794
- --selection-bgColor: #194fb1b3;
794
+ --selection-bgColor: #194fb1b3; /** Background color for text selection highlights */
795
795
  --shadow-floating-legacy: 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966;
796
796
  --shadow-inset: inset 0px 1px 0px 0px #0104093d;
797
797
  --shadow-resting-medium: 0px 1px 1px 0px #01040966, 0px 3px 6px 0px #010409cc;
@@ -1656,7 +1656,7 @@
1656
1656
  --fgColor-onEmphasis: #ffffff; /** Text color for use on emphasis backgrounds */
1657
1657
  --fgColor-onInverse: #010409; /** Text color for use on inverse backgrounds */
1658
1658
  --fgColor-white: #ffffff; /** Pure white text */
1659
- --focus-outlineColor: var(--borderColor-accent-emphasis);
1659
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
1660
1660
  --header-fgColor-default: #ffffffb3;
1661
1661
  --label-auburn-borderColor: var(--label-auburn-fgColor-rest);
1662
1662
  --label-blue-borderColor: var(--label-blue-fgColor-rest);
@@ -1688,7 +1688,7 @@
1688
1688
  --progressBar-bgColor-success: var(--bgColor-success-emphasis);
1689
1689
  --reactionButton-selected-fgColor-rest: var(--fgColor-link);
1690
1690
  --selectMenu-borderColor: var(--borderColor-default);
1691
- --selection-bgColor: #194fb1b3;
1691
+ --selection-bgColor: #194fb1b3; /** Background color for text selection highlights */
1692
1692
  --shadow-floating-legacy: 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966;
1693
1693
  --shadow-inset: inset 0px 1px 0px 0px #0104093d;
1694
1694
  --shadow-resting-medium: 0px 1px 1px 0px #01040966, 0px 3px 6px 0px #010409cc;
@@ -759,7 +759,7 @@
759
759
  --fgColor-onEmphasis: #ffffff; /** Text color for use on emphasis backgrounds */
760
760
  --fgColor-onInverse: #010409; /** Text color for use on inverse backgrounds */
761
761
  --fgColor-white: #ffffff; /** Pure white text */
762
- --focus-outlineColor: var(--borderColor-accent-emphasis);
762
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
763
763
  --header-fgColor-default: #ffffffb3;
764
764
  --label-auburn-borderColor: var(--label-auburn-fgColor-rest);
765
765
  --label-blue-borderColor: var(--label-blue-fgColor-rest);
@@ -791,7 +791,7 @@
791
791
  --progressBar-bgColor-success: var(--bgColor-success-emphasis);
792
792
  --reactionButton-selected-fgColor-rest: var(--fgColor-link);
793
793
  --selectMenu-borderColor: var(--borderColor-default);
794
- --selection-bgColor: #194fb1b3;
794
+ --selection-bgColor: #194fb1b3; /** Background color for text selection highlights */
795
795
  --shadow-floating-legacy: 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966;
796
796
  --shadow-inset: inset 0px 1px 0px 0px #0104093d;
797
797
  --shadow-resting-medium: 0px 1px 1px 0px #01040966, 0px 3px 6px 0px #010409cc;
@@ -1656,7 +1656,7 @@
1656
1656
  --fgColor-onEmphasis: #ffffff; /** Text color for use on emphasis backgrounds */
1657
1657
  --fgColor-onInverse: #010409; /** Text color for use on inverse backgrounds */
1658
1658
  --fgColor-white: #ffffff; /** Pure white text */
1659
- --focus-outlineColor: var(--borderColor-accent-emphasis);
1659
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
1660
1660
  --header-fgColor-default: #ffffffb3;
1661
1661
  --label-auburn-borderColor: var(--label-auburn-fgColor-rest);
1662
1662
  --label-blue-borderColor: var(--label-blue-fgColor-rest);
@@ -1688,7 +1688,7 @@
1688
1688
  --progressBar-bgColor-success: var(--bgColor-success-emphasis);
1689
1689
  --reactionButton-selected-fgColor-rest: var(--fgColor-link);
1690
1690
  --selectMenu-borderColor: var(--borderColor-default);
1691
- --selection-bgColor: #194fb1b3;
1691
+ --selection-bgColor: #194fb1b3; /** Background color for text selection highlights */
1692
1692
  --shadow-floating-legacy: 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966;
1693
1693
  --shadow-inset: inset 0px 1px 0px 0px #0104093d;
1694
1694
  --shadow-resting-medium: 0px 1px 1px 0px #01040966, 0px 3px 6px 0px #010409cc;
@@ -801,7 +801,7 @@
801
801
  --fgColor-onInverse: #010409; /** Text color for use on inverse backgrounds */
802
802
  --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
803
803
  --fgColor-white: #ffffff; /** Pure white text */
804
- --focus-outlineColor: var(--borderColor-accent-emphasis);
804
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
805
805
  --header-fgColor-default: #ffffffb3;
806
806
  --overlay-bgColor: #010409;
807
807
  --page-header-bgColor: var(--bgColor-default);
@@ -816,7 +816,7 @@
816
816
  --progressBar-track-bgColor: var(--borderColor-default);
817
817
  --reactionButton-selected-fgColor-rest: var(--fgColor-link);
818
818
  --selectMenu-borderColor: var(--borderColor-default);
819
- --selection-bgColor: #1f6febb3;
819
+ --selection-bgColor: #1f6febb3; /** Background color for text selection highlights */
820
820
  --shadow-floating-legacy: 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966;
821
821
  --shadow-inset: inset 0px 1px 0px 0px #0104093d;
822
822
  --shadow-resting-medium: 0px 1px 1px 0px #01040966, 0px 3px 6px 0px #010409cc;
@@ -1698,7 +1698,7 @@
1698
1698
  --fgColor-onInverse: #010409; /** Text color for use on inverse backgrounds */
1699
1699
  --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
1700
1700
  --fgColor-white: #ffffff; /** Pure white text */
1701
- --focus-outlineColor: var(--borderColor-accent-emphasis);
1701
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
1702
1702
  --header-fgColor-default: #ffffffb3;
1703
1703
  --overlay-bgColor: #010409;
1704
1704
  --page-header-bgColor: var(--bgColor-default);
@@ -1713,7 +1713,7 @@
1713
1713
  --progressBar-track-bgColor: var(--borderColor-default);
1714
1714
  --reactionButton-selected-fgColor-rest: var(--fgColor-link);
1715
1715
  --selectMenu-borderColor: var(--borderColor-default);
1716
- --selection-bgColor: #1f6febb3;
1716
+ --selection-bgColor: #1f6febb3; /** Background color for text selection highlights */
1717
1717
  --shadow-floating-legacy: 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966;
1718
1718
  --shadow-inset: inset 0px 1px 0px 0px #0104093d;
1719
1719
  --shadow-resting-medium: 0px 1px 1px 0px #01040966, 0px 3px 6px 0px #010409cc;
@@ -799,7 +799,7 @@
799
799
  --fgColor-open: var(--fgColor-success); /** Text color for open state indicators (issues, PRs) */
800
800
  --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
801
801
  --fgColor-white: #ffffff; /** Pure white text */
802
- --focus-outlineColor: var(--borderColor-accent-emphasis);
802
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
803
803
  --header-fgColor-default: #ffffffb3;
804
804
  --overlay-bgColor: #010409;
805
805
  --page-header-bgColor: var(--bgColor-default);
@@ -814,7 +814,7 @@
814
814
  --progressBar-track-bgColor: var(--borderColor-default);
815
815
  --reactionButton-selected-fgColor-rest: var(--fgColor-link);
816
816
  --selectMenu-borderColor: var(--borderColor-default);
817
- --selection-bgColor: #1f6febb3;
817
+ --selection-bgColor: #1f6febb3; /** Background color for text selection highlights */
818
818
  --shadow-floating-legacy: 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966;
819
819
  --shadow-inset: inset 0px 1px 0px 0px #0104093d;
820
820
  --shadow-resting-medium: 0px 1px 1px 0px #01040966, 0px 3px 6px 0px #010409cc;
@@ -1696,7 +1696,7 @@
1696
1696
  --fgColor-open: var(--fgColor-success); /** Text color for open state indicators (issues, PRs) */
1697
1697
  --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
1698
1698
  --fgColor-white: #ffffff; /** Pure white text */
1699
- --focus-outlineColor: var(--borderColor-accent-emphasis);
1699
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
1700
1700
  --header-fgColor-default: #ffffffb3;
1701
1701
  --overlay-bgColor: #010409;
1702
1702
  --page-header-bgColor: var(--bgColor-default);
@@ -1711,7 +1711,7 @@
1711
1711
  --progressBar-track-bgColor: var(--borderColor-default);
1712
1712
  --reactionButton-selected-fgColor-rest: var(--fgColor-link);
1713
1713
  --selectMenu-borderColor: var(--borderColor-default);
1714
- --selection-bgColor: #1f6febb3;
1714
+ --selection-bgColor: #1f6febb3; /** Background color for text selection highlights */
1715
1715
  --shadow-floating-legacy: 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966;
1716
1716
  --shadow-inset: inset 0px 1px 0px 0px #0104093d;
1717
1717
  --shadow-resting-medium: 0px 1px 1px 0px #01040966, 0px 3px 6px 0px #010409cc;
@@ -770,7 +770,7 @@
770
770
  --fgColor-onInverse: #ffffff; /** Text color for use on inverse backgrounds */
771
771
  --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
772
772
  --fgColor-white: #ffffff; /** Pure white text */
773
- --focus-outlineColor: var(--borderColor-accent-emphasis);
773
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
774
774
  --header-fgColor-default: #ffffffb3;
775
775
  --header-fgColor-logo: #ffffff;
776
776
  --label-auburn-borderColor: var(--label-auburn-fgColor-rest);
@@ -802,7 +802,7 @@
802
802
  --progressBar-bgColor-severe: var(--bgColor-severe-emphasis);
803
803
  --progressBar-bgColor-sponsors: var(--bgColor-sponsors-emphasis);
804
804
  --progressBar-bgColor-success: var(--bgColor-success-emphasis);
805
- --selection-bgColor: #0349b433;
805
+ --selection-bgColor: #0349b433; /** Background color for text selection highlights */
806
806
  --shadow-inset: inset 0px 1px 0px 0px #0104090a;
807
807
  --shadow-resting-small: 0px 1px 1px 0px #0104090f, 0px 1px 3px 0px #0104090f;
808
808
  --shadow-resting-xsmall: 0px 1px 1px 0px #0104090f;
@@ -1667,7 +1667,7 @@
1667
1667
  --fgColor-onInverse: #ffffff; /** Text color for use on inverse backgrounds */
1668
1668
  --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
1669
1669
  --fgColor-white: #ffffff; /** Pure white text */
1670
- --focus-outlineColor: var(--borderColor-accent-emphasis);
1670
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
1671
1671
  --header-fgColor-default: #ffffffb3;
1672
1672
  --header-fgColor-logo: #ffffff;
1673
1673
  --label-auburn-borderColor: var(--label-auburn-fgColor-rest);
@@ -1699,7 +1699,7 @@
1699
1699
  --progressBar-bgColor-severe: var(--bgColor-severe-emphasis);
1700
1700
  --progressBar-bgColor-sponsors: var(--bgColor-sponsors-emphasis);
1701
1701
  --progressBar-bgColor-success: var(--bgColor-success-emphasis);
1702
- --selection-bgColor: #0349b433;
1702
+ --selection-bgColor: #0349b433; /** Background color for text selection highlights */
1703
1703
  --shadow-inset: inset 0px 1px 0px 0px #0104090a;
1704
1704
  --shadow-resting-small: 0px 1px 1px 0px #0104090f, 0px 1px 3px 0px #0104090f;
1705
1705
  --shadow-resting-xsmall: 0px 1px 1px 0px #0104090f;
@@ -787,7 +787,7 @@
787
787
  --fgColor-onInverse: #ffffff; /** Text color for use on inverse backgrounds */
788
788
  --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
789
789
  --fgColor-white: #ffffff; /** Pure white text */
790
- --focus-outlineColor: var(--borderColor-accent-emphasis);
790
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
791
791
  --header-fgColor-default: #ffffffb3;
792
792
  --header-fgColor-logo: #ffffff;
793
793
  --overlay-bgColor: #ffffff;
@@ -801,7 +801,7 @@
801
801
  --progressBar-bgColor-sponsors: var(--bgColor-sponsors-emphasis);
802
802
  --progressBar-bgColor-success: var(--bgColor-success-emphasis);
803
803
  --progressBar-track-bgColor: var(--borderColor-default);
804
- --selection-bgColor: #0969da33;
804
+ --selection-bgColor: #0969da33; /** Background color for text selection highlights */
805
805
  --shadow-inset: inset 0px 1px 0px 0px #1f23280a;
806
806
  --shadow-resting-small: 0px 1px 1px 0px #1f23280f, 0px 1px 3px 0px #1f23280f;
807
807
  --shadow-resting-xsmall: 0px 1px 1px 0px #1f23280f;
@@ -1684,7 +1684,7 @@
1684
1684
  --fgColor-onInverse: #ffffff; /** Text color for use on inverse backgrounds */
1685
1685
  --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
1686
1686
  --fgColor-white: #ffffff; /** Pure white text */
1687
- --focus-outlineColor: var(--borderColor-accent-emphasis);
1687
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
1688
1688
  --header-fgColor-default: #ffffffb3;
1689
1689
  --header-fgColor-logo: #ffffff;
1690
1690
  --overlay-bgColor: #ffffff;
@@ -1698,7 +1698,7 @@
1698
1698
  --progressBar-bgColor-sponsors: var(--bgColor-sponsors-emphasis);
1699
1699
  --progressBar-bgColor-success: var(--bgColor-success-emphasis);
1700
1700
  --progressBar-track-bgColor: var(--borderColor-default);
1701
- --selection-bgColor: #0969da33;
1701
+ --selection-bgColor: #0969da33; /** Background color for text selection highlights */
1702
1702
  --shadow-inset: inset 0px 1px 0px 0px #1f23280a;
1703
1703
  --shadow-resting-small: 0px 1px 1px 0px #1f23280f, 0px 1px 3px 0px #1f23280f;
1704
1704
  --shadow-resting-xsmall: 0px 1px 1px 0px #1f23280f;
@@ -770,7 +770,7 @@
770
770
  --fgColor-open: var(--fgColor-success); /** Text color for open state indicators (issues, PRs) */
771
771
  --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
772
772
  --fgColor-white: #ffffff; /** Pure white text */
773
- --focus-outlineColor: var(--borderColor-accent-emphasis);
773
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
774
774
  --header-fgColor-default: #ffffffb3;
775
775
  --header-fgColor-logo: #ffffff;
776
776
  --label-auburn-borderColor: var(--label-auburn-fgColor-rest);
@@ -802,7 +802,7 @@
802
802
  --progressBar-bgColor-severe: var(--bgColor-severe-emphasis);
803
803
  --progressBar-bgColor-sponsors: var(--bgColor-sponsors-emphasis);
804
804
  --progressBar-bgColor-success: var(--bgColor-success-emphasis);
805
- --selection-bgColor: #0349b433;
805
+ --selection-bgColor: #0349b433; /** Background color for text selection highlights */
806
806
  --shadow-inset: inset 0px 1px 0px 0px #0104090a;
807
807
  --shadow-resting-small: 0px 1px 1px 0px #0104090f, 0px 1px 3px 0px #0104090f;
808
808
  --shadow-resting-xsmall: 0px 1px 1px 0px #0104090f;
@@ -1667,7 +1667,7 @@
1667
1667
  --fgColor-open: var(--fgColor-success); /** Text color for open state indicators (issues, PRs) */
1668
1668
  --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
1669
1669
  --fgColor-white: #ffffff; /** Pure white text */
1670
- --focus-outlineColor: var(--borderColor-accent-emphasis);
1670
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
1671
1671
  --header-fgColor-default: #ffffffb3;
1672
1672
  --header-fgColor-logo: #ffffff;
1673
1673
  --label-auburn-borderColor: var(--label-auburn-fgColor-rest);
@@ -1699,7 +1699,7 @@
1699
1699
  --progressBar-bgColor-severe: var(--bgColor-severe-emphasis);
1700
1700
  --progressBar-bgColor-sponsors: var(--bgColor-sponsors-emphasis);
1701
1701
  --progressBar-bgColor-success: var(--bgColor-success-emphasis);
1702
- --selection-bgColor: #0349b433;
1702
+ --selection-bgColor: #0349b433; /** Background color for text selection highlights */
1703
1703
  --shadow-inset: inset 0px 1px 0px 0px #0104090a;
1704
1704
  --shadow-resting-small: 0px 1px 1px 0px #0104090f, 0px 1px 3px 0px #0104090f;
1705
1705
  --shadow-resting-xsmall: 0px 1px 1px 0px #0104090f;
@@ -770,7 +770,7 @@
770
770
  --fgColor-onInverse: #ffffff; /** Text color for use on inverse backgrounds */
771
771
  --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
772
772
  --fgColor-white: #ffffff; /** Pure white text */
773
- --focus-outlineColor: var(--borderColor-accent-emphasis);
773
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
774
774
  --header-fgColor-default: #ffffffb3;
775
775
  --header-fgColor-logo: #ffffff;
776
776
  --label-auburn-borderColor: var(--label-auburn-fgColor-rest);
@@ -802,7 +802,7 @@
802
802
  --progressBar-bgColor-severe: var(--bgColor-severe-emphasis);
803
803
  --progressBar-bgColor-sponsors: var(--bgColor-sponsors-emphasis);
804
804
  --progressBar-bgColor-success: var(--bgColor-success-emphasis);
805
- --selection-bgColor: #0349b433;
805
+ --selection-bgColor: #0349b433; /** Background color for text selection highlights */
806
806
  --shadow-inset: inset 0px 1px 0px 0px #0104090a;
807
807
  --shadow-resting-small: 0px 1px 1px 0px #0104090f, 0px 1px 3px 0px #0104090f;
808
808
  --shadow-resting-xsmall: 0px 1px 1px 0px #0104090f;
@@ -1667,7 +1667,7 @@
1667
1667
  --fgColor-onInverse: #ffffff; /** Text color for use on inverse backgrounds */
1668
1668
  --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
1669
1669
  --fgColor-white: #ffffff; /** Pure white text */
1670
- --focus-outlineColor: var(--borderColor-accent-emphasis);
1670
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
1671
1671
  --header-fgColor-default: #ffffffb3;
1672
1672
  --header-fgColor-logo: #ffffff;
1673
1673
  --label-auburn-borderColor: var(--label-auburn-fgColor-rest);
@@ -1699,7 +1699,7 @@
1699
1699
  --progressBar-bgColor-severe: var(--bgColor-severe-emphasis);
1700
1700
  --progressBar-bgColor-sponsors: var(--bgColor-sponsors-emphasis);
1701
1701
  --progressBar-bgColor-success: var(--bgColor-success-emphasis);
1702
- --selection-bgColor: #0349b433;
1702
+ --selection-bgColor: #0349b433; /** Background color for text selection highlights */
1703
1703
  --shadow-inset: inset 0px 1px 0px 0px #0104090a;
1704
1704
  --shadow-resting-small: 0px 1px 1px 0px #0104090f, 0px 1px 3px 0px #0104090f;
1705
1705
  --shadow-resting-xsmall: 0px 1px 1px 0px #0104090f;
@@ -788,7 +788,7 @@
788
788
  --fgColor-onInverse: #ffffff; /** Text color for use on inverse backgrounds */
789
789
  --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
790
790
  --fgColor-white: #ffffff; /** Pure white text */
791
- --focus-outlineColor: var(--borderColor-accent-emphasis);
791
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
792
792
  --header-fgColor-default: #ffffffb3;
793
793
  --header-fgColor-logo: #ffffff;
794
794
  --overlay-bgColor: #ffffff;
@@ -802,7 +802,7 @@
802
802
  --progressBar-bgColor-sponsors: var(--bgColor-sponsors-emphasis);
803
803
  --progressBar-bgColor-success: var(--bgColor-success-emphasis);
804
804
  --progressBar-track-bgColor: var(--borderColor-default);
805
- --selection-bgColor: #0969da33;
805
+ --selection-bgColor: #0969da33; /** Background color for text selection highlights */
806
806
  --shadow-inset: inset 0px 1px 0px 0px #1f23280a;
807
807
  --shadow-resting-small: 0px 1px 1px 0px #1f23280f, 0px 1px 3px 0px #1f23280f;
808
808
  --shadow-resting-xsmall: 0px 1px 1px 0px #1f23280f;
@@ -1685,7 +1685,7 @@
1685
1685
  --fgColor-onInverse: #ffffff; /** Text color for use on inverse backgrounds */
1686
1686
  --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
1687
1687
  --fgColor-white: #ffffff; /** Pure white text */
1688
- --focus-outlineColor: var(--borderColor-accent-emphasis);
1688
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
1689
1689
  --header-fgColor-default: #ffffffb3;
1690
1690
  --header-fgColor-logo: #ffffff;
1691
1691
  --overlay-bgColor: #ffffff;
@@ -1699,7 +1699,7 @@
1699
1699
  --progressBar-bgColor-sponsors: var(--bgColor-sponsors-emphasis);
1700
1700
  --progressBar-bgColor-success: var(--bgColor-success-emphasis);
1701
1701
  --progressBar-track-bgColor: var(--borderColor-default);
1702
- --selection-bgColor: #0969da33;
1702
+ --selection-bgColor: #0969da33; /** Background color for text selection highlights */
1703
1703
  --shadow-inset: inset 0px 1px 0px 0px #1f23280a;
1704
1704
  --shadow-resting-small: 0px 1px 1px 0px #1f23280f, 0px 1px 3px 0px #1f23280f;
1705
1705
  --shadow-resting-xsmall: 0px 1px 1px 0px #1f23280f;
@@ -788,7 +788,7 @@
788
788
  --fgColor-open: var(--fgColor-success); /** Text color for open state indicators (issues, PRs) */
789
789
  --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
790
790
  --fgColor-white: #ffffff; /** Pure white text */
791
- --focus-outlineColor: var(--borderColor-accent-emphasis);
791
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
792
792
  --header-fgColor-default: #ffffffb3;
793
793
  --header-fgColor-logo: #ffffff;
794
794
  --overlay-bgColor: #ffffff;
@@ -801,7 +801,7 @@
801
801
  --progressBar-bgColor-severe: var(--bgColor-severe-emphasis);
802
802
  --progressBar-bgColor-sponsors: var(--bgColor-sponsors-emphasis);
803
803
  --progressBar-track-bgColor: var(--borderColor-default);
804
- --selection-bgColor: #0969da33;
804
+ --selection-bgColor: #0969da33; /** Background color for text selection highlights */
805
805
  --shadow-inset: inset 0px 1px 0px 0px #1f23280a;
806
806
  --shadow-resting-small: 0px 1px 1px 0px #1f23280f, 0px 1px 3px 0px #1f23280f;
807
807
  --shadow-resting-xsmall: 0px 1px 1px 0px #1f23280f;
@@ -1685,7 +1685,7 @@
1685
1685
  --fgColor-open: var(--fgColor-success); /** Text color for open state indicators (issues, PRs) */
1686
1686
  --fgColor-upsell: var(--fgColor-done); /** Text color for upsell and promotional content */
1687
1687
  --fgColor-white: #ffffff; /** Pure white text */
1688
- --focus-outlineColor: var(--borderColor-accent-emphasis);
1688
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
1689
1689
  --header-fgColor-default: #ffffffb3;
1690
1690
  --header-fgColor-logo: #ffffff;
1691
1691
  --overlay-bgColor: #ffffff;
@@ -1698,7 +1698,7 @@
1698
1698
  --progressBar-bgColor-severe: var(--bgColor-severe-emphasis);
1699
1699
  --progressBar-bgColor-sponsors: var(--bgColor-sponsors-emphasis);
1700
1700
  --progressBar-track-bgColor: var(--borderColor-default);
1701
- --selection-bgColor: #0969da33;
1701
+ --selection-bgColor: #0969da33; /** Background color for text selection highlights */
1702
1702
  --shadow-inset: inset 0px 1px 0px 0px #1f23280a;
1703
1703
  --shadow-resting-small: 0px 1px 1px 0px #1f23280f, 0px 1px 3px 0px #1f23280f;
1704
1704
  --shadow-resting-xsmall: 0px 1px 1px 0px #1f23280f;
@@ -1,47 +1,89 @@
1
1
  {
2
2
  "control-minTarget-auto": {
3
3
  "key": "{control.minTarget.auto}",
4
+ "$extensions": {
5
+ "org.primer.llm": {
6
+ "usage": ["touch-target", "mobile-button", "tap-area"],
7
+ "rules": "Use as minimum size for interactive elements on touch devices. Ensures WCAG 2.5.5 compliance (44x44px minimum). Do NOT use for fine pointer (mouse) contexts."
8
+ }
9
+ },
4
10
  "filePath": "src/tokens/functional/size/size-coarse.json5",
5
11
  "isSource": true,
6
12
  "original": {
7
13
  "$value": "{base.size.44}",
8
14
  "$type": "dimension",
15
+ "$description": "Minimum touch target size for coarse pointer devices (touch screens)",
16
+ "$extensions": {
17
+ "org.primer.llm": {
18
+ "usage": ["touch-target", "mobile-button", "tap-area"],
19
+ "rules": "Use as minimum size for interactive elements on touch devices. Ensures WCAG 2.5.5 compliance (44x44px minimum). Do NOT use for fine pointer (mouse) contexts."
20
+ }
21
+ },
9
22
  "key": "{control.minTarget.auto}"
10
23
  },
11
24
  "name": "control-minTarget-auto",
12
25
  "attributes": {},
13
26
  "path": ["control", "minTarget", "auto"],
14
27
  "value": "2.75rem",
15
- "type": "dimension"
28
+ "type": "dimension",
29
+ "description": "Minimum touch target size for coarse pointer devices (touch screens)"
16
30
  },
17
31
  "controlStack-medium-gap-auto": {
18
32
  "key": "{controlStack.medium.gap.auto}",
33
+ "$extensions": {
34
+ "org.primer.llm": {
35
+ "usage": ["touch-control-spacing", "mobile-form-gap", "stacked-buttons"],
36
+ "rules": "Use for spacing between interactive controls on touch devices in standard layouts. Do NOT use for desktop/mouse interfaces."
37
+ }
38
+ },
19
39
  "filePath": "src/tokens/functional/size/size-coarse.json5",
20
40
  "isSource": true,
21
41
  "original": {
22
42
  "$value": "{base.size.12}",
23
43
  "$type": "dimension",
44
+ "$description": "Gap between stacked controls in medium density layouts for touch devices",
45
+ "$extensions": {
46
+ "org.primer.llm": {
47
+ "usage": ["touch-control-spacing", "mobile-form-gap", "stacked-buttons"],
48
+ "rules": "Use for spacing between interactive controls on touch devices in standard layouts. Do NOT use for desktop/mouse interfaces."
49
+ }
50
+ },
24
51
  "key": "{controlStack.medium.gap.auto}"
25
52
  },
26
53
  "name": "controlStack-medium-gap-auto",
27
54
  "attributes": {},
28
55
  "path": ["controlStack", "medium", "gap", "auto"],
29
56
  "value": "0.75rem",
30
- "type": "dimension"
57
+ "type": "dimension",
58
+ "description": "Gap between stacked controls in medium density layouts for touch devices"
31
59
  },
32
60
  "controlStack-small-gap-auto": {
33
61
  "key": "{controlStack.small.gap.auto}",
62
+ "$extensions": {
63
+ "org.primer.llm": {
64
+ "usage": ["touch-control-spacing", "mobile-form-gap", "stacked-buttons"],
65
+ "rules": "Use for spacing between interactive controls on touch devices in compact layouts. Provides adequate touch separation. Do NOT use for desktop/mouse interfaces."
66
+ }
67
+ },
34
68
  "filePath": "src/tokens/functional/size/size-coarse.json5",
35
69
  "isSource": true,
36
70
  "original": {
37
71
  "$value": "{base.size.16}",
38
72
  "$type": "dimension",
73
+ "$description": "Gap between stacked controls in small density layouts for touch devices",
74
+ "$extensions": {
75
+ "org.primer.llm": {
76
+ "usage": ["touch-control-spacing", "mobile-form-gap", "stacked-buttons"],
77
+ "rules": "Use for spacing between interactive controls on touch devices in compact layouts. Provides adequate touch separation. Do NOT use for desktop/mouse interfaces."
78
+ }
79
+ },
39
80
  "key": "{controlStack.small.gap.auto}"
40
81
  },
41
82
  "name": "controlStack-small-gap-auto",
42
83
  "attributes": {},
43
84
  "path": ["controlStack", "small", "gap", "auto"],
44
85
  "value": "1rem",
45
- "type": "dimension"
86
+ "type": "dimension",
87
+ "description": "Gap between stacked controls in small density layouts for touch devices"
46
88
  }
47
89
  }
@@ -1,47 +1,89 @@
1
1
  {
2
2
  "control-minTarget-auto": {
3
3
  "key": "{control.minTarget.auto}",
4
+ "$extensions": {
5
+ "org.primer.llm": {
6
+ "usage": ["mouse-target", "desktop-button", "click-area"],
7
+ "rules": "Use as minimum size for interactive elements on desktop/mouse interfaces. Smaller than touch targets for denser layouts. Do NOT use for touch/mobile contexts."
8
+ }
9
+ },
4
10
  "filePath": "src/tokens/functional/size/size-fine.json5",
5
11
  "isSource": true,
6
12
  "original": {
7
13
  "$value": "{base.size.16}",
8
14
  "$type": "dimension",
15
+ "$description": "Minimum target size for fine pointer devices (mouse)",
16
+ "$extensions": {
17
+ "org.primer.llm": {
18
+ "usage": ["mouse-target", "desktop-button", "click-area"],
19
+ "rules": "Use as minimum size for interactive elements on desktop/mouse interfaces. Smaller than touch targets for denser layouts. Do NOT use for touch/mobile contexts."
20
+ }
21
+ },
9
22
  "key": "{control.minTarget.auto}"
10
23
  },
11
24
  "name": "control-minTarget-auto",
12
25
  "attributes": {},
13
26
  "path": ["control", "minTarget", "auto"],
14
27
  "value": "1rem",
15
- "type": "dimension"
28
+ "type": "dimension",
29
+ "description": "Minimum target size for fine pointer devices (mouse)"
16
30
  },
17
31
  "controlStack-medium-gap-auto": {
18
32
  "key": "{controlStack.medium.gap.auto}",
33
+ "$extensions": {
34
+ "org.primer.llm": {
35
+ "usage": ["desktop-control-spacing", "form-gap", "stacked-buttons"],
36
+ "rules": "Use for spacing between interactive controls on desktop in standard layouts. Do NOT use for mobile/touch interfaces."
37
+ }
38
+ },
19
39
  "filePath": "src/tokens/functional/size/size-fine.json5",
20
40
  "isSource": true,
21
41
  "original": {
22
42
  "$value": "{base.size.8}",
23
43
  "$type": "dimension",
44
+ "$description": "Gap between stacked controls in medium density layouts for mouse interfaces",
45
+ "$extensions": {
46
+ "org.primer.llm": {
47
+ "usage": ["desktop-control-spacing", "form-gap", "stacked-buttons"],
48
+ "rules": "Use for spacing between interactive controls on desktop in standard layouts. Do NOT use for mobile/touch interfaces."
49
+ }
50
+ },
24
51
  "key": "{controlStack.medium.gap.auto}"
25
52
  },
26
53
  "name": "controlStack-medium-gap-auto",
27
54
  "attributes": {},
28
55
  "path": ["controlStack", "medium", "gap", "auto"],
29
56
  "value": "0.5rem",
30
- "type": "dimension"
57
+ "type": "dimension",
58
+ "description": "Gap between stacked controls in medium density layouts for mouse interfaces"
31
59
  },
32
60
  "controlStack-small-gap-auto": {
33
61
  "key": "{controlStack.small.gap.auto}",
62
+ "$extensions": {
63
+ "org.primer.llm": {
64
+ "usage": ["desktop-control-spacing", "form-gap", "stacked-buttons"],
65
+ "rules": "Use for spacing between interactive controls on desktop in compact layouts. Tighter spacing than touch devices. Do NOT use for mobile/touch interfaces."
66
+ }
67
+ },
34
68
  "filePath": "src/tokens/functional/size/size-fine.json5",
35
69
  "isSource": true,
36
70
  "original": {
37
71
  "$value": "{base.size.8}",
38
72
  "$type": "dimension",
73
+ "$description": "Gap between stacked controls in small density layouts for mouse interfaces",
74
+ "$extensions": {
75
+ "org.primer.llm": {
76
+ "usage": ["desktop-control-spacing", "form-gap", "stacked-buttons"],
77
+ "rules": "Use for spacing between interactive controls on desktop in compact layouts. Tighter spacing than touch devices. Do NOT use for mobile/touch interfaces."
78
+ }
79
+ },
39
80
  "key": "{controlStack.small.gap.auto}"
40
81
  },
41
82
  "name": "controlStack-small-gap-auto",
42
83
  "attributes": {},
43
84
  "path": ["controlStack", "small", "gap", "auto"],
44
85
  "value": "0.5rem",
45
- "type": "dimension"
86
+ "type": "dimension",
87
+ "description": "Gap between stacked controls in small density layouts for mouse interfaces"
46
88
  }
47
89
  }