@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
@@ -38261,6 +38261,10 @@
38261
38261
  "collection": "mode",
38262
38262
  "group": "component (internal)",
38263
38263
  "scopes": ["borderColor", "effectColor"]
38264
+ },
38265
+ "org.primer.llm": {
38266
+ "usage": ["focus-ring", "keyboard-navigation", "accessibility-indicator"],
38267
+ "rules": "Use for focus outlines on interactive elements like buttons, links, and form controls. MUST be visible for keyboard navigation accessibility. Do NOT use for decorative borders or non-interactive elements."
38264
38268
  }
38265
38269
  },
38266
38270
  "filePath": "src/tokens/functional/color/focus.json5",
@@ -38268,11 +38272,16 @@
38268
38272
  "original": {
38269
38273
  "$value": "{borderColor.accent.emphasis}",
38270
38274
  "$type": "color",
38275
+ "$description": "Outline color for focus states on interactive elements",
38271
38276
  "$extensions": {
38272
38277
  "org.primer.figma": {
38273
38278
  "collection": "mode",
38274
38279
  "group": "component (internal)",
38275
38280
  "scopes": ["borderColor", "effectColor"]
38281
+ },
38282
+ "org.primer.llm": {
38283
+ "usage": ["focus-ring", "keyboard-navigation", "accessibility-indicator"],
38284
+ "rules": "Use for focus outlines on interactive elements like buttons, links, and form controls. MUST be visible for keyboard navigation accessibility. Do NOT use for decorative borders or non-interactive elements."
38276
38285
  }
38277
38286
  },
38278
38287
  "key": "{focus.outlineColor}"
@@ -38281,7 +38290,8 @@
38281
38290
  "attributes": {},
38282
38291
  "path": ["focus", "outlineColor"],
38283
38292
  "value": "#0349b4",
38284
- "type": "color"
38293
+ "type": "color",
38294
+ "description": "Outline color for focus states on interactive elements"
38285
38295
  },
38286
38296
  "header-bgColor": {
38287
38297
  "key": "{header.bgColor}",
@@ -47334,6 +47344,10 @@
47334
47344
  "isSource": true,
47335
47345
  "$type": "color"
47336
47346
  }
47347
+ },
47348
+ "org.primer.llm": {
47349
+ "usage": ["text-selection", "highlighted-text", "selected-content"],
47350
+ "rules": "Use for native text selection (::selection) and programmatic text highlighting. Do NOT use for general emphasis or background colors on containers."
47337
47351
  }
47338
47352
  },
47339
47353
  "alpha": 0.2,
@@ -47342,6 +47356,7 @@
47342
47356
  "original": {
47343
47357
  "$value": "{bgColor.accent.emphasis}",
47344
47358
  "$type": "color",
47359
+ "$description": "Background color for text selection highlights",
47345
47360
  "$extensions": {
47346
47361
  "org.primer.figma": {
47347
47362
  "collection": "mode",
@@ -47356,6 +47371,10 @@
47356
47371
  "isSource": true,
47357
47372
  "$type": "color"
47358
47373
  }
47374
+ },
47375
+ "org.primer.llm": {
47376
+ "usage": ["text-selection", "highlighted-text", "selected-content"],
47377
+ "rules": "Use for native text selection (::selection) and programmatic text highlighting. Do NOT use for general emphasis or background colors on containers."
47359
47378
  }
47360
47379
  },
47361
47380
  "alpha": 0.2,
@@ -47365,7 +47384,8 @@
47365
47384
  "attributes": {},
47366
47385
  "path": ["selection", "bgColor"],
47367
47386
  "value": "#0349b433",
47368
- "type": "color"
47387
+ "type": "color",
47388
+ "description": "Background color for text selection highlights"
47369
47389
  },
