@primer/view-components 0.28.0-rc.bfe86ece → 0.29.0-rc.e262bef4

package/static/info_arch.json

@@ -309,6 +309,9 @@
             "default": "N/A",
             "description": "These arguments are forwarded to {{#link_to_component}}Primer::Alpha::ActionList::Item{{/link_to_component}}, or whatever class is passed as the `component_klass` argument."
           }
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -321,6 +324,9 @@
             "default": "N/A",
             "description": "The arguments accepted by {{#link_to_component}}Primer::Alpha::ActionList::Divider{{/link_to_component}}."
           }
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -369,6 +375,9 @@
             "default": "N/A",
             "description": "These arguments are forwarded to {{#link_to_component}}Primer::Alpha::ActionList::Item{{/link_to_component}}, or whatever class is passed as the `component_klass` argument."
           }
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -376,6 +385,9 @@
         "description": "Returns the value of attribute id.",
         "parameters": [
 
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -383,6 +395,9 @@
         "description": "Returns the value of attribute select_variant.",
         "parameters": [
 
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -390,6 +405,9 @@
         "description": "Returns the value of attribute role.",
         "parameters": [
 
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -397,6 +415,9 @@
         "description": "Returns the value of attribute aria_selection_variant.",
         "parameters": [
 
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -415,6 +436,9 @@
             "default": "N/A",
             "description": "These arguments are forwarded to {{#link_to_component}}Primer::Alpha::ActionList::Item{{/link_to_component}}, or whatever class is passed as the `component_klass` argument."
           }
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -463,6 +487,9 @@
             "default": "N/A",
             "description": "These arguments are forwarded to {{#link_to_component}}Primer::Alpha::ActionList::Item{{/link_to_component}}, or whatever class is passed as the `component_klass` argument."
           }
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -470,6 +497,9 @@
         "description": "Returns the value of attribute post_list_content_block.",
         "parameters": [
 
+        ],
+        "return_types": [
+
         ]
       }
     ],
