@esri/calcite-components 1.0.0-beta.83 → 1.0.0-beta.84

package/dist/extras/docs-json.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2022-06-07T00:59:50",
+  "timestamp": "2022-07-12T02:02:10",
   "compiler": {
     "name": "@stencil/core",
-    "version": "2.16.0",
+    "version": "2.17.0",
     "typescriptVersion": "4.5.4"
   },
   "components": [
@@ -15,7 +15,7 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "- A slot for adding `calcite-accordion-item`s. `calcite-accordion` cannot be nested, however calcite-accordion-item`s can."
+          "text": "- A slot for adding `calcite-accordion-item`s. `calcite-accordion` cannot be nested, however `calcite-accordion-item`s can."
         }
       ],
       "usage": {
@@ -28,7 +28,7 @@
           "mutable": false,
           "attr": "appearance",
           "reflectToAttr": true,
-          "docs": "specify the appearance - default (containing border), or minimal (no containing border), defaults to default",
+          "docs": "Specifies the appearance of the component.",
           "docsTags": [],
           "default": "\"default\"",
           "values": [
@@ -54,7 +54,7 @@
           "mutable": false,
           "attr": "icon-position",
           "reflectToAttr": true,
-          "docs": "specify the placement of the icon in the header, defaults to end",
+          "docs": "Specifies the placement of the icon in the header.",
           "docsTags": [],
           "default": "\"end\"",
           "values": [
@@ -76,7 +76,7 @@
           "mutable": false,
           "attr": "icon-type",
           "reflectToAttr": true,
-          "docs": "specify the type of the icon in the header, defaults to chevron",
+          "docs": "Specifies the type of the icon in the header.",
           "docsTags": [],
           "default": "\"chevron\"",
           "values": [
@@ -102,7 +102,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of accordion, defaults to m",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -128,7 +128,7 @@
           "mutable": false,
           "attr": "selection-mode",
           "reflectToAttr": true,
-          "docs": "specify the selection mode - multi (allow any number of open items), single (allow one open item),\nor single-persist (allow and require one open item), defaults to multi",
+          "docs": "Specifies the selection mode - \"multi\" (allow any number of open items), \"single\" (allow one open item),\nor \"single-persist\" (allow and require one open item).",
           "docsTags": [],
           "default": "\"multi\"",
           "values": [
@@ -172,7 +172,7 @@
       "slots": [
         {
           "name": "",
-          "docs": "A slot for adding `calcite-accordion-item`s. `calcite-accordion` cannot be nested, however calcite-accordion-item`s can."
+          "docs": "A slot for adding `calcite-accordion-item`s. `calcite-accordion` cannot be nested, however `calcite-accordion-item`s can."
         }
       ],
       "parts": [],
@@ -200,7 +200,46 @@
           "mutable": true,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "Indicates whether the item is active.",
+          "docs": "When true, the component is active.",
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use expanded instead"
+            }
+          ],
+          "default": "false",
+          "deprecation": "use expanded instead",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "description",
+          "type": "string",
+          "mutable": false,
+          "attr": "description",
+          "reflectToAttr": false,
+          "docs": "Specifies a description for the component.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "expanded",
+          "type": "boolean",
+          "mutable": true,
+          "attr": "expanded",
+          "reflectToAttr": true,
+          "docs": "When true, item is expanded",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -211,13 +250,29 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "heading",
+          "type": "string",
+          "mutable": false,
+          "attr": "heading",
+          "reflectToAttr": false,
+          "docs": "Specifies heading text for the component.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "icon",
           "type": "string",
           "mutable": false,
           "attr": "icon",
           "reflectToAttr": true,
-          "docs": "optionally pass an icon to display - accepts Calcite UI icon names",
+          "docs": "Specifies an icon to display - accepts Calcite UI icon names.",
           "docsTags": [],
           "values": [
             {
@@ -233,8 +288,14 @@
           "mutable": false,
           "attr": "item-subtitle",
           "reflectToAttr": false,
-          "docs": "pass a title for the accordion item",
-          "docsTags": [],
+          "docs": "Specifies a subtitle for the component.",
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "Use `description` instead."
+            }
+          ],
+          "deprecation": "Use `description` instead.",
           "values": [
             {
               "type": "string"
@@ -249,8 +310,14 @@
           "mutable": false,
           "attr": "item-title",
           "reflectToAttr": false,
-          "docs": "pass a title for the accordion item",
-          "docsTags": [],
+          "docs": "Specifies a title for the component.",
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "Use `heading` instead."
+            }
+          ],
+          "deprecation": "Use `heading` instead.",
           "values": [
             {
               "type": "string"
@@ -317,7 +384,7 @@
           "mutable": false,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "Indicates whether the action is highlighted.",
+          "docs": "When true, the component is highlighted.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -334,7 +401,7 @@
           "mutable": false,
           "attr": "alignment",
           "reflectToAttr": true,
-          "docs": "Optionally specify the horizontal alignment of button elements with text content.",
+          "docs": "Specifies the horizontal alignment of button elements with text content.",
           "docsTags": [],
           "values": [
             {
@@ -359,7 +426,7 @@
           "mutable": false,
           "attr": "appearance",
           "reflectToAttr": true,
-          "docs": "Specify the appearance style of the action, defaults to solid.",
+          "docs": "Specifies the appearance of the component.",
           "docsTags": [],
           "default": "\"solid\"",
           "values": [
@@ -381,7 +448,7 @@
           "mutable": false,
           "attr": "compact",
           "reflectToAttr": true,
-          "docs": "Compact mode is used internally by components to reduce side padding, e.g. calcite-block-section.",
+          "docs": "When true, the side padding of the component is reduced. Compact mode is used internally by components, e.g. `calcite-block-section`.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -398,7 +465,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, disabled prevents interaction. This state shows items with lower opacity/grayed.",
+          "docs": "When true, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -415,7 +482,7 @@
           "mutable": false,
           "attr": "icon",
           "reflectToAttr": false,
-          "docs": "The name of the icon to display. The value of this property must match the icon name from https://esri.github.io/calcite-ui-icons/.",
+          "docs": "Specifies an icon to display - accepts Calcite UI icon names.",
           "docsTags": [],
           "values": [
             {
@@ -431,7 +498,7 @@
           "mutable": false,
           "attr": "indicator",
           "reflectToAttr": true,
-          "docs": "Indicates unread changes.",
+          "docs": "When true, indicates unread changes.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -448,7 +515,7 @@
           "mutable": false,
           "attr": "intl-loading",
           "reflectToAttr": false,
-          "docs": "string to override English loading text",
+          "docs": "Specifies the text label to display while loading.",
           "docsTags": [
             {
               "name": "default",
@@ -470,7 +537,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "The label of the action. If no label is provided, the label inherits what's provided for the `text` prop.",
+          "docs": "Specifies the label of the component. If no label is provided, the label inherits what's provided for the `text` prop.",
           "docsTags": [],
           "values": [
             {
@@ -486,7 +553,7 @@
           "mutable": false,
           "attr": "loading",
           "reflectToAttr": true,
-          "docs": "When true, content is waiting to be loaded. This state shows a busy indicator.",
+          "docs": "When true, a busy indicator is displayed.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -503,7 +570,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "Specifies the size of the action.",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -529,7 +596,7 @@
           "mutable": false,
           "attr": "text",
           "reflectToAttr": false,
-          "docs": "Text that accompanies the action icon.",
+          "docs": "Specifies text that accompanies the icon.",
           "docsTags": [],
           "values": [
             {
@@ -577,7 +644,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when the action has been clicked.",
+          "docs": "Emits when the component has been clicked.",
           "docsTags": [
             {
               "name": "deprecated",
@@ -588,7 +655,13 @@
         }
       ],
       "listeners": [],
-      "styles": [],
+      "styles": [
+        {
+          "name": "--calcite-action-indicator-color",
+          "annotation": "prop",
+          "docs": "optionally specify the color of the action indicator"
+        }
+      ],
       "slots": [
         {
           "name": "",
@@ -678,7 +751,7 @@
           "mutable": false,
           "attr": "expand-disabled",
           "reflectToAttr": true,
-          "docs": "When set to true, the expand-toggling behavior will be disabled.",
+          "docs": "When true, the expand-toggling behavior is disabled.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -695,7 +768,7 @@
           "mutable": true,
           "attr": "expanded",
           "reflectToAttr": true,
-          "docs": "Indicates whether widget is expanded.",
+          "docs": "When true, the component is expanded.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -712,7 +785,7 @@
           "mutable": false,
           "attr": "intl-collapse",
           "reflectToAttr": false,
-          "docs": "Updates the label of the collapse icon when the component is expanded.",
+          "docs": "Specifies the label of the collapse icon when the component is expanded.",
           "docsTags": [],
           "values": [
             {
@@ -728,7 +801,7 @@
           "mutable": false,
           "attr": "intl-expand",
           "reflectToAttr": false,
-          "docs": "Updates the label of the expand icon when the component is not expanded.",
+          "docs": "Specifies the label of the expand icon when the component is collapsed.",
           "docsTags": [],
           "values": [
             {
@@ -744,7 +817,7 @@
           "mutable": false,
           "attr": "overflow-actions-disabled",
           "reflectToAttr": false,
-          "docs": "Disables automatically overflowing actions that won't fit into menus.",
+          "docs": "Disables automatically overflowing `calcite-action`s that won't fit into menus.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -761,7 +834,7 @@
           "mutable": false,
           "attr": "position",
           "reflectToAttr": true,
-          "docs": "Arranges the component depending on the elements 'dir' property.",
+          "docs": "Arranges the component depending on the element's `dir` property.",
           "docsTags": [],
           "values": [
             {
@@ -782,7 +855,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "Specifies the size of the expand action.",
+          "docs": "Specifies the size of the expand `calcite-action`.",
           "docsTags": [],
           "values": [
             {
@@ -827,7 +900,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when expanded has been toggled.",
+          "docs": "Emits when the `expanded` property is toggled.",
           "docsTags": []
         }
       ],
@@ -889,11 +962,11 @@
         },
         {
           "name": "slot",
-          "text": "menu-actions - a slot for adding an overflow menu with actions inside a dropdown."
+          "text": "menu-actions - A slot for adding an overflow menu with `calcite-action`s inside a `calcite-dropdown`."
         },
         {
           "name": "slot",
-          "text": "menu-tooltip - a slot for adding an tooltip for the menu."
+          "text": "menu-tooltip - A slot for adding a `calcite-tooltip` for the menu."
         }
       ],
       "usage": {},
@@ -941,7 +1014,7 @@
           "mutable": false,
           "attr": "expanded",
           "reflectToAttr": true,
-          "docs": "Indicates whether widget is expanded.",
+          "docs": "When true, the component is expanded.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -958,7 +1031,7 @@
           "mutable": false,
           "attr": "intl-more",
           "reflectToAttr": false,
-          "docs": "Text string for the actions menu.",
+          "docs": "Specifies a text string for the `calcite-action-menu`.",
           "docsTags": [],
           "values": [
             {
@@ -974,7 +1047,7 @@
           "mutable": false,
           "attr": "layout",
           "reflectToAttr": true,
-          "docs": "Indicates the horizontal, vertical, or grid layout of the component.",
+          "docs": "Indicates the layout of the component.",
           "docsTags": [],
           "default": "\"vertical\"",
           "values": [
@@ -1000,7 +1073,7 @@
           "mutable": true,
           "attr": "menu-open",
           "reflectToAttr": true,
-          "docs": "Opens the action menu.",
+          "docs": "When true, the `calcite-action-menu` is open.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -1017,7 +1090,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "Specifies the size of the action-menu.",
+          "docs": "Specifies the size of the `calcite-action-menu`.",
           "docsTags": [],
           "values": [
             {
@@ -1044,7 +1117,7 @@
         {
           "name": "--calcite-action-group-columns",
           "annotation": "prop",
-          "docs": "sets number of grid-template-columns when layout is grid"
+          "docs": "Sets number of grid-template-columns when the `layout` property is \"grid\"."
         }
       ],
       "slots": [
@@ -1054,11 +1127,11 @@
         },
         {
           "name": "menu-actions",
-          "docs": "a slot for adding an overflow menu with actions inside a dropdown."
+          "docs": "A slot for adding an overflow menu with `calcite-action`s inside a `calcite-dropdown`."
         },
         {
           "name": "menu-tooltip",
-          "docs": "a slot for adding an tooltip for the menu."
+          "docs": "A slot for adding a `calcite-tooltip` for the menu."
         }
       ],
       "parts": [],
@@ -1123,7 +1196,7 @@
           "mutable": false,
           "attr": "expanded",
           "reflectToAttr": true,
-          "docs": "Indicates whether widget is expanded.",
+          "docs": "When true, the component is expanded.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -1155,7 +1228,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "Text string for the actions menu.",
+          "docs": "Specifies the text string for the component.",
           "docsTags": [],
           "values": [
             {
@@ -1171,7 +1244,7 @@
           "mutable": true,
           "attr": "open",
           "reflectToAttr": true,
-          "docs": "Opens the action menu.",
+          "docs": "When true, the component is open.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -1188,7 +1261,7 @@
           "mutable": false,
           "attr": "overlay-positioning",
           "reflectToAttr": false,
-          "docs": "Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value.",
+          "docs": "Determines the type of positioning to use for the overlaid content. If your element is in a fixed container, use the \"fixed\" value.",
           "docsTags": [],
           "default": "\"absolute\"",
           "values": [
@@ -1210,7 +1283,7 @@
           "mutable": false,
           "attr": "placement",
           "reflectToAttr": true,
-          "docs": "Determines where the component will be positioned relative to the referenceElement.",
+          "docs": "Determines where the component will be positioned relative to the `referenceElement`.",
           "docsTags": [
             {
               "name": "see",
@@ -1238,7 +1311,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "Specifies the size of the menu trigger action.",
+          "docs": "Specifies the size of the component's trigger `calcite-action`.",
           "docsTags": [],
           "values": [
             {
@@ -1278,7 +1351,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when the open property has changed.",
+          "docs": "Emits when the `open` property has changed.",
           "docsTags": []
         }
       ],
@@ -1348,11 +1421,11 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "- A slot for adding `calcite-action`s to the action pad."
+          "text": "- A slot for adding `calcite-action`s to the component."
         },
         {
           "name": "slot",
-          "text": "expand-tooltip - Used to set the tooltip for the expand toggle."
+          "text": "expand-tooltip - Used to set the `calcite-tooltip` for the expand toggle."
         }
       ],
       "usage": {
@@ -1367,7 +1440,7 @@
           "mutable": false,
           "attr": "expand-disabled",
           "reflectToAttr": true,
-          "docs": "When set to true, the expand-toggling behavior will be disabled.",
+          "docs": "When true, the expand-toggling behavior is disabled.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -1384,7 +1457,7 @@
           "mutable": true,
           "attr": "expanded",
           "reflectToAttr": true,
-          "docs": "Indicates whether widget is expanded.",
+          "docs": "When true, the component is expanded.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -1401,7 +1474,7 @@
           "mutable": false,
           "attr": "intl-collapse",
           "reflectToAttr": false,
-          "docs": "Updates the label of the collapse icon when the component is expanded.",
+          "docs": "Specifies the label of the collapse icon when the component is expanded.",
           "docsTags": [],
           "values": [
             {
@@ -1417,7 +1490,7 @@
           "mutable": false,
           "attr": "intl-expand",
           "reflectToAttr": false,
-          "docs": "Updates the label of the expand icon when the component is not expanded.",
+          "docs": "Specifies the label of the expand icon when the component is collapsed.",
           "docsTags": [],
           "values": [
             {
@@ -1433,7 +1506,7 @@
           "mutable": false,
           "attr": "layout",
           "reflectToAttr": true,
-          "docs": "Indicates the horizontal or vertical layout of the component.",
+          "docs": "Indicates the layout of the component.",
           "docsTags": [],
           "default": "\"vertical\"",
           "values": [
@@ -1459,7 +1532,7 @@
           "mutable": false,
           "attr": "position",
           "reflectToAttr": true,
-          "docs": "Arranges the component depending on the elements 'dir' property.",
+          "docs": "Arranges the component depending on the element's `dir` property.",
           "docsTags": [],
           "values": [
             {
@@ -1480,7 +1553,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "Specifies the size of the expand action.",
+          "docs": "Specifies the size of the expand `calcite-action`.",
           "docsTags": [],
           "values": [
             {
@@ -1525,7 +1598,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when expanded has been toggled.",
+          "docs": "Emits when the `expanded` property is toggled.",
           "docsTags": []
         }
       ],
@@ -1534,11 +1607,11 @@
       "slots": [
         {
           "name": "",
-          "docs": "A slot for adding `calcite-action`s to the action pad."
+          "docs": "A slot for adding `calcite-action`s to the component."
         },
         {
           "name": "expand-tooltip",
-          "docs": "Used to set the tooltip for the expand toggle."
+          "docs": "Used to set the `calcite-tooltip` for the expand toggle."
         }
       ],
       "parts": [],
@@ -1579,15 +1652,15 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "title - Title of the alert (optional)"
+          "text": "title - A slot for optionally adding a title to the component."
         },
         {
           "name": "slot",
-          "text": "message - Main text of the alert"
+          "text": "message - A slot for adding main text to the component."
         },
         {
           "name": "slot",
-          "text": "link - Optional action to take from the alert (undo, try again, link to page, etc.)"
+          "text": "link - A slot for optionally adding an action to take from the alert (undo, try again, link to page, etc.)"
         }
       ],
       "usage": {
@@ -1600,7 +1673,7 @@
           "mutable": true,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "Is the alert currently active or not",
+          "docs": "When true, the component is active.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -1617,7 +1690,7 @@
           "mutable": false,
           "attr": "auto-dismiss",
           "reflectToAttr": false,
-          "docs": "Close the alert automatically (recommended for passive, non-blocking alerts)",
+          "docs": "When true, the component closes automatically (recommended for passive, non-blocking alerts).",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -1634,7 +1707,7 @@
           "mutable": false,
           "attr": "auto-dismiss-duration",
           "reflectToAttr": true,
-          "docs": "Duration of autoDismiss (only used with `autoDismiss`)",
+          "docs": "Specifies the duration before the component automatically closes (only use with `autoDismiss`).",
           "docsTags": [],
           "default": "this.autoDismiss ? \"medium\" : null",
           "values": [
@@ -1660,7 +1733,7 @@
           "mutable": false,
           "attr": "color",
           "reflectToAttr": true,
-          "docs": "Color for the alert (will apply to top border and icon)",
+          "docs": "Specifies the color for the component (will apply to top border and icon).",
           "docsTags": [],
           "default": "\"blue\"",
           "values": [
@@ -1690,7 +1763,7 @@
           "mutable": false,
           "attr": "icon",
           "reflectToAttr": true,
-          "docs": "when used as a boolean set to true, show a default recommended icon. You can\nalso pass a calcite-ui-icon name to this prop to display a requested icon",
+          "docs": "When true, shows a default recommended icon. Alternatively,\npass a Calcite UI Icon name to display a specific icon.",
           "docsTags": [],
           "values": [
             {
@@ -1709,7 +1782,7 @@
           "mutable": false,
           "attr": "intl-close",
           "reflectToAttr": false,
-          "docs": "string to override English close text",
+          "docs": "Specifies the text label for the close button.",
           "docsTags": [
             {
               "name": "default",
@@ -1731,7 +1804,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "Accessible name for the component",
+          "docs": "Specifies an accessible name for the component.",
           "docsTags": [],
           "values": [
             {
@@ -1747,7 +1820,7 @@
           "mutable": false,
           "attr": "placement",
           "reflectToAttr": false,
-          "docs": "specify the placement of the alert",
+          "docs": "Specifies the placement of the component",
           "docsTags": [],
           "default": "\"bottom\"",
           "values": [
@@ -1785,7 +1858,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of the alert, defaults to m",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -1820,22 +1893,40 @@
         }
       ],
       "events": [
+        {
+          "event": "calciteAlertBeforeClose",
+          "detail": "{ el: HTMLCalciteAlertElement; queue: HTMLCalciteAlertElement[]; }",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "",
+          "docsTags": []
+        },
+        {
+          "event": "calciteAlertBeforeOpen",
+          "detail": "{ el: HTMLCalciteAlertElement; queue: HTMLCalciteAlertElement[]; }",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "",
+          "docsTags": []
+        },
         {
           "event": "calciteAlertClose",
-          "detail": "any",
+          "detail": "{ el: HTMLCalciteAlertElement; queue: HTMLCalciteAlertElement[]; }",
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Fired when an alert is closed",
+          "docs": "",
           "docsTags": []
         },
         {
           "event": "calciteAlertOpen",
-          "detail": "any",
+          "detail": "{ el: HTMLCalciteAlertElement; queue: HTMLCalciteAlertElement[]; }",
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Fired when an alert is opened",
+          "docs": "",
           "docsTags": []
         }
       ],
@@ -1857,21 +1948,21 @@
         {
           "name": "--calcite-alert-width",
           "annotation": "prop",
-          "docs": "the width of the alert"
+          "docs": "Specifies the width of the component."
         }
       ],
       "slots": [
         {
           "name": "link",
-          "docs": "Optional action to take from the alert (undo, try again, link to page, etc.)"
+          "docs": "A slot for optionally adding an action to take from the alert (undo, try again, link to page, etc.)"
         },
         {
           "name": "message",
-          "docs": "Main text of the alert"
+          "docs": "A slot for adding main text to the component."
         },
         {
           "name": "title",
-          "docs": "Title of the alert (optional)"
+          "docs": "A slot for optionally adding a title to the component."
         }
       ],
       "parts": [],
@@ -1907,7 +1998,7 @@
           "mutable": false,
           "attr": "full-name",
           "reflectToAttr": false,
-          "docs": "full name of the user",
+          "docs": "Specifies the full name of the user.",
           "docsTags": [],
           "values": [
             {
@@ -1923,7 +2014,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of the avatar, defaults to m",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -1949,7 +2040,7 @@
           "mutable": false,
           "attr": "thumbnail",
           "reflectToAttr": false,
-          "docs": "src to an image (remember to add a token if the user is private)",
+          "docs": "Specifies the `src` to an image (remember to add a token if the user is private).",
           "docsTags": [],
           "values": [
             {
@@ -1965,7 +2056,7 @@
           "mutable": false,
           "attr": "user-id",
           "reflectToAttr": false,
-          "docs": "unique id for user",
+          "docs": "Specifies the unique id of the user.",
           "docsTags": [],
           "values": [
             {
@@ -1981,7 +2072,7 @@
           "mutable": false,
           "attr": "username",
           "reflectToAttr": false,
-          "docs": "user name",
+          "docs": "Specifies the username of the user.",
           "docsTags": [],
           "values": [
             {
@@ -2057,6 +2148,39 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "description",
+          "type": "string",
+          "mutable": false,
+          "attr": "description",
+          "reflectToAttr": false,
+          "docs": "Block description",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "disablePadding",
+          "type": "boolean",
+          "mutable": false,
+          "attr": "disable-padding",
+          "reflectToAttr": false,
+          "docs": "When true, removes padding for the slotted content",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "disabled",
           "type": "boolean",
@@ -2298,7 +2422,13 @@
           "attr": "summary",
           "reflectToAttr": false,
           "docs": "Block summary.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use description instead"
+            }
+          ],
+          "deprecation": "use description instead",
           "values": [
             {
               "type": "string"
@@ -3504,6 +3634,23 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "closed",
+          "type": "boolean",
+          "mutable": true,
+          "attr": "closed",
+          "reflectToAttr": true,
+          "docs": "When true, hides the chip",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "color",
           "type": "\"blue\" | \"green\" | \"grey\" | \"red\" | \"yellow\"",
@@ -4321,6 +4468,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "numberingSystem",
+          "type": "string",
+          "mutable": false,
+          "attr": "numbering-system",
+          "reflectToAttr": false,
+          "docs": "standard UniCode numeral system tag for localization",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "scale",
           "type": "\"l\" | \"m\" | \"s\"",
@@ -4565,6 +4728,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "numberingSystem",
+          "type": "string",
+          "mutable": false,
+          "attr": "numbering-system",
+          "reflectToAttr": false,
+          "docs": "standard UniCode numeral system tag for localization",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "scale",
           "type": "\"l\" | \"m\" | \"s\"",
@@ -4782,9 +4961,15 @@
           "mutable": true,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "Opens or closes the combobox",
-          "docsTags": [],
+          "docs": "When true, opens the combobox",
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use open instead"
+            }
+          ],
           "default": "false",
+          "deprecation": "use open instead",
           "values": [
             {
               "type": "boolean"
@@ -4912,6 +5097,23 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "open",
+          "type": "boolean",
+          "mutable": true,
+          "attr": "open",
+          "reflectToAttr": true,
+          "docs": "When true, opens the combobox",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "overlayPositioning",
           "type": "\"absolute\" | \"fixed\"",
@@ -4950,6 +5152,22 @@
           "optional": true,
           "required": false
         },
+        {
+          "name": "placeholderIcon",
+          "type": "string",
+          "mutable": false,
+          "attr": "placeholder-icon",
+          "reflectToAttr": false,
+          "docs": "Placeholder icon for input",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "scale",
           "type": "\"l\" | \"m\" | \"s\"",
@@ -5048,6 +5266,24 @@
         }
       ],
       "events": [
+        {
+          "event": "calciteComboboxBeforeClose",
+          "detail": "{ el: HTMLCalciteComboboxElement; }",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "",
+          "docsTags": []
+        },
+        {
+          "event": "calciteComboboxBeforeOpen",
+          "detail": "{ el: HTMLCalciteComboboxElement; }",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "",
+          "docsTags": []
+        },
         {
           "event": "calciteComboboxChange",
           "detail": "{ selectedItems: HTMLCalciteComboboxItemElement[]; }",
@@ -5066,6 +5302,15 @@
           "docs": "Called when a selected item in the combobox is dismissed via its chip",
           "docsTags": []
         },
+        {
+          "event": "calciteComboboxClose",
+          "detail": "{ el: HTMLCalciteComboboxElement; }",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "",
+          "docsTags": []
+        },
         {
           "event": "calciteComboboxFilterChange",
           "detail": "{ visibleItems: HTMLCalciteComboboxItemElement[]; text: string; }",
@@ -5075,6 +5320,15 @@
           "docs": "Called when the user has entered text to filter the options list",
           "docsTags": []
         },
+        {
+          "event": "calciteComboboxOpen",
+          "detail": "{ el: HTMLCalciteComboboxElement; }",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "",
+          "docsTags": []
+        },
         {
           "event": "calciteLookupChange",
           "detail": "HTMLCalciteComboboxItemElement[]",
@@ -5186,7 +5440,13 @@
           "attr": "constant",
           "reflectToAttr": true,
           "docs": "Don't filter this item based on the search text",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use filterDisabled instead"
+            }
+          ],
+          "deprecation": "use filterDisabled instead",
           "values": [
             {
               "type": "boolean"
@@ -5212,6 +5472,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "filterDisabled",
+          "type": "boolean",
+          "mutable": false,
+          "attr": "filter-disabled",
+          "reflectToAttr": false,
+          "docs": "Do not filter this item based on the search text",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "guid",
           "type": "string",
@@ -6580,8 +6856,14 @@
           "attr": "active",
           "reflectToAttr": true,
           "docs": "Opens or closes the dropdown",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use open instead."
+            }
+          ],
           "default": "false",
+          "deprecation": "use open instead.",
           "values": [
             {
               "type": "boolean"
@@ -6647,10 +6929,27 @@
           "reflectToAttr": false,
           "docs": "specify the maximum number of calcite-dropdown-items to display before showing the scroller, must be greater than 0 -\nthis value does not include groupTitles passed to calcite-dropdown-group",
           "docsTags": [],
-          "default": "0",
+          "default": "0",
+          "values": [
+            {
+              "type": "number"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "open",
+          "type": "boolean",
+          "mutable": true,
+          "attr": "open",
+          "reflectToAttr": true,
+          "docs": "When true, opens the dropdown",
+          "docsTags": [],
+          "default": "false",
           "values": [
             {
-              "type": "number"
+              "type": "boolean"
             }
           ],
           "optional": false,
@@ -6845,22 +7144,40 @@
         }
       ],
       "events": [
+        {
+          "event": "calciteDropdownBeforeClose",
+          "detail": "{ el: HTMLCalciteDropdownElement; }",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "",
+          "docsTags": []
+        },
+        {
+          "event": "calciteDropdownBeforeOpen",
+          "detail": "{ el: HTMLCalciteDropdownElement; }",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "",
+          "docsTags": []
+        },
         {
           "event": "calciteDropdownClose",
-          "detail": "void",
+          "detail": "{ el: HTMLCalciteDropdownElement; }",
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "fires when a dropdown has been closed",
+          "docs": "",
           "docsTags": []
         },
         {
           "event": "calciteDropdownOpen",
-          "detail": "void",
+          "detail": "{ el: HTMLCalciteDropdownElement; }",
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "fires when a dropdown has been opened",
+          "docs": "",
           "docsTags": []
         },
         {
@@ -8419,7 +8736,7 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "action - A slot for positioning a button next to an input"
+          "text": "action - A slot for positioning a button next to the component."
         }
       ],
       "usage": {
@@ -8436,7 +8753,7 @@
           "mutable": false,
           "attr": "alignment",
           "reflectToAttr": true,
-          "docs": "specify the alignment of the value of the input",
+          "docs": "Specifies the text alignment of the component's value.",
           "docsTags": [],
           "default": "\"start\"",
           "values": [
@@ -8458,8 +8775,13 @@
           "mutable": false,
           "attr": "autofocus",
           "reflectToAttr": false,
-          "docs": "should the input autofocus",
-          "docsTags": [],
+          "docs": "When true, the component is focused on page load.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[autofocus](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autofocus)"
+            }
+          ],
           "default": "false",
           "values": [
             {
@@ -8475,7 +8797,7 @@
           "mutable": false,
           "attr": "clearable",
           "reflectToAttr": true,
-          "docs": "optionally display a clear button that displays when field has a value\nshows by default for search, time, date\nwill not display for type=\"textarea\"",
+          "docs": "When true, a clear button is displayed when the component has a value. The clear button shows by default for \"search\", \"time\", and \"date\" types, and will not display for the \"textarea\" type.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8492,8 +8814,13 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "is the input disabled",
-          "docsTags": [],
+          "docs": "When true, interaction is prevented and the component is displayed with lower opacity.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[disabled](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/disabled)"
+            }
+          ],
           "default": "false",
           "values": [
             {
@@ -8509,7 +8836,7 @@
           "mutable": false,
           "attr": "group-separator",
           "reflectToAttr": false,
-          "docs": "for number values, displays the locale's group separator",
+          "docs": "When true, number values are displayed with the locale's group separator.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8526,8 +8853,13 @@
           "mutable": false,
           "attr": "hidden",
           "reflectToAttr": false,
-          "docs": "when true, the component will not be visible",
-          "docsTags": [],
+          "docs": "When true, the component will not be visible.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[hidden](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/hidden)"
+            }
+          ],
           "default": "false",
           "values": [
             {
@@ -8543,7 +8875,7 @@
           "mutable": false,
           "attr": "icon",
           "reflectToAttr": true,
-          "docs": "when used as a boolean set to true, show a default recommended icon for certain\ninput types (tel, password, email, date, time, search). You can also pass a\ncalcite-ui-icon name to this prop to display a requested icon for any input type",
+          "docs": "When true, shows a default recommended icon. Alternatively, pass a Calcite UI Icon name to display a specific icon.",
           "docsTags": [],
           "values": [
             {
@@ -8562,7 +8894,7 @@
           "mutable": false,
           "attr": "icon-flip-rtl",
           "reflectToAttr": true,
-          "docs": "flip the icon in rtl",
+          "docs": "When true, the icon is flipped in RTL.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8595,7 +8927,7 @@
           "mutable": false,
           "attr": "intl-loading",
           "reflectToAttr": false,
-          "docs": "string to override English loading text",
+          "docs": "Accessible name that will appear while loading.",
           "docsTags": [
             {
               "name": "default",
@@ -8617,7 +8949,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "Applies to the aria-label attribute on the button or hyperlink",
+          "docs": "Accessible name for the component's button or hyperlink.",
           "docsTags": [],
           "values": [
             {
@@ -8633,7 +8965,7 @@
           "mutable": false,
           "attr": "loading",
           "reflectToAttr": true,
-          "docs": "specify if the input is in loading state",
+          "docs": "When true, the component is in the loading state and `calcite-progress` is displayed.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8650,7 +8982,7 @@
           "mutable": false,
           "attr": "locale",
           "reflectToAttr": false,
-          "docs": "BCP 47 language tag for desired language and country format",
+          "docs": "Specifies the BCP 47 language tag for the desired language and country format.",
           "docsTags": [],
           "default": "document.documentElement.lang || \"en\"",
           "values": [
@@ -8667,8 +8999,13 @@
           "mutable": false,
           "attr": "max",
           "reflectToAttr": true,
-          "docs": "input max",
-          "docsTags": [],
+          "docs": "Specifies the maximum value for type \"number\".",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[max](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#max)"
+            }
+          ],
           "values": [
             {
               "type": "number"
@@ -8683,8 +9020,13 @@
           "mutable": false,
           "attr": "max-length",
           "reflectToAttr": true,
-          "docs": "Maximum length of the input value",
-          "docsTags": [],
+          "docs": "Specifies the maximum length of text for the component's value.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[maxlength](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength)"
+            }
+          ],
           "values": [
             {
               "type": "number"
@@ -8699,7 +9041,7 @@
           "mutable": false,
           "attr": "maxlength",
           "reflectToAttr": true,
-          "docs": "Maximum length of text input.",
+          "docs": "Specifies the maximum length of text for the component's value.",
           "docsTags": [
             {
               "name": "deprecated",
@@ -8721,8 +9063,13 @@
           "mutable": false,
           "attr": "min",
           "reflectToAttr": true,
-          "docs": "input min",
-          "docsTags": [],
+          "docs": "Specifies the minimum value for type \"number\".",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[min](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#min)"
+            }
+          ],
           "values": [
             {
               "type": "number"
@@ -8737,8 +9084,13 @@
           "mutable": false,
           "attr": "min-length",
           "reflectToAttr": true,
-          "docs": "Minimum length of the text input",
-          "docsTags": [],
+          "docs": "Specifies the minimum length of text for the component's value.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[minlength](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#minlength)"
+            }
+          ],
           "values": [
             {
               "type": "number"
@@ -8753,8 +9105,13 @@
           "mutable": false,
           "attr": "name",
           "reflectToAttr": true,
-          "docs": "The name of the input",
-          "docsTags": [],
+          "docs": "Specifies the name of the component.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[name](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name)"
+            }
+          ],
           "values": [
             {
               "type": "string"
@@ -8769,7 +9126,7 @@
           "mutable": false,
           "attr": "number-button-type",
           "reflectToAttr": true,
-          "docs": "specify the placement of the number buttons",
+          "docs": "Specifies the placement of the buttons for type \"number\".",
           "docsTags": [],
           "default": "\"vertical\"",
           "values": [
@@ -8795,8 +9152,13 @@
           "mutable": false,
           "attr": "numbering-system",
           "reflectToAttr": false,
-          "docs": "standard UniCode numeral system tag for localization",
-          "docsTags": [],
+          "docs": "Specifies the Unicode numeral system used by the component for localization.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[numberingSystem](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/numberingSystem)"
+            }
+          ],
           "values": [
             {
               "type": "string"
@@ -8811,8 +9173,13 @@
           "mutable": false,
           "attr": "placeholder",
           "reflectToAttr": false,
-          "docs": "explicitly whitelist placeholder attribute",
-          "docsTags": [],
+          "docs": "Specifies placeholder text for the component.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[placeholder](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder)"
+            }
+          ],
           "values": [
             {
               "type": "string"
@@ -8827,7 +9194,7 @@
           "mutable": false,
           "attr": "prefix-text",
           "reflectToAttr": false,
-          "docs": "optionally add prefix",
+          "docs": "Adds text to the start of the component.",
           "docsTags": [],
           "values": [
             {
@@ -8843,8 +9210,13 @@
           "mutable": false,
           "attr": "read-only",
           "reflectToAttr": false,
-          "docs": "When true, a field cannot be modified.",
-          "docsTags": [],
+          "docs": "When true, the value cannot be modified.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)"
+            }
+          ],
           "default": "false",
           "values": [
             {
@@ -8860,7 +9232,7 @@
           "mutable": false,
           "attr": "required",
           "reflectToAttr": false,
-          "docs": "is the input required",
+          "docs": "When true, the component must have a value in order for the form to submit.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8877,7 +9249,7 @@
           "mutable": true,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of the input, defaults to m",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -8903,7 +9275,7 @@
           "mutable": true,
           "attr": "status",
           "reflectToAttr": true,
-          "docs": "specify the status of the input field, determines message and icons",
+          "docs": "Specifies the status of the input field, which determines message and icons.",
           "docsTags": [],
           "default": "\"idle\"",
           "values": [
@@ -8929,8 +9301,13 @@
           "mutable": false,
           "attr": "step",
           "reflectToAttr": true,
-          "docs": "input step",
-          "docsTags": [],
+          "docs": "Specifies the granularity that the component's value must adhere to.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[step](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/step)"
+            }
+          ],
           "values": [
             {
               "value": "any",
@@ -8949,7 +9326,7 @@
           "mutable": false,
           "attr": "suffix-text",
           "reflectToAttr": false,
-          "docs": "optionally add suffix",
+          "docs": "Adds text to the end of the component.",
           "docsTags": [],
           "values": [
             {
@@ -8965,7 +9342,7 @@
           "mutable": false,
           "attr": "type",
           "reflectToAttr": true,
-          "docs": "specify the input type\n\nNote that the following types add type-specific icons by default: `date`, `email`, `password`, `search`, `tel`, `time`",
+          "docs": "Specifies the component type.\n\nNote that the following types add type-specific icons by default: \"date\", \"email\", \"password\", \"search\", \"tel\", \"time\".",
           "docsTags": [],
           "default": "\"text\"",
           "values": [
@@ -9043,7 +9420,7 @@
           "mutable": true,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "input value",
+          "docs": "The component's value.",
           "docsTags": [],
           "default": "\"\"",
           "values": [
@@ -9056,6 +9433,17 @@
         }
       ],
       "methods": [
+        {
+          "name": "selectText",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "signature": "selectText() => Promise<void>",
+          "parameters": [],
+          "docs": "Selects all text of the component's `value`.",
+          "docsTags": []
+        },
         {
           "name": "setFocus",
           "returns": {
@@ -9075,7 +9463,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "This event fires each time a new value is typed and committed.",
+          "docs": "Fires each time a new value is typed and committed.",
           "docsTags": []
         },
         {
@@ -9084,7 +9472,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "This event fires each time a new value is typed.",
+          "docs": "Fires each time a new value is typed.",
           "docsTags": []
         }
       ],
@@ -9093,7 +9481,7 @@
       "slots": [
         {
           "name": "action",
-          "docs": "A slot for positioning a button next to an input"
+          "docs": "A slot for positioning a button next to the component."
         }
       ],
       "parts": [],
@@ -10428,8 +10816,14 @@
           "attr": "disable-spacing",
           "reflectToAttr": false,
           "docs": "eliminates any space around the label",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "set the --calcite-label-margin-bottom css variable to 0 instead"
+            }
+          ],
           "default": "false",
+          "deprecation": "set the --calcite-label-margin-bottom css variable to 0 instead",
           "values": [
             {
               "type": "boolean"
@@ -10565,7 +10959,13 @@
       "methods": [],
       "events": [],
       "listeners": [],
-      "styles": [],
+      "styles": [
+        {
+          "name": "--calcite-label-margin-bottom",
+          "annotation": "prop",
+          "docs": "The bottom margin of `calcite-label`."
+        }
+      ],
       "slots": [
         {
           "name": "",
@@ -10806,7 +11206,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, prevents user interaction.",
+          "docs": "When true, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -10823,7 +11223,7 @@
           "mutable": false,
           "attr": "heading-level",
           "reflectToAttr": false,
-          "docs": "Number at which section headings should start for the list.",
+          "docs": "Specifies the number at which section headings should start.",
           "docsTags": [],
           "values": [
             {
@@ -10895,19 +11295,19 @@
         },
         {
           "name": "slot",
-          "text": "actions-start - A slot for adding actionable `calcite-action` elements before the content of the list item."
+          "text": "actions-start - A slot for adding actionable `calcite-action` elements before the content of the component."
         },
         {
           "name": "slot",
-          "text": "content-start - A slot for adding non-actionable elements before the label and description of the list item."
+          "text": "content-start - A slot for adding non-actionable elements before the label and description of the component."
         },
         {
           "name": "slot",
-          "text": "content-end - A slot for adding non-actionable elements after the label and description of the list item."
+          "text": "content-end - A slot for adding non-actionable elements after the label and description of the component."
         },
         {
           "name": "slot",
-          "text": "actions-end - A slot for adding actionable `calcite-action` elements after the content of the list item."
+          "text": "actions-end - A slot for adding actionable `calcite-action` elements after the content of the component."
         }
       ],
       "usage": {},
@@ -10918,14 +11318,14 @@
           "mutable": false,
           "attr": "description",
           "reflectToAttr": false,
-          "docs": "An optional description for the list item. Displays below the label text.",
+          "docs": "A description for the component. Displays below the label text.",
           "docsTags": [],
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": false,
+          "optional": true,
           "required": false
         },
         {
@@ -10934,7 +11334,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, prevents user interaction.",
+          "docs": "When true, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -10951,7 +11351,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "The label text of the list item. Displays above the description text.",
+          "docs": "The label text of the component. Displays above the description text.",
           "docsTags": [],
           "values": [
             {
@@ -10967,7 +11367,7 @@
           "mutable": false,
           "attr": "non-interactive",
           "reflectToAttr": true,
-          "docs": "When true, prevents the content of the list item from user interaction.",
+          "docs": "When true, prevents the content of the component from user interaction.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11002,19 +11402,19 @@
         },
         {
           "name": "actions-end",
-          "docs": "A slot for adding actionable `calcite-action` elements after the content of the list item."
+          "docs": "A slot for adding actionable `calcite-action` elements after the content of the component."
         },
         {
           "name": "actions-start",
-          "docs": "A slot for adding actionable `calcite-action` elements before the content of the list item."
+          "docs": "A slot for adding actionable `calcite-action` elements before the content of the component."
         },
         {
           "name": "content-end",
-          "docs": "A slot for adding non-actionable elements after the label and description of the list item."
+          "docs": "A slot for adding non-actionable elements after the label and description of the component."
         },
         {
           "name": "content-start",
-          "docs": "A slot for adding non-actionable elements before the label and description of the list item."
+          "docs": "A slot for adding non-actionable elements before the label and description of the component."
         }
       ],
       "parts": [],
@@ -11042,7 +11442,7 @@
           "mutable": false,
           "attr": "heading",
           "reflectToAttr": true,
-          "docs": "The title for all nested `calcite-list-item` rows.",
+          "docs": "The header text for all nested `calcite-list-item` rows.",
           "docsTags": [],
           "values": [
             {
@@ -11058,7 +11458,7 @@
           "mutable": false,
           "attr": "heading-level",
           "reflectToAttr": false,
-          "docs": "Number at which section headings should start for the group.",
+          "docs": "Specifies the number at which section headings should start.",
           "docsTags": [],
           "values": [
             {
@@ -11124,7 +11524,7 @@
           "mutable": false,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "When true, the loader is active.",
+          "docs": "When true, the component is active.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11158,7 +11558,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "Accessible name for the loader.",
+          "docs": "Accessible name for the component.",
           "docsTags": [],
           "values": [
             {
@@ -11174,7 +11574,7 @@
           "mutable": false,
           "attr": "no-padding",
           "reflectToAttr": false,
-          "docs": "Disables spacing around the loader.",
+          "docs": "Disables spacing around the component.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11191,7 +11591,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "Specify the scale of the loader.",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -11217,7 +11617,7 @@
           "mutable": false,
           "attr": "text",
           "reflectToAttr": false,
-          "docs": "Text that displays under the loading indicator.",
+          "docs": "Text that displays under the component's indicator.",
           "docsTags": [],
           "default": "\"\"",
           "values": [
@@ -11255,7 +11655,7 @@
           "mutable": false,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "Valid only for determinate indicators. Percent complete of 100.",
+          "docs": "The component's value. Valid only for determinate indicators. Percent complete of 100.",
           "docsTags": [],
           "default": "0",
           "values": [
@@ -11274,7 +11674,7 @@
         {
           "name": "--calcite-loader-font-size",
           "annotation": "prop",
-          "docs": "When type is determinate, the font-size of the loader percentage."
+          "docs": "When type is \"determinate\", the font size of the loading percentage."
         },
         {
           "name": "--calcite-loader-size",
@@ -11324,11 +11724,11 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "header - A slot for adding a `calcite-modal` header."
+          "text": "header - A slot for adding header text."
         },
         {
           "name": "slot",
-          "text": "content - A slot for adding `calcite-modal` content."
+          "text": "content - A slot for adding the component's content."
         },
         {
           "name": "slot",
@@ -11356,8 +11756,14 @@
           "attr": "active",
           "reflectToAttr": true,
           "docs": "When true, the `calcite-modal` is active.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use open instead"
+            }
+          ],
           "default": "false",
+          "deprecation": "use open instead",
           "values": [
             {
               "type": "boolean"
@@ -11372,7 +11778,7 @@
           "mutable": false,
           "attr": "background-color",
           "reflectToAttr": true,
-          "docs": "Sets the background color of `calcite-modal` content.",
+          "docs": "Sets the background color of the component's content.",
           "docsTags": [],
           "default": "\"white\"",
           "values": [
@@ -11410,7 +11816,7 @@
           "mutable": false,
           "attr": "color",
           "reflectToAttr": true,
-          "docs": "Adds a color bar to the top of `calcite-modal` for visual impact.\nUse color to add importance to destructive or workflow dialogs.",
+          "docs": "Adds a color bar to the top of component for visual impact.\nUse color to add importance to destructive or workflow dialogs.",
           "docsTags": [],
           "values": [
             {
@@ -11431,7 +11837,7 @@
           "mutable": false,
           "attr": "disable-close-button",
           "reflectToAttr": false,
-          "docs": "When true, disables the close button within the `calcite-modal`.",
+          "docs": "When true, disables the component's close button.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11465,7 +11871,7 @@
           "mutable": false,
           "attr": "disable-outside-close",
           "reflectToAttr": false,
-          "docs": "When true, disables the closing of the `calcite-modal` when clicked outside.",
+          "docs": "When true, disables the closing of the component when clicked outside.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11482,7 +11888,7 @@
           "mutable": false,
           "attr": "docked",
           "reflectToAttr": true,
-          "docs": "When true, prevents the `calcite-modal` from expanding to the entire screen on mobile devices.",
+          "docs": "When true, prevents the component from expanding to the entire screen on mobile devices.",
           "docsTags": [],
           "values": [
             {
@@ -11498,7 +11904,7 @@
           "mutable": false,
           "attr": "fullscreen",
           "reflectToAttr": true,
-          "docs": "Set the `calcite-modal` to always be fullscreen (overrides width).",
+          "docs": "Sets the component to always be fullscreen (overrides width).",
           "docsTags": [],
           "values": [
             {
@@ -11514,7 +11920,7 @@
           "mutable": false,
           "attr": "intl-close",
           "reflectToAttr": false,
-          "docs": "Accessible label for the close button.",
+          "docs": "Accessible name for the component's close button.",
           "docsTags": [],
           "default": "TEXT.close",
           "values": [
@@ -11542,13 +11948,30 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "open",
+          "type": "boolean",
+          "mutable": true,
+          "attr": "open",
+          "reflectToAttr": true,
+          "docs": "When true,`calcite-modal`  opens",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "scale",
           "type": "\"l\" | \"m\" | \"s\"",
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "Specify the scale of `calcite-modal`.",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -11574,7 +11997,7 @@
           "mutable": false,
           "attr": "width",
           "reflectToAttr": true,
-          "docs": "Set the width of the `calcite-modal`. Can use scale sizes or pass a number (displays in pixels).",
+          "docs": "Specifies the width of the component. Can use scale sizes or pass a number (displays in pixels).",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -11628,7 +12051,7 @@
           },
           "signature": "scrollContent(top?: number, left?: number) => Promise<void>",
           "parameters": [],
-          "docs": "Set the scroll top of the `calcite-modal` content.",
+          "docs": "Sets the scroll top of the component's content.",
           "docsTags": [
             {
               "name": "param",
@@ -11664,7 +12087,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emits when `calcite-modal` finishes the close animation.",
+          "docs": "Emits when the component finishes the close animation.",
           "docsTags": []
         },
         {
@@ -11673,7 +12096,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emits when `calcite-modal` finishes the open animation.",
+          "docs": "Emits when the component finishes the open animation.",
           "docsTags": []
         }
       ],
@@ -11689,27 +12112,27 @@
         {
           "name": "--calcite-modal-content-text",
           "annotation": "prop",
-          "docs": "The `calcite-modal` content font size."
+          "docs": "The component content's font size."
         },
         {
           "name": "--calcite-modal-padding",
           "annotation": "prop",
-          "docs": "The top/bottom padding around items in the `calcite-modal`."
+          "docs": "The top/bottom padding around items within the component."
         },
         {
           "name": "--calcite-modal-padding-large",
           "annotation": "prop",
-          "docs": "The left/right padding around items in the `calcite-modal`."
+          "docs": "The left/right padding around items within the component."
         },
         {
           "name": "--calcite-modal-title-text",
           "annotation": "prop",
-          "docs": "The `calcite-modal` title font size."
+          "docs": "The component title's font size."
         },
         {
           "name": "--calcite-scrim-background",
           "annotation": "prop",
-          "docs": "The semi-transparent background color behind the `calcite-modal`."
+          "docs": "The component's semi-transparent background color."
         }
       ],
       "slots": [
@@ -11719,11 +12142,11 @@
         },
         {
           "name": "content",
-          "docs": "A slot for adding `calcite-modal` content."
+          "docs": "A slot for adding the component's content."
         },
         {
           "name": "header",
-          "docs": "A slot for adding a `calcite-modal` header."
+          "docs": "A slot for adding header text."
         },
         {
           "name": "primary",
@@ -11759,7 +12182,7 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "title - A slot for adding the title (optional)."
+          "text": "title - A slot for adding the title."
         },
         {
           "name": "slot",
@@ -11767,11 +12190,11 @@
         },
         {
           "name": "slot",
-          "text": "link - A slot for adding actions to take, such as: undo, try again, link to page, etc. (optional)."
+          "text": "link - A slot for adding actions to take, such as: undo, try again, link to page, etc."
         },
         {
           "name": "slot",
-          "text": "actions-end - A slot for adding actions to the end of the `calcite-notice` (optional). It is recommended to use two or less actions."
+          "text": "actions-end - A slot for adding actions to the end of the component. It is recommended to use two or less actions."
         }
       ],
       "usage": {
@@ -11785,7 +12208,7 @@
           "mutable": true,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "When true, the `calcite-notice` is active.",
+          "docs": "When true, the component is active.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11802,7 +12225,7 @@
           "mutable": false,
           "attr": "color",
           "reflectToAttr": true,
-          "docs": "The color for the `calcite-notice`. Color will apply to top border and icon.",
+          "docs": "The color for the component's top border and icon.",
           "docsTags": [],
           "default": "\"blue\"",
           "values": [
@@ -11832,7 +12255,7 @@
           "mutable": false,
           "attr": "dismissible",
           "reflectToAttr": true,
-          "docs": "Shows a button the user can click to dismiss the `calcite-notice`.",
+          "docs": "When true, a close button is added to the component.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11849,7 +12272,7 @@
           "mutable": false,
           "attr": "icon",
           "reflectToAttr": true,
-          "docs": "When present, shows a default recommended icon. You can\nalso pass a calcite-ui-icon name to display a requested icon.",
+          "docs": "Specifies an icon to display - accepts Calcite UI icon names.",
           "docsTags": [],
           "values": [
             {
@@ -11868,7 +12291,7 @@
           "mutable": false,
           "attr": "intl-close",
           "reflectToAttr": false,
-          "docs": "Accessible label for the close button.",
+          "docs": "Accessible name for the close button.",
           "docsTags": [
             {
               "name": "default",
@@ -11890,7 +12313,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "Specify the scale of `calcite-notice`.",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -11916,7 +12339,7 @@
           "mutable": false,
           "attr": "width",
           "reflectToAttr": true,
-          "docs": "Specify the width of the `calcite-notice`.",
+          "docs": "Specifies the width of the component.",
           "docsTags": [],
           "default": "\"auto\"",
           "values": [
@@ -11946,7 +12369,7 @@
           },
           "signature": "setFocus() => Promise<void>",
           "parameters": [],
-          "docs": "Sets focus on the `calcite-notice`.",
+          "docs": "Sets focus on the component.",
           "docsTags": []
         }
       ],
@@ -11957,7 +12380,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Fired when `calcite-notice` is closed.",
+          "docs": "Fired when the component is closed.",
           "docsTags": []
         },
         {
@@ -11966,7 +12389,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Fired when `calcite-notice` is opened.",
+          "docs": "Fired when the component is opened.",
           "docsTags": []
         }
       ],
@@ -11975,17 +12398,17 @@
         {
           "name": "--calcite-notice-width",
           "annotation": "prop",
-          "docs": "The width of `calcite-notice`."
+          "docs": "The width of the component."
         }
       ],
       "slots": [
         {
           "name": "actions-end",
-          "docs": "A slot for adding actions to the end of the `calcite-notice` (optional). It is recommended to use two or less actions."
+          "docs": "A slot for adding actions to the end of the component. It is recommended to use two or less actions."
         },
         {
           "name": "link",
-          "docs": "A slot for adding actions to take, such as: undo, try again, link to page, etc. (optional)."
+          "docs": "A slot for adding actions to take, such as: undo, try again, link to page, etc."
         },
         {
           "name": "message",
@@ -11993,7 +12416,7 @@
         },
         {
           "name": "title",
-          "docs": "A slot for adding the title (optional)."
+          "docs": "A slot for adding the title."
         }
       ],
       "parts": [],
@@ -12022,7 +12445,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, it prevents the option from being selected.",
+          "docs": "When true, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -12039,7 +12462,7 @@
           "mutable": true,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "The option label.",
+          "docs": "Accessible name for the component.",
           "docsTags": [],
           "values": [
             {
@@ -12055,7 +12478,7 @@
           "mutable": false,
           "attr": "selected",
           "reflectToAttr": true,
-          "docs": "When true, this option is selected. Otherwise, false.",
+          "docs": "When true, the component is selected.",
           "docsTags": [],
           "values": [
             {
@@ -12071,7 +12494,7 @@
           "mutable": true,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "The value associated with this option.",
+          "docs": "The component's value.",
           "docsTags": [],
           "values": [
             {
@@ -12112,7 +12535,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, it prevents selection from any of its associated options.",
+          "docs": "When true, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -12129,7 +12552,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "The group label. This property is required.",
+          "docs": "Accessible name for the component.",
           "docsTags": [],
           "values": [
             {
@@ -12172,7 +12595,7 @@
           "mutable": false,
           "attr": "num",
           "reflectToAttr": false,
-          "docs": "number of items per page",
+          "docs": "Specifies the number of items per page.",
           "docsTags": [],
           "default": "20",
           "values": [
@@ -12189,7 +12612,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "The scale of the pagination",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -12215,7 +12638,7 @@
           "mutable": true,
           "attr": "start",
           "reflectToAttr": false,
-          "docs": "index of item that should begin the page",
+          "docs": "Specifies the starting item number.",
           "docsTags": [],
           "default": "1",
           "values": [
@@ -12232,7 +12655,7 @@
           "mutable": false,
           "attr": "text-label-next",
           "reflectToAttr": false,
-          "docs": "Used as an accessible label (aria-label) for the next button",
+          "docs": "Accessible name for the component's next button.",
           "docsTags": [
             {
               "name": "default",
@@ -12254,7 +12677,7 @@
           "mutable": false,
           "attr": "text-label-previous",
           "reflectToAttr": false,
-          "docs": "Used as an accessible label (aria-label) of the previous button",
+          "docs": "Accessible name for the component's previous button.",
           "docsTags": [
             {
               "name": "default",
@@ -12276,7 +12699,7 @@
           "mutable": false,
           "attr": "total",
           "reflectToAttr": false,
-          "docs": "total number of items",
+          "docs": "Specifies the total number of items.",
           "docsTags": [],
           "default": "0",
           "values": [
@@ -12297,7 +12720,7 @@
           },
           "signature": "nextPage() => Promise<void>",
           "parameters": [],
-          "docs": "Go to the next page of results",
+          "docs": "Go to the next page of results.",
           "docsTags": []
         },
         {
@@ -12308,7 +12731,7 @@
           },
           "signature": "previousPage() => Promise<void>",
           "parameters": [],
-          "docs": "Go to the previous page of results",
+          "docs": "Go to the previous page of results.",
           "docsTags": []
         }
       ],
@@ -12319,11 +12742,11 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted whenever the selected page changes.",
+          "docs": "Emits when the selected page changes.",
           "docsTags": [
             {
               "name": "see",
-              "text": "[PaginationDetail](https://github.com/Esri/calcite-components/blob/master/src/components/pagination/calcite-pagination.tsx#L18)"
+              "text": "[PaginationDetail](https://github.com/Esri/calcite-components/blob/master/src/components/pagination/pagination.tsx#L23)"
             }
           ]
         },
@@ -12333,7 +12756,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted whenever the selected page changes.",
+          "docs": "Emits when the selected page changes.",
           "docsTags": [
             {
               "name": "deprecated",
@@ -12348,7 +12771,7 @@
         {
           "name": "--calcite-pagination-spacing",
           "annotation": "prop",
-          "docs": "the amount of padding around each pagination item"
+          "docs": "The amount of padding around each pagination item."
         }
       ],
       "slots": [],
@@ -12376,11 +12799,11 @@
         },
         {
           "name": "slot",
-          "text": "header-actions-start - A slot for adding actions or content to the start side of the panel header."
+          "text": "header-actions-start - A slot for adding actions or content to the start side of the header."
         },
         {
           "name": "slot",
-          "text": "header-actions-end - A slot for adding actions or content to the end side of the panel header."
+          "text": "header-actions-end - A slot for adding actions or content to the end side of the header."
         },
         {
           "name": "slot",
@@ -12388,7 +12811,7 @@
         },
         {
           "name": "slot",
-          "text": "header-menu-actions - A slot for adding an overflow menu with actions inside a dropdown."
+          "text": "header-menu-actions - A slot for adding an overflow menu with actions inside a `calcite-dropdown`."
         },
         {
           "name": "slot",
@@ -12425,13 +12848,29 @@
           "optional": true,
           "required": false
         },
+        {
+          "name": "description",
+          "type": "string",
+          "mutable": false,
+          "attr": "description",
+          "reflectToAttr": false,
+          "docs": "A description for the component.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "disabled",
           "type": "boolean",
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, disabled prevents interaction. This state shows items with lower opacity/grayed.",
+          "docs": "When true, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -12448,7 +12887,7 @@
           "mutable": true,
           "attr": "dismissed",
           "reflectToAttr": true,
-          "docs": "Hides the panel.",
+          "docs": "When true, hides the component.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -12465,7 +12904,7 @@
           "mutable": false,
           "attr": "dismissible",
           "reflectToAttr": true,
-          "docs": "Displays a close button in the trailing side of the header.",
+          "docs": "When true, a close button is added to the component.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -12482,7 +12921,7 @@
           "mutable": false,
           "attr": "heading",
           "reflectToAttr": false,
-          "docs": "Heading text.",
+          "docs": "The component header text.",
           "docsTags": [],
           "values": [
             {
@@ -12498,7 +12937,7 @@
           "mutable": false,
           "attr": "heading-level",
           "reflectToAttr": false,
-          "docs": "Number at which section headings should start for this component.",
+          "docs": "Specifies the number at which section headings should start.",
           "docsTags": [],
           "values": [
             {
@@ -12535,7 +12974,7 @@
           "mutable": false,
           "attr": "height-scale",
           "reflectToAttr": true,
-          "docs": "Specifies the maximum height of the panel.",
+          "docs": "Specifies the maximum height of the component.",
           "docsTags": [],
           "values": [
             {
@@ -12560,7 +12999,7 @@
           "mutable": false,
           "attr": "intl-back",
           "reflectToAttr": false,
-          "docs": "'Back' text string.",
+          "docs": "Accessible name for the component's back button. The back button will only be shown when 'showBackButton' is true.",
           "docsTags": [],
           "values": [
             {
@@ -12576,7 +13015,7 @@
           "mutable": false,
           "attr": "intl-close",
           "reflectToAttr": false,
-          "docs": "'Close' text string for the close button. The close button will only be shown when 'dismissible' is true.",
+          "docs": "Accessible name for the component's close button. The close button will only be shown when 'dismissible' is true.",
           "docsTags": [],
           "values": [
             {
@@ -12592,7 +13031,7 @@
           "mutable": false,
           "attr": "intl-options",
           "reflectToAttr": false,
-          "docs": "'Options' text string for the actions menu.",
+          "docs": "Accessible name for the component's actions menu.",
           "docsTags": [],
           "values": [
             {
@@ -12608,7 +13047,7 @@
           "mutable": false,
           "attr": "loading",
           "reflectToAttr": true,
-          "docs": "When true, content is waiting to be loaded. This state shows a busy indicator.",
+          "docs": "When true, a busy indicator is displayed.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -12625,7 +13064,7 @@
           "mutable": false,
           "attr": "menu-open",
           "reflectToAttr": true,
-          "docs": "Opens the action menu.",
+          "docs": "When true, the action menu items in the `header-menu-actions` slot are open.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -12642,7 +13081,7 @@
           "mutable": false,
           "attr": "show-back-button",
           "reflectToAttr": true,
-          "docs": "Shows a back button in the header.",
+          "docs": "When true, displays a back button in the header.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -12660,7 +13099,13 @@
           "attr": "summary",
           "reflectToAttr": false,
           "docs": "Summary text. A description displayed underneath the heading.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use description instead"
+            }
+          ],
+          "deprecation": "use description instead",
           "values": [
             {
               "type": "string"
@@ -12675,7 +13120,7 @@
           "mutable": false,
           "attr": "width-scale",
           "reflectToAttr": true,
-          "docs": "This sets width of the panel.",
+          "docs": "Specifies the width of the component.",
           "docsTags": [],
           "values": [
             {
@@ -12704,7 +13149,7 @@
           },
           "signature": "scrollContentTo(options?: ScrollToOptions) => Promise<void>",
           "parameters": [],
-          "docs": "Scrolls panel content to a particular set of coordinates.\n\n```\n  myCalcitePanel.scrollContentTo({\n    left: 0, // Specifies the number of pixels along the X axis to scroll the window or element.\n    top: 0, // Specifies the number of pixels along the Y axis to scroll the window or element\n    behavior: \"auto\" // Specifies whether the scrolling should animate smoothly (smooth), or happen instantly in a single jump (auto, the default value).\n  });\n```",
+          "docs": "Scrolls the component's content to a specified set of coordinates.\n\n```\n  myCalcitePanel.scrollContentTo({\n    left: 0, // Specifies the number of pixels along the X axis to scroll the window or element.\n    top: 0, // Specifies the number of pixels along the Y axis to scroll the window or element\n    behavior: \"auto\" // Specifies whether the scrolling should animate smoothly (smooth), or happen instantly in a single jump (auto, the default value).\n  });\n```",
           "docsTags": [
             {
               "name": "param",
@@ -12736,7 +13181,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when the back button has been clicked.",
+          "docs": "Fires when the back button is clicked.",
           "docsTags": []
         },
         {
@@ -12745,7 +13190,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when the close button has been clicked.",
+          "docs": "Fires when the close button is clicked.",
           "docsTags": []
         },
         {
@@ -12754,7 +13199,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when the close button has been clicked.",
+          "docs": "Fires when the close button is clicked.",
           "docsTags": [
             {
               "name": "deprecated",
@@ -12769,7 +13214,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when the content has been scrolled.",
+          "docs": "Fires when the content is scrolled.",
           "docsTags": []
         }
       ],
@@ -12778,17 +13223,17 @@
         {
           "name": "--calcite-panel-max-height",
           "annotation": "prop",
-          "docs": "the maximum height of the panel"
+          "docs": "The maximum height of the component."
         },
         {
           "name": "--calcite-panel-max-width",
           "annotation": "prop",
-          "docs": "the maximum width of the panel"
+          "docs": "The maximum width of the component."
         },
         {
           "name": "--calcite-panel-min-width",
           "annotation": "prop",
-          "docs": "the minimum width of the panel"
+          "docs": "The minimum width of the component."
         }
       ],
       "slots": [
@@ -12810,11 +13255,11 @@
         },
         {
           "name": "header-actions-end",
-          "docs": "A slot for adding actions or content to the end side of the panel header."
+          "docs": "A slot for adding actions or content to the end side of the header."
         },
         {
           "name": "header-actions-start",
-          "docs": "A slot for adding actions or content to the start side of the panel header."
+          "docs": "A slot for adding actions or content to the start side of the header."
         },
         {
           "name": "header-content",
@@ -12822,7 +13267,7 @@
         },
         {
           "name": "header-menu-actions",
-          "docs": "A slot for adding an overflow menu with actions inside a dropdown."
+          "docs": "A slot for adding an overflow menu with actions inside a `calcite-dropdown`."
         }
       ],
       "parts": [],
@@ -12864,11 +13309,11 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "- A slot for adding `calcite-pick-list-item` elements or `calcite-pick-list-group` elements. Items are displayed as a vertical list."
+          "text": "- A slot for adding `calcite-pick-list-item` or `calcite-pick-list-group` elements. Items are displayed as a vertical list."
         },
         {
           "name": "slot",
-          "text": "menu-actions - A slot for adding a button + menu combo for performing actions like sorting."
+          "text": "menu-actions - A slot for adding a button and menu combination for performing actions, such as sorting."
         }
       ],
       "usage": {
@@ -12883,7 +13328,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, disabled prevents interaction. This state shows items with lower opacity/grayed.",
+          "docs": "When true, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -12933,7 +13378,7 @@
           "mutable": false,
           "attr": "heading-level",
           "reflectToAttr": false,
-          "docs": "Number at which section headings should start for this component.",
+          "docs": "Specifies the number at which section headings should start.",
           "docsTags": [],
           "values": [
             {
@@ -12970,7 +13415,7 @@
           "mutable": false,
           "attr": "loading",
           "reflectToAttr": true,
-          "docs": "When true, content is waiting to be loaded. This state shows a busy indicator.",
+          "docs": "When true, a busy indicator is displayed.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -12987,7 +13432,7 @@
           "mutable": false,
           "attr": "multiple",
           "reflectToAttr": true,
-          "docs": "Multiple works similar to standard radio buttons and checkboxes.\nWhen true, a user can select multiple items at a time.\nWhen false, only a single item can be selected at a time\nand selecting a new item will deselect any other selected items.",
+          "docs": "Similar to standard radio buttons and checkboxes.\nWhen true, a user can select multiple `calcite-pick-list-item`s at a time.\nWhen false, only a single `calcite-pick-list-item` can be selected at a time,\nand a new selection will deselect previous selections.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -13004,7 +13449,7 @@
           "mutable": false,
           "attr": "selection-follows-focus",
           "reflectToAttr": false,
-          "docs": "When true and single-selection is enabled, the selection will change when navigating items via the keyboard.",
+          "docs": "When true and single-selection is enabled, the selection changes when navigating `calcite-pick-list-item`s via keyboard.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -13025,7 +13470,7 @@
           },
           "signature": "getSelectedItems() => Promise<Map<string, HTMLCalcitePickListItemElement>>",
           "parameters": [],
-          "docs": "Returns the currently selected items",
+          "docs": "Returns the component's selected `calcite-pick-list-item`s.",
           "docsTags": []
         },
         {
@@ -13052,7 +13497,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when any of the item selections have changed.",
+          "docs": "Emits when any of the `calcite-pick-list-item` selections have changed.",
           "docsTags": []
         }
       ],
@@ -13087,11 +13532,11 @@
       "slots": [
         {
           "name": "",
-          "docs": "A slot for adding `calcite-pick-list-item` elements or `calcite-pick-list-group` elements. Items are displayed as a vertical list."
+          "docs": "A slot for adding `calcite-pick-list-item` or `calcite-pick-list-group` elements. Items are displayed as a vertical list."
         },
         {
           "name": "menu-actions",
-          "docs": "A slot for adding a button + menu combo for performing actions like sorting."
+          "docs": "A slot for adding a button and menu combination for performing actions, such as sorting."
         }
       ],
       "parts": [],
@@ -13137,7 +13582,7 @@
           "mutable": false,
           "attr": "group-title",
           "reflectToAttr": true,
-          "docs": "The title used for all nested `calcite-pick-list` rows.",
+          "docs": "Specifies the title for all nested `calcite-pick-list-item`s.",
           "docsTags": [],
           "values": [
             {
@@ -13153,7 +13598,7 @@
           "mutable": false,
           "attr": "heading-level",
           "reflectToAttr": false,
-          "docs": "Number at which section headings should start for this component.",
+          "docs": "Specifies the number at which section headings should start.",
           "docsTags": [],
           "values": [
             {
@@ -13209,11 +13654,11 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "actions-end - a slot for adding actions or content to the end side of the item."
+          "text": "actions-end - A slot for adding actions or content to the end side of the component."
         },
         {
           "name": "slot",
-          "text": "actions-start - a slot for adding actions or content to the start side of the item."
+          "text": "actions-start - A slot for adding actions or content to the start side of the component."
         }
       ],
       "usage": {},
@@ -13224,7 +13669,7 @@
           "mutable": false,
           "attr": "description",
           "reflectToAttr": true,
-          "docs": "An optional description for this item.  This will appear below the label text.",
+          "docs": "A description for the component that displays below the label text.",
           "docsTags": [],
           "values": [
             {
@@ -13240,7 +13685,7 @@
           "mutable": false,
           "attr": "disable-deselect",
           "reflectToAttr": false,
-          "docs": "When false, the item cannot be deselected by user interaction.",
+          "docs": "When false, the component cannot be deselected by user interaction.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -13257,7 +13702,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, the item cannot be clicked and is visually muted.",
+          "docs": "When true, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -13302,7 +13747,7 @@
           "mutable": false,
           "attr": "intl-remove",
           "reflectToAttr": true,
-          "docs": "Used as an accessible label (aria-label) for the \"remove item\" action. Only applicable if removable is true.",
+          "docs": "Accessible name for the component's remove button. Only applicable if removable is \"true\".",
           "docsTags": [
             {
               "name": "default",
@@ -13324,7 +13769,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": true,
-          "docs": "The main label for this item. This will appear next to the icon.",
+          "docs": "Label and accessible name for the component. Appears next to the icon.",
           "docsTags": [],
           "values": [
             {
@@ -13339,7 +13784,7 @@
           "type": "{ [x: string]: unknown; }",
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Used to provide additional metadata to an item, primarily used when the parent list has a filter.",
+          "docs": "Provides additional metadata to the component. Primary use is for a filter on the parent list.",
           "docsTags": [],
           "values": [
             {
@@ -13355,7 +13800,7 @@
           "mutable": false,
           "attr": "removable",
           "reflectToAttr": true,
-          "docs": "Set this to true to display a remove action that removes the item from the list.",
+          "docs": "When true, displays a remove action that removes the item from the list.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -13372,7 +13817,7 @@
           "mutable": true,
           "attr": "selected",
           "reflectToAttr": true,
-          "docs": "Set this to true to pre-select an item. Toggles when an item is checked/unchecked.",
+          "docs": "When true, selects an item. Toggles when an item is checked/unchecked.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -13389,7 +13834,7 @@
           "mutable": false,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "The item's associated value.",
+          "docs": "The component's value.",
           "docsTags": [],
           "values": [
             {
@@ -13420,7 +13865,7 @@
           },
           "signature": "toggleSelected(coerce?: boolean) => Promise<void>",
           "parameters": [],
-          "docs": "Used to toggle the selection state. By default this won't trigger an event.\nThe first argument allows the value to be coerced, rather than swapping values.",
+          "docs": "Toggles the selection state. By default this won't trigger an event.\nThe first argument allows the value to be coerced, rather than swapping values.",
           "docsTags": [
             {
               "name": "param",
@@ -13436,7 +13881,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted whenever the item is selected or unselected.",
+          "docs": "Fires when the component is selected or unselected.",
           "docsTags": []
         },
         {
@@ -13445,7 +13890,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted whenever the remove button is pressed.",
+          "docs": "Fires when the remove button is pressed.",
           "docsTags": []
         }
       ],
@@ -13454,11 +13899,11 @@
       "slots": [
         {
           "name": "actions-end",
-          "docs": "a slot for adding actions or content to the end side of the item."
+          "docs": "A slot for adding actions or content to the end side of the component."
         },
         {
           "name": "actions-start",
-          "docs": "a slot for adding actions or content to the start side of the item."
+          "docs": "A slot for adding actions or content to the start side of the component."
         }
       ],
       "parts": [],
@@ -13506,7 +13951,7 @@
           "mutable": false,
           "attr": "auto-close",
           "reflectToAttr": true,
-          "docs": "Automatically closes any currently open popovers when clicking outside of a popover.",
+          "docs": "When true and clicking outside of the component, automatically closes open `calcite-popover`s.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -13523,7 +13968,7 @@
           "mutable": false,
           "attr": "close-button",
           "reflectToAttr": true,
-          "docs": "Display a close button within the Popover.",
+          "docs": "When true, a close button is added to the component.",
           "docsTags": [
             {
               "name": "deprecated",
@@ -13546,7 +13991,7 @@
           "mutable": false,
           "attr": "disable-flip",
           "reflectToAttr": true,
-          "docs": "Prevents flipping the popover's placement when it starts to overlap its reference element.",
+          "docs": "When true, prevents flipping the component's placement when overlapping its `referenceElement`.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -13563,7 +14008,7 @@
           "mutable": false,
           "attr": "disable-pointer",
           "reflectToAttr": true,
-          "docs": "Removes the caret pointer.",
+          "docs": "When true, removes the caret pointer.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -13580,7 +14025,7 @@
           "mutable": false,
           "attr": "dismissible",
           "reflectToAttr": true,
-          "docs": "Display a close button within the Popover.",
+          "docs": "When true, a close button is added to the component.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -13612,7 +14057,7 @@
           "mutable": false,
           "attr": "heading",
           "reflectToAttr": false,
-          "docs": "Heading text.",
+          "docs": "The component header text.",
           "docsTags": [],
           "values": [
             {
@@ -13628,7 +14073,7 @@
           "mutable": false,
           "attr": "heading-level",
           "reflectToAttr": false,
-          "docs": "Number at which section headings should start for this component.",
+          "docs": "Specifies the number at which section headings should start.",
           "docsTags": [],
           "values": [
             {
@@ -13665,7 +14110,7 @@
           "mutable": false,
           "attr": "intl-close",
           "reflectToAttr": false,
-          "docs": "Text for close button.",
+          "docs": "Accessible name for the component's close button.",
           "docsTags": [
             {
               "name": "default",
@@ -13687,7 +14132,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "Accessible name for the component",
+          "docs": "Accessible name for the component.",
           "docsTags": [],
           "values": [
             {
@@ -13703,7 +14148,7 @@
           "mutable": false,
           "attr": "offset-distance",
           "reflectToAttr": true,
-          "docs": "Offset the position of the popover away from the reference element.",
+          "docs": "Offsets the position of the popover away from the `referenceElement`.",
           "docsTags": [
             {
               "name": "default",
@@ -13725,7 +14170,7 @@
           "mutable": false,
           "attr": "offset-skidding",
           "reflectToAttr": true,
-          "docs": "Offset the position of the popover along the reference element.",
+          "docs": "Offsets the position of the popover along the `referenceElement`.",
           "docsTags": [],
           "default": "0",
           "values": [
@@ -13742,7 +14187,7 @@
           "mutable": true,
           "attr": "open",
           "reflectToAttr": true,
-          "docs": "Display and position the component.",
+          "docs": "When true, displays and positions the component.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -13759,7 +14204,7 @@
           "mutable": false,
           "attr": "overlay-positioning",
           "reflectToAttr": false,
-          "docs": "Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value.",
+          "docs": "Describes the positioning type to use for the overlaid content. If the element is in a fixed container, use the \"fixed\" value.",
           "docsTags": [],
           "default": "\"absolute\"",
           "values": [
@@ -13781,7 +14226,7 @@
           "mutable": false,
           "attr": "placement",
           "reflectToAttr": true,
-          "docs": "Determines where the component will be positioned relative to the referenceElement.",
+          "docs": "Determines where the component will be positioned relative to the `referenceElement`.",
           "docsTags": [
             {
               "name": "see",
@@ -13809,7 +14254,7 @@
           "mutable": false,
           "attr": "reference-element",
           "reflectToAttr": false,
-          "docs": "Reference HTMLElement used to position this component according to the placement property. As a convenience, a string ID of the reference element can be used. However, setting this property to use an HTMLElement is preferred so that the component does not need to query the DOM for the referenceElement.",
+          "docs": "The `referenceElement` used to position the component according to its \"placement\" value. Setting to an `HTMLElement` is preferred so the component does not need to query the DOM. However, a string `id` of the reference element can also be used.",
           "docsTags": [],
           "values": [
             {
@@ -13834,7 +14279,7 @@
           "mutable": false,
           "attr": "trigger-disabled",
           "reflectToAttr": true,
-          "docs": "Disables automatically toggling a popover when its referenceElement has been triggered. This property can be set to true to manage when a popover is open.",
+          "docs": "When true, disables automatically toggling the component when its `referenceElement` has been triggered. This property can be set to \"true\" to manage when a popover is open.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -13882,7 +14327,7 @@
           },
           "signature": "toggle(value?: boolean) => Promise<void>",
           "parameters": [],
-          "docs": "Toggles the popover's open property.",
+          "docs": "Toggles the component's open property.",
           "docsTags": [
             {
               "name": "param",
@@ -13898,7 +14343,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Fired when the popover is closed",
+          "docs": "Fired when the component is closed.",
           "docsTags": []
         },
         {
@@ -13907,7 +14352,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Fired when the popover is opened",
+          "docs": "Fired when the component is opened.",
           "docsTags": []
         }
       ],
@@ -14036,7 +14481,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "Label for the progress indicator",
+          "docs": "Accessible name for the component.",
           "docsTags": [],
           "values": [
             {
@@ -14052,7 +14497,7 @@
           "mutable": false,
           "attr": "reversed",
           "reflectToAttr": false,
-          "docs": "For indeterminate progress bars, reverse the animation direction",
+          "docs": "When true and for indeterminate progress bars, reverses the animation direction.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -14069,7 +14514,7 @@
           "mutable": false,
           "attr": "text",
           "reflectToAttr": false,
-          "docs": "Text to display for the progress indicator",
+          "docs": "Text that displays under the component's indicator.",
           "docsTags": [],
           "values": [
             {
@@ -14085,7 +14530,7 @@
           "mutable": false,
           "attr": "type",
           "reflectToAttr": false,
-          "docs": "Use indeterminate if finding actual progress value is impossible",
+          "docs": "Use indeterminate if finding actual progress value is impossible.",
           "docsTags": [],
           "default": "\"determinate\"",
           "values": [
@@ -14107,7 +14552,7 @@
           "mutable": false,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "Fraction completed, in the range of 0 - 1.0",
+          "docs": "The component's progress value, with a range of 0.0 - 1.0.",
           "docsTags": [],
           "default": "0",
           "values": [
@@ -14630,7 +15075,11 @@
           "mutable": true,
           "reflectToAttr": false,
           "docs": "The group's selected item.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "readonly"
+            }
+          ],
           "values": [
             {
               "type": "HTMLCalciteRadioGroupItemElement"
@@ -16851,7 +17300,7 @@
         },
         {
           "name": "layout",
-          "type": "\"grid\" | \"horizontal\" | \"vertical\"",
+          "type": "\"horizontal\" | \"vertical\"",
           "mutable": false,
           "attr": "layout",
           "reflectToAttr": true,
@@ -16859,10 +17308,6 @@
           "docsTags": [],
           "default": "\"horizontal\"",
           "values": [
-            {
-              "value": "grid",
-              "type": "string"
-            },
             {
               "value": "horizontal",
               "type": "string"
@@ -16981,7 +17426,17 @@
           "docsTags": []
         }
       ],
-      "events": [],
+      "events": [
+        {
+          "event": "calciteStepperItemChange",
+          "detail": "StepperItemChangeEventDetail",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "This event fires when the active stepper item has changed.",
+          "docsTags": []
+        }
+      ],
       "listeners": [
         {
           "event": "calciteInternalStepperItemKeyEvent",
@@ -16997,6 +17452,11 @@
           "event": "calciteInternalStepperItemSelect",
           "capture": false,
           "passive": false
+        },
+        {
+          "event": "calciteInternalUserRequestedStepperItemSelect",
+          "capture": false,
+          "passive": false
         }
       ],
       "styles": [],
@@ -17059,6 +17519,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "description",
+          "type": "string",
+          "mutable": false,
+          "attr": "description",
+          "reflectToAttr": false,
+          "docs": "stepper item description",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "disabled",
           "type": "boolean",
@@ -17093,6 +17569,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "heading",
+          "type": "string",
+          "mutable": false,
+          "attr": "heading",
+          "reflectToAttr": false,
+          "docs": "stepper item heading",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "itemSubtitle",
           "type": "string",
@@ -17100,7 +17592,13 @@
           "attr": "item-subtitle",
           "reflectToAttr": false,
           "docs": "pass a title for the stepper item",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use description instead"
+            }
+          ],
+          "deprecation": "use description instead",
           "values": [
             {
               "type": "string"
@@ -17116,7 +17614,13 @@
           "attr": "item-title",
           "reflectToAttr": false,
           "docs": "pass a title for the stepper item",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use heading instead"
+            }
+          ],
+          "deprecation": "use heading instead",
           "values": [
             {
               "type": "string"
@@ -17796,13 +18300,13 @@
         },
         {
           "name": "position",
-          "type": "\"above\" | \"below\"",
+          "type": "\"above\" | \"below\" | \"bottom\" | \"top\"",
           "mutable": false,
           "attr": "position",
           "reflectToAttr": true,
-          "docs": "Display the tabs above (default) or below the tab content",
+          "docs": "Display the tabs top (default) or bottom of the tab content. above and below are deprecated.",
           "docsTags": [],
-          "default": "\"above\"",
+          "default": "\"top\"",
           "values": [
             {
               "value": "above",
@@ -17811,6 +18315,14 @@
             {
               "value": "below",
               "type": "string"
+            },
+            {
+              "value": "bottom",
+              "type": "string"
+            },
+            {
+              "value": "top",
+              "type": "string"
             }
           ],
           "optional": false,
@@ -19354,7 +19866,7 @@
           "mutable": false,
           "attr": "close-on-click",
           "reflectToAttr": false,
-          "docs": "Closes the `calcite-tooltip` when the `referenceElement` is clicked.",
+          "docs": "Closes the component when the `referenceElement` is clicked.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19371,7 +19883,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "Accessible name for the `calcite-tooltip`.",
+          "docs": "Accessible name for the component.",
           "docsTags": [],
           "values": [
             {
@@ -19387,7 +19899,7 @@
           "mutable": false,
           "attr": "offset-distance",
           "reflectToAttr": true,
-          "docs": "Offset the position of the `calcite-tooltip` away from the `referenceElement`.",
+          "docs": "Offset the position of the component away from the `referenceElement`.",
           "docsTags": [
             {
               "name": "default",
@@ -19409,7 +19921,7 @@
           "mutable": false,
           "attr": "offset-skidding",
           "reflectToAttr": true,
-          "docs": "Offset the position of the `calcite-tooltip` along the `referenceElement`.",
+          "docs": "Offset the position of the component along the `referenceElement`.",
           "docsTags": [],
           "default": "0",
           "values": [
@@ -19426,7 +19938,7 @@
           "mutable": false,
           "attr": "open",
           "reflectToAttr": true,
-          "docs": "When true, the `calcite-tooltip` is open.",
+          "docs": "When true, the component is open.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19493,7 +20005,7 @@
           "mutable": false,
           "attr": "reference-element",
           "reflectToAttr": false,
-          "docs": "The `referenceElement` to position `calcite-tooltip` according to its \"placement\" value. Setting to the `HTMLElement` is preferred so `calcite-tooltip` does not need to query the DOM for the `referenceElement`. However, a string ID of the reference element can be used.",
+          "docs": "The `referenceElement` to position the component according to its \"placement\" value. Setting to the `HTMLElement` is preferred so the component does not need to query the DOM for the `referenceElement`. However, a string ID of the reference element can be used.",
           "docsTags": [],
           "values": [
             {
@@ -19642,7 +20154,7 @@
           "mutable": true,
           "attr": "lines",
           "reflectToAttr": true,
-          "docs": "Display indentation guide lines.",
+          "docs": "Displays indentation guide lines.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19659,7 +20171,7 @@
           "mutable": true,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "Specify the scale of the tree.",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -19685,7 +20197,7 @@
           "mutable": true,
           "attr": "selection-mode",
           "reflectToAttr": true,
-          "docs": "Customize how tree selection works.",
+          "docs": "Customize how the component's selection works.",
           "docsTags": [
             {
               "name": "default",
@@ -19726,7 +20238,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emits when the user selects/deselects tree items. An object including an array of selected items will be passed in the event's \"detail\" property.",
+          "docs": "Fires when the user selects/deselects `calcite-tree-items`. An object including an array of selected items will be passed in the event's \"detail\" property.",
           "docsTags": [
             {
               "name": "see",
@@ -19783,7 +20295,7 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "- A slot for adding content to the item."
+          "text": "- A slot for adding the component's content."
         },
         {
           "name": "slot",
@@ -19798,7 +20310,7 @@
           "mutable": true,
           "attr": "expanded",
           "reflectToAttr": true,
-          "docs": "Expanded state of the item.",
+          "docs": "When true, the component is expanded.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19815,7 +20327,7 @@
           "mutable": true,
           "attr": "selected",
           "reflectToAttr": true,
-          "docs": "Selected state of the item.",
+          "docs": "When true, the component is selected.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19845,7 +20357,7 @@
       "slots": [
         {
           "name": "",
-          "docs": "A slot for adding content to the item."
+          "docs": "A slot for adding the component's content."
         },
         {
           "name": "children",
@@ -19893,7 +20405,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, prevents user interaction. This state shows list items grayed out and with lower opacity.",
+          "docs": "When true, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19910,7 +20422,7 @@
           "mutable": false,
           "attr": "drag-enabled",
           "reflectToAttr": true,
-          "docs": "When true, list items are sortable via a draggable button.",
+          "docs": "When true, `calcite-value-list-item`s are sortable via a draggable button.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19927,7 +20439,7 @@
           "mutable": false,
           "attr": "filter-enabled",
           "reflectToAttr": true,
-          "docs": "When true, an input appears at the top of the list that can be used by end users to filter list items.",
+          "docs": "When true, an input appears at the top of the component that can be used by end users to filter list items.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19960,7 +20472,7 @@
           "mutable": false,
           "attr": "group",
           "reflectToAttr": false,
-          "docs": "The list's group identifier.\n\nTo drag elements from one list into another, both lists must have the same group value.",
+          "docs": "The component's group identifier.\n\nTo drag elements from one list into another, both lists must have the same group value.",
           "docsTags": [],
           "values": [
             {
@@ -19976,7 +20488,7 @@
           "mutable": false,
           "attr": "loading",
           "reflectToAttr": true,
-          "docs": "When true, content is waiting to be loaded. This state shows a busy indicator.",
+          "docs": "When true, a busy indicator is displayed.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19993,7 +20505,7 @@
           "mutable": false,
           "attr": "multiple",
           "reflectToAttr": true,
-          "docs": "Similar to standard radio buttons and checkboxes.\nWhen true, a user can select multiple list items at a time.\nWhen false, only a single list item can be selected at a time,\nand selecting a new list item will deselect any other selected list items.",
+          "docs": "Similar to standard radio buttons and checkboxes.\nWhen true, a user can select multiple `calcite-value-list-item`s at a time.\nWhen false, only a single `calcite-value-list-item` can be selected at a time,\nand a new selection will deselect previous selections.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -20010,7 +20522,7 @@
           "mutable": false,
           "attr": "selection-follows-focus",
           "reflectToAttr": false,
-          "docs": "When true and single-selection is enabled, the selection changes when navigating list items via the keyboard.",
+          "docs": "When true and single-selection is enabled, the selection changes when navigating `calcite-value-list-item`s via keyboard.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -20141,11 +20653,11 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "actions-end - A slot for adding actions or content to the end side of the item."
+          "text": "actions-end - A slot for adding actions or content to the end side of the component."
         },
         {
           "name": "slot",
-          "text": "actions-start - A slot for adding actions or content to the start side of the item."
+          "text": "actions-start - A slot for adding actions or content to the start side of the component."
         }
       ],
       "usage": {},
@@ -20156,7 +20668,7 @@
           "mutable": false,
           "attr": "description",
           "reflectToAttr": true,
-          "docs": "An optional description for the list item that displays below the label text.",
+          "docs": "A description for the component that displays below the label text.",
           "docsTags": [],
           "values": [
             {
@@ -20172,7 +20684,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, the list item cannot be clicked and is visually muted.",
+          "docs": "When true, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -20217,7 +20729,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": true,
-          "docs": "The main label for the list item. Appears next to the icon.",
+          "docs": "Label and accessible name for the component. Appears next to the icon.",
           "docsTags": [],
           "values": [
             {
@@ -20232,7 +20744,7 @@
           "type": "{ [x: string]: unknown; }",
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Provides additional metadata to a list item. Primary use is for a filter on the parent list.",
+          "docs": "Provides additional metadata to the component. Primary use is for a filter on the parent list.",
           "docsTags": [],
           "values": [
             {
@@ -20248,7 +20760,7 @@
           "mutable": false,
           "attr": "non-interactive",
           "reflectToAttr": true,
-          "docs": "When true, prevents the content of the list item from user interaction.",
+          "docs": "When true, prevents the content of the component from user interaction.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -20265,7 +20777,7 @@
           "mutable": false,
           "attr": "removable",
           "reflectToAttr": true,
-          "docs": "When true, adds an action to remove the list item.",
+          "docs": "When true, adds an action to remove the component.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -20282,7 +20794,7 @@
           "mutable": true,
           "attr": "selected",
           "reflectToAttr": true,
-          "docs": "When true, preselects the list item. Toggles when an item is checked/unchecked.",
+          "docs": "When true, the component is selected.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -20299,7 +20811,7 @@
           "mutable": false,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "The list item's associated value.",
+          "docs": "The component's value.",
           "docsTags": [],
           "values": [
             {
@@ -20346,7 +20858,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emits when the remove button is pressed.",
+          "docs": "Fires when the remove button is pressed.",
           "docsTags": []
         }
       ],
@@ -20361,11 +20873,11 @@
       "slots": [
         {
           "name": "actions-end",
-          "docs": "A slot for adding actions or content to the end side of the item."
+          "docs": "A slot for adding actions or content to the end side of the component."
         },
         {
           "name": "actions-start",
-          "docs": "A slot for adding actions or content to the start side of the item."
+          "docs": "A slot for adding actions or content to the start side of the component."
         }
       ],
       "parts": [],