47370
47390
  "shadow-floating-large": {
47371
47391
  "key": "{shadow.floating.large}",
@@ -38259,6 +38259,10 @@
38259
38259
  "collection": "mode",
38260
38260
  "group": "component (internal)",
38261
38261
  "scopes": ["borderColor", "effectColor"]
38262
+ },
38263
+ "org.primer.llm": {
38264
+ "usage": ["focus-ring", "keyboard-navigation", "accessibility-indicator"],
38265
+ "rules": "Use for focus outlines on interactive elements like buttons, links, and form controls. MUST be visible for keyboard navigation accessibility. Do NOT use for decorative borders or non-interactive elements."
38262
38266
  }
38263
38267
  },
38264
38268
  "filePath": "src/tokens/functional/color/focus.json5",
@@ -38266,11 +38270,16 @@
38266
38270
  "original": {
38267
38271
  "$value": "{borderColor.accent.emphasis}",
38268
38272
  "$type": "color",
38273
+ "$description": "Outline color for focus states on interactive elements",
38269
38274
  "$extensions": {
38270
38275
  "org.primer.figma": {
38271
38276
  "collection": "mode",
38272
38277
  "group": "component (internal)",
38273
38278
  "scopes": ["borderColor", "effectColor"]
38279
+ },
38280
+ "org.primer.llm": {
38281
+ "usage": ["focus-ring", "keyboard-navigation", "accessibility-indicator"],
38282
+ "rules": "Use for focus outlines on interactive elements like buttons, links, and form controls. MUST be visible for keyboard navigation accessibility. Do NOT use for decorative borders or non-interactive elements."
38274
38283
  }
38275
38284
  },
38276
38285
  "key": "{focus.outlineColor}"
@@ -38279,7 +38288,8 @@
38279
38288
  "attributes": {},
38280
38289
  "path": ["focus", "outlineColor"],
38281
38290
  "value": "#0969da",
38282
- "type": "color"
38291
+ "type": "color",
38292
+ "description": "Outline color for focus states on interactive elements"
38283
38293
  },
38284
38294
  "header-bgColor": {
38285
38295
  "key": "{header.bgColor}",
@@ -47332,6 +47342,10 @@
47332
47342
  "isSource": true,
47333
47343
  "$type": "color"
47334
47344
  }
47345
+ },
47346
+ "org.primer.llm": {
47347
+ "usage": ["text-selection", "highlighted-text", "selected-content"],
47348
+ "rules": "Use for native text selection (::selection) and programmatic text highlighting. Do NOT use for general emphasis or background colors on containers."
47335
47349
  }
47336
47350
  },
47337
47351
  "alpha": 0.2,
@@ -47340,6 +47354,7 @@
47340
47354
  "original": {
47341
47355
  "$value": "{bgColor.accent.emphasis}",
47342
47356
  "$type": "color",
47357
+ "$description": "Background color for text selection highlights",
47343
47358
  "$extensions": {
47344
47359
  "org.primer.figma": {
47345
47360
  "collection": "mode",
@@ -47354,6 +47369,10 @@
47354
47369
  "isSource": true,
47355
47370
  "$type": "color"
47356
47371
  }
47372
+ },
47373
+ "org.primer.llm": {
47374
+ "usage": ["text-selection", "highlighted-text", "selected-content"],
47375
+ "rules": "Use for native text selection (::selection) and programmatic text highlighting. Do NOT use for general emphasis or background colors on containers."
47357
47376
  }
47358
47377
  },
47359
47378
  "alpha": 0.2,
@@ -47363,7 +47382,8 @@
47363
47382
  "attributes": {},
47364
47383
  "path": ["selection", "bgColor"],
47365
47384
  "value": "#0969da33",
47366
- "type": "color"
47385
+ "type": "color",
47386
+ "description": "Background color for text selection highlights"
47367
47387
  },
47368
47388
  "shadow-floating-large": {
47369
47389
  "key": "{shadow.floating.large}",
@@ -38255,6 +38255,10 @@
38255
38255
  "collection": "mode",
38256
38256
  "group": "component (internal)",
38257
38257
  "scopes": ["borderColor", "effectColor"]
38258
+ },
38259
+ "org.primer.llm": {
38260
+ "usage": ["focus-ring", "keyboard-navigation", "accessibility-indicator"],
38261
+ "rules": "Use for focus outlines on interactive elements like buttons, links, and form controls. MUST be visible for keyboard navigation accessibility. Do NOT use for decorative borders or non-interactive elements."
38258
38262
  }