@@ -1015,6 +1045,9 @@
             "description": "Returns the value of attribute id.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           },
           {
@@ -1022,6 +1055,9 @@
             "description": "Returns the value of attribute item_id.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           },
           {
@@ -1029,6 +1065,9 @@
             "description": "Returns the value of attribute list.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           },
           {
@@ -1036,6 +1075,9 @@
             "description": "Returns the value of attribute href.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           },
           {
@@ -1043,6 +1085,9 @@
             "description": "Returns the value of attribute active.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           },
           {
@@ -1050,6 +1095,9 @@
             "description": "Returns the value of attribute disabled.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           },
           {
@@ -1057,6 +1105,9 @@
             "description": "Returns the value of attribute parent.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           },
           {
@@ -1064,6 +1115,9 @@
             "description": "Returns the value of attribute active.\nWhether or not this item is active.",
             "parameters": [
 
+            ],
+            "return_types": [
+              "Boolean"
             ]
           },
           {
@@ -1071,6 +1125,9 @@
             "description": "Returns the value of attribute disabled.\nWhether or not this item is disabled.",
             "parameters": [
 
+            ],
+            "return_types": [
+              "Boolean"
             ]
           }
         ],
@@ -1135,6 +1192,9 @@
             "description": "Returns the value of attribute title_id.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           },
           {
@@ -1142,6 +1202,9 @@
             "description": "Returns the value of attribute subtitle_id.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           }
         ],
@@ -1225,7 +1288,7 @@
   },
   {
     "fully_qualified_name": "Primer::Alpha::ActionMenu",
-    "description": "ActionMenu is used for actions, navigation, to display secondary options, or single/multi select lists. They appear when\nusers interact with buttons, actions, or other controls.\n\nThe only allowed elements for the `Item` components are: `:a`, `:button`, and `:clipboard-copy`. The default is `:button`.\n\n### Select variants\n\nWhile `ActionMenu`s default to a list of buttons that can link to other pages, copy text to the clipboard, etc, they also support\n`single` and `multiple` select variants. The single select variant allows a single item to be \"selected\" (i.e. marked \"active\")\nwhen clicked, which will cause a check mark to appear to the left of the item text. When the `multiple` select variant is chosen,\nmultiple items may be selected and check marks will appear next to each selected item.\n\nUse the `select_variant:` option to control which variant the `ActionMenu` uses. For more information, see the documentation on\nsupported arguments below.\n\n### Dynamic labels\n\nWhen using the `single` select variant, an optional label indicating the selected item can be displayed inside the menu button.\nDynamic labels can also be prefixed with custom text.\n\nPass `dynamic_label: true` to enable dynamic label behavior, and pass `dynamic_label_prefix: \"<string>\"` to set a custom prefix.\nFor more information, see the documentation on supported arguments below.\n\n### `ActionMenu`s as form inputs\n\nWhen using either the `single` or `multiple` select variants, `ActionMenu`s can be used as form inputs. They behave very\nsimilarly to how HTML `<select>` boxes behave, and play nicely with Rails' built-in form mechanisms. Pass arguments via the\n`form_arguments:` argument, including the Rails form builder object and the name of the field:\n\n```erb\n<% form_with(url: update_merge_strategy_path) do |f| %>\n  <%= render(Primer::Alpha::ActionMenu.new(form_arguments: { builder: f, name: \"merge_strategy\" })) do |menu| %>\n    <% menu.with_item(label: \"Fast forward\", data: { value: \"fast_forward\" }) %>\n    <% menu.with_item(label: \"Recursive\", data: { value: \"recursive\" }) %>\n    <% menu.with_item(label: \"Ours\", data: { value: \"ours\" }) %>\n    <% menu.with_item(label: \"Theirs\", data: { value: \"theirs\" }) %>\n  <% end %>\n<% end %>\n```\n\nThe value of the `data: { value: ... }` argument is sent to the server on submit, keyed using the name provided above\n(eg. `\"merge_strategy\"`). If no value is provided for an item, the value of that item is the item's label.  Here's the\ncorresponding `MergeStrategyController` that might be written to handle the form above:\n\n```ruby\nclass MergeStrategyController < ApplicationController\n  def update\n    puts \"You chose #{merge_strategy_params[:merge_strategy]}\"\n  end\n\n  private\n\n  def merge_strategy_params\n    params.permit(:merge_strategy)\n  end\nend\n```\n\n### `ActionMenu` items that submit forms\n\nWhereas `ActionMenu` items normally permit navigation via `<a>` tags which make HTTP `get` requests, `ActionMenu` items\nalso permit navigation via `POST` requests. To enable this behavior, include the `href:` argument as normal, but also pass\nthe `form_arguments:` argument to the appropriate item:\n\n```erb\n<%= render(Primer::Alpha::ActionMenu.new) do |menu| %>\n  <% menu.with_item(\n    label: \"Repository\",\n    href: update_repo_grouping_path,\n    form_arguments: {\n      method: :post,\n      name: \"group_by\",\n      value: \"repository\"\n    }\n  ) %>\n<% end %>\n```\n\nMake sure to specify `method: :post`, as the default is `:get`. When clicked, the list item will submit a POST request to\nthe URL passed in the `href:` argument, including a parameter named `\"group_by\"` with a value of `\"repository\"`. If no value\nis given, the name, eg. `\"group_by\"`, will be used as the value.\n\nIt is possible to include multiple fields on submit. Instead of passing the `name:` and `value:` arguments, pass an array via\nthe `inputs:` argument:\n\n```erb\n<%= render(Primer::Alpha::ActionMenu.new) do |menu| %>\n  <% menu.with_show_button { \"Group By\" } %>\n  <% menu.with_item(\n    label: \"Repository\",\n    href: update_repo_grouping_path,\n    form_arguments: {\n      method: :post,\n      inputs: [{\n        name: \"group_by\",\n        value: \"repository\"\n      }, {\n        name: \"some_other_field\",\n        value: \"some value\",\n      }],\n    }\n  ) %>\n<% end %>\n```\n\n### Form arguments\n\nThe following table summarizes the arguments allowed in the `form_arguments:` hash mentioned above.\n\n|Name             |Type          |Default|Description|\n|:----------------|:-------------|:------|:----------|\n|`method`         |`Symbol`      |`:get` |The HTTP request method to use to submit the form. One of `:get`, `:post`, `:patch`, `:put`, `:delete`, or `:head`|\n|`name`           |`String`      |`nil`  |The name of the field that will be sent to the server on submit.|\n|`value`          |`String`      |`nil`  |The value of the field that will be sent to the server on submit.|\n|`input_arguments`|`Hash`        |`{}`   |Additional key/value pairs to emit as HTML attributes on the `<input type=\"hidden\">` element.|\n|`inputs`         |`Array<Hash>` |`[]`   |An array of hashes representing HTML `<input type=\"hidden\">` elements. Must contain at least `name:` and `value:` keys. If additional key/value pairs are provided, they are emitted as HTML attributes on the `<input>` element. This argument supercedes the `name:`, `value:`, and `:input_arguments` arguments listed above.|\n\nThe elements of the `inputs:` array will be emitted as HTML `<input type=\"hidden\">` elements.\n\n### JavaScript API\n\n`ActionList`s render an `<action-list>` custom element that exposes behavior to the client. For all these methods,\n`itemId` refers to the value of the `item_id:` argument (see below) that is used to populate the `data-item-id` HTML\nattribute.\n\n#### Query methods\n\n* `getItemById(itemId: string): Element`: Returns the item's HTML `<li>` element. The return value can be passed as the `item` argument to the other methods listed below.\n* `isItemChecked(item: Element): boolean`: Returns `true` if the item is checked, `false` otherwise.\n* `isItemHidden(item: Element): boolean`: Returns `true` if the item is hidden, `false` otherwise.\n* `isItemDisabled(item: Element): boolean`: Returns `true` if the item is disabled, `false` otherwise.\n\n#### State methods\n\n* `showItem(item: Element)`: Shows the item, i.e. makes it visible.\n* `hideItem(item: Element)`: Hides the item, i.e. makes it invisible.\n* `enableItem(item: Element)`: Enables the item, i.e. makes it clickable by the mouse and keyboard.\n* `disableItem(item: Element)`: Disables the item, i.e. makes it unclickable by the mouse and keyboard.\n* `checkItem(item: Element)`: Checks the item. Only has an effect in single- and multi-select modes.\n* `uncheckItem(item: Element)`: Unchecks the item. Only has an effect in multi-select mode, since items cannot be unchecked in single-select mode.\n\n#### Events\n\nThe `<action-menu>` element fires an `itemActivated` event whenever an item is activated (eg. clicked) via the mouse or keyboard.\n\n```typescript\ndocument.querySelector(\"action-menu\").addEventListener(\"itemActivated\", (event: ItemActivatedEvent) => {\n  event.item  // Element: the <li> item that was activated\n  event.checked  // boolean: whether or not the result of the activation checked the item\n})\n```",
+    "description": "ActionMenu is used for actions, navigation, to display secondary options, or single/multi select lists. They appear when\nusers interact with buttons, actions, or other controls.\n\nThe only allowed elements for the `Item` components are: `:a`, `:button`, and `:clipboard-copy`. The default is `:button`.\n\n### Select variants\n\nWhile `ActionMenu`s default to a list of buttons that can link to other pages, copy text to the clipboard, etc, they also support\n`single` and `multiple` select variants. The single select variant allows a single item to be \"selected\" (i.e. marked \"active\")\nwhen clicked, which will cause a check mark to appear to the left of the item text. When the `multiple` select variant is chosen,\nmultiple items may be selected and check marks will appear next to each selected item.\n\nUse the `select_variant:` option to control which variant the `ActionMenu` uses. For more information, see the documentation on\nsupported arguments below.\n\n### Dynamic labels\n\nWhen using the `single` select variant, an optional label indicating the selected item can be displayed inside the menu button.\nDynamic labels can also be prefixed with custom text.\n\nPass `dynamic_label: true` to enable dynamic label behavior, and pass `dynamic_label_prefix: \"<string>\"` to set a custom prefix.\nFor more information, see the documentation on supported arguments below.\n\n### `ActionMenu`s as form inputs\n\nWhen using either the `single` or `multiple` select variants, `ActionMenu`s can be used as form inputs. They behave very\nsimilarly to how HTML `<select>` boxes behave, and play nicely with Rails' built-in form mechanisms. Pass arguments via the\n`form_arguments:` argument, including the Rails form builder object and the name of the field:\n\n```erb\n<% form_with(url: update_merge_strategy_path) do |f| %>\n  <%= render(Primer::Alpha::ActionMenu.new(form_arguments: { builder: f, name: \"merge_strategy\" })) do |menu| %>\n    <% menu.with_item(label: \"Fast forward\", data: { value: \"fast_forward\" }) %>\n    <% menu.with_item(label: \"Recursive\", data: { value: \"recursive\" }) %>\n    <% menu.with_item(label: \"Ours\", data: { value: \"ours\" }) %>\n    <% menu.with_item(label: \"Theirs\", data: { value: \"theirs\" }) %>\n  <% end %>\n<% end %>\n```\n\nThe value of the `data: { value: ... }` argument is sent to the server on submit, keyed using the name provided above\n(eg. `\"merge_strategy\"`). If no value is provided for an item, the value of that item is the item's label.  Here's the\ncorresponding `MergeStrategyController` that might be written to handle the form above:\n\n```ruby\nclass MergeStrategyController < ApplicationController\n  def update\n    puts \"You chose #{merge_strategy_params[:merge_strategy]}\"\n  end\n\n  private\n\n  def merge_strategy_params\n    params.permit(:merge_strategy)\n  end\nend\n```\n\n### `ActionMenu` items that submit forms\n\nWhereas `ActionMenu` items normally permit navigation via `<a>` tags which make HTTP `get` requests, `ActionMenu` items\nalso permit navigation via `POST` requests. To enable this behavior, include the `href:` argument as normal, but also pass\nthe `form_arguments:` argument to the appropriate item:\n\n```erb\n<%= render(Primer::Alpha::ActionMenu.new) do |menu| %>\n  <% menu.with_item(\n    label: \"Repository\",\n    href: update_repo_grouping_path,\n    form_arguments: {\n      method: :post,\n      name: \"group_by\",\n      value: \"repository\"\n    }\n  ) %>\n<% end %>\n```\n\nMake sure to specify `method: :post`, as the default is `:get`. When clicked, the list item will submit a POST request to\nthe URL passed in the `href:` argument, including a parameter named `\"group_by\"` with a value of `\"repository\"`. If no value\nis given, the name, eg. `\"group_by\"`, will be used as the value.\n\nIt is possible to include multiple fields on submit. Instead of passing the `name:` and `value:` arguments, pass an array via\nthe `inputs:` argument:\n\n```erb\n<%= render(Primer::Alpha::ActionMenu.new) do |menu| %>\n  <% menu.with_show_button { \"Group By\" } %>\n  <% menu.with_item(\n    label: \"Repository\",\n    href: update_repo_grouping_path,\n    form_arguments: {\n      method: :post,\n      inputs: [{\n        name: \"group_by\",\n        value: \"repository\"\n      }, {\n        name: \"some_other_field\",\n        value: \"some value\",\n      }],\n    }\n  ) %>\n<% end %>\n```\n\n### Form arguments\n\nThe following table summarizes the arguments allowed in the `form_arguments:` hash mentioned above.\n\n|Name             |Type          |Default|Description|\n|:----------------|:-------------|:------|:----------|\n|`method`         |`Symbol`      |`:get` |The HTTP request method to use to submit the form. One of `:get`, `:post`, `:patch`, `:put`, `:delete`, or `:head`|\n|`name`           |`String`      |`nil`  |The name of the field that will be sent to the server on submit.|\n|`value`          |`String`      |`nil`  |The value of the field that will be sent to the server on submit.|\n|`input_arguments`|`Hash`        |`{}`   |Additional key/value pairs to emit as HTML attributes on the `<input type=\"hidden\">` element.|\n|`inputs`         |`Array<Hash>` |`[]`   |An array of hashes representing HTML `<input type=\"hidden\">` elements. Must contain at least `name:` and `value:` keys. If additional key/value pairs are provided, they are emitted as HTML attributes on the `<input>` element. This argument supercedes the `name:`, `value:`, and `:input_arguments` arguments listed above.|\n\nThe elements of the `inputs:` array will be emitted as HTML `<input type=\"hidden\">` elements.\n\n### JavaScript API\n\n`ActionMenu`s render an `<action-menu>` custom element that exposes behavior to the client.\n\n#### Query methods\n\n* `getItemById(itemId: string): Element`: Returns the item's HTML `<li>` element. The return value can be passed as the `item` argument to the other methods listed below.\n* `isItemChecked(item: Element): boolean`: Returns `true` if the item is checked, `false` otherwise.\n* `isItemHidden(item: Element): boolean`: Returns `true` if the item is hidden, `false` otherwise.\n* `isItemDisabled(item: Element): boolean`: Returns `true` if the item is disabled, `false` otherwise.\n\nNOTE: Item IDs are special values provided by the user that are attached to `ActionMenu` items as the `data-item-id`\nHTML attribute. Item IDs can be provided by passing an `item_id:` attribute when adding items to the list, eg:\n\n```erb\n<%= render(Primer::Alpha::ActionMenu.new) do |menu| %>\n  <% menu.with_item(item_id: \"my-id\") %>\n<% end %>\n```\n\n#### State methods\n\n* `showItem(item: Element)`: Shows the item, i.e. makes it visible.\n* `hideItem(item: Element)`: Hides the item, i.e. makes it invisible.\n* `enableItem(item: Element)`: Enables the item, i.e. makes it clickable by the mouse and keyboard.\n* `disableItem(item: Element)`: Disables the item, i.e. makes it unclickable by the mouse and keyboard.\n* `checkItem(item: Element)`: Checks the item. Only has an effect in single- and multi-select modes.\n* `uncheckItem(item: Element)`: Unchecks the item. Only has an effect in multi-select mode, since items cannot be unchecked in single-select mode.\n\n#### Events\n\nThe `<action-menu>` element fires an `itemActivated` event whenever an item is activated (eg. clicked) via the mouse or keyboard.\n\n```typescript\ndocument.querySelector(\"action-menu\").addEventListener(\"itemActivated\", (event: CustomEvent<ItemActivatedEvent>) => {\n  event.detail.item     // Element: the <li> item that was activated\n  event.detail.checked  // boolean: whether or not the result of the activation checked the item\n})\n```",
     "accessibility_docs": "The action for the menu item needs to be on the element with `role=\"menuitem\"`. Semantics are removed for everything\nnested inside of it. When a menu item is selected, the menu will close immediately.\n\nAdditional information around the keyboard functionality and implementation can be found on the\n[WAI-ARIA Authoring Practices](https://www.w3.org/TR/wai-aria-practices-1.2/#menu).",
     "is_form_component": false,
     "is_published": true,
@@ -1342,6 +1405,9 @@
         "description": "Returns the value of attribute list.",
         "parameters": [
 
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -1349,6 +1415,9 @@
         "description": "Returns the value of attribute preload.",
         "parameters": [
 
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -1356,6 +1425,9 @@
         "description": "Returns the value of attribute preload.",
         "parameters": [
 
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -1368,6 +1440,9 @@
             "default": "N/A",
             "description": "The arguments accepted by {{#link_to_component}}Primer::Alpha::Overlay{{/link_to_component}}'s `show_button` slot."
           }
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -1380,6 +1455,9 @@
             "default": "N/A",
             "description": "The arguments accepted by {{#link_to_component}}Primer::Alpha::ActionList::Item{{/link_to_component}}."
           }
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -1392,6 +1470,9 @@
             "default": "N/A",
             "description": "The arguments accepted by {{#link_to_component}}Primer::Alpha::ActionList{{/link_to_component}}'s `divider` slot."
           }
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -1434,6 +1515,9 @@
             "default": "N/A",
             "description": "The arguments accepted by {{#link_to_component}}Primer::Alpha::ActionList::Item{{/link_to_component}}."
           }
+        ],
+        "return_types": [
+
         ]
       }
     ],
@@ -1847,6 +1931,9 @@
             "description": "Returns the value of attribute items.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           }
         ],
