npm - @esri/calcite-components - Versions diffs - 1.0.0-next.556 → 1.0.0-next.559 - Mend

@esri/calcite-components 1.0.0-next.556 → 1.0.0-next.559

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (969) hide show

package/dist/extras/docs-json.json CHANGED Viewed

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2022-08-08T22:18:31",
+  "timestamp": "2022-08-15T19:57:46",
   "compiler": {
     "name": "@stencil/core",
-    "version": "2.17.3",
+    "version": "2.16.1",
     "typescriptVersion": "4.5.4"
   },
   "components": [
@@ -1289,7 +1289,7 @@
           "mutable": false,
           "attr": "overlay-positioning",
           "reflectToAttr": false,
-          "docs": "Determines 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.\n\nUsing the \"absolute\" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The \"fixed\" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is \"fixed\".",
           "docsTags": [],
           "default": "\"absolute\"",
           "values": [
@@ -5209,7 +5209,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.\n\nUsing the \"absolute\" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The \"fixed\" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is \"fixed\".",
           "docsTags": [],
           "default": "\"absolute\"",
           "values": [
@@ -7050,7 +7050,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.\n\nUsing the \"absolute\" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The \"fixed\" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is \"fixed\".",
           "docsTags": [],
           "default": "\"absolute\"",
           "values": [
@@ -8288,7 +8288,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Emitted when the the handle is activated and the up or down arrow key is pressed.\n\n**Note:**: The `handle` event payload prop is deprecated, please use the event's target/currentTarget instead",
+          "docs": "Emitted when the handle is activated and the up or down arrow key is pressed.\n\n**Note:**: The `handle` event payload prop is deprecated, please use the event's target/currentTarget instead",
           "docsTags": []
         }
       ],
@@ -9951,7 +9951,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.\n\nUsing the \"absolute\" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The \"fixed\" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is \"fixed\".",
           "docsTags": [],
           "default": "\"absolute\"",
           "values": [
@@ -15695,7 +15695,7 @@
           "mutable": false,
           "attr": "overlay-positioning",
           "reflectToAttr": false,
-          "docs": "Describes the positioning type to use for the overlaid content. If the element is in a fixed container, use the \"fixed\" value.",
+          "docs": "Determines the type of positioning to use for the overlaid content.\n\nUsing the \"absolute\" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The \"fixed\" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is \"fixed\".",
           "docsTags": [],
           "default": "\"absolute\"",
           "values": [
@@ -17083,7 +17083,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 +17105,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 +17186,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 +17203,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 +17219,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 +17235,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "The component scale.",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -17260,7 +17260,7 @@
           "type": "HTMLCalciteOptionElement",
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "The currently selected option.",
+          "docs": "The component's selected option `HTMLElement`.",
           "docsTags": [
             {
               "name": "readonly"
@@ -17280,7 +17280,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 +17297,7 @@
           "mutable": false,
           "attr": "width",
           "reflectToAttr": true,
-          "docs": "The component width.",
+          "docs": "Specifies the width of the component.",
           "docsTags": [],
           "default": "\"auto\"",
           "values": [
@@ -17338,7 +17338,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 +17358,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 +17392,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 +17420,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 +17436,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 +17455,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 +17473,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 +17506,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 +17521,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 +17538,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 +17564,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 +17588,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 +17609,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 +17630,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 +17647,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 +17664,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 +17690,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 +17712,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 +17733,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 +17750,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 +17783,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 +17794,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 +17824,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 +17841,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 +17857,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 +17877,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 +17893,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 +17910,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 +17927,7 @@
           "mutable": false,
           "attr": "max",
           "reflectToAttr": true,
-          "docs": "Maximum selectable value",
+          "docs": "The component's maximum selectable value.",
           "docsTags": [],
           "default": "100",
           "values": [
@@ -17944,7 +17944,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 +17960,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 +17976,7 @@
           "mutable": false,
           "attr": "min",
           "reflectToAttr": true,
-          "docs": "Minimum selectable value",
+          "docs": "The component's minimum selectable value.",
           "docsTags": [],
           "default": "0",
           "values": [
@@ -17993,7 +17993,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 +18009,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 +18042,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 +18058,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 +18074,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 +18091,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 +18108,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 +18134,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 +18151,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 +18168,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 +18184,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 +18219,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 +18228,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 +18237,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 +18449,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 +18479,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 +18509,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 +18526,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 +18556,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 +18572,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": [
@@ -18589,7 +18589,7 @@
           "mutable": false,
           "attr": "overlay-positioning",
           "reflectToAttr": false,
-          "docs": "Describes the type of positioning to use for the dropdown. If your element is in a fixed container, use the 'fixed' value.",
+          "docs": "Determines the type of positioning to use for the overlaid content.\n\nUsing the \"absolute\" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The \"fixed\" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is \"fixed\".",
           "docsTags": [],
           "default": "\"absolute\"",
           "values": [
@@ -18611,7 +18611,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 +18627,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 +18652,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 +18668,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 +18684,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 +18700,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 +18726,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 +18755,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 +18764,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 +18815,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 +18832,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 +18854,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 +18871,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 +18901,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 +18912,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 +18928,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 +18939,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 +18950,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 +18961,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": []
         }
       ],
@@ -19019,7 +19019,7 @@
           "mutable": true,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "is the step active",
+          "docs": "When true, the component is active.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19036,7 +19036,7 @@
           "mutable": false,
           "attr": "complete",
           "reflectToAttr": true,
-          "docs": "has the step been completed",
+          "docs": "When true, the component's workflow has been completed.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19053,7 +19053,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 +19069,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 +19086,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 +19103,7 @@
           "mutable": false,
           "attr": "heading",
           "reflectToAttr": false,
-          "docs": "stepper item heading",
+          "docs": "The component header text.",
           "docsTags": [],
           "values": [
             {
@@ -19119,14 +19119,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 +19141,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"
@@ -19215,7 +19215,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 +19232,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 +19249,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 +19265,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 +19281,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 +19307,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 +19330,7 @@
           "mutable": false,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "The value of the switch input",
+          "docs": "The component's value.",
           "docsTags": [],
           "values": [
             {
@@ -19361,7 +19361,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": []
         }
       ],
@@ -21541,7 +21541,7 @@
           "mutable": false,
           "attr": "overlay-positioning",
           "reflectToAttr": false,
-          "docs": "Describes the positioning type to use for the overlaid content. If the `referenceElement` is in a fixed container, use the \"fixed\" value.",
+          "docs": "Determines the type of positioning to use for the overlaid content.\n\nUsing the \"absolute\" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The \"fixed\" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is \"fixed\".",
           "docsTags": [],
           "default": "\"absolute\"",
           "values": [