38259
38263
  },
38260
38264
  "filePath": "src/tokens/functional/color/focus.json5",
@@ -38262,11 +38266,16 @@
38262
38266
  "original": {
38263
38267
  "$value": "{borderColor.accent.emphasis}",
38264
38268
  "$type": "color",
38269
+ "$description": "Outline color for focus states on interactive elements",
38265
38270
  "$extensions": {
38266
38271
  "org.primer.figma": {
38267
38272
  "collection": "mode",
38268
38273
  "group": "component (internal)",
38269
38274
  "scopes": ["borderColor", "effectColor"]
38275
+ },
38276
+ "org.primer.llm": {
38277
+ "usage": ["focus-ring", "keyboard-navigation", "accessibility-indicator"],
38278
+ "rules": "Use for focus outlines on interactive elements like buttons, links, and form controls. MUST be visible for keyboard navigation accessibility. Do NOT use for decorative borders or non-interactive elements."
38270
38279
  }
38271
38280
  },
38272
38281
  "key": "{focus.outlineColor}"
@@ -38275,7 +38284,8 @@
38275
38284
  "attributes": {},
38276
38285
  "path": ["focus", "outlineColor"],
38277
38286
  "value": "#0349b4",
38278
- "type": "color"
38287
+ "type": "color",
38288
+ "description": "Outline color for focus states on interactive elements"
38279
38289
  },
38280
38290
  "header-bgColor": {
38281
38291
  "key": "{header.bgColor}",
@@ -47328,6 +47338,10 @@
47328
47338
  "isSource": true,
47329
47339
  "$type": "color"
47330
47340
  }
47341
+ },
47342
+ "org.primer.llm": {
47343
+ "usage": ["text-selection", "highlighted-text", "selected-content"],
47344
+ "rules": "Use for native text selection (::selection) and programmatic text highlighting. Do NOT use for general emphasis or background colors on containers."
47331
47345
  }
47332
47346
  },
47333
47347
  "alpha": 0.2,
@@ -47336,6 +47350,7 @@
47336
47350
  "original": {
47337
47351
  "$value": "{bgColor.accent.emphasis}",
47338
47352
  "$type": "color",
47353
+ "$description": "Background color for text selection highlights",
47339
47354
  "$extensions": {
47340
47355
  "org.primer.figma": {
47341
47356
  "collection": "mode",
@@ -47350,6 +47365,10 @@
47350
47365
  "isSource": true,
47351
47366
  "$type": "color"
47352
47367
  }
47368
+ },
47369
+ "org.primer.llm": {
47370
+ "usage": ["text-selection", "highlighted-text", "selected-content"],
47371
+ "rules": "Use for native text selection (::selection) and programmatic text highlighting. Do NOT use for general emphasis or background colors on containers."
47353
47372
  }
47354
47373
  },
47355
47374
  "alpha": 0.2,
@@ -47359,7 +47378,8 @@
47359
47378
  "attributes": {},
47360
47379
  "path": ["selection", "bgColor"],
47361
47380
  "value": "#0349b433",
47362
- "type": "color"
47381
+ "type": "color",
47382
+ "description": "Background color for text selection highlights"
47363
47383
  },
47364
47384
  "shadow-floating-large": {
47365
47385
  "key": "{shadow.floating.large}",
@@ -38261,6 +38261,10 @@
38261
38261
  "collection": "mode",
38262
38262
  "group": "component (internal)",
38263
38263
  "scopes": ["borderColor", "effectColor"]
38264
+ },
38265
+ "org.primer.llm": {
38266
+ "usage": ["focus-ring", "keyboard-navigation", "accessibility-indicator"],
38267
+ "rules": "Use for focus outlines on interactive elements like buttons, links, and form controls. MUST be visible for keyboard navigation accessibility. Do NOT use for decorative borders or non-interactive elements."
38264
38268
  }
38265
38269
  },
38266
38270
  "filePath": "src/tokens/functional/color/focus.json5",
