@carbon/web-components 2.49.0 → 2.50.0-rc.0

package/custom-elements.json

@@ -157,11 +157,13 @@
         },
         {
           "name": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
-          "description": "`true` if the button should be disabled.",
+          "description": "Specify whether the Button should be disabled, or not",
           "type": "boolean",
           "default": "false"
         },
@@ -178,7 +180,7 @@
         },
         {
           "name": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -188,19 +190,19 @@
         },
         {
           "name": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -223,24 +225,24 @@
         },
         {
           "name": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
           "name": "size",
-          "description": "Button size.",
+          "description": "Specify the size of the button, from the following list of sizes: `xs`, `sm`, `md`, `lg`, `xl`, `2xl`",
           "type": "string",
           "default": "\"lg\""
         },
         {
           "name": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -257,12 +259,12 @@
         },
         {
           "name": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         }
@@ -297,12 +299,14 @@
         {
           "name": "dangerDescription",
           "attribute": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
           "attribute": "disabled",
-          "description": "`true` if the button should be disabled.",
+          "description": "Specify whether the Button should be disabled, or not",
           "type": "boolean",
           "default": "false"
         },
@@ -322,7 +326,7 @@
         {
           "name": "href",
           "attribute": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -334,21 +338,21 @@
         {
           "name": "isExpressive",
           "attribute": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
           "attribute": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
           "attribute": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -375,27 +379,27 @@
         {
           "name": "rel",
           "attribute": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
           "name": "size",
           "attribute": "size",
-          "description": "Button size.",
+          "description": "Specify the size of the button, from the following list of sizes: `xs`, `sm`, `md`, `lg`, `xl`, `2xl`",
           "type": "string",
           "default": "\"lg\""
         },
         {
           "name": "tabIndex",
           "attribute": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
           "attribute": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -415,13 +419,13 @@
         {
           "name": "tooltipText",
           "attribute": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
           "attribute": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         },
@@ -1049,7 +1053,9 @@
         },
         {
           "name": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
@@ -1070,7 +1076,7 @@
         },
         {
           "name": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -1080,19 +1086,19 @@
         },
         {
           "name": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -1115,7 +1121,7 @@
         },
         {
           "name": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -1126,13 +1132,13 @@
         },
         {
           "name": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -1149,12 +1155,12 @@
         },
         {
           "name": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         }
@@ -1271,7 +1277,9 @@
         {
           "name": "dangerDescription",
           "attribute": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
@@ -1296,7 +1304,7 @@
         {
           "name": "href",
           "attribute": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -1308,21 +1316,21 @@
         {
           "name": "isExpressive",
           "attribute": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
           "attribute": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
           "attribute": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -1349,7 +1357,7 @@
         {
           "name": "rel",
           "attribute": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -1362,14 +1370,14 @@
         {
           "name": "tabIndex",
           "attribute": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
           "attribute": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -1389,13 +1397,13 @@
         {
           "name": "tooltipText",
           "attribute": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
           "attribute": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         },
@@ -1517,11 +1525,13 @@
         },
         {
           "name": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
-          "description": "`true` if the button should be disabled.",
+          "description": "Specify whether the Button should be disabled, or not",
           "type": "boolean",
           "default": "false"
         },
@@ -1538,7 +1548,7 @@
         },
         {
           "name": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -1548,19 +1558,19 @@
         },
         {
           "name": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -1583,24 +1593,24 @@
         },
         {
           "name": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
           "name": "size",
-          "description": "Button size.",
+          "description": "Specify the size of the button, from the following list of sizes: `xs`, `sm`, `md`, `lg`, `xl`, `2xl`",
           "type": "string",
           "default": "\"lg\""
         },
         {
           "name": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -1617,12 +1627,12 @@
         },
         {
           "name": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         }
@@ -1650,12 +1660,14 @@
         {
           "name": "dangerDescription",
           "attribute": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
           "attribute": "disabled",
-          "description": "`true` if the button should be disabled.",
+          "description": "Specify whether the Button should be disabled, or not",
           "type": "boolean",
           "default": "false"
         },
@@ -1675,7 +1687,7 @@
         {
           "name": "href",
           "attribute": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -1687,21 +1699,21 @@
         {
           "name": "isExpressive",
           "attribute": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
           "attribute": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
           "attribute": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -1728,27 +1740,27 @@
         {
           "name": "rel",
           "attribute": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
           "name": "size",
           "attribute": "size",
-          "description": "Button size.",
+          "description": "Specify the size of the button, from the following list of sizes: `xs`, `sm`, `md`, `lg`, `xl`, `2xl`",
           "type": "string",
           "default": "\"lg\""
         },
         {
           "name": "tabIndex",
           "attribute": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
           "attribute": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -1768,13 +1780,13 @@
         {
           "name": "tooltipText",
           "attribute": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
           "attribute": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         },
@@ -3603,11 +3615,13 @@
         },
         {
           "name": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
-          "description": "`true` if the button should be disabled.",
+          "description": "Specify whether the Button should be disabled, or not",
           "type": "boolean",
           "default": "false"
         },
@@ -3624,7 +3638,7 @@
         },
         {
           "name": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -3634,19 +3648,19 @@
         },
         {
           "name": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -3669,7 +3683,7 @@
         },
         {
           "name": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -3680,13 +3694,13 @@
         },
         {
           "name": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -3703,12 +3717,12 @@
         },
         {
           "name": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         }
@@ -3792,12 +3806,14 @@
         {
           "name": "dangerDescription",
           "attribute": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
           "attribute": "disabled",
-          "description": "`true` if the button should be disabled.",
+          "description": "Specify whether the Button should be disabled, or not",
           "type": "boolean",
           "default": "false"
         },
@@ -3817,7 +3833,7 @@
         {
           "name": "href",
           "attribute": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -3829,21 +3845,21 @@
         {
           "name": "isExpressive",
           "attribute": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
           "attribute": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
           "attribute": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -3870,7 +3886,7 @@
         {
           "name": "rel",
           "attribute": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -3883,14 +3899,14 @@
         {
           "name": "tabIndex",
           "attribute": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
           "attribute": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -3910,13 +3926,13 @@
         {
           "name": "tooltipText",
           "attribute": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
           "attribute": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         },
@@ -9554,11 +9570,13 @@
         },
         {
           "name": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
-          "description": "`true` if the button should be disabled.",
+          "description": "Specify whether the Button should be disabled, or not",
           "type": "boolean",
           "default": "false"
         },
@@ -9575,7 +9593,7 @@
         },
         {
           "name": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -9585,19 +9603,19 @@
         },
         {
           "name": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -9620,7 +9638,7 @@
         },
         {
           "name": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -9631,13 +9649,13 @@
         },
         {
           "name": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -9654,12 +9672,12 @@
         },
         {
           "name": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         }
@@ -9729,12 +9747,14 @@
         {
           "name": "dangerDescription",
           "attribute": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
           "attribute": "disabled",
-          "description": "`true` if the button should be disabled.",
+          "description": "Specify whether the Button should be disabled, or not",
           "type": "boolean",
           "default": "false"
         },
@@ -9754,7 +9774,7 @@
         {
           "name": "href",
           "attribute": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -9766,21 +9786,21 @@
         {
           "name": "isExpressive",
           "attribute": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
           "attribute": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
           "attribute": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -9807,7 +9827,7 @@
         {
           "name": "rel",
           "attribute": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -9820,14 +9840,14 @@
         {
           "name": "tabIndex",
           "attribute": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
           "attribute": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -9847,13 +9867,13 @@
         {
           "name": "tooltipText",
           "attribute": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
           "attribute": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         },
@@ -10954,11 +10974,13 @@
         },
         {
           "name": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
-          "description": "`true` if the button should be disabled.",
+          "description": "Specify whether the Button should be disabled, or not",
           "type": "boolean",
           "default": "false"
         },
@@ -10975,7 +10997,7 @@
         },
         {
           "name": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -10985,19 +11007,19 @@
         },
         {
           "name": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -11020,24 +11042,24 @@
         },
         {
           "name": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
           "name": "size",
-          "description": "Button size.",
+          "description": "Specify the size of the button, from the following list of sizes: `xs`, `sm`, `md`, `lg`, `xl`, `2xl`",
           "type": "string",
           "default": "\"lg\""
         },
         {
           "name": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -11054,12 +11076,12 @@
         },
         {
           "name": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         }
@@ -11087,12 +11109,14 @@
         {
           "name": "dangerDescription",
           "attribute": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
           "attribute": "disabled",
-          "description": "`true` if the button should be disabled.",
+          "description": "Specify whether the Button should be disabled, or not",
           "type": "boolean",
           "default": "false"
         },
@@ -11112,7 +11136,7 @@
         {
           "name": "href",
           "attribute": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -11124,21 +11148,21 @@
         {
           "name": "isExpressive",
           "attribute": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
           "attribute": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
           "attribute": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -11165,27 +11189,27 @@
         {
           "name": "rel",
           "attribute": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
           "name": "size",
           "attribute": "size",
-          "description": "Button size.",
+          "description": "Specify the size of the button, from the following list of sizes: `xs`, `sm`, `md`, `lg`, `xl`, `2xl`",
           "type": "string",
           "default": "\"lg\""
         },
         {
           "name": "tabIndex",
           "attribute": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
           "attribute": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -11205,13 +11229,13 @@
         {
           "name": "tooltipText",
           "attribute": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
           "attribute": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         },
@@ -12101,11 +12125,13 @@
         },
         {
           "name": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
-          "description": "`true` if the button should be disabled.",
+          "description": "Specify whether the Button should be disabled, or not",
           "type": "boolean",
           "default": "false"
         },
@@ -12122,7 +12148,7 @@
         },
         {
           "name": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -12132,19 +12158,19 @@
         },
         {
           "name": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -12167,24 +12193,24 @@
         },
         {
           "name": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
           "name": "size",
-          "description": "Button size.",
+          "description": "Specify the size of the button, from the following list of sizes: `xs`, `sm`, `md`, `lg`, `xl`, `2xl`",
           "type": "string",
           "default": "\"lg\""
         },
         {
           "name": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -12201,12 +12227,12 @@
         },
         {
           "name": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         }
@@ -12234,12 +12260,14 @@
         {
           "name": "dangerDescription",
           "attribute": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
           "attribute": "disabled",
-          "description": "`true` if the button should be disabled.",
+          "description": "Specify whether the Button should be disabled, or not",
           "type": "boolean",
           "default": "false"
         },
@@ -12259,7 +12287,7 @@
         {
           "name": "href",
           "attribute": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -12271,21 +12299,21 @@
         {
           "name": "isExpressive",
           "attribute": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
           "attribute": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
           "attribute": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -12312,27 +12340,27 @@
         {
           "name": "rel",
           "attribute": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
           "name": "size",
           "attribute": "size",
-          "description": "Button size.",
+          "description": "Specify the size of the button, from the following list of sizes: `xs`, `sm`, `md`, `lg`, `xl`, `2xl`",
           "type": "string",
           "default": "\"lg\""
         },
         {
           "name": "tabIndex",
           "attribute": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
           "attribute": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -12352,13 +12380,13 @@
         {
           "name": "tooltipText",
           "attribute": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
           "attribute": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         },
@@ -13696,6 +13724,16 @@
           "type": "OVERFLOW_MENU_SIZE",
           "default": "\"md\""
         },
+        {
+          "name": "menuOffset",
+          "description": "The adjustment in position applied to the floating menu.",
+          "type": "MenuOffset | undefined"
+        },
+        {
+          "name": "menuOffsetFlip",
+          "description": "The adjustment in position applied to the floating menu when flipped.",
+          "type": "MenuOffset | undefined"
+        },
         {
           "name": "styles",
           "default": "\"styles\""
@@ -13933,7 +13971,9 @@
         },
         {
           "name": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
@@ -13954,7 +13994,7 @@
         },
         {
           "name": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -13964,19 +14004,19 @@
         },
         {
           "name": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -13999,7 +14039,7 @@
         },
         {
           "name": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -14010,13 +14050,13 @@
         },
         {
           "name": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -14033,12 +14073,12 @@
         },
         {
           "name": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         }
@@ -14155,7 +14195,9 @@
         {
           "name": "dangerDescription",
           "attribute": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
@@ -14180,7 +14222,7 @@
         {
           "name": "href",
           "attribute": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -14192,21 +14234,21 @@
         {
           "name": "isExpressive",
           "attribute": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
           "attribute": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
           "attribute": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -14233,7 +14275,7 @@
         {
           "name": "rel",
           "attribute": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -14246,14 +14288,14 @@
         {
           "name": "tabIndex",
           "attribute": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
           "attribute": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -14273,13 +14315,13 @@
         {
           "name": "tooltipText",
           "attribute": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
           "attribute": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         },
@@ -17849,11 +17891,13 @@
         },
         {
           "name": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
-          "description": "`true` if the button should be disabled.",
+          "description": "Specify whether the Button should be disabled, or not",
           "type": "boolean",
           "default": "false"
         },
@@ -17870,7 +17914,7 @@
         },
         {
           "name": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -17880,19 +17924,19 @@
         },
         {
           "name": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -17915,24 +17959,24 @@
         },
         {
           "name": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
           "name": "size",
-          "description": "Button size.",
+          "description": "Specify the size of the button, from the following list of sizes: `xs`, `sm`, `md`, `lg`, `xl`, `2xl`",
           "type": "string",
           "default": "\"lg\""
         },
         {
           "name": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -17949,12 +17993,12 @@
         },
         {
           "name": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         }
@@ -17989,12 +18033,14 @@
         {
           "name": "dangerDescription",
           "attribute": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
           "attribute": "disabled",
-          "description": "`true` if the button should be disabled.",
+          "description": "Specify whether the Button should be disabled, or not",
           "type": "boolean",
           "default": "false"
         },
@@ -18014,7 +18060,7 @@
         {
           "name": "href",
           "attribute": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -18026,21 +18072,21 @@
         {
           "name": "isExpressive",
           "attribute": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
           "attribute": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
           "attribute": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -18067,27 +18113,27 @@
         {
           "name": "rel",
           "attribute": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
           "name": "size",
           "attribute": "size",
-          "description": "Button size.",
+          "description": "Specify the size of the button, from the following list of sizes: `xs`, `sm`, `md`, `lg`, `xl`, `2xl`",
           "type": "string",
           "default": "\"lg\""
         },
         {
           "name": "tabIndex",
           "attribute": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
           "attribute": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -18107,13 +18153,13 @@
         {
           "name": "tooltipText",
           "attribute": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
           "attribute": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         },
@@ -22607,11 +22653,13 @@
         },
         {
           "name": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
-          "description": "`true` if the button should be disabled.",
+          "description": "Specify whether the Button should be disabled, or not",
           "type": "boolean",
           "default": "false"
         },
@@ -22628,7 +22676,7 @@
         },
         {
           "name": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -22638,19 +22686,19 @@
         },
         {
           "name": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -22673,24 +22721,24 @@
         },
         {
           "name": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
           "name": "size",
-          "description": "Button size.",
+          "description": "Specify the size of the button, from the following list of sizes: `xs`, `sm`, `md`, `lg`, `xl`, `2xl`",
           "type": "string",
           "default": "\"lg\""
         },
         {
           "name": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -22707,12 +22755,12 @@
         },
         {
           "name": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         }
@@ -22760,12 +22808,14 @@
         {
           "name": "dangerDescription",
           "attribute": "danger-description",
-          "description": "Specify the message read by screen readers for the danger button variant"
+          "description": "Specify the message read by screen readers for the danger button variants",
+          "type": "string",
+          "default": "\"danger\""
         },
         {
           "name": "disabled",
           "attribute": "disabled",
-          "description": "`true` if the button should be disabled.",
+          "description": "Specify whether the Button should be disabled, or not",
           "type": "boolean",
           "default": "false"
         },
@@ -22785,7 +22835,7 @@
         {
           "name": "href",
           "attribute": "href",
-          "description": "Link `href`. If present, this button is rendered as `<a>`.",
+          "description": "Optionally specify an href for your Button to become an `<a>` element",
           "type": "string"
         },
         {
@@ -22797,21 +22847,21 @@
         {
           "name": "isExpressive",
           "attribute": "isExpressive",
-          "description": "`true` if expressive theme enabled.",
+          "description": "Specify whether the Button is expressive, or not.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "isSelected",
           "attribute": "isSelected",
-          "description": "Specify whether the Button is currently selected.\nOnly applies to the Ghost variant.",
+          "description": "Specify whether the Button is currently selected. Only applies to the icon only Ghost variant.",
           "type": "boolean",
           "default": "false"
         },
         {
           "name": "kind",
           "attribute": "kind",
-          "description": "Button kind.",
+          "description": "Specify the kind of Button you want to create. `primary`, `secondary`,`tertiary`, `ghost`, `danger`, `danger-tertiary`, `danger-ghost`",
           "type": "BUTTON_KIND",
           "default": "\"primary\""
         },
@@ -22838,27 +22888,27 @@
         {
           "name": "rel",
           "attribute": "rel",
-          "description": "The link type, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `rel` when using an `<a>` element.",
           "type": "string"
         },
         {
           "name": "size",
           "attribute": "size",
-          "description": "Button size.",
+          "description": "Specify the size of the button, from the following list of sizes: `xs`, `sm`, `md`, `lg`, `xl`, `2xl`",
           "type": "string",
           "default": "\"lg\""
         },
         {
           "name": "tabIndex",
           "attribute": "tab-index",
-          "description": "Specify the tabIndex of the button.",
+          "description": "Optional prop to specify the tabIndex of the Button",
           "type": "number",
           "default": "0"
         },
         {
           "name": "target",
           "attribute": "target",
-          "description": "The link target, if this button is rendered as `<a>`.",
+          "description": "Optionally specify a `target` when using an `<a>` element.",
           "type": "string"
         },
         {
@@ -22878,13 +22928,13 @@
         {
           "name": "tooltipText",
           "attribute": "tooltip-text",
-          "description": "Specify the text to be rendered in the tooltip. If using\n\"cds-badge-indicator\" with no count prop then the text\nshould include describing there is a new notification.",
+          "description": "If rendering an `icon-only` button through `slot=\"icon\"`, Specify the text to be rendered in the tooltip. If using\n`cds-badge-indicator` with no count prop then the text should include describing there is a new notification.",
           "type": "string"
         },
         {
           "name": "type",
           "attribute": "type",
-          "description": "Button type.",
+          "description": "Optional prop to specify the type of the Button.",
           "type": "BUTTON_TYPE",
           "default": "\"button\""
         },