@esri/calcite-components 1.0.0-beta.91 → 1.0.0-beta.92

package/dist/extras/docs-json.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2022-08-10T20:18:12",
+  "timestamp": "2022-08-18T04:25:45",
   "compiler": {
     "name": "@stencil/core",
     "version": "2.16.1",
@@ -7454,8 +7454,14 @@
           "attr": "active",
           "reflectToAttr": true,
           "docs": "Indicates whether the item is active.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "Use selected instead."
+            }
+          ],
           "default": "false",
+          "deprecation": "Use selected instead.",
           "values": [
             {
               "type": "boolean"
@@ -7569,6 +7575,23 @@
           "optional": true,
           "required": false
         },
+        {
+          "name": "selected",
+          "type": "boolean",
+          "mutable": true,
+          "attr": "selected",
+          "reflectToAttr": true,
+          "docs": "When true, item is selected",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "target",
           "type": "string",
@@ -16436,7 +16459,7 @@
       "events": [
         {
           "event": "calciteRadioButtonGroupChange",
-          "detail": "void",
+          "detail": "any",
           "bubbles": true,
           "cancelable": false,
           "composed": true,
@@ -17083,7 +17106,7 @@
           "mutable": false,
           "attr": "intl-loading",
           "reflectToAttr": false,
-          "docs": "string to override English loading text",
+          "docs": "Accessible name when the component is loading.",
           "docsTags": [
             {
               "name": "default",
@@ -17105,7 +17128,7 @@
           "mutable": false,
           "attr": "loading",
           "reflectToAttr": true,
-          "docs": "Determines if the component will have the loader overlay.\nOtherwise, will render opaque disabled state.",
+          "docs": "When true, a busy indicator is displayed.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -17186,7 +17209,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": [
@@ -17203,7 +17226,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "The component's label. This is required for accessibility purposes.",
+          "docs": "Accessible name for the component.",
           "docsTags": [],
           "values": [
             {
@@ -17219,7 +17242,7 @@
           "mutable": false,
           "attr": "name",
           "reflectToAttr": false,
-          "docs": "The select's name. Gets submitted with the form.",
+          "docs": "Specifies the name of the component on form submission.",
           "docsTags": [],
           "values": [
             {
@@ -17235,7 +17258,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "The component scale.",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -17260,7 +17283,7 @@
           "type": "HTMLCalciteOptionElement",
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "The currently selected option.",
+          "docs": "The component's selected option `HTMLElement`.",
           "docsTags": [
             {
               "name": "readonly"
@@ -17280,7 +17303,7 @@
           "mutable": true,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "The value of the selectedOption",
+          "docs": "The component's \"selectedOption\" value.",
           "docsTags": [],
           "default": "null",
           "values": [
@@ -17297,7 +17320,7 @@
           "mutable": false,
           "attr": "width",
           "reflectToAttr": true,
-          "docs": "The component width.",
+          "docs": "Specifies the width of the component.",
           "docsTags": [],
           "default": "\"auto\"",
           "values": [
@@ -17338,7 +17361,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "This event will fire whenever the selected option changes.",
+          "docs": "Fires when the selected option changes.",
           "docsTags": []
         }
       ],
@@ -17358,12 +17381,12 @@
         {
           "name": "--calcite-select-font-size",
           "annotation": "prop",
-          "docs": "the font-size of items in the select"
+          "docs": "The font size of items in the component."
         },
         {
           "name": "--calcite-select-spacing",
           "annotation": "prop",
-          "docs": "the padding around the selected option text"
+          "docs": "The padding around the selected option text."
         }
       ],
       "slots": [
@@ -17392,15 +17415,15 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "- A slot for adding content to the shell. This content will appear between any leading and trailing panels added to the shell. (eg. a map)"
+          "text": "- A slot for adding content to the component. This content will appear between any leading and trailing panels added to the component, such as a map."
         },
         {
           "name": "slot",
-          "text": "header - A slot for adding header content. This content will be positioned at the top of the shell."
+          "text": "header - A slot for adding header content. This content will be positioned at the top of the component."
         },
         {
           "name": "slot",
-          "text": "footer - A slot for adding footer content. This content will be positioned at the bottom of the shell."
+          "text": "footer - A slot for adding footer content. This content will be positioned at the bottom of the component."
         },
         {
           "name": "slot",
@@ -17420,7 +17443,7 @@
         },
         {
           "name": "slot",
-          "text": "center-row - A slot for adding custom content in the center row."
+          "text": "center-row - A slot for adding content to the center row."
         }
       ],
       "usage": {
@@ -17436,7 +17459,7 @@
           "mutable": false,
           "attr": "content-behind",
           "reflectToAttr": true,
-          "docs": "Positions the center content behind any calcite-shell-panels.",
+          "docs": "Positions the center content behind any `calcite-shell-panel`s.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -17455,17 +17478,17 @@
         {
           "name": "--calcite-shell-tip-spacing",
           "annotation": "prop",
-          "docs": "the left/right positioning of the tip-manager when slotted within a shell"
+          "docs": "The left and right spacing of the `calcite-tip-manager` when slotted in the component."
         }
       ],
       "slots": [
         {
           "name": "",
-          "docs": "A slot for adding content to the shell. This content will appear between any leading and trailing panels added to the shell. (eg. a map)"
+          "docs": "A slot for adding content to the component. This content will appear between any leading and trailing panels added to the component, such as a map."
         },
         {
           "name": "center-row",
-          "docs": "A slot for adding custom content in the center row."
+          "docs": "A slot for adding content to the center row."
         },
         {
           "name": "contextual-panel",
@@ -17473,11 +17496,11 @@
         },
         {
           "name": "footer",
-          "docs": "A slot for adding footer content. This content will be positioned at the bottom of the shell."
+          "docs": "A slot for adding footer content. This content will be positioned at the bottom of the component."
         },
         {
           "name": "header",
-          "docs": "A slot for adding header content. This content will be positioned at the top of the shell."
+          "docs": "A slot for adding header content. This content will be positioned at the top of the component."
         },
         {
           "name": "panel-end",
@@ -17506,11 +17529,11 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "- A slot for adding content to the shell panel."
+          "text": "- A slot for adding content to the `calcite-shell-panel`."
         },
         {
           "name": "slot",
-          "text": "action-bar - A slot for adding a `calcite-action-bar` to the panel."
+          "text": "action-bar - A slot for adding a `calcite-action-bar` to the `calcite-shell-panel`."
         }
       ],
       "usage": {},
@@ -17521,7 +17544,7 @@
           "mutable": false,
           "attr": "detached",
           "reflectToAttr": true,
-          "docs": "This property makes the content area appear like a \"floating\" panel.",
+          "docs": "When true, the content area displays like a floating panel.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -17538,7 +17561,7 @@
           "mutable": false,
           "attr": "height-scale",
           "reflectToAttr": true,
-          "docs": "Specifies the maximum height of the row.",
+          "docs": "Specifies the maximum height of the component.",
           "docsTags": [],
           "default": "\"s\"",
           "values": [
@@ -17564,7 +17587,7 @@
           "mutable": false,
           "attr": "position",
           "reflectToAttr": true,
-          "docs": "Arranges the component depending on the elements 'dir' property.",
+          "docs": "Specifies the component's position. Will be flipped when the element direction is right-to-left (\"rtl\").",
           "docsTags": [],
           "default": "\"end\"",
           "values": [
@@ -17588,11 +17611,11 @@
       "slots": [
         {
           "name": "",
-          "docs": "A slot for adding content to the shell panel."
+          "docs": "A slot for adding content to the `calcite-shell-panel`."
         },
         {
           "name": "action-bar",
-          "docs": "A slot for adding a `calcite-action-bar` to the panel."
+          "docs": "A slot for adding a `calcite-action-bar` to the `calcite-shell-panel`."
         }
       ],
       "parts": [],
@@ -17609,11 +17632,11 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "- A slot for adding content to the shell panel."
+          "text": "- A slot for adding content to the component."
         },
         {
           "name": "slot",
-          "text": "action-bar - A slot for adding a `calcite-action-bar` to the panel."
+          "text": "action-bar - A slot for adding a `calcite-action-bar` to the component."
         }
       ],
       "usage": {
@@ -17630,7 +17653,7 @@
           "mutable": false,
           "attr": "collapsed",
           "reflectToAttr": true,
-          "docs": "Hide the content panel.",
+          "docs": "When true, hides the component's content area.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -17647,7 +17670,7 @@
           "mutable": false,
           "attr": "detached",
           "reflectToAttr": true,
-          "docs": "This property makes the content area appear like a \"floating\" panel.",
+          "docs": "When true, the content area displays like a floating panel.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -17664,7 +17687,7 @@
           "mutable": false,
           "attr": "detached-height-scale",
           "reflectToAttr": true,
-          "docs": "Specifies the maximum height of the contents when detached.",
+          "docs": "When \"detached\", specifies the maximum height of the component.",
           "docsTags": [],
           "default": "\"l\"",
           "values": [
@@ -17690,7 +17713,7 @@
           "mutable": false,
           "attr": "intl-resize",
           "reflectToAttr": false,
-          "docs": "Accessible label for resize separator.",
+          "docs": "Accessible name for the resize separator.",
           "docsTags": [
             {
               "name": "default",
@@ -17712,7 +17735,7 @@
           "mutable": false,
           "attr": "position",
           "reflectToAttr": true,
-          "docs": "Arranges the component depending on the elements 'dir' property.",
+          "docs": "Specifies the component's position. Will be flipped when the element direction is right-to-left (\"rtl\").",
           "docsTags": [],
           "values": [
             {
@@ -17733,7 +17756,7 @@
           "mutable": false,
           "attr": "resizable",
           "reflectToAttr": true,
-          "docs": "This property makes the content area resizable if the calcite-shell-panel is not 'detached'.",
+          "docs": "When true and not \"detached\", the component's content area is resizable.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -17750,7 +17773,7 @@
           "mutable": false,
           "attr": "width-scale",
           "reflectToAttr": true,
-          "docs": "This sets width of the content area.",
+          "docs": "Specifies the width of the component's content area.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -17783,10 +17806,10 @@
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use a resizeObserver on the shell-panel to listen for changes to its size."
+              "text": "use a resizeObserver on the component to listen for changes to its size."
             }
           ],
-          "deprecation": "use a resizeObserver on the shell-panel to listen for changes to its size."
+          "deprecation": "use a resizeObserver on the component to listen for changes to its size."
         }
       ],
       "listeners": [],
@@ -17794,11 +17817,11 @@
       "slots": [
         {
           "name": "",
-          "docs": "A slot for adding content to the shell panel."
+          "docs": "A slot for adding content to the component."
         },
         {
           "name": "action-bar",
-          "docs": "A slot for adding a `calcite-action-bar` to the panel."
+          "docs": "A slot for adding a `calcite-action-bar` to the component."
         }
       ],
       "parts": [],
@@ -17824,7 +17847,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "Disable and gray out the slider",
+          "docs": "When true, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -17841,7 +17864,7 @@
           "mutable": true,
           "attr": "has-histogram",
           "reflectToAttr": true,
-          "docs": "Indicates if a histogram is present",
+          "docs": "When true, indicates a histogram is present.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -17857,7 +17880,7 @@
           "type": "Point[]",
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "List of x,y coordinates within the slider's min and max, displays above the slider track.",
+          "docs": "A list of the histogram's x,y coordinates within the component's \"min\" and \"max\". Displays above the component's track.",
           "docsTags": [
             {
               "name": "see",
@@ -17877,7 +17900,7 @@
           "type": "ColorStop[]",
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Array of values describing a single color stop, sorted by offset ascending.",
+          "docs": "A set of single color stops for a histogram, sorted by offset ascending.",
           "docsTags": [],
           "values": [
             {
@@ -17893,7 +17916,7 @@
           "mutable": false,
           "attr": "label-handles",
           "reflectToAttr": true,
-          "docs": "Label handles with their numeric value",
+          "docs": "When true, displays label handles with their numeric value.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -17910,7 +17933,7 @@
           "mutable": false,
           "attr": "label-ticks",
           "reflectToAttr": true,
-          "docs": "Label tick marks with their numeric value.",
+          "docs": "When true and \"ticks\" is specified, displays label tick marks with their numeric value.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -17927,7 +17950,7 @@
           "mutable": false,
           "attr": "max",
           "reflectToAttr": true,
-          "docs": "Maximum selectable value",
+          "docs": "The component's maximum selectable value.",
           "docsTags": [],
           "default": "100",
           "values": [
@@ -17944,7 +17967,7 @@
           "mutable": false,
           "attr": "max-label",
           "reflectToAttr": false,
-          "docs": "Used as an accessible label (aria-label) for second handle if needed (ex. \"Temperature, upper bound\")",
+          "docs": "For multiple selections, the accessible name for the second handle, such as \"Temperature, upper bound\".",
           "docsTags": [],
           "values": [
             {
@@ -17960,7 +17983,7 @@
           "mutable": true,
           "attr": "max-value",
           "reflectToAttr": false,
-          "docs": "Currently selected upper number (if multi-select)",
+          "docs": "For multiple selections, the component's upper value.",
           "docsTags": [],
           "values": [
             {
@@ -17976,7 +17999,7 @@
           "mutable": false,
           "attr": "min",
           "reflectToAttr": true,
-          "docs": "Minimum selectable value",
+          "docs": "The component's minimum selectable value.",
           "docsTags": [],
           "default": "0",
           "values": [
@@ -17993,7 +18016,7 @@
           "mutable": false,
           "attr": "min-label",
           "reflectToAttr": false,
-          "docs": "Used as an accessible label (aria-label) for first (or only) handle (ex. \"Temperature, lower bound\")",
+          "docs": "Accessible name for first (or only) handle, such as \"Temperature, lower bound\".",
           "docsTags": [],
           "values": [
             {
@@ -18009,7 +18032,7 @@
           "mutable": true,
           "attr": "min-value",
           "reflectToAttr": false,
-          "docs": "Currently selected lower number (if multi-select)",
+          "docs": "For multiple selections, the component's lower value.",
           "docsTags": [],
           "values": [
             {
@@ -18042,7 +18065,7 @@
           "mutable": false,
           "attr": "name",
           "reflectToAttr": true,
-          "docs": "The name of the slider",
+          "docs": "Specifies the name of the component on form submission.",
           "docsTags": [],
           "values": [
             {
@@ -18058,7 +18081,7 @@
           "mutable": false,
           "attr": "page-step",
           "reflectToAttr": false,
-          "docs": "Interval to move on page up/page down keys",
+          "docs": "Specifies the interval to move with the page up, or page down keys.",
           "docsTags": [],
           "values": [
             {
@@ -18074,7 +18097,7 @@
           "mutable": false,
           "attr": "precise",
           "reflectToAttr": false,
-          "docs": "Use finer point for handles",
+          "docs": "When true, sets a finer point for handles.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -18091,7 +18114,7 @@
           "mutable": false,
           "attr": "required",
           "reflectToAttr": true,
-          "docs": "When true, makes the component required for form-submission.",
+          "docs": "When true, the component must have a value on form submission.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -18108,7 +18131,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": false,
-          "docs": "Specify the scale of the slider, defaults to m",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -18134,7 +18157,7 @@
           "mutable": false,
           "attr": "snap",
           "reflectToAttr": false,
-          "docs": "When true, enables snap selection along the step interval",
+          "docs": "When true, enables snap selection in coordination with \"step\" via a mouse.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -18151,7 +18174,7 @@
           "mutable": false,
           "attr": "step",
           "reflectToAttr": false,
-          "docs": "Interval to move on up/down keys",
+          "docs": "Specifies the interval to move with the up, or down keys.",
           "docsTags": [],
           "default": "1",
           "values": [
@@ -18168,7 +18191,7 @@
           "mutable": false,
           "attr": "ticks",
           "reflectToAttr": false,
-          "docs": "Show tick marks on the number line at provided interval",
+          "docs": "Displays tick marks on the number line at a specified interval.",
           "docsTags": [],
           "values": [
             {
@@ -18184,7 +18207,7 @@
           "mutable": true,
           "attr": "value",
           "reflectToAttr": true,
-          "docs": "Currently selected number (if single select)",
+          "docs": "The component's value.",
           "docsTags": [],
           "default": "0",
           "values": [
@@ -18219,7 +18242,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Fires on when the thumb is released on slider\nIf you need to constantly listen to the drag event,\nplease use calciteSliderInput instead",
+          "docs": "Fires when the thumb is released on the component.\n\n**Note:** If you need to constantly listen to the drag event,\nuse \"calciteSliderInput\" instead.",
           "docsTags": []
         },
         {
@@ -18228,7 +18251,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Fires on all updates to the slider.\n:warning: Will be fired frequently during drag. If you are performing any\nexpensive operations consider using a debounce or throttle to avoid\nlocking up the main thread.",
+          "docs": "Fires on all updates to the component.\n\n**Note:** Will be fired frequently during drag. If you are performing any\nexpensive operations consider using a debounce or throttle to avoid\nlocking up the main thread.",
           "docsTags": []
         },
         {
@@ -18237,14 +18260,14 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Fires on all updates to the slider.\n:warning: Will be fired frequently during drag. If you are performing any\nexpensive operations consider using a debounce or throttle to avoid\nlocking up the main thread.",
+          "docs": "Fires on all updates to the component.\n\n**Note:** Will be fired frequently during drag. If you are performing any\nexpensive operations consider using a debounce or throttle to avoid\nlocking up the main thread.",
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use calciteSliderInput instead"
+              "text": "use \"calciteSliderInput\" instead."
             }
           ],
-          "deprecation": "use calciteSliderInput instead"
+          "deprecation": "use \"calciteSliderInput\" instead."
         }
       ],
       "listeners": [
@@ -18449,7 +18472,7 @@
           "mutable": false,
           "attr": "appearance",
           "reflectToAttr": true,
-          "docs": "specify the appearance style of the button, defaults to solid.",
+          "docs": "Specifies the appearance style of the component.",
           "docsTags": [],
           "default": "\"solid\"",
           "values": [
@@ -18479,7 +18502,7 @@
           "mutable": false,
           "attr": "color",
           "reflectToAttr": true,
-          "docs": "specify the color of the control, defaults to blue",
+          "docs": "Specifies the color of the component.",
           "docsTags": [],
           "default": "\"blue\"",
           "values": [
@@ -18509,7 +18532,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "is the control disabled",
+          "docs": "When true, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -18526,7 +18549,7 @@
           "mutable": false,
           "attr": "dropdown-icon-type",
           "reflectToAttr": true,
-          "docs": "specify the icon used for the dropdown menu, defaults to chevron",
+          "docs": "Specifies the icon used for the dropdown menu.",
           "docsTags": [],
           "default": "\"chevron\"",
           "values": [
@@ -18556,7 +18579,7 @@
           "mutable": false,
           "attr": "dropdown-label",
           "reflectToAttr": true,
-          "docs": "aria label for overflow button",
+          "docs": "Accessible name for the dropdown menu.",
           "docsTags": [],
           "values": [
             {
@@ -18572,7 +18595,7 @@
           "mutable": false,
           "attr": "loading",
           "reflectToAttr": true,
-          "docs": "optionally add a calcite-loader component to the control,\ndisabling interaction. with the primary button",
+          "docs": "When true, a busy indicator is displayed on the primary button.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -18611,7 +18634,7 @@
           "mutable": false,
           "attr": "primary-icon-end",
           "reflectToAttr": true,
-          "docs": "optionally pass an icon to display at the end of the primary button - accepts Calcite UI icon names",
+          "docs": "Specifies an icon to display at the end of the primary button - accepts Calcite UI icon names.",
           "docsTags": [],
           "values": [
             {
@@ -18627,7 +18650,7 @@
           "mutable": false,
           "attr": "primary-icon-flip-rtl",
           "reflectToAttr": true,
-          "docs": "flip the primary icon(s) in rtl",
+          "docs": "When true, the primary button icon will be flipped when the element direction is right-to-left (\"rtl\").",
           "docsTags": [],
           "values": [
             {
@@ -18652,7 +18675,7 @@
           "mutable": false,
           "attr": "primary-icon-start",
           "reflectToAttr": true,
-          "docs": "optionally pass an icon to display at the start of the primary button - accepts Calcite UI icon names",
+          "docs": "Specifies an icon to display at the start of the primary button - accepts Calcite UI icon names.",
           "docsTags": [],
           "values": [
             {
@@ -18668,7 +18691,7 @@
           "mutable": false,
           "attr": "primary-label",
           "reflectToAttr": true,
-          "docs": "optionally pass an aria-label for the primary button",
+          "docs": "Accessible name for the primary button.",
           "docsTags": [],
           "values": [
             {
@@ -18684,7 +18707,7 @@
           "mutable": false,
           "attr": "primary-text",
           "reflectToAttr": true,
-          "docs": "text for primary action button",
+          "docs": "Text displayed in the primary button.",
           "docsTags": [],
           "values": [
             {
@@ -18700,7 +18723,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of the control, defaults to m",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -18726,7 +18749,7 @@
           "mutable": false,
           "attr": "width",
           "reflectToAttr": true,
-          "docs": "specify the width of the button, defaults to auto",
+          "docs": "Specifies the width of the component.",
           "docsTags": [],
           "default": "\"auto\"",
           "values": [
@@ -18755,7 +18778,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "fired when the primary button is clicked\n\n**Note:** The event payload is deprecated, please use separate mouse event listeners to get info about click.",
+          "docs": "Fires when the primary button is clicked.\n\n**Note:** The event payload is deprecated, use separate mouse event listeners to get info about click.",
           "docsTags": []
         },
         {
@@ -18764,7 +18787,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "fired when the secondary button is clicked\n\n**Note:** The event payload is deprecated, please use separate mouse event listeners to get info about click.",
+          "docs": "Fires when the dropdown menu is clicked.\n\n**Note:** The event payload is deprecated, use separate mouse event listeners to get info about click.",
           "docsTags": []
         }
       ],
@@ -18815,7 +18838,7 @@
           "mutable": false,
           "attr": "icon",
           "reflectToAttr": true,
-          "docs": "optionally display a status icon next to the step title",
+          "docs": "When true, displays a status icon in the `calcite-stepper-item` heading.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -18832,7 +18855,7 @@
           "mutable": false,
           "attr": "layout",
           "reflectToAttr": true,
-          "docs": "specify the layout of stepper, defaults to horizontal",
+          "docs": "Defines the layout of the component.",
           "docsTags": [],
           "default": "\"horizontal\"",
           "values": [
@@ -18854,7 +18877,7 @@
           "mutable": false,
           "attr": "numbered",
           "reflectToAttr": true,
-          "docs": "optionally display the number next to the step title",
+          "docs": "When true, displays the step number in the `calcite-stepper-item` heading.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -18871,7 +18894,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of stepper, defaults to m",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -18901,7 +18924,7 @@
           },
           "signature": "endStep() => Promise<void>",
           "parameters": [],
-          "docs": "set the last step as active",
+          "docs": "Set the last `calcite-stepper-item` as active.",
           "docsTags": []
         },
         {
@@ -18912,7 +18935,7 @@
           },
           "signature": "goToStep(step: number) => Promise<void>",
           "parameters": [],
-          "docs": "set the requested step as active",
+          "docs": "Set a specified `calcite-stepper-item` as active.",
           "docsTags": [
             {
               "name": "param",
@@ -18928,7 +18951,7 @@
           },
           "signature": "nextStep() => Promise<void>",
           "parameters": [],
-          "docs": "set the next step as active",
+          "docs": "Set the next `calcite-stepper-item` as active.",
           "docsTags": []
         },
         {
@@ -18939,7 +18962,7 @@
           },
           "signature": "prevStep() => Promise<void>",
           "parameters": [],
-          "docs": "set the previous step as active",
+          "docs": "Set the previous `calcite-stepper-item` as active.",
           "docsTags": []
         },
         {
@@ -18950,7 +18973,7 @@
           },
           "signature": "startStep() => Promise<void>",
           "parameters": [],
-          "docs": "set the first step as active",
+          "docs": "Set the first `calcite-stepper-item` as active.",
           "docsTags": []
         }
       ],
@@ -18961,7 +18984,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "This event fires when the active stepper item has changed.",
+          "docs": "Fires when the active `calcite-stepper-item` changes.",
           "docsTags": []
         }
       ],
@@ -19020,8 +19043,14 @@
           "attr": "active",
           "reflectToAttr": true,
           "docs": "is the step active",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "Use selected instead."
+            }
+          ],
           "default": "false",
+          "deprecation": "Use selected instead.",
           "values": [
             {
               "type": "boolean"
@@ -19053,7 +19082,7 @@
           "mutable": false,
           "attr": "description",
           "reflectToAttr": false,
-          "docs": "stepper item description",
+          "docs": "A description for the component. Displays below the header text.",
           "docsTags": [],
           "values": [
             {
@@ -19069,7 +19098,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "is the step disabled and not navigable to by a user",
+          "docs": "When true, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19086,7 +19115,7 @@
           "mutable": false,
           "attr": "error",
           "reflectToAttr": false,
-          "docs": "does the step contain an error that needs to be resolved by the user",
+          "docs": "When true, the component contains an error that requires resolution from the user.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19103,7 +19132,7 @@
           "mutable": false,
           "attr": "heading",
           "reflectToAttr": false,
-          "docs": "stepper item heading",
+          "docs": "The component header text.",
           "docsTags": [],
           "values": [
             {
@@ -19119,14 +19148,14 @@
           "mutable": false,
           "attr": "item-subtitle",
           "reflectToAttr": false,
-          "docs": "pass a title for the stepper item",
+          "docs": "A description for the component. Displays below the header text.",
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use description instead"
+              "text": "use \"description\" instead."
             }
           ],
-          "deprecation": "use description instead",
+          "deprecation": "use \"description\" instead.",
           "values": [
             {
               "type": "string"
@@ -19141,14 +19170,14 @@
           "mutable": false,
           "attr": "item-title",
           "reflectToAttr": false,
-          "docs": "pass a title for the stepper item",
+          "docs": "The component header text.",
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use heading instead"
+              "text": "use \"heading\" instead."
             }
           ],
-          "deprecation": "use heading instead",
+          "deprecation": "use \"heading\" instead.",
           "values": [
             {
               "type": "string"
@@ -19156,6 +19185,23 @@
           ],
           "optional": true,
           "required": false
+        },
+        {
+          "name": "selected",
+          "type": "boolean",
+          "mutable": true,
+          "attr": "selected",
+          "reflectToAttr": true,
+          "docs": "When true, step is selected",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
         }
       ],
       "methods": [
@@ -19215,7 +19261,7 @@
           "mutable": true,
           "attr": "checked",
           "reflectToAttr": true,
-          "docs": "True if the switch is initially on",
+          "docs": "When true, the component is checked.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19232,7 +19278,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "True if the switch is disabled",
+          "docs": "When true, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19249,7 +19295,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "Applies to the aria-label attribute on the switch",
+          "docs": "Accessible name for the component.",
           "docsTags": [],
           "values": [
             {
@@ -19265,7 +19311,7 @@
           "mutable": false,
           "attr": "name",
           "reflectToAttr": true,
-          "docs": "The name of the switch input",
+          "docs": "Specifies the name of the component on form submission.",
           "docsTags": [],
           "values": [
             {
@@ -19281,7 +19327,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "The scale of the switch",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -19307,15 +19353,15 @@
           "mutable": true,
           "attr": "switched",
           "reflectToAttr": false,
-          "docs": "True if the switch is initially on",
+          "docs": "When true, the component is checked.",
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use 'checked' instead."
+              "text": "use \"checked\" instead."
             }
           ],
           "default": "false",
-          "deprecation": "use 'checked' instead.",
+          "deprecation": "use \"checked\" instead.",
           "values": [
             {
               "type": "boolean"
@@ -19330,7 +19376,7 @@
           "mutable": false,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "The value of the switch input",
+          "docs": "The component's value.",
           "docsTags": [],
           "values": [
             {
@@ -19361,7 +19407,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Fires when the checked value has changed.\n\n**Note:** The event payload is deprecated, please use the `checked` property on the component instead",
+          "docs": "Fires when the checked value has changed.\n\n**Note:** The event payload is deprecated, use the component's \"checked\" property instead.",
           "docsTags": []
         }
       ],
@@ -21779,7 +21825,7 @@
         },
         {
           "name": "selectionMode",
-          "type": "TreeSelectionMode.Ancestors | TreeSelectionMode.Children | TreeSelectionMode.Multi | TreeSelectionMode.MultiChildren | TreeSelectionMode.Single",
+          "type": "TreeSelectionMode.Ancestors | TreeSelectionMode.Children | TreeSelectionMode.Multi | TreeSelectionMode.MultiChildren | TreeSelectionMode.None | TreeSelectionMode.Single",
           "mutable": true,
           "attr": "selection-mode",
           "reflectToAttr": true,
@@ -21808,6 +21854,9 @@
             {
               "type": "TreeSelectionMode.MultiChildren"
             },
+            {
+              "type": "TreeSelectionMode.None"
+            },
             {
               "type": "TreeSelectionMode.Single"
             }