@@ -38268,11 +38272,16 @@
38268
38272
  "original": {
38269
38273
  "$value": "{borderColor.accent.emphasis}",
38270
38274
  "$type": "color",
38275
+ "$description": "Outline color for focus states on interactive elements",
38271
38276
  "$extensions": {
38272
38277
  "org.primer.figma": {
38273
38278
  "collection": "mode",
38274
38279
  "group": "component (internal)",
38275
38280
  "scopes": ["borderColor", "effectColor"]
38281
+ },
38282
+ "org.primer.llm": {
38283
+ "usage": ["focus-ring", "keyboard-navigation", "accessibility-indicator"],
38284
+ "rules": "Use for focus outlines on interactive elements like buttons, links, and form controls. MUST be visible for keyboard navigation accessibility. Do NOT use for decorative borders or non-interactive elements."
38276
38285
  }
38277
38286
  },
38278
38287
  "key": "{focus.outlineColor}"
@@ -38281,7 +38290,8 @@
38281
38290
  "attributes": {},
38282
38291
  "path": ["focus", "outlineColor"],
38283
38292
  "value": "#0349b4",
38284
- "type": "color"
38293
+ "type": "color",
38294
+ "description": "Outline color for focus states on interactive elements"
38285
38295
  },
38286
38296
  "header-bgColor": {
38287
38297
  "key": "{header.bgColor}",
@@ -47334,6 +47344,10 @@
47334
47344
  "isSource": true,
47335
47345
  "$type": "color"
47336
47346
  }
47347
+ },
47348
+ "org.primer.llm": {
47349
+ "usage": ["text-selection", "highlighted-text", "selected-content"],
47350
+ "rules": "Use for native text selection (::selection) and programmatic text highlighting. Do NOT use for general emphasis or background colors on containers."
47337
47351
  }
47338
47352
  },
47339
47353
  "alpha": 0.2,
@@ -47342,6 +47356,7 @@
47342
47356
  "original": {
47343
47357
  "$value": "{bgColor.accent.emphasis}",
47344
47358
  "$type": "color",
47359
+ "$description": "Background color for text selection highlights",
47345
47360
  "$extensions": {
47346
47361
  "org.primer.figma": {
47347
47362
  "collection": "mode",
@@ -47356,6 +47371,10 @@
47356
47371
  "isSource": true,
47357
47372
  "$type": "color"
47358
47373
  }
47374
+ },
47375
+ "org.primer.llm": {
47376
+ "usage": ["text-selection", "highlighted-text", "selected-content"],
47377
+ "rules": "Use for native text selection (::selection) and programmatic text highlighting. Do NOT use for general emphasis or background colors on containers."
47359
47378
  }
47360
47379
  },
47361
47380
  "alpha": 0.2,
@@ -47365,7 +47384,8 @@
47365
47384
  "attributes": {},
47366
47385
  "path": ["selection", "bgColor"],
47367
47386
  "value": "#0349b433",
47368
- "type": "color"
47387
+ "type": "color",
47388
+ "description": "Background color for text selection highlights"
47369
47389
  },
47370
47390
  "shadow-floating-large": {
47371
47391
  "key": "{shadow.floating.large}",
@@ -38259,6 +38259,10 @@
38259
38259
  "collection": "mode",
38260
38260
  "group": "component (internal)",
38261
38261
  "scopes": ["borderColor", "effectColor"]
38262
+ },
38263
+ "org.primer.llm": {
38264
+ "usage": ["focus-ring", "keyboard-navigation", "accessibility-indicator"],
38265
+ "rules": "Use for focus outlines on interactive elements like buttons, links, and form controls. MUST be visible for keyboard navigation accessibility. Do NOT use for decorative borders or non-interactive elements."
38262
38266
  }
38263
38267
  },
38264
38268
  "filePath": "src/tokens/functional/color/focus.json5",