@@ -2057,6 +2144,9 @@
                 "default": "N/A",
                 "description": "The arguments accepted by {{#link_to_component}}Primer::Alpha::ActionMenu::Heading{{/link_to_component}}."
               }
+            ],
+            "return_types": [
+
             ]
           }
         ],
@@ -2181,6 +2271,9 @@
             "default": "N/A",
             "description": "The component configuration."
           }
+        ],
+        "return_types": [
+          "String"
         ]
       }
     ],
@@ -3043,6 +3136,9 @@
             "default": "N/A",
             "description": "The block accepted by {{#link_to_component}}Primer::Alpha::CheckBox{{/link_to_component}}."
           }
+        ],
+        "return_types": [
+
         ]
       }
     ],
@@ -3280,6 +3376,9 @@
         "description": "The dialog's ID value.",
         "parameters": [
 
+        ],
+        "return_types": [
+
         ]
       }
     ],
@@ -3614,25 +3713,19 @@
         ]
       },
       {
-        "fully_qualified_name": "Primer::Alpha::Dialog::Footer",
-        "description": "A `Dialog::Footer` is a compositional component, used to render the\nFooter of a dialog. See {{#link_to_component}}Primer::Alpha::Dialog{{/link_to_component}}.",
+        "fully_qualified_name": "Primer::Alpha::Dialog::Body",
+        "description": "A `Dialog::Body` is a compositional component, used to render the\nBody of a dialog. See {{#link_to_component}}Primer::Alpha::Dialog{{/link_to_component}}.",
         "accessibility_docs": null,
         "is_form_component": false,
         "is_published": true,
         "requires_js": false,
-        "component": "Dialog::Footer",
+        "component": "Dialog::Body",
         "status": "alpha",
         "a11y_reviewed": true,
-        "short_name": "DialogFooter",
-        "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/dialog/footer.rb",
-        "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/dialog/footer/default/",
+        "short_name": "DialogBody",
+        "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/dialog/body.rb",
+        "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/dialog/body/default/",
         "parameters": [
-          {
-            "name": "show_divider",
-            "type": "Boolean",
-            "default": "`false`",
-            "description": "Show a divider between the footer and body."
-          },
           {
             "name": "system_arguments",
             "type": "Hash",
@@ -3654,19 +3747,25 @@
         ]
       },
       {
-        "fully_qualified_name": "Primer::Alpha::Dialog::Body",
-        "description": "A `Dialog::Body` is a compositional component, used to render the\nBody of a dialog. See {{#link_to_component}}Primer::Alpha::Dialog{{/link_to_component}}.",
+        "fully_qualified_name": "Primer::Alpha::Dialog::Footer",
+        "description": "A `Dialog::Footer` is a compositional component, used to render the\nFooter of a dialog. See {{#link_to_component}}Primer::Alpha::Dialog{{/link_to_component}}.",
         "accessibility_docs": null,
         "is_form_component": false,
         "is_published": true,
         "requires_js": false,
-        "component": "Dialog::Body",
+        "component": "Dialog::Footer",
         "status": "alpha",
         "a11y_reviewed": true,
-        "short_name": "DialogBody",
-        "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/dialog/body.rb",
-        "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/dialog/body/default/",
+        "short_name": "DialogFooter",
+        "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/dialog/footer.rb",
+        "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/dialog/footer/default/",
         "parameters": [
+          {
+            "name": "show_divider",
+            "type": "Boolean",
+            "default": "`false`",
+            "description": "Show a divider between the footer and body."
+          },
           {
             "name": "system_arguments",
             "type": "Hash",
@@ -5814,6 +5913,9 @@
         "description": "Returns the value of attribute selected.",
         "parameters": [
 
+        ],
+        "return_types": [
+
         ]
       }
     ],
@@ -6675,6 +6777,9 @@
             "default": "N/A",
             "description": "The block accepted by {{#link_to_component}}Primer::Alpha::RadioButton{{/link_to_component}}."
           }
+        ],
+        "return_types": [
+
         ]
       }
     ],
