@primer/components 31.2.1-rc.f73a0f8c → 32.0.1-rc.c4c2c50a

package/lib-esm/theme-preval.js

@@ -479,6 +479,452 @@ module.exports = {
           }
         }
       },
+      "light_high_contrast": {
+        "colors": {
+          "canvasDefaultTransparent": "rgba(255,255,255,0)",
+          "marketingIcon": {
+            "primary": "#1168e3",
+            "secondary": "#368cf9"
+          },
+          "diffBlob": {
+            "addition": {
+              "numText": "#24292F",
+              "fg": "#ffffff",
+              "numBg": "#CCFFD8",
+              "lineBg": "#E6FFEC",
+              "wordBg": "#055d20"
+            },
+            "deletion": {
+              "numText": "#24292F",
+              "fg": "#ffffff",
+              "numBg": "#FFD7D5",
+              "lineBg": "#fff0ee",
+              "wordBg": "#a0111f"
+            },
+            "hunk": {
+              "numBg": "#9cd7ff"
+            },
+            "expander": {
+              "icon": "#24292F"
+            }
+          },
+          "diffstat": {
+            "deletionBorder": "rgba(1,4,9,0.8)",
+            "additionBorder": "rgba(1,4,9,0.8)",
+            "additionBg": "#117f32"
+          },
+          "searchKeyword": {
+            "hl": "#fcf7be"
+          },
+          "prettylights": {
+            "syntax": {
+              "comment": "#67707A",
+              "constant": "#023b95",
+              "entity": "#622cbc",
+              "storageModifierImport": "#24292F",
+              "entityTag": "#024c1a",
+              "keyword": "#a0111f",
+              "string": "#032563",
+              "variable": "#702c00",
+              "brackethighlighterUnmatched": "#6e011a",
+              "invalidIllegalText": "#FFFFFF",
+              "invalidIllegalBg": "#6e011a",
+              "carriageReturnText": "#FFFFFF",
+              "carriageReturnBg": "#a0111f",
+              "stringRegexp": "#024c1a",
+              "markupList": "#2e1800",
+              "markupHeading": "#023b95",
+              "markupItalic": "#24292F",
+              "markupBold": "#24292F",
+              "markupDeletedText": "#6e011a",
+              "markupDeletedBg": "#fff0ee",
+              "markupInsertedText": "#024c1a",
+              "markupInsertedBg": "#d2fedb",
+              "markupChangedText": "#702c00",
+              "markupChangedBg": "#ffc67b",
+              "markupIgnoredText": "#E7ECF0",
+              "markupIgnoredBg": "#023b95",
+              "metaDiffRange": "#622cbc",
+              "brackethighlighterAngle": "#4F5760",
+              "sublimelinterGutterMark": "#88929D",
+              "constantOtherReferenceLink": "#032563"
+            }
+          },
+          "codemirror": {
+            "text": "#24292F",
+            "bg": "#ffffff",
+            "guttersBg": "#ffffff",
+            "guttermarkerText": "#ffffff",
+            "guttermarkerSubtleText": "#67707A",
+            "linenumberText": "#24292F",
+            "cursor": "#24292F",
+            "selectionBg": "#368cf9",
+            "activelineBg": "#E7ECF0",
+            "matchingbracketText": "#24292F",
+            "linesBg": "#ffffff",
+            "syntax": {
+              "comment": "#24292F",
+              "constant": "#023b95",
+              "entity": "#622cbc",
+              "keyword": "#a0111f",
+              "storage": "#a0111f",
+              "string": "#032563",
+              "support": "#023b95",
+              "variable": "#702c00"
+            }
+          },
+          "checks": {
+            "bg": "#24292F",
+            "textPrimary": "#FFFFFF",
+            "textSecondary": "#88929D",
+            "textLink": "#368cf9",
+            "btnIcon": "#ACB6C0",
+            "btnHoverIcon": "#FFFFFF",
+            "btnHoverBg": "rgba(255,255,255,0.125)",
+            "inputText": "#E7ECF0",
+            "inputPlaceholderText": "#88929D",
+            "inputFocusText": "#88929D",
+            "inputBg": "#30363D",
+            "donutError": "#d5232c",
+            "donutPending": "#956400",
+            "donutSuccess": "#117f32",
+            "donutNeutral": "#ACB6C0",
+            "dropdownText": "#ACB6C0",
+            "dropdownBg": "#30363D",
+            "dropdownBorder": "#3D454E",
+            "dropdownShadow": "rgba(1,4,9,0.3)",
+            "dropdownHoverText": "#FFFFFF",
+            "dropdownHoverBg": "#3D454E",
+            "dropdownBtnHoverText": "#FFFFFF",
+            "dropdownBtnHoverBg": "#30363D",
+            "scrollbarThumbBg": "#4F5760",
+            "headerLabelText": "#CED5DC",
+            "headerLabelOpenText": "#FFFFFF",
+            "headerBorder": "#30363D",
+            "headerIcon": "#88929D",
+            "lineText": "#CED5DC",
+            "lineNumText": "rgba(136,146,157,0.75)",
+            "lineTimestampText": "#88929D",
+            "lineHoverBg": "#30363D",
+            "lineSelectedBg": "rgba(17,104,227,0.15)",
+            "lineSelectedNumText": "#368cf9",
+            "lineDtFmText": "#24292F",
+            "lineDtFmBg": "#744500",
+            "gateBg": "rgba(96,55,0,0.15)",
+            "gateText": "#CED5DC",
+            "gateWaitingText": "#ACB6C0",
+            "stepHeaderOpenBg": "#30363D",
+            "stepErrorText": "#ee5a5d",
+            "stepWarningText": "#b58407",
+            "loglineText": "#88929D",
+            "loglineNumText": "rgba(136,146,157,0.75)",
+            "loglineDebugText": "#a371f7",
+            "loglineErrorText": "#CED5DC",
+            "loglineErrorNumText": "#ee5a5d",
+            "loglineErrorBg": "rgba(134,6,29,0.15)",
+            "loglineWarningText": "#CED5DC",
+            "loglineWarningNumText": "#b58407",
+            "loglineWarningBg": "rgba(96,55,0,0.15)",
+            "loglineCommandText": "#368cf9",
+            "loglineSectionText": "#26a148",
+            "ansi": {
+              "black": "#24292F",
+              "blackBright": "#30363D",
+              "white": "#CED5DC",
+              "whiteBright": "#CED5DC",
+              "gray": "#88929D",
+              "red": "#ee5a5d",
+              "redBright": "#ff8e8a",
+              "green": "#26a148",
+              "greenBright": "#43c663",
+              "yellow": "#b58407",
+              "yellowBright": "#d5a824",
+              "blue": "#368cf9",
+              "blueBright": "#67b3fd",
+              "magenta": "#a371f7",
+              "magentaBright": "#c49bff",
+              "cyan": "#76e3ea",
+              "cyanBright": "#b3f0ff"
+            }
+          },
+          "project": {
+            "headerBg": "#24292F",
+            "sidebarBg": "#ffffff",
+            "gradientIn": "#ffffff",
+            "gradientOut": "rgba(255,255,255,0)"
+          },
+          "mktg": {
+            "btn": {
+              "bg": "#1b1f23"
+            }
+          },
+          "avatar": {
+            "bg": "#ffffff",
+            "border": "rgba(1,4,9,0.8)",
+            "stackFade": "#ACB6C0",
+            "stackFadeMore": "#CED5DC"
+          },
+          "topicTag": {
+            "border": "rgba(0,0,0,0)"
+          },
+          "selectMenu": {
+            "backdropBorder": "rgba(0,0,0,0)",
+            "tapHighlight": "rgba(172,182,192,0.5)",
+            "tapFocusBg": "#9cd7ff"
+          },
+          "header": {
+            "text": "rgba(255,255,255,0.7)",
+            "bg": "#24292F",
+            "logo": "#ffffff"
+          },
+          "headerSearch": {
+            "bg": "#24292F",
+            "border": "#4F5760"
+          },
+          "sidenav": {
+            "selectedBg": "#ffffff"
+          },
+          "menu": {
+            "bgActive": "rgba(0,0,0,0)"
+          },
+          "input": {
+            "disabledBg": "rgba(172,182,192,0.2)"
+          },
+          "timeline": {
+            "badgeBg": "#E7ECF0"
+          },
+          "ansi": {
+            "black": "#24292F",
+            "blackBright": "#4F5760",
+            "white": "#67707A",
+            "whiteBright": "#88929D",
+            "gray": "#67707A",
+            "red": "#a0111f",
+            "redBright": "#86061d",
+            "green": "#024c1a",
+            "greenBright": "#055d20",
+            "yellow": "#3f2200",
+            "yellowBright": "#4e2c00",
+            "blue": "#0349b4",
+            "blueBright": "#1168e3",
+            "magenta": "#622cbc",
+            "magentaBright": "#844ae7",
+            "cyan": "#1b7c83",
+            "cyanBright": "#3192aa"
+          },
+          "btn": {
+            "text": "#24292F",
+            "bg": "#E7ECF0",
+            "border": "rgba(1,4,9,0.8)",
+            "hoverBg": "#CED5DC",
+            "hoverBorder": "rgba(1,4,9,0.8)",
+            "activeBg": "#ACB6C0",
+            "activeBorder": "rgba(1,4,9,0.8)",
+            "selectedBg": "#ACB6C0",
+            "focusBg": "#CED5DC",
+            "focusBorder": "rgba(1,4,9,0.8)",
+            "counterBg": "rgba(1,4,9,0.08)",
+            "primary": {
+              "text": "#ffffff",
+              "bg": "#055d20",
+              "border": "#013d14",
+              "hoverBg": "#024c1a",
+              "hoverBorder": "#013d14",
+              "selectedBg": "hsla(139,95%,13%,1)",
+              "disabledText": "rgba(255,255,255,0.8)",
+              "disabledBg": "#94d3a2",
+              "disabledBorder": "rgba(1,4,9,0.8)",
+              "focusBg": "#013d14",
+              "focusBorder": "#013d14",
+              "icon": "rgba(255,255,255,0.8)",
+              "counterBg": "rgba(255,255,255,0.2)"
+            },
+            "outline": {
+              "text": "#023b95",
+              "hoverText": "#ffffff",
+              "hoverBg": "#0349b4",
+              "hoverBorder": "#022f7a",
+              "hoverCounterBg": "rgba(255,255,255,0.2)",
+              "selectedText": "#ffffff",
+              "selectedBg": "#022f7a",
+              "selectedBorder": "#022f7a",
+              "disabledText": "rgba(3,73,180,0.5)",
+              "disabledBg": "#E7ECF0",
+              "disabledCounterBg": "rgba(3,73,180,0.05)",
+              "focusBorder": "#022f7a",
+              "counterBg": "rgba(3,73,180,0.1)"
+            },
+            "danger": {
+              "text": "#86061d",
+              "hoverText": "#ffffff",
+              "hoverBg": "#a0111f",
+              "hoverBorder": "#6e011a",
+              "hoverCounterBg": "rgba(255,255,255,0.2)",
+              "selectedText": "#ffffff",
+              "selectedBg": "#6e011a",
+              "selectedBorder": "#6e011a",
+              "disabledText": "rgba(160,17,31,0.5)",
+              "disabledBg": "#E7ECF0",
+              "disabledCounterBg": "rgba(160,17,31,0.05)",
+              "focusBorder": "#6e011a",
+              "counterBg": "rgba(160,17,31,0.1)",
+              "icon": "#86061d",
+              "hoverIcon": "#ffffff"
+            }
+          },
+          "underlinenav": {
+            "icon": "#67707A",
+            "borderHover": "rgba(172,182,192,0.2)"
+          },
+          "actionListItem": {
+            "inlineDivider": "rgba(48,54,61,0.48)",
+            "default": {
+              "hoverBg": "rgba(206,213,220,0.32)",
+              "activeBg": "rgba(206,213,220,0.48)",
+              "selectedBg": "rgba(206,213,220,0.24)"
+            },
+            "danger": {
+              "hoverBg": "rgba(255,240,238,0.64)",
+              "activeBg": "#fff0ee",
+              "hoverText": "#a0111f"
+            }
+          },
+          "fg": {
+            "default": "#24292F",
+            "muted": "#24292F",
+            "subtle": "#67707A",
+            "onEmphasis": "#ffffff"
+          },
+          "canvas": {
+            "default": "#ffffff",
+            "overlay": "#ffffff",
+            "inset": "#ffffff",
+            "subtle": "#E7ECF0"
+          },
+          "border": {
+            "default": "#30363D",
+            "muted": "#88929D",
+            "subtle": "rgba(1,4,9,0.8)"
+          },
+          "neutral": {
+            "emphasisPlus": "#24292F",
+            "emphasis": "#67707A",
+            "muted": "rgba(172,182,192,0.2)",
+            "subtle": "#E7ECF0"
+          },
+          "accent": {
+            "fg": "#0349b4",
+            "emphasis": "#0349b4",
+            "muted": "#368cf9",
+            "subtle": "#dff7ff"
+          },
+          "success": {
+            "fg": "#055d20",
+            "emphasis": "#055d20",
+            "muted": "#26a148",
+            "subtle": "#d2fedb"
+          },
+          "attention": {
+            "fg": "#744500",
+            "emphasis": "#744500",
+            "muted": "#b58407",
+            "subtle": "#fcf7be"
+          },
+          "severe": {
+            "fg": "#873800",
+            "emphasis": "#873800",
+            "muted": "#dc6d1a",
+            "subtle": "#fff2d5"
+          },
+          "danger": {
+            "fg": "#a0111f",
+            "emphasis": "#a0111f",
+            "muted": "#ee5a5d",
+            "subtle": "#fff0ee"
+          },
+          "done": {
+            "fg": "#622cbc",
+            "emphasis": "#622cbc",
+            "muted": "#a371f7",
+            "subtle": "#faf0fe"
+          },
+          "sponsors": {
+            "fg": "#971368",
+            "emphasis": "#971368",
+            "muted": "#ed4baf",
+            "subtle": "#feeff7"
+          },
+          "primer": {
+            "fg": {
+              "disabled": "#88929D"
+            },
+            "canvas": {
+              "backdrop": "rgba(1,4,9,0.5)",
+              "sticky": "rgba(255,255,255,0.95)"
+            },
+            "border": {
+              "active": "#ef5b48",
+              "contrast": "rgba(1,4,9,0.1)"
+            }
+          }
+        },
+        "shadows": {
+          "mktg": {
+            "btn": {
+              "shadow": {
+                "outline": "rgb(0 0 0 / 15%) 0 0 0 1px inset",
+                "focus": "rgb(0 0 0 / 15%) 0 0 0 4px",
+                "hover": "0 3px 2px rgba(0, 0, 0, 0.07), 0 7px 5px rgba(0, 0, 0, 0.04), 0 12px 10px rgba(0, 0, 0, 0.03), 0 22px 18px rgba(0, 0, 0, 0.03), 0 42px 33px rgba(0, 0, 0, 0.02), 0 100px 80px rgba(0, 0, 0, 0.02)",
+                "hoverMuted": "rgb(0 0 0 / 70%) 0 0 0 2px inset"
+              }
+            }
+          },
+          "avatar": {
+            "childShadow": "-2px -2px 0 rgba(255,255,255,0.8)"
+          },
+          "overlay": {
+            "shadow": "0 1px 3px rgba(1,4,9,0.12), 0 8px 24px rgba(61,69,78,0.12)"
+          },
+          "btn": {
+            "shadow": "0 1px 0 rgba(1,4,9,0.04)",
+            "insetShadow": "inset 0 1px 0 rgba(255,255,255,0.25)",
+            "focusShadow": "0 0 0 3px rgba(3,73,180,0.3)",
+            "shadowActive": "inset 0 0.15em 0.3em rgba(1,4,9,0.15)",
+            "shadowInputFocus": "0 0 0 0.2em rgba(3,73,180,0.3)",
+            "primary": {
+              "shadow": "0 1px 0 rgba(1,4,9,0.1)",
+              "insetShadow": "inset 0 1px 0 rgba(255,255,255,0.03)",
+              "selectedShadow": "inset 0 1px 0 rgba(0,35,11,0.2)",
+              "focusShadow": "0 0 0 3px rgba(1,61,20,0.4)"
+            },
+            "outline": {
+              "hoverShadow": "0 1px 0 rgba(1,4,9,0.1)",
+              "hoverInsetShadow": "inset 0 1px 0 rgba(255,255,255,0.03)",
+              "selectedShadow": "inset 0 1px 0 rgba(2,26,74,0.2)",
+              "focusShadow": "0 0 0 3px rgba(2,59,149,0.4)"
+            },
+            "danger": {
+              "hoverShadow": "0 1px 0 rgba(1,4,9,0.1)",
+              "hoverInsetShadow": "inset 0 1px 0 rgba(255,255,255,0.03)",
+              "selectedShadow": "inset 0 1px 0 rgba(67,0,17,0.2)",
+              "focusShadow": "0 0 0 3px rgba(134,6,29,0.4)"
+            }
+          },
+          "shadow": {
+            "small": "0 1px 0 rgba(1,4,9,0.04)",
+            "medium": "0 3px 6px rgba(136,146,157,0.15)",
+            "large": "0 8px 24px rgba(136,146,157,0.2)",
+            "extraLarge": "0 12px 28px rgba(136,146,157,0.3)"
+          },
+          "primer": {
+            "shadow": {
+              "highlight": "inset 0 1px 0 rgba(255,255,255,0.25)",
+              "inset": "inset 0 1px 0 rgba(206,213,220,0.2)",
+              "focus": "0 0 0 3px rgba(3,73,180,0.3)"
+            }
+          }
+        }
+      },
       "light_colorblind": {
         "colors": {
           "canvasDefaultTransparent": "rgba(255,255,255,0)",

package/lib-esm/utils/testing.d.ts

@@ -53,7 +53,7 @@ export declare function render(component: React.ReactElement, theme?: {
         xlarge: string;
     };
     space: string[];
-    colorSchemes: Record<"light" | "light_colorblind" | "dark" | "dark_dimmed" | "dark_high_contrast" | "dark_colorblind", Record<"colors" | "shadows", Partial<{
+    colorSchemes: Record<"light" | "light_high_contrast" | "light_colorblind" | "dark" | "dark_dimmed" | "dark_high_contrast" | "dark_colorblind", Record<"colors" | "shadows", Partial<{
         canvasDefaultTransparent: string;
         marketingIcon: {
             primary: string;

package/package-lock.json

@@ -1,16 +1,16 @@
 {
   "name": "@primer/components",
-  "version": "31.1.0",
+  "version": "32.0.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "@primer/components",
-      "version": "31.1.0",
+      "version": "32.0.0",
       "license": "MIT",
       "dependencies": {
         "@primer/octicons-react": "^16.1.0",
-        "@primer/primitives": "7.0.1",
+        "@primer/primitives": "7.1.1",
         "@radix-ui/react-polymorphic": "0.0.14",
         "@react-aria/ssr": "3.1.0",
         "@styled-system/css": "5.1.5",
@@ -79,7 +79,7 @@
         "eslint-plugin-jsx-a11y": "6.4.1",
         "eslint-plugin-mdx": "1.15.1",
         "eslint-plugin-prettier": "3.4.0",
-        "eslint-plugin-primer-react": "0.6.1",
+        "eslint-plugin-primer-react": "0.7.0",
         "eslint-plugin-react": "7.24.0",
         "eslint-plugin-react-hooks": "4.2.0",
         "jest": "27.0.4",
@@ -7561,9 +7561,9 @@
       }
     },
     "node_modules/@primer/primitives": {
-      "version": "7.0.1",
-      "resolved": "https://registry.npmjs.org/@primer/primitives/-/primitives-7.0.1.tgz",
-      "integrity": "sha512-Ddmi5Fuck3nsHt1+uvZiVzLwtjNrBloWq8FfQz74Qd9TXKxvHxrGxQuEJ21T3PxJMMwwEsKo7fk18oy1rTmFiA=="
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/@primer/primitives/-/primitives-7.1.1.tgz",
+      "integrity": "sha512-+Gwo89YK1OFi6oubTlah/zPxxzMNaMLy+inECAYI646KIFdzzhAsKWb3z5tSOu5Ff7no4isRV64rWfMSKLZclw=="
     },
     "node_modules/@radix-ui/react-polymorphic": {
       "version": "0.0.14",
@@ -18504,9 +18504,9 @@
       }
     },
     "node_modules/eslint-plugin-primer-react": {
-      "version": "0.6.1",
-      "resolved": "https://registry.npmjs.org/eslint-plugin-primer-react/-/eslint-plugin-primer-react-0.6.1.tgz",
-      "integrity": "sha512-sinHj+soe1LItPJZDPqK443viPGfuuT3NLk0dH8s2QMvmO0deL77aMD2/N3gP6iYg5eEOkVsp38eFkUSTaXm4w==",
+      "version": "0.7.0",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-primer-react/-/eslint-plugin-primer-react-0.7.0.tgz",
+      "integrity": "sha512-ERzMiCVPBwfG57xpSVjMuPg093GB76xtDLOiHtnYcME+40yOSKsI4lor9QnN7OjnEMj8AHgns4ixpBN8iK23nA==",
       "dev": true,
       "dependencies": {
         "@styled-system/props": "^5.1.5",
@@ -43351,9 +43351,9 @@
       "requires": {}
     },
     "@primer/primitives": {
-      "version": "7.0.1",
-      "resolved": "https://registry.npmjs.org/@primer/primitives/-/primitives-7.0.1.tgz",
-      "integrity": "sha512-Ddmi5Fuck3nsHt1+uvZiVzLwtjNrBloWq8FfQz74Qd9TXKxvHxrGxQuEJ21T3PxJMMwwEsKo7fk18oy1rTmFiA=="
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/@primer/primitives/-/primitives-7.1.1.tgz",
+      "integrity": "sha512-+Gwo89YK1OFi6oubTlah/zPxxzMNaMLy+inECAYI646KIFdzzhAsKWb3z5tSOu5Ff7no4isRV64rWfMSKLZclw=="
     },
     "@radix-ui/react-polymorphic": {
       "version": "0.0.14",
@@ -51952,9 +51952,9 @@
       }
     },
     "eslint-plugin-primer-react": {
-      "version": "0.6.1",
-      "resolved": "https://registry.npmjs.org/eslint-plugin-primer-react/-/eslint-plugin-primer-react-0.6.1.tgz",
-      "integrity": "sha512-sinHj+soe1LItPJZDPqK443viPGfuuT3NLk0dH8s2QMvmO0deL77aMD2/N3gP6iYg5eEOkVsp38eFkUSTaXm4w==",
+      "version": "0.7.0",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-primer-react/-/eslint-plugin-primer-react-0.7.0.tgz",
+      "integrity": "sha512-ERzMiCVPBwfG57xpSVjMuPg093GB76xtDLOiHtnYcME+40yOSKsI4lor9QnN7OjnEMj8AHgns4ixpBN8iK23nA==",
       "dev": true,
       "requires": {
         "@styled-system/props": "^5.1.5",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primer/components",
-  "version": "31.2.1-rc.f73a0f8c",
+  "version": "32.0.1-rc.c4c2c50a",
   "description": "Primer react components",
   "main": "lib/index.js",
   "module": "lib-esm/index.js",
@@ -45,7 +45,7 @@
   "license": "MIT",
   "dependencies": {
     "@primer/octicons-react": "^16.1.0",
-    "@primer/primitives": "7.0.1",
+    "@primer/primitives": "7.1.1",
     "@radix-ui/react-polymorphic": "0.0.14",
     "@react-aria/ssr": "3.1.0",
     "@styled-system/css": "5.1.5",
@@ -114,7 +114,7 @@
     "eslint-plugin-jsx-a11y": "6.4.1",
     "eslint-plugin-mdx": "1.15.1",
     "eslint-plugin-prettier": "3.4.0",
-    "eslint-plugin-primer-react": "0.6.1",
+    "eslint-plugin-primer-react": "0.7.0",
     "eslint-plugin-react": "7.24.0",
     "eslint-plugin-react-hooks": "4.2.0",
     "jest": "27.0.4",

package/src/ActionList2/Group.tsx

@@ -1,18 +1,51 @@
 import React from 'react'
+import {useSSRSafeId} from '@react-aria/ssr'
 import Box from '../Box'
 import {SxProp} from '../sx'
-import {Header, HeaderProps} from './Header'
-import {ListProps} from './List'
+import {ListContext, ListProps} from './List'
+import {AriaRole} from '../utils/types'
 
-export type GroupProps = HeaderProps &
-  SxProp & {
+export type GroupProps = {
+  /**
+   * Style variations. Usage is discretionary.
+   *
+   * - `"filled"` - Superimposed on a background, offset from nearby content
+   * - `"subtle"` - Relatively less offset from nearby content
+   */
+  variant?: 'subtle' | 'filled'
+  /**
+   * Primary text which names a `Group`.
+   */
+  title?: string
+  /**
+   * Secondary text which provides additional information about a `Group`.
+   */
+  auxiliaryText?: string
+  /**
+   * The ARIA role describing the function of the list inside `Group` component. `listbox` or `menu` are a common values.
+   */
+  role?: AriaRole
+} & SxProp & {
+    /**
+     * Whether multiple Items or a single Item can be selected in the Group. Overrides value on ActionList root.
+     */
     selectionVariant?: ListProps['selectionVariant'] | false
   }
 
 type ContextProps = Pick<GroupProps, 'selectionVariant'>
 export const GroupContext = React.createContext<ContextProps>({})
 
-export const Group: React.FC<GroupProps> = ({title, variant, auxiliaryText, selectionVariant, sx = {}, ...props}) => {
+export const Group: React.FC<GroupProps> = ({
+  title,
+  variant = 'subtle',
+  auxiliaryText,
+  selectionVariant,
+  role,
+  sx = {},
+  ...props
+}) => {
+  const labelId = useSSRSafeId()
+
   return (
     <Box
       as="li"
@@ -23,12 +56,48 @@ export const Group: React.FC<GroupProps> = ({title, variant, auxiliaryText, sele
       }}
       {...props}
     >
-      {title && <Header title={title} variant={variant} auxiliaryText={auxiliaryText} />}
+      {title && <Header title={title} variant={variant} auxiliaryText={auxiliaryText} labelId={labelId} />}
       <GroupContext.Provider value={{selectionVariant}}>
-        <Box as="ul" sx={{paddingInlineStart: 0}}>
+        <Box as="ul" sx={{paddingInlineStart: 0}} aria-labelledby={title ? labelId : undefined} role={role}>
           {props.children}
         </Box>
       </GroupContext.Provider>
     </Box>
   )
 }
+
+export type HeaderProps = Pick<GroupProps, 'variant' | 'title' | 'auxiliaryText'> & {
+  labelId: string
+}
+
+/**
+ * Displays the name and description of a `Group`.
+ *
+ * For visual presentation only. It's hidden from screen readers.
+ */
+const Header: React.FC<HeaderProps> = ({variant, title, auxiliaryText, labelId, ...props}) => {
+  const {variant: listVariant} = React.useContext(ListContext)
+
+  const styles = {
+    paddingY: '6px',
+    paddingX: listVariant === 'full' ? 2 : 3,
+    fontSize: 0,
+    fontWeight: 'bold',
+    color: 'fg.muted',
+    ...(variant === 'filled' && {
+      backgroundColor: 'canvas.subtle',
+      marginX: 0,
+      marginBottom: 2,
+      borderTop: '1px solid',
+      borderBottom: '1px solid',
+      borderColor: 'neutral.muted'
+    })
+  }
+
+  return (
+    <Box sx={styles} role="presentation" aria-hidden="true" {...props}>
+      <span id={labelId}>{title}</span>
+      {auxiliaryText && <span>{auxiliaryText}</span>}
+    </Box>
+  )
+}