@@ -38266,11 +38270,16 @@
38266
38270
  "original": {
38267
38271
  "$value": "{borderColor.accent.emphasis}",
38268
38272
  "$type": "color",
38273
+ "$description": "Outline color for focus states on interactive elements",
38269
38274
  "$extensions": {
38270
38275
  "org.primer.figma": {
38271
38276
  "collection": "mode",
38272
38277
  "group": "component (internal)",
38273
38278
  "scopes": ["borderColor", "effectColor"]
38279
+ },
38280
+ "org.primer.llm": {
38281
+ "usage": ["focus-ring", "keyboard-navigation", "accessibility-indicator"],
38282
+ "rules": "Use for focus outlines on interactive elements like buttons, links, and form controls. MUST be visible for keyboard navigation accessibility. Do NOT use for decorative borders or non-interactive elements."
38274
38283
  }
38275
38284
  },
38276
38285
  "key": "{focus.outlineColor}"
@@ -38279,7 +38288,8 @@
38279
38288
  "attributes": {},
38280
38289
  "path": ["focus", "outlineColor"],
38281
38290
  "value": "#0969da",
38282
- "type": "color"
38291
+ "type": "color",
38292
+ "description": "Outline color for focus states on interactive elements"
38283
38293
  },
38284
38294
  "header-bgColor": {
38285
38295
  "key": "{header.bgColor}",
@@ -47332,6 +47342,10 @@
47332
47342
  "isSource": true,
47333
47343
  "$type": "color"
47334
47344
  }
47345
+ },
47346
+ "org.primer.llm": {
47347
+ "usage": ["text-selection", "highlighted-text", "selected-content"],
47348
+ "rules": "Use for native text selection (::selection) and programmatic text highlighting. Do NOT use for general emphasis or background colors on containers."
47335
47349
  }
47336
47350
  },
47337
47351
  "alpha": 0.2,
@@ -47340,6 +47354,7 @@
47340
47354
  "original": {
47341
47355
  "$value": "{bgColor.accent.emphasis}",
47342
47356
  "$type": "color",
47357
+ "$description": "Background color for text selection highlights",
47343
47358
  "$extensions": {
47344
47359
  "org.primer.figma": {
47345
47360
  "collection": "mode",
@@ -47354,6 +47369,10 @@
47354
47369
  "isSource": true,
47355
47370
  "$type": "color"
47356
47371
  }
47372
+ },
47373
+ "org.primer.llm": {
47374
+ "usage": ["text-selection", "highlighted-text", "selected-content"],
47375
+ "rules": "Use for native text selection (::selection) and programmatic text highlighting. Do NOT use for general emphasis or background colors on containers."
47357
47376
  }
47358
47377
  },
47359
47378
  "alpha": 0.2,
@@ -47363,7 +47382,8 @@
47363
47382
  "attributes": {},
47364
47383
  "path": ["selection", "bgColor"],
47365
47384
  "value": "#0969da33",
47366
- "type": "color"
47385
+ "type": "color",
47386
+ "description": "Background color for text selection highlights"
47367
47387
  },
47368
47388
  "shadow-floating-large": {
47369
47389
  "key": "{shadow.floating.large}",
@@ -38253,6 +38253,10 @@
38253
38253
  "collection": "mode",
38254
38254
  "group": "component (internal)",
38255
38255
  "scopes": ["borderColor", "effectColor"]
38256
+ },
38257
+ "org.primer.llm": {
38258
+ "usage": ["focus-ring", "keyboard-navigation", "accessibility-indicator"],
38259
+ "rules": "Use for focus outlines on interactive elements like buttons, links, and form controls. MUST be visible for keyboard navigation accessibility. Do NOT use for decorative borders or non-interactive elements."
38256
38260
  }
38257
38261
  },
38258
38262
  "filePath": "src/tokens/functional/color/focus.json5",