@@ -7093,6 +7198,9 @@
                 "default": "N/A",
                 "description": "The arguments accepted by {{#link_to_component}}Primer::Beta::Button{{/link_to_component}}'s `with_trailing_visual_label` slot."
               }
+            ],
+            "return_types": [
+
             ]
           }
         ],
@@ -7204,82 +7312,665 @@
         "description": "Default `true`. When set to `false`, prevents the model name from prefixing the field name. For example, if the field name is `my_field`, Rails will normally emit an HTML name attribute of `model[my_field]`. Setting `scope_name_to_model` to `false` will cause Rails to emit `my_field` instead."
       },
       {
-        "name": "scope_id_to_model",
-        "type": "Boolean",
-        "default": "N/A",
-        "description": "Default `true`. When set to `false`, prevents the model name from prefixing the field ID. For example, if the field name is `my_field`, Rails will normally emit an HTML ID attribute of `model_my_field`. Setting `scope_id_to_model` to `false` will cause Rails to emit `my_field` instead."
+        "name": "scope_id_to_model",
+        "type": "Boolean",
+        "default": "N/A",
+        "description": "Default `true`. When set to `false`, prevents the model name from prefixing the field ID. For example, if the field name is `my_field`, Rails will normally emit an HTML ID attribute of `model_my_field`. Setting `scope_id_to_model` to `false` will cause Rails to emit `my_field` instead."
+      },
+      {
+        "name": "required",
+        "type": "Boolean",
+        "default": "N/A",
+        "description": "Default `false`. When set to `true`, causes an asterisk (*) to appear next to the field's label indicating it is a required field. Note that this option explicitly does _not_ add a `required` HTML attribute. Doing so would enable native browser validations, which are inaccessible and inconsistent with the Primer design system."
+      },
+      {
+        "name": "aria",
+        "type": "Hash",
+        "default": "N/A",
+        "description": "Key/value pairs that represent Aria attributes and their values. Eg. `aria: { current: true }` becomes `aria-current=\"true\"`."
+      },
+      {
+        "name": "data",
+        "type": "Hash",
+        "default": "N/A",
+        "description": "Key/value pairs that represent data attributes and their values. Eg. `data: { foo: \"bar\" }` becomes `data-foo=\"bar\"`."
+      },
+      {
+        "name": "system_arguments",
+        "type": "Hash",
+        "default": "N/A",
+        "description": "A hash of attributes passed to the underlying Rails builder methods. These options may mean something special depending on the type of input, otherwise they are emitted as HTML attributes. See the [Rails documentation](https://guides.rubyonrails.org/form_helpers.html) for more information. In addition, the usual Primer utility arguments are accepted in system arguments. For example, passing `mt: 2` will add the `mt-2` class to the input. See the Primer system arguments docs for details."
+      },
+      {
+        "name": "multiple",
+        "type": "Boolean",
+        "default": "N/A",
+        "description": "If set to true, the selection will allow multiple choices."
+      },
+      {
+        "name": "include_blank",
+        "type": "Boolean, String",
+        "default": "N/A",
+        "description": "If set to true, an empty option will be created. If set to a string, the string will be used as the option's content and the value will be empty."
+      },
+      {
+        "name": "prompt",
+        "type": "String",
+        "default": "N/A",
+        "description": "Create a prompt option with blank value and the text asking user to select something."
+      }
+    ],
+    "slots": [
+
+    ],
+    "methods": [
+      {
+        "name": "option",
+        "description": "Adds an option to the list.",
+        "parameters": [
+          {
+            "name": "label",
+            "type": "String",
+            "default": "N/A",
+            "description": "The user-facing label for the option."
+          },
+          {
+            "name": "value",
+            "type": "String",
+            "default": "N/A",
+            "description": "The value sent to the server on form submission."
+          }
+        ],
+        "return_types": [
+
+        ]
+      }
+    ],
+    "previews": [
+      {
+        "preview_path": "primer/alpha/select/playground",
+        "name": "playground",
+        "snapshot": "false",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      },
+      {
+        "preview_path": "primer/alpha/select/default",
+        "name": "default",
+        "snapshot": "false",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      },
+      {
+        "preview_path": "primer/alpha/select/with_caption",
+        "name": "with_caption",
+        "snapshot": "true",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      },
+      {
+        "preview_path": "primer/alpha/select/visually_hide_label",
+        "name": "visually_hide_label",
+        "snapshot": "true",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      },
+      {
+        "preview_path": "primer/alpha/select/full_width",
+        "name": "full_width",
+        "snapshot": "true",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      },
+      {
+        "preview_path": "primer/alpha/select/not_full_width",
+        "name": "not_full_width",
+        "snapshot": "true",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      },
+      {
+        "preview_path": "primer/alpha/select/disabled",
+        "name": "disabled",
+        "snapshot": "true",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      },
+      {
+        "preview_path": "primer/alpha/select/invalid",
+        "name": "invalid",
+        "snapshot": "true",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      },
+      {
+        "preview_path": "primer/alpha/select/with_validation_message",
+        "name": "with_validation_message",
+        "snapshot": "true",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      }
+    ],
+    "subcomponents": [
+
+    ]
+  },
+  {
+    "fully_qualified_name": "Primer::Alpha::SelectPanel",
+    "description": "Select panels allow for selecting from a large number of options and can be thought of as a more capable\nversion of the traditional HTML `<select>` element.\n\nSelect panels:\n\n1. feature an input field at the top that allows an end user to filter the list of results.\n1. can render their items statically or dynamically by fetching results from the server.\n1. allow selecting a single item or multiple items.\n1. permit leading visuals like Octicons, avatars, and custom SVGs.\n1. can be used as form inputs in Rails forms.\n\n## Static list items\n\nThe Rails `SelectPanel` component allows items to be provided statically or loaded dynamically from the\nserver. Providing items statically is done using a fetch strategy of `:local` in combination with the\n`item` slot:\n\n```erb\n<%= render(Primer::Alpha::SelectPanel.new(fetch_strategy: :local))) do |panel| %>\n  <% panel.with_show_button { \"Select item\" } %>\n  <% panel.with_item(label: \"Item 1\") %>\n  <% panel.with_item(label: \"Item 2\") %>\n<% end %>\n```\n\n## Dynamic list items\n\nList items can also be fetched dynamically from the server and will require creating a Rails controller action\nto respond with the list of items in addition to rendering the `SelectPanel` instance. Render the instance as\nnormal, providing your desired [fetch strategy](#fetch-strategies):\n\n```erb\n<%= render(\n  Primer::Alpha::SelectPanel.new(\n    fetch_strategy: :remote,\n    src: search_items_path  # perhaps a Rails URL helper\n  )\n) %>\n```\n\nDefine a controller action to serve the list of items. The `SelectPanel` component passes any filter text in\nthe `q=` URL parameter.\n\n```ruby\nclass SearchItemsController < ApplicationController\n  def show\n    # NOTE: params[:q] may be nil since there is no filter string available\n    # when the panel is first opened\n    @results = SomeModel.search(params[:q] || \"\")\n  end\nend\n```\n\nResponses must be HTML fragments, eg. have a content type of `text/html+fragment`. This content type isn't\navailable by default in Rails, so you may have to register it eg. in an initializer:\n\n```ruby\nMime::Type.register(\"text/fragment+html\", :html_fragment)\n```\n\nRender a `Primer::Alpha::SelectPanel::ItemList` in the action's template, search_items/show.html_fragment.erb:\n\n```erb\n<%= render(Primer::Alpha::SelectPanel::ItemList.new) do |list| %>\n  <% @results.each do |result| %>\n    <% list.with_item(label: result.title) do |item| %>\n      <% item.with_description(result.description) %>\n    <% end %>\n  <% end %>\n<% end %>\n```\n\n### Selection consistency\n\nThe `SelectPanel` component automatically \"remembers\" which items have been selected across item fetch requests,\nmeaning the controller that renders dynamic list items does not (and should not) remember these selections or\npersist them until the user has confirmed them, either by submitting the form or otherwise indicating completion.\nThe `SelectPanel` component does not include unconfirmed selection data in requests.\n\n## Fetch strategies\n\nThe list of items can be fetched from a remote URL, or provided as a static list, configured using the\n`fetch_strategy` attribute. Fetch strategies are summarized below.\n\n1. `:remote`: a query is made to the URL in the `src` attribute every time the input field changes.\n\n2. `:eventually_local`: a query is made to the URL in the `src` attribute when the panel is first opened. The\n    results are \"remembered\" and filtered in-memory for all subsequent filter operations, i.e. when the input\n    field changes.\n\n3. `:local`: the list of items is provided statically ahead of time and filtered in-memory. No requests are made\n    to the server.\n\n## Customizing filter behavior\n\nIf the fetch strategy is `:remote`, then filtering is handled server-side. The server should render a\n`Primer::Alpha::SelectPanel::ItemList` (an alias of {{#link_to_component}}Primer::Alpha::ActionList{{/link_to_component}})\nin the response containing the filtered list of items. The component achieves remote fetching via the\n[remote-input-element](https://github.com/github/remote-input-element), which sends a request to the\nserver with the filter string in the `q=` parameter. Responses must be HTML fragments, eg. have a content\ntype of `text/html+fragment`.\n\n### Local filtering\n\nIf the fetch strategy is `:local` or `:eventually_local`, filtering is performed client-side. Filter behavior can\nbe customized in JavaScript by setting the `filterFn` attribute on the instance of `SelectPanelElement`, eg:\n\n```javascript\ndocument.querySelector(\"select-panel\").filterFn = (item: HTMLElement, query: string): boolean => {\n  // return true if the item should be displayed, false otherwise\n}\n```\n\nThe element's default filter function uses the value of the `data-filter-string` attribute, falling back to the\nelement's `innerText` property. It performs a case-insensitive substring match against the filter string.\n\n### `SelectPanel`s as form inputs\n\n`SelectPanel`s can be used as form inputs. They behave very similarly to how HTML `<select>` boxes behave, and\nplay nicely with Rails' built-in form mechanisms. Pass arguments via the `form_arguments:` argument, including\nthe Rails form builder object and the name of the field. Each list item must also have a value specified in\n`content_arguments: { data: { value: } }`.\n\n```erb\n<% form_with(model: Address.new) do |f| %>\n  <%= render(Primer::Alpha::SelectPanel.new(form_arguments: { builder: f, name: \"country\" })) do |menu| %>\n    <% countries.each do |country|\n      <% menu.with_item(label: country.name, content_arguments: { data: { value: country.code } }) %>\n    <% end %>\n  <% end %>\n<% end %>\n```\n\nThe value of the `data: { value: ... }` argument is sent to the server on submit, keyed using the name provided above\n(eg. `\"country\"`). If no value is provided for an item, the value of that item is the item's label.  Here's the\ncorresponding `AddressesController` that might be written to handle the form above:\n\n```ruby\nclass AddressesController < ApplicationController\n  def create\n    puts \"You chose #{address_params[:country]} as your country\"\n  end\n\n  private\n\n  def address_params\n    params.require(:address).permit(:country)\n  end\nend\n```\n\nIf items are provided dynamically, things become a bit more complicated. The `form_for` or `form_with` method call\nhappens in the view that renders the `SelectPanel`, which means the form builder object but isn't available in the\nview that renders the list items. In such a case, it can be useful to create an instance of the form builder maually:\n\n```erb\n<% builder = ActionView::Helpers::FormBuilder.new(\n  \"address\",  # the name of the model, used to wrap input names, eg 'address[country_code]'\n  nil,        # object (eg. the Address instance, which we can omit)\n  self,       # template\n  {}          # options\n) %>\n<%= render(Primer::Alpha::SelectPanel::ItemList.new(\n  form_arguments: { builder: builder, name: \"country\" }\n)) do |list| %>\n  <% countries.each do |country| %>\n    <% menu.with_item(label: country.name, data: { value: country.code }) %>\n  <% end %>\n<% end %>\n```\n\n### JavaScript API\n\n`SelectPanel`s render a `<select-panel>` custom element that exposes behavior to the client.\n\n#### Utility methods\n\n* `show()`: Manually open the panel. Under normal circumstances, a show button is used to show the panel, but this method exists to support unusual use-cases.\n* `hide()`: Manually hides (closes) the panel.\n\n#### Query methods\n\n* `getItemById(itemId: string): Element`: Returns the item's HTML `<li>` element. The return value can be passed as the `item` argument to the other methods listed below.\n* `isItemChecked(item: Element): boolean`: Returns `true` if the item is checked, `false` otherwise.\n* `isItemHidden(item: Element): boolean`: Returns `true` if the item is hidden, `false` otherwise.\n* `isItemDisabled(item: Element): boolean`: Returns `true` if the item is disabled, `false` otherwise.\n\nNOTE: Item IDs are special values provided by the user that are attached to `SelectPanel` list items as the `data-item-id`\nHTML attribute. Item IDs can be provided by passing an `item_id:` attribute when adding items to the panel, eg:\n\n```erb\n<%= render(Primer::Alpha::SelectPanel.new) do |panel| %>\n  <% panel.with_item(item_id: \"my-id\") %>\n<% end %>\n```\n\nThe same is true when rendering `ItemList`s:\n\n```erb\n<%= render(Primer::Alpha::SelectPanel::ItemList.new) do |list| %>\n  <% list.with_item(item_id: \"my-id\") %>\n<% end %>\n```\n\n#### State methods\n\n* `enableItem(item: Element)`: Enables the item, i.e. makes it clickable by the mouse and keyboard.\n* `disableItem(item: Element)`: Disables the item, i.e. makes it unclickable by the mouse and keyboard.\n* `checkItem(item: Element)`: Checks the item. Only has an effect in single- and multi-select modes.\n* `uncheckItem(item: Element)`: Unchecks the item. Only has an effect in multi-select mode, since items cannot be unchecked in single-select mode.\n\n#### Events\n\n|Name                 |Type                                       |Bubbles |Cancelable |\n|:--------------------|:------------------------------------------|:-------|:----------|\n|`itemActivated`      |`CustomEvent<ItemActivatedEvent>`          |Yes     |No         |\n|`beforeItemActivated`|`CustomEvent<ItemActivatedEvent>`          |Yes     |Yes        |\n|`dialog:open`        |`CustomEvent<{dialog: HTMLDialogElement}>` |No      |No         |\n|`panelClosed`        |`CustomEvent<{panel: SelectPanelElement}>` |Yes     |No         |\n\n_Item activation_\n\nThe `<select-panel>` element fires an `itemActivated` event whenever an item is activated (eg. clicked) via the mouse or keyboard.\n\n```typescript\ndocument.querySelector(\"select-panel\").addEventListener(\n  \"itemActivated\",\n  (event: CustomEvent<ItemActivatedEvent>) => {\n    event.detail.item     // Element: the <li> item that was activated\n    event.detail.checked  // boolean: whether or not the result of the activation checked the item\n  }\n)\n```\n\nThe `beforeItemActivated` event fires before an item is activated. Canceling this event will prevent the item\nfrom being activated.\n\n```typescript\ndocument.querySelector(\"select-panel\").addEventListener(\n  \"beforeItemActivated\",\n  (event: CustomEvent<ItemActivatedEvent>) => {\n    event.detail.item      // Element: the <li> item that was activated\n    event.detail.checked   // boolean: whether or not the result of the activation checked the item\n    event.preventDefault() // Cancel the event to prevent activation (eg. checking/unchecking)\n  }\n)\n```",
+    "accessibility_docs": null,
+    "is_form_component": false,
+    "is_published": true,
+    "requires_js": true,
+    "component": "SelectPanel",
+    "status": "alpha",
+    "a11y_reviewed": false,
+    "short_name": "SelectPanel",
+    "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/select_panel.rb",
+    "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/select_panel/default/",
+    "parameters": [
+      {
+        "name": "src",
+        "type": "String",
+        "default": "`nil`",
+        "description": "The URL to fetch search results from."
+      },
+      {
+        "name": "title",
+        "type": "String",
+        "default": "`\"Menu\"`",
+        "description": "The title that appears at the top of the panel."
+      },
+      {
+        "name": "id",
+        "type": "String",
+        "default": "`self.class.generate_id`",
+        "description": "The unique ID of the panel."
+      },
+      {
+        "name": "size",
+        "type": "Symbol",
+        "default": "`:small`",
+        "description": "The size of the panel. One of `:auto`, `:large`, `:medium`, `:medium_portrait`, `:small`, or `:xlarge`."
+      },
+      {
+        "name": "select_variant",
+        "type": "Symbol",
+        "default": "`:single`",
+        "description": "One of `:multiple`, `:multiple_checkbox`, `:none`, or `:single`."
+      },
+      {
+        "name": "fetch_strategy",
+        "type": "Symbol",
+        "default": "`:remote`",
+        "description": "One of `:eventually_local`, `:local`, or `:remote`."
+      },
+      {
+        "name": "no_results_label",
+        "type": "String",
+        "default": "`\"No results found\"`",
+        "description": "The label to display when no results are found."
+      },
+      {
+        "name": "preload",
+        "type": "Boolean",
+        "default": "`false`",
+        "description": "Whether to preload search results when the page loads. If this option is false, results are loaded when the panel is opened."
+      },
+      {
+        "name": "dynamic_label",
+        "type": "Boolean",
+        "default": "`false`",
+        "description": "Whether or not to display the text of the currently selected item in the show button."
+      },
+      {
+        "name": "dynamic_label_prefix",
+        "type": "String",
+        "default": "`nil`",
+        "description": "If provided, the prefix is prepended to the dynamic label and displayed in the show button."
+      },
+      {
+        "name": "dynamic_aria_label_prefix",
+        "type": "String",
+        "default": "`nil`",
+        "description": "If provided, the prefix is prepended to the dynamic label and set as the value of the `aria-label` attribute on the show button."
+      },
+      {
+        "name": "body_id",
+        "type": "String",
+        "default": "`nil`",
+        "description": "The unique ID of the panel body. If not provided, the body ID will be set to the panel ID with a \"-body\" suffix."
+      },
+      {
+        "name": "list_arguments",
+        "type": "Hash",
+        "default": "`{}`",
+        "description": "Arguments to pass to the underlying {{#link_to_component}}Primer::Alpha::ActionList{{/link_to_component}} component. Only has an effect for the local fetch strategy."
+      },
+      {
+        "name": "form_arguments",
+        "type": "Hash",
+        "default": "`{}`",
+        "description": "Form arguments to pass to the underlying {{#link_to_component}}Primer::Alpha::ActionList{{/link_to_component}} component. Only has an effect for the local fetch strategy."
+      },
+      {
+        "name": "show_filter",
+        "type": "Boolean",
+        "default": "`true`",
+        "description": "Whether or not to show the filter input."
+      },
+      {
+        "name": "open_on_load",
+        "type": "Boolean",
+        "default": "`false`",
+        "description": "Open the panel when the page loads."
+      },
+      {
+        "name": "anchor_align",
+        "type": "Symbol",
+        "default": "`:start`",
+        "description": "The anchor alignment of the Overlay. One of `:center`, `:end`, or `:start`."
+      },
+      {
+        "name": "anchor_side",
+        "type": "Symbol",
+        "default": "`:outside_bottom`",
+        "description": "The side to anchor the Overlay to. One of `:inside_bottom`, `:inside_center`, `:inside_left`, `:inside_right`, `:inside_top`, `:outside_bottom`, `:outside_left`, `:outside_right`, or `:outside_top`."
+      },
+      {
+        "name": "system_arguments",
+        "type": "Hash",
+        "default": "N/A",
+        "description": "{{link_to_system_arguments_docs}}"
+      }
+    ],
+    "slots": [
+      {
+        "name": "footer",
+        "description": "Renders content in a footer region below the list of items.",
+        "parameters": [
+          {
+            "name": "system_arguments",
+            "type": "Hash",
+            "default": "N/A",
+            "description": "The arguments accepted by {{#link_to_component}}Primer::Alpha::Dialog::Footer{{/link_to_component}}."
+          }
+        ]
+      },
+      {
+        "name": "subtitle",
+        "description": "Renders content underneath the title at the top of the panel.",
+        "parameters": [
+          {
+            "name": "system_arguments",
+            "type": "Hash",
+            "default": "N/A",
+            "description": "The arguments accepted by {{#link_to_component}}Primer::Alpha::Dialog::Header{{/link_to_component}}'s `subtitle` slot."
+          }
+        ]
+      },
+      {
+        "name": "show_button",
+        "description": "Adds a show button (i.e. a button) that will open the panel when clicked.",
+        "parameters": [
+          {
+            "name": "system_arguments",
+            "type": "Hash",
+            "default": "N/A",
+            "description": "The arguments accepted by {{#link_to_component}}Primer::Beta::Button{{/link_to_component}}."
+          }
+        ]
+      },
+      {
+        "name": "preload_error_content",
+        "description": "Customizable content for the error message that appears when items are fetched for the first time. This message\nappears in place of the list of items.\nFor more information, see the [documentation regarding SelectPanel error messaging](/components/selectpanel#errorwarning).",
+        "parameters": [
+
+        ]
+      },
+      {
+        "name": "error_content",
+        "description": "Customizable content for the error message that appears when items are fetched as the result of a filter\noperation. This message appears as a banner above the previously fetched list of items.\nFor more information, see the [documentation regarding SelectPanel error messaging](/components/selectpanel#errorwarning).",
+        "parameters": [
+
+        ]
+      }
+    ],
+    "methods": [
+      {
+        "name": "src",
+        "description": "The URL to fetch search results from.",
+        "parameters": [
+
+        ],
+        "return_types": [
+          "String"
+        ]
+      },
+      {
+        "name": "panel_id",
+        "description": "The unique ID of the panel.",
+        "parameters": [
+
+        ],
+        "return_types": [
+          "String"
+        ]
+      },
+      {
+        "name": "body_id",
+        "description": "The unique ID of the panel body.",
+        "parameters": [
+
+        ],
+        "return_types": [
+          "String"
+        ]
+      },
+      {
+        "name": "select_variant",
+        "description": "One of `:multiple`, `:none`, or `:single`.",
+        "parameters": [
+
+        ],
+        "return_types": [
+          "Symbol"
+        ]
+      },
+      {
+        "name": "fetch_strategy",
+        "description": "One of `:eventually_local`, `:local`, or `:remote`.",
+        "parameters": [
+
+        ],
+        "return_types": [
+          "Symbol"
+        ]
+      },
+      {
+        "name": "preload",
+        "description": "Whether to preload search results when the page loads. If this option is false, results are loaded when the panel is opened.",
+        "parameters": [
+
+        ],
+        "return_types": [
+          "Boolean"
+        ]
+      },
+      {
+        "name": "preload?",
+        "description": "Whether to preload search results when the page loads. If this option is false, results are loaded when the panel is opened.",
+        "parameters": [
+
+        ],
+        "return_types": [
+          "Boolean"
+        ]
+      },
+      {
+        "name": "show_filter",
+        "description": "Whether or not to show the filter input.",
+        "parameters": [
+
+        ],
+        "return_types": [
+          "Boolean"
+        ]
+      },
+      {
+        "name": "show_filter?",
+        "description": "Whether or not to show the filter input.",
+        "parameters": [
+
+        ],
+        "return_types": [
+          "Boolean"
+        ]
+      },
+      {
+        "name": "with_item",
+        "description": "Adds an item to the list. Note that this method only has an effect for the local fetch strategy.",
+        "parameters": [
+          {
+            "name": "system_arguments",
+            "type": "Hash",
+            "default": "N/A",
+            "description": "The arguments accepted by {{#link_to_component}}Primer::Alpha::ActionList{{/link_to_component}}'s `item` slot."
+          }
+        ],
+        "return_types": [
+
+        ]
+      }
+    ],
+    "previews": [
+      {
+        "preview_path": "primer/alpha/select_panel/playground",
+        "name": "playground",
+        "snapshot": "false",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      },
+      {
+        "preview_path": "primer/alpha/select_panel/default",
+        "name": "default",
+        "snapshot": "interactive",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      },
+      {
+        "preview_path": "primer/alpha/select_panel/local_fetch",
+        "name": "local_fetch",
+        "snapshot": "interactive",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      },
+      {
+        "preview_path": "primer/alpha/select_panel/eventually_local_fetch",
+        "name": "eventually_local_fetch",
+        "snapshot": "interactive",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      },
+      {
+        "preview_path": "primer/alpha/select_panel/remote_fetch",
+        "name": "remote_fetch",
+        "snapshot": "interactive",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      },
+      {
+        "preview_path": "primer/alpha/select_panel/local_fetch_no_results",
+        "name": "local_fetch_no_results",
+        "snapshot": "interactive",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      },
+      {
+        "preview_path": "primer/alpha/select_panel/eventually_local_fetch_no_results",
+        "name": "eventually_local_fetch_no_results",
+        "snapshot": "interactive",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
       },
       {
-        "name": "required",
-        "type": "Boolean",
-        "default": "N/A",
-        "description": "Default `false`. When set to `true`, causes an asterisk (*) to appear next to the field's label indicating it is a required field. Note that this option explicitly does _not_ add a `required` HTML attribute. Doing so would enable native browser validations, which are inaccessible and inconsistent with the Primer design system."
+        "preview_path": "primer/alpha/select_panel/remote_fetch_no_results",
+        "name": "remote_fetch_no_results",
+        "snapshot": "interactive",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
       },
       {
-        "name": "aria",
-        "type": "Hash",
-        "default": "N/A",
-        "description": "Key/value pairs that represent Aria attributes and their values. Eg. `aria: { current: true }` becomes `aria-current=\"true\"`."
+        "preview_path": "primer/alpha/select_panel/single_select",
+        "name": "single_select",
+        "snapshot": "interactive",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
       },
       {
-        "name": "data",
-        "type": "Hash",
-        "default": "N/A",
-        "description": "Key/value pairs that represent data attributes and their values. Eg. `data: { foo: \"bar\" }` becomes `data-foo=\"bar\"`."
+        "preview_path": "primer/alpha/select_panel/multiselect",
+        "name": "multiselect",
+        "snapshot": "interactive",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
       },
       {
-        "name": "system_arguments",
-        "type": "Hash",
-        "default": "N/A",
-        "description": "A hash of attributes passed to the underlying Rails builder methods. These options may mean something special depending on the type of input, otherwise they are emitted as HTML attributes. See the [Rails documentation](https://guides.rubyonrails.org/form_helpers.html) for more information. In addition, the usual Primer utility arguments are accepted in system arguments. For example, passing `mt: 2` will add the `mt-2` class to the input. See the Primer system arguments docs for details."
+        "preview_path": "primer/alpha/select_panel/with_dynamic_label",
+        "name": "with_dynamic_label",
+        "snapshot": "interactive",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
       },
       {
-        "name": "multiple",
-        "type": "Boolean",
-        "default": "N/A",
-        "description": "If set to true, the selection will allow multiple choices."
+        "preview_path": "primer/alpha/select_panel/with_dynamic_label_and_aria_prefix",
+        "name": "with_dynamic_label_and_aria_prefix",
+        "snapshot": "interactive",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
       },
       {
-        "name": "include_blank",
-        "type": "Boolean, String",
-        "default": "N/A",
-        "description": "If set to true, an empty option will be created. If set to a string, the string will be used as the option's content and the value will be empty."
+        "preview_path": "primer/alpha/select_panel/footer_buttons",
+        "name": "footer_buttons",
+        "snapshot": "interactive",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
       },
       {
-        "name": "prompt",
-        "type": "String",
-        "default": "N/A",
-        "description": "Create a prompt option with blank value and the text asking user to select something."
-      }
-    ],
-    "slots": [
-
-    ],
-    "methods": [
-      {
-        "name": "option",
-        "description": "Adds an option to the list.",
-        "parameters": [
-          {
-            "name": "label",
-            "type": "String",
-            "default": "N/A",
-            "description": "The user-facing label for the option."
-          },
-          {
-            "name": "value",
-            "type": "String",
-            "default": "N/A",
-            "description": "The value sent to the server on form submission."
-          }
-        ]
-      }
-    ],
-    "previews": [
-      {
-        "preview_path": "primer/alpha/select/playground",
-        "name": "playground",
-        "snapshot": "false",
+        "preview_path": "primer/alpha/select_panel/with_avatar_items",
+        "name": "with_avatar_items",
+        "snapshot": "interactive",
         "skip_rules": {
           "wont_fix": [
             "region"
@@ -7290,9 +7981,9 @@
         }
       },
       {
-        "preview_path": "primer/alpha/select/default",
-        "name": "default",
-        "snapshot": "false",
+        "preview_path": "primer/alpha/select_panel/with_leading_icons",
+        "name": "with_leading_icons",
+        "snapshot": "interactive",
         "skip_rules": {
           "wont_fix": [
             "region"
@@ -7303,9 +7994,9 @@
         }
       },
       {
-        "preview_path": "primer/alpha/select/with_caption",
-        "name": "with_caption",
-        "snapshot": "true",
+        "preview_path": "primer/alpha/select_panel/with_trailing_icons",
+        "name": "with_trailing_icons",
+        "snapshot": "interactive",
         "skip_rules": {
           "wont_fix": [
             "region"
@@ -7316,9 +8007,9 @@
         }
       },
       {
-        "preview_path": "primer/alpha/select/visually_hide_label",
-        "name": "visually_hide_label",
-        "snapshot": "true",
+        "preview_path": "primer/alpha/select_panel/with_subtitle",
+        "name": "with_subtitle",
+        "snapshot": "interactive",
         "skip_rules": {
           "wont_fix": [
             "region"
@@ -7329,9 +8020,9 @@
         }
       },
       {
-        "preview_path": "primer/alpha/select/full_width",
-        "name": "full_width",
-        "snapshot": "true",
+        "preview_path": "primer/alpha/select_panel/remote_fetch_initial_failure",
+        "name": "remote_fetch_initial_failure",
+        "snapshot": "interactive",
         "skip_rules": {
           "wont_fix": [
             "region"
@@ -7342,9 +8033,9 @@
         }
       },
       {
-        "preview_path": "primer/alpha/select/not_full_width",
-        "name": "not_full_width",
-        "snapshot": "true",
+        "preview_path": "primer/alpha/select_panel/remote_fetch_filter_failure",
+        "name": "remote_fetch_filter_failure",
+        "snapshot": "interactive",
         "skip_rules": {
           "wont_fix": [
             "region"
@@ -7355,9 +8046,9 @@
         }
       },
       {
-        "preview_path": "primer/alpha/select/disabled",
-        "name": "disabled",
-        "snapshot": "true",
+        "preview_path": "primer/alpha/select_panel/eventually_local_fetch_initial_failure",
+        "name": "eventually_local_fetch_initial_failure",
+        "snapshot": "interactive",
         "skip_rules": {
           "wont_fix": [
             "region"
@@ -7368,9 +8059,9 @@
         }
       },
       {
-        "preview_path": "primer/alpha/select/invalid",
-        "name": "invalid",
-        "snapshot": "true",
+        "preview_path": "primer/alpha/select_panel/single_select_form",
+        "name": "single_select_form",
+        "snapshot": "interactive",
         "skip_rules": {
           "wont_fix": [
             "region"
@@ -7381,9 +8072,9 @@
         }
       },
       {
-        "preview_path": "primer/alpha/select/with_validation_message",
-        "name": "with_validation_message",
-        "snapshot": "true",
+        "preview_path": "primer/alpha/select_panel/multiselect_form",
+        "name": "multiselect_form",
+        "snapshot": "interactive",
         "skip_rules": {
           "wont_fix": [
             "region"
@@ -7395,7 +8086,64 @@
       }
     ],
     "subcomponents": [
+      {
+        "fully_qualified_name": "Primer::Alpha::SelectPanel::ItemList",
+        "description": "The component that should be used to render the list of items in the body of a SelectPanel.",
+        "accessibility_docs": null,
+        "is_form_component": false,
+        "is_published": true,
+        "requires_js": true,
+        "component": "SelectPanel::ItemList",
+        "status": "alpha",
+        "a11y_reviewed": true,
+        "short_name": "SelectPanelItemList",
+        "source": "https://github.com/primer/view_components/tree/main/app/components/primer/alpha/select_panel/item_list.rb",
+        "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/alpha/select_panel/item_list/default/",
+        "parameters": [
+          {
+            "name": "system_arguments",
+            "type": "Hash",
+            "default": "N/A",
+            "description": "The arguments accepted by {{#link_to_component}}Primer::Alpha::ActionList{{/link_to_component}}."
+          }
+        ],
+        "slots": [
+          {
+            "name": "heading",
+            "description": "Heading text rendered above the list of items.",
+            "parameters": [
+              {
+                "name": "component_klass",
+                "type": "Class",
+                "default": "N/A",
+                "description": "The class to use instead of the default {{#link_to_component}}Primer::Alpha::ActionList::Heading{{/link_to_component}}."
+              },
+              {
+                "name": "system_arguments",
+                "type": "Hash",
+                "default": "N/A",
+                "description": "The arguments accepted by `component_klass`."
+              }
+            ]
+          },
+          {
+            "name": "items",
+            "description": "Items. Items can be individual items, avatar items, or dividers. See the documentation for `#with_item`, `#with_divider`, and `#with_avatar_item` respectively for more information.",
+            "parameters": [
+
+            ]
+          }
+        ],
+        "methods": [
+
+        ],
+        "previews": [
+
+        ],
+        "subcomponents": [
 
+        ]
+      }
     ]
   },
   {
@@ -8813,6 +9561,9 @@
         "description": "Returns the value of attribute id.",
         "parameters": [
 
+        ],
+        "return_types": [
+
         ]
       }
     ],
@@ -10304,6 +11055,9 @@
         "description": "Returns the value of attribute disabled.",
         "parameters": [
 
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -10311,6 +11065,9 @@
         "description": "Returns the value of attribute disabled.",
         "parameters": [
 
+        ],
+        "return_types": [
+
         ]
       }
     ],
@@ -10883,6 +11640,9 @@
             "description": "Returns the value of attribute id.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           }
         ],
@@ -11032,6 +11792,9 @@
             "description": "Returns the value of attribute selected.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           },
           {
@@ -11044,6 +11807,9 @@
                 "default": "N/A",
                 "description": "the value to set the attribute selected to."
               }
+            ],
+            "return_types": [
+
             ]
           },
           {
@@ -11051,6 +11817,9 @@
             "description": "Returns the value of attribute href.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           },
           {
@@ -11063,6 +11832,9 @@
                 "default": "N/A",
                 "description": "the value to set the attribute href to."
               }
+            ],
+            "return_types": [
+
             ]
           }
         ],
@@ -11547,6 +12319,9 @@
             "default": "N/A",
             "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."
           }
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -11559,6 +12334,9 @@
             "default": "N/A",
             "description": "The arguments accepted by {{#link_to_component}}Primer::Beta::ButtonGroup::MenuButton{{/link_to_component}}."
           }
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -11571,6 +12349,9 @@
             "default": "N/A",
             "description": "The arguments accepted by {{#link_to_component}}Primer::Beta::ClipboardCopyButton{{/link_to_component}}."
           }
