@primer/view-components 0.18.2-rc.fe99b203 → 0.19.0-rc.1ce8b774

package/static/arguments.json

@@ -3436,6 +3436,28 @@
       }
     ]
   },
+  {
+    "component": "ButtonGroup::MenuButton",
+    "status": "alpha",
+    "a11y_reviewed": false,
+    "short_name": "ButtonGroupMenuButton",
+    "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/button_group/menu_button.rb",
+    "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/button_group/menu_button/default/",
+    "parameters": [
+      {
+        "name": "menu_arguments",
+        "type": "Hash",
+        "default": "`{}`",
+        "description": "The arguments accepted by [ActionMenu](/components/alpha/actionmenu)."
+      },
+      {
+        "name": "button_arguments",
+        "type": "Hash",
+        "default": "`{}`",
+        "description": "The arguments accepted by [Button](/components/beta/button) or [IconButton](/components/beta/iconbutton), depending on the value of the `icon:` argument."
+      }
+    ]
+  },
   {
     "component": "ClipboardCopy",
     "status": "beta",

package/static/audited_at.json

@@ -75,6 +75,7 @@
   "Primer::Beta::Breadcrumbs::Item": "",
   "Primer::Beta::Button": "",
   "Primer::Beta::ButtonGroup": "",
+  "Primer::Beta::ButtonGroup::MenuButton": "",
   "Primer::Beta::ClipboardCopy": "",
   "Primer::Beta::ClipboardCopyBaseButton": "",
   "Primer::Beta::ClipboardCopyButton": "",

package/static/constants.json

@@ -848,6 +848,9 @@
     ]
   },
   "Primer::Beta::ButtonGroup": {
+    "MenuButton": "Primer::Beta::ButtonGroup::MenuButton"
+  },
+  "Primer::Beta::ButtonGroup::MenuButton": {
   },
   "Primer::Beta::ClipboardCopy": {
   },

package/static/info_arch.json

@@ -2232,7 +2232,7 @@
   {
     "fully_qualified_name": "Primer::Alpha::Banner",
     "description": "Use `Banner` to highlight important information.",
-    "accessibility_docs": null,
+    "accessibility_docs": "Depending on the scenario, some Banners may need to receive focus when they appear. This helps to maximize discoverability of the message, especially in critical scenarios. Visit the [Banner's Accessibility section](https://primer.style/components/banner#accessibility) or defer to the accessibility team to determine if your scenario requires focusing the banner.\n\nTo properly focus a banner, add a `tabindex=\"-1\"` to the Banner container, and focus that container (one way is using the [`focus()` API](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus)).\n\nFor more information about the focus management technique, visit the [Accessible Banner Prototype docs](https://github.com/github/accessibility/blob/main/docs/coaching-recommendations/toast-flash-banner/accessible-banner-prototype.md#consideration). This guidance is subject to change.",
     "is_form_component": false,
     "is_published": true,
     "requires_js": true,
@@ -11038,7 +11038,7 @@
     "slots": [
       {
         "name": "buttons",
-        "description": "List of buttons to be rendered. Add buttons via the `#with_button` and `#with_clipboard_copy_button` methods (see below).",
+        "description": "List of buttons to be rendered. Add buttons via the `#with_button`, `#with_menu_button`, and `#with_clipboard_copy_button` methods (see below).",
         "parameters": [
 
         ]
@@ -11063,6 +11063,18 @@
           }
         ]
       },
+      {
+        "name": "with_menu_button",
+        "description": "Adds a button that activates a menu when clicked.",
+        "parameters": [
+          {
+            "name": "system_arguments",
+            "type": "Hash",
+            "default": "N/A",
+            "description": "The arguments accepted by {{#link_to_component}}Primer::Beta::ButtonGroup::MenuButton{{/link_to_component}}."
+          }
+        ]
+      },
       {
         "name": "with_clipboard_copy_button",
         "description": "Adds a {{#link_to_component}}Primer::Beta::ClipboardCopyButton{{/link_to_component}}.",
@@ -11116,6 +11128,19 @@
           ]
         }
       },
+      {
+        "preview_path": "primer/beta/button_group/with_menu_button",
+        "name": "with_menu_button",
+        "snapshot": "true",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      },
       {
         "preview_path": "primer/beta/button_group/icon_buttons",
         "name": "icon_buttons",
@@ -11157,7 +11182,46 @@
       }
     ],
     "subcomponents": [
+      {
+        "fully_qualified_name": "Primer::Beta::ButtonGroup::MenuButton",
+        "description": "Renders a button in a {{#link_to_component}}Primer::Beta::ButtonGroup{{/link_to_component}} that displays an {{#link_to_component}}Primer::Alpha::ActionMenu{{/link_to_component}} when clicked.\nThis component should not be used outside of a `ButtonGroup` context.\n\nThis component yields both the button and the list to the block when rendered.\n\n```erb\n<%= render(Primer::Beta::ButtonGroup.new) do |group| %>\n  <% group.with_menu_button do |menu, button| %>\n    <% menu.with_item(label: \"Item 1\") %>\n    <% button.with_trailing_visual_icon(icon: \"triangle-down\") %>\n  <% end %>\n<% end %>\n```",
+        "accessibility_docs": null,
+        "is_form_component": false,
+        "is_published": true,
+        "requires_js": false,
+        "component": "ButtonGroup::MenuButton",
+        "status": "alpha",
+        "a11y_reviewed": false,
+        "short_name": "ButtonGroupMenuButton",
+        "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/button_group/menu_button.rb",
+        "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/button_group/menu_button/default/",
+        "parameters": [
+          {
+            "name": "menu_arguments",
+            "type": "Hash",
+            "default": "`{}`",
+            "description": "The arguments accepted by {{#link_to_component}}Primer::Alpha::ActionMenu{{/link_to_component}}."
+          },
+          {
+            "name": "button_arguments",
+            "type": "Hash",
+            "default": "`{}`",
+            "description": "The arguments accepted by {{#link_to_component}}Primer::Beta::Button{{/link_to_component}} or {{#link_to_component}}Primer::Beta::IconButton{{/link_to_component}}, depending on the value of the `icon:` argument."
+          }
+        ],
+        "slots": [
 
+        ],
+        "methods": [
+
+        ],
+        "previews": [
+
+        ],
+        "subcomponents": [
+
+        ]
+      }
     ]
   },
   {

package/static/previews.json

@@ -2236,6 +2236,19 @@
           ]
         }
       },
+      {
+        "preview_path": "primer/beta/button_group/with_menu_button",
+        "name": "with_menu_button",
+        "snapshot": "true",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      },
       {
         "preview_path": "primer/beta/button_group/icon_buttons",
         "name": "icon_buttons",

package/static/statuses.json

@@ -75,6 +75,7 @@
   "Primer::Beta::Breadcrumbs::Item": "alpha",
   "Primer::Beta::Button": "beta",
   "Primer::Beta::ButtonGroup": "beta",
+  "Primer::Beta::ButtonGroup::MenuButton": "alpha",
   "Primer::Beta::ClipboardCopy": "beta",
   "Primer::Beta::ClipboardCopyBaseButton": "beta",
   "Primer::Beta::ClipboardCopyButton": "beta",