@@ -38260,11 +38264,16 @@
38260
38264
  "original": {
38261
38265
  "$value": "{borderColor.accent.emphasis}",
38262
38266
  "$type": "color",
38267
+ "$description": "Outline color for focus states on interactive elements",
38263
38268
  "$extensions": {
38264
38269
  "org.primer.figma": {
38265
38270
  "collection": "mode",
38266
38271
  "group": "component (internal)",
38267
38272
  "scopes": ["borderColor", "effectColor"]
38273
+ },
38274
+ "org.primer.llm": {
38275
+ "usage": ["focus-ring", "keyboard-navigation", "accessibility-indicator"],
38276
+ "rules": "Use for focus outlines on interactive elements like buttons, links, and form controls. MUST be visible for keyboard navigation accessibility. Do NOT use for decorative borders or non-interactive elements."
38268
38277
  }
38269
38278
  },
38270
38279
  "key": "{focus.outlineColor}"
@@ -38273,7 +38282,8 @@
38273
38282
  "attributes": {},
38274
38283
  "path": ["focus", "outlineColor"],
38275
38284
  "value": "#0969da",
38276
- "type": "color"
38285
+ "type": "color",
38286
+ "description": "Outline color for focus states on interactive elements"
38277
38287
  },
38278
38288
  "header-bgColor": {
38279
38289
  "key": "{header.bgColor}",
@@ -47326,6 +47336,10 @@
47326
47336
  "isSource": true,
47327
47337
  "$type": "color"
47328
47338
  }
47339
+ },
47340
+ "org.primer.llm": {
47341
+ "usage": ["text-selection", "highlighted-text", "selected-content"],
47342
+ "rules": "Use for native text selection (::selection) and programmatic text highlighting. Do NOT use for general emphasis or background colors on containers."
47329
47343
  }
47330
47344
  },
47331
47345
  "alpha": 0.2,
@@ -47334,6 +47348,7 @@
47334
47348
  "original": {
47335
47349
  "$value": "{bgColor.accent.emphasis}",
47336
47350
  "$type": "color",
47351
+ "$description": "Background color for text selection highlights",
47337
47352
  "$extensions": {
47338
47353
  "org.primer.figma": {
47339
47354
  "collection": "mode",
@@ -47348,6 +47363,10 @@
47348
47363
  "isSource": true,
47349
47364
  "$type": "color"
47350
47365
  }
47366
+ },
47367
+ "org.primer.llm": {
47368
+ "usage": ["text-selection", "highlighted-text", "selected-content"],
47369
+ "rules": "Use for native text selection (::selection) and programmatic text highlighting. Do NOT use for general emphasis or background colors on containers."
47351
47370
  }
47352
47371
  },
47353
47372
  "alpha": 0.2,
@@ -47357,7 +47376,8 @@
47357
47376
  "attributes": {},
47358
47377
  "path": ["selection", "bgColor"],
47359
47378
  "value": "#0969da33",
47360
- "type": "color"
47379
+ "type": "color",
47380
+ "description": "Background color for text selection highlights"
47361
47381
  },
47362
47382
  "shadow-floating-large": {
47363
47383
  "key": "{shadow.floating.large}",
@@ -908,6 +908,7 @@
908
908
  "a": 1
909
909
  },
910
910
  "type": "COLOR",
911
+ "description": "Outline color for focus states on interactive elements",
911
912
  "refId": "mode/focus/outlineColor",
912
913
  "reference": "mode/borderColor/accent-emphasis",
913
914
  "collection": "mode",
@@ -8495,6 +8496,7 @@
8495
8496
  },
8496
8497
  "type": "COLOR",
8497
8498
  "alpha": 0.7,
8499
+ "description": "Background color for text selection highlights",
8498
8500
  "refId": "mode/selection/bgColor",
8499
8501
  "reference": "mode/bgColor/accent-emphasis",
8500
8502
  "collection": "mode",
@@ -908,6 +908,7 @@
908
908
  "a": 1
909
909
  },
910
910
  "type": "COLOR",
911
+ "description": "Outline color for focus states on interactive elements",
911
912
  "refId": "mode/focus/outlineColor",
912
913
  "reference": "mode/borderColor/accent-emphasis",
913
914
  "collection": "mode",
@@ -8488,6 +8489,7 @@
8488
8489
  },
8489
8490
  "type": "COLOR",
8490
8491
  "alpha": 0.7,
8492
+ "description": "Background color for text selection highlights",
8491
8493
  "refId": "mode/selection/bgColor",
8492
8494
  "reference": "mode/bgColor/accent-emphasis",