+        ],
+        "return_types": [
+
         ]
       }
     ],
@@ -12370,6 +13151,9 @@
         "description": "Returns the value of attribute disabled.",
         "parameters": [
 
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -12377,6 +13161,9 @@
         "description": "Returns the value of attribute disabled.",
         "parameters": [
 
+        ],
+        "return_types": [
+
         ]
       }
     ],
@@ -13427,6 +14214,9 @@
             "default": "N/A",
             "description": "These arguments are forwarded to {{#link_to_component}}Primer::Beta::NavList::Item{{/link_to_component}}, or whatever class is passed as the `component_klass` argument."
           }
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -13475,6 +14265,9 @@
             "default": "N/A",
             "description": "These arguments are forwarded to {{#link_to_component}}Primer::Beta::NavList::Item{{/link_to_component}}, or whatever class is passed as the `component_klass` argument."
           }
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -13487,6 +14280,9 @@
             "default": "N/A",
             "description": "The arguments accepted by {{#link_to_component}}Primer::Beta::NavList::Group{{/link_to_component}}."
           }
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -13499,6 +14295,9 @@
             "default": "N/A",
             "description": "The arguments accepted by {{#link_to_component}}Primer::Beta::NavList::Divider{{/link_to_component}}."
           }
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -13517,6 +14316,9 @@
             "default": "N/A",
             "description": "These arguments are forwarded to {{#link_to_component}}Primer::Beta::NavList::Item{{/link_to_component}}, or whatever class is passed as the `component_klass` argument."
           }
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -13565,6 +14367,9 @@
             "default": "N/A",
             "description": "These arguments are forwarded to {{#link_to_component}}Primer::Beta::NavList::Item{{/link_to_component}}, or whatever class is passed as the `component_klass` argument."
           }
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -13572,6 +14377,9 @@
         "description": "Lists that contain top-level items (i.e. items outside of a group) should be wrapped in a <ul>",
         "parameters": [
 
+        ],
+        "return_types": [
+          "Boolean"
         ]
       }
     ],