8493
8495
  "collection": "mode",
@@ -908,6 +908,7 @@
908
908
  "a": 1
909
909
  },
910
910
  "type": "COLOR",
911
+ "description": "Outline color for focus states on interactive elements",
911
912
  "refId": "mode/focus/outlineColor",
912
913
  "reference": "mode/borderColor/accent-emphasis",
913
914
  "collection": "mode",
@@ -8484,6 +8485,7 @@
8484
8485
  },
8485
8486
  "type": "COLOR",
8486
8487
  "alpha": 0.7,
8488
+ "description": "Background color for text selection highlights",
8487
8489
  "refId": "mode/selection/bgColor",
8488
8490
  "reference": "mode/bgColor/accent-emphasis",
8489
8491
  "collection": "mode",
@@ -908,6 +908,7 @@
908
908
  "a": 1
909
909
  },
910
910
  "type": "COLOR",
911
+ "description": "Outline color for focus states on interactive elements",
911
912
  "refId": "mode/focus/outlineColor",
912
913
  "reference": "mode/borderColor/accent-emphasis",
913
914
  "collection": "mode",
@@ -8494,6 +8495,7 @@
8494
8495
  },
8495
8496
  "type": "COLOR",
8496
8497
  "alpha": 0.7,
8498
+ "description": "Background color for text selection highlights",
8497
8499
  "refId": "mode/selection/bgColor",
8498
8500
  "reference": "mode/bgColor/accent-emphasis",
8499
8501
  "collection": "mode",
@@ -908,6 +908,7 @@
908
908
  "a": 1
909
909
  },
910
910
  "type": "COLOR",
911
+ "description": "Outline color for focus states on interactive elements",
911
912
  "refId": "mode/focus/outlineColor",
912
913
  "reference": "mode/borderColor/accent-emphasis",
913
914
  "collection": "mode",
@@ -8489,6 +8490,7 @@
8489
8490
  },
8490
8491
  "type": "COLOR",
8491
8492
  "alpha": 0.7,
8493
+ "description": "Background color for text selection highlights",
8492
8494
  "refId": "mode/selection/bgColor",
8493
8495
  "reference": "mode/bgColor/accent-emphasis",
8494
8496
  "collection": "mode",
@@ -908,6 +908,7 @@
908
908
  "a": 1
909
909
  },
910
910
  "type": "COLOR",
911
+ "description": "Outline color for focus states on interactive elements",
911
912
  "refId": "mode/focus/outlineColor",
912
913
  "reference": "mode/borderColor/accent-emphasis",
913
914
  "collection": "mode",
@@ -8486,6 +8487,7 @@
8486
8487
  },
8487
8488
  "type": "COLOR",
8488
8489
  "alpha": 0.2,
8490
+ "description": "Background color for text selection highlights",
8489
8491
  "refId": "mode/selection/bgColor",
8490
8492
  "reference": "mode/bgColor/accent-emphasis",
8491
8493
  "collection": "mode",
@@ -908,6 +908,7 @@
908
908
  "a": 1
909
909
  },
910
910
  "type": "COLOR",
911
+ "description": "Outline color for focus states on interactive elements",
911
912
  "refId": "mode/focus/outlineColor",
912
913
  "reference": "mode/borderColor/accent-emphasis",
913
914
  "collection": "mode",
@@ -8479,6 +8480,7 @@
8479
8480
  },
8480
8481
  "type": "COLOR",
8481
8482
  "alpha": 0.2,
8483
+ "description": "Background color for text selection highlights",
8482
8484
  "refId": "mode/selection/bgColor",
8483
8485
  "reference": "mode/bgColor/accent-emphasis",
8484
8486
  "collection": "mode",
@@ -908,6 +908,7 @@
908
908
  "a": 1
909
909
  },
910
910
  "type": "COLOR",
911
+ "description": "Outline color for focus states on interactive elements",
911
912
  "refId": "mode/focus/outlineColor",
912
913
  "reference": "mode/borderColor/accent-emphasis",
913
914
  "collection": "mode",
@@ -8485,6 +8486,7 @@
8485
8486
  },
8486
8487
  "type": "COLOR",
8487
8488
  "alpha": 0.2,
8489
+ "description": "Background color for text selection highlights",
8488
8490
  "refId": "mode/selection/bgColor",
8489
8491
  "reference": "mode/bgColor/accent-emphasis",
8490
8492
  "collection": "mode",
@@ -908,6 +908,7 @@
908
908
  "a": 1
909
909
  },
910
910
  "type": "COLOR",
911
+ "description": "Outline color for focus states on interactive elements",
911
912
  "refId": "mode/focus/outlineColor",
912
913
  "reference": "mode/borderColor/accent-emphasis",
913
914
  "collection": "mode",
@@ -8481,6 +8482,7 @@
8481
8482
  },
8482
8483
  "type": "COLOR",
8483
8484
  "alpha": 0.2,
8485
+ "description": "Background color for text selection highlights",
8484
8486
  "refId": "mode/selection/bgColor",
8485
8487
  "reference": "mode/bgColor/accent-emphasis",
8486
8488
  "collection": "mode",
@@ -1058,7 +1058,7 @@
1058
1058
  --fgColor-onEmphasis: var(--base-color-neutral-13); /** Text color for use on emphasis backgrounds */
1059
1059
  --fgColor-onInverse: var(--base-color-neutral-0); /** Text color for use on inverse backgrounds */
1060
1060
  --fgColor-white: var(--base-color-neutral-13); /** Pure white text */
1061
- --focus-outlineColor: var(--borderColor-accent-emphasis);
1061
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
1062
1062
  --header-fgColor-default: #ffffffb3;
1063
1063
  --label-auburn-borderColor: var(--label-auburn-fgColor-rest);
1064
1064
  --label-blue-borderColor: var(--label-blue-fgColor-rest);
@@ -1090,7 +1090,7 @@
1090
1090
  --progressBar-bgColor-success: var(--bgColor-success-emphasis);
1091
1091
  --reactionButton-selected-fgColor-rest: var(--fgColor-link);
1092
1092
  --selectMenu-borderColor: var(--borderColor-default);
1093
- --selection-bgColor: #194fb1b3;
1093
+ --selection-bgColor: #194fb1b3; /** Background color for text selection highlights */
1094
1094
  --shadow-floating-legacy: 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966;
1095
1095
  --shadow-inset: inset 0px 1px 0px 0px #0104093d;
1096
1096
  --shadow-resting-medium: 0px 1px 1px 0px #01040966, 0px 3px 6px 0px #010409cc;
@@ -2254,7 +2254,7 @@
2254
2254
  --fgColor-onEmphasis: var(--base-color-neutral-13); /** Text color for use on emphasis backgrounds */
2255
2255
  --fgColor-onInverse: var(--base-color-neutral-0); /** Text color for use on inverse backgrounds */
2256
2256
  --fgColor-white: var(--base-color-neutral-13); /** Pure white text */
2257
- --focus-outlineColor: var(--borderColor-accent-emphasis);
2257
+ --focus-outlineColor: var(--borderColor-accent-emphasis); /** Outline color for focus states on interactive elements */
2258
2258
  --header-fgColor-default: #ffffffb3;
2259
2259
  --label-auburn-borderColor: var(--label-auburn-fgColor-rest);
2260
2260
  --label-blue-borderColor: var(--label-blue-fgColor-rest);
@@ -2286,7 +2286,7 @@
2286
2286
  --progressBar-bgColor-success: var(--bgColor-success-emphasis);
2287
2287
  --reactionButton-selected-fgColor-rest: var(--fgColor-link);
2288
2288
  --selectMenu-borderColor: var(--borderColor-default);
2289
- --selection-bgColor: #194fb1b3;
2289
+ --selection-bgColor: #194fb1b3; /** Background color for text selection highlights */
2290
2290
  --shadow-floating-legacy: 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966;
2291
2291
  --shadow-inset: inset 0px 1px 0px 0px #0104093d;
2292
2292
  --shadow-resting-medium: 0px 1px 1px 0px #01040966, 0px 3px 6px 0px #010409cc;