@@ -13756,6 +14564,9 @@
             "description": "Returns the value of attribute title.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           },
           {
@@ -13763,6 +14574,9 @@
             "description": "Returns the value of attribute id.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           },
           {
@@ -13770,6 +14584,9 @@
             "description": "Returns the value of attribute heading_level.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           },
           {
@@ -13777,6 +14594,9 @@
             "description": "Returns the value of attribute system_arguments.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           }
         ],
@@ -13903,6 +14723,9 @@
             "description": "Returns the value of attribute selected_by_ids.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           },
           {
@@ -13910,6 +14733,9 @@
             "description": "Returns the value of attribute sub_item.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           },
           {
@@ -13917,6 +14743,9 @@
             "description": "Returns the value of attribute sub_item.\nWhether or not this item is nested under a parent item.",
             "parameters": [
 
+            ],
+            "return_types": [
+              "Boolean"
             ]
           },
           {
@@ -13924,6 +14753,9 @@
             "description": "Cause this item to show its list of sub items when rendered.",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           },
           {
@@ -13931,6 +14763,9 @@
             "description": "Normally it would be easier to simply ask each item for its active status, eg.\nitems.any?(&:active?), but unfortunately the view context is not set on each\nitem until _after_ the parent's before_render, etc methods have been called.\nThis means helper methods like current_page? will blow up with an error, since\n`helpers` is simply an alias for the view context (i.e. an instance of\nActionView::Base). Since we know the view context for the parent object must\nbe set before `before_render` is invoked, we can call helper methods here in\nthe parent and bypass the problem entirely. Maybe not the most OO approach,\nbut it works.",
             "parameters": [
 
+            ],
+            "return_types": [
+              "Boolean"
             ]
           }
         ],
@@ -14076,6 +14911,9 @@
             "description": "Cause this group to show its list of sub items when rendered.\n:nocov:",
             "parameters": [
 
+            ],
+            "return_types": [
+
             ]
           }
         ],
@@ -15829,6 +16667,9 @@
         "description": "remove alias when all buttons are migrated to new slot names",
         "parameters": [
 
+        ],
+        "return_types": [
+
         ]
       },
       {
@@ -15836,6 +16677,9 @@
         "description": "remove alias when all buttons are migrated to new slot names",
         "parameters": [
 
+        ],
+        "return_types": [
+
         ]
       }
     ],