@esri/calcite-components 2.2.0-next.10 → 2.2.0-next.12

package/dist/extras/docs-json.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2024-01-02T20:15:09",
+  "timestamp": "2024-01-09T01:10:23",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.9.0",
@@ -181,7 +181,7 @@
           "mutable": false,
           "attr": "selection-mode",
           "reflectToAttr": true,
-          "docs": "Specifies the selection mode - `\"multiple\"` (allow any number of open items), `\"single\"` (allow one open item),\nor `\"single-persist\"` (allow and require one open item).",
+          "docs": "Specifies the selection mode of the component, where:\n\n`\"multiple\"` allows any number of selections,\n\n`\"single\"` allows only one selection, and\n\n`\"single-persist\"` allows one selection and prevents de-selection.",
           "docsTags": [],
           "default": "\"multiple\"",
           "values": [
@@ -1219,7 +1219,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emits when the `expanded` property is toggled.",
+          "docs": "Fires when the `expanded` property is toggled.",
           "docsTags": []
         }
       ],
@@ -2012,7 +2012,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emits when the `open` property is toggled.",
+          "docs": "Fires when the `open` property is toggled.",
           "docsTags": []
         }
       ],
@@ -2325,7 +2325,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emits when the `expanded` property is toggled.",
+          "docs": "Fires when the `expanded` property is toggled.",
           "docsTags": []
         }
       ],
@@ -3467,14 +3467,14 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emits when the component's header is clicked.",
+          "docs": "Fires when the component's header is clicked.",
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use `openClose` events: `calciteBlock[Before]Open` and `calciteBlock[Before]Close` instead."
+              "text": "Use `openClose` events such as `calciteBlockOpen`, `calciteBlockClose`, `calciteBlockBeforeOpen`, and `calciteBlockBeforeClose` instead."
             }
           ],
-          "deprecation": "use `openClose` events: `calciteBlock[Before]Open` and `calciteBlock[Before]Close` instead."
+          "deprecation": "Use `openClose` events such as `calciteBlockOpen`, `calciteBlockClose`, `calciteBlockBeforeOpen`, and `calciteBlockBeforeClose` instead."
         }
       ],
       "listeners": [],
@@ -3680,7 +3680,7 @@
           "mutable": false,
           "attr": "toggle-display",
           "reflectToAttr": true,
-          "docs": "Specifies the component's toggle display -\n\n`\"button\"` (selectable header), or\n\n`\"switch\"` (toggle switch).",
+          "docs": "Specifies how the component's toggle is displayed -\n\n`\"button\"` (selectable header), or\n\n`\"switch\"` (toggle switch).",
           "docsTags": [],
           "default": "\"button\"",
           "values": [
@@ -3733,7 +3733,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emits when the header has been clicked.",
+          "docs": "Fires when the header has been clicked.",
           "docsTags": []
         }
       ],
@@ -4038,7 +4038,7 @@
           "mutable": false,
           "attr": "kind",
           "reflectToAttr": true,
-          "docs": "Specifies the kind of the component (will apply to border and background if applicable).",
+          "docs": "Specifies the kind of the component, which will apply to the border and background if applicable.",
           "docsTags": [],
           "default": "\"brand\"",
           "values": [
@@ -4308,7 +4308,7 @@
           "mutable": false,
           "attr": "type",
           "reflectToAttr": true,
-          "docs": "Specifies the default behavior of the button.",
+          "docs": "Specifies the default behavior of the component.",
           "docsTags": [
             {
               "name": "mdn",
@@ -4821,7 +4821,7 @@
           "mutable": false,
           "attr": "name",
           "reflectToAttr": true,
-          "docs": "Specifies the name of the component on form submission.",
+          "docs": "Specifies the name of the component.\n\nRequired to pass the component's `value` on form submission.",
           "docsTags": [],
           "values": [
             {
@@ -4963,7 +4963,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emits when the component's `checked` status changes.",
+          "docs": "Fires when the component's `checked` status changes.",
           "docsTags": []
         }
       ],
@@ -5587,7 +5587,7 @@
           "mutable": false,
           "attr": "selection-mode",
           "reflectToAttr": true,
-          "docs": "Specifies the selection mode of the component.",
+          "docs": "Specifies the selection mode of the component, where:\n\n`\"multiple\"` allows any number of selections,\n\n`\"single\"` allows only one selection,\n\n`\"single-persist\"` allows one selection and prevents de-selection, and\n\n`\"none\"` does not allow any selections.",
           "docsTags": [],
           "default": "\"none\"",
           "values": [
@@ -5648,7 +5648,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emits when the component's selection changes.",
+          "docs": "Fires when the component's selection changes.",
           "docsTags": []
         }
       ],
@@ -5703,7 +5703,7 @@
           "mutable": false,
           "attr": "allow-empty",
           "reflectToAttr": true,
-          "docs": "When `true`, an empty color (`null`) will be allowed as a `value`. When `false`, a color value is enforced, and clearing the input or blurring will restore the last valid `value`.",
+          "docs": "When `true`, an empty color (`null`) will be allowed as a `value`.\n\nWhen `false`, a color value is enforced, and clearing the input or blurring will restore the last valid `value`.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -5725,7 +5725,7 @@
           "mutable": false,
           "attr": "alpha-channel",
           "reflectToAttr": false,
-          "docs": "When true, the component will allow updates to the color's alpha value.",
+          "docs": "When `true`, the component will allow updates to the color's alpha value.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -5747,7 +5747,7 @@
           "mutable": false,
           "attr": "channels-disabled",
           "reflectToAttr": false,
-          "docs": "When true, hides the RGB/HSV channel inputs",
+          "docs": "When `true`, hides the RGB/HSV channel inputs.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -5873,7 +5873,7 @@
           "mutable": false,
           "attr": "hex-disabled",
           "reflectToAttr": false,
-          "docs": "When true, hides the hex input",
+          "docs": "When `true`, hides the hex input.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -6045,7 +6045,7 @@
           "mutable": false,
           "attr": "saved-disabled",
           "reflectToAttr": true,
-          "docs": "When true, hides the saved colors section",
+          "docs": "When `true`, hides the saved colors section.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -6311,7 +6311,7 @@
           "mutable": false,
           "attr": "allow-empty",
           "reflectToAttr": false,
-          "docs": "When `false`, an empty color (`null`) will be allowed as a `value`. Otherwise, a color value is enforced on the component.\n\nWhen `true`, a color value is enforced, and clearing the input or blurring will restore the last valid `value`. When `false`, an empty color (`null`) will be allowed as a `value`.",
+          "docs": "When `true`, an empty color (`null`) will be allowed as a `value`.\n\nWhen `false`, a color value is enforced, and clearing the input or blurring will restore the last valid `value`.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -6333,7 +6333,7 @@
           "mutable": false,
           "attr": "alpha-channel",
           "reflectToAttr": false,
-          "docs": "When true, the component will allow updates to the color's alpha value.",
+          "docs": "When `true`, the component will allow updates to the color's alpha value.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -7152,7 +7152,7 @@
           "mutable": false,
           "attr": "selection-mode",
           "reflectToAttr": true,
-          "docs": "Specifies the selection mode:\n- \"multiple\" allows any number of selected items (default),\n- \"single\" allows only one selection,\n- \"single-persist\" allow and require one open item,\n- \"ancestors\" is like multiple, but shows ancestors of selected items as selected, with only deepest children shown in chips.",
+          "docs": "Specifies the selection mode of the component, where:\n\n`\"multiple\"` allows any number of selections,\n\n`\"single\"` allows only one selection,\n\n`\"single-persist\"` allows one selection and prevents de-selection, and\n\n`\"ancestors\"` allows multiple selections, but shows ancestors of selected items as selected, with only deepest children shown in chips.",
           "docsTags": [],
           "default": "\"multiple\"",
           "values": [
@@ -7751,7 +7751,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emits whenever the component is selected or unselected.",
+          "docs": "Fires whenever the component is selected or unselected.",
           "docsTags": []
         }
       ],
@@ -8289,7 +8289,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emits when a user changes the component's date. For `range` events, use `calciteDatePickerRangeChange`.",
+          "docs": "Fires when a user changes the component's date. For `range` events, use `calciteDatePickerRangeChange`.",
           "docsTags": []
         },
         {
@@ -8303,7 +8303,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emits when a user changes the component's date `range`. For components without `range` use `calciteDatePickerChange`.",
+          "docs": "Fires when a user changes the component's date `range`. For components without `range` use `calciteDatePickerChange`.",
           "docsTags": []
         }
       ],
@@ -8441,7 +8441,7 @@
           "mutable": false,
           "attr": "end-of-range",
           "reflectToAttr": true,
-          "docs": "Date is the end of date range",
+          "docs": "Date is the end of date range.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8463,7 +8463,7 @@
           "mutable": false,
           "attr": "highlighted",
           "reflectToAttr": true,
-          "docs": "Date is currently highlighted as part of the range",
+          "docs": "Date is currently highlighted as part of the range,",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8507,7 +8507,7 @@
           "mutable": false,
           "attr": "range-hover",
           "reflectToAttr": true,
-          "docs": "Date is being hovered and within the set range",
+          "docs": "Date is being hovered and within the set range.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8587,7 +8587,7 @@
           "mutable": false,
           "attr": "start-of-range",
           "reflectToAttr": true,
-          "docs": "Date is the start of date range",
+          "docs": "Date is the start of date range.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8637,7 +8637,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emitted when user selects day",
+          "docs": "Fires when user selects day.",
           "docsTags": []
         }
       ],
@@ -8685,7 +8685,7 @@
           },
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Date currently active.",
+          "docs": "The currently active Date.",
           "docsTags": [],
           "default": "new Date()",
           "values": [
@@ -8711,7 +8711,7 @@
           },
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "End date currently active",
+          "docs": "End date currently active.",
           "docsTags": [],
           "values": [
             {
@@ -8737,7 +8737,7 @@
           },
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "The range of dates currently being hovered",
+          "docs": "The range of dates currently being hovered.",
           "docsTags": [],
           "values": [
             {
@@ -8935,7 +8935,7 @@
           },
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Focused date with indicator (will become selected date if user proceeds)",
+          "docs": "The focused date is indicated and will become the selected date if the user proceeds.",
           "docsTags": [],
           "values": [
             {
@@ -9009,7 +9009,7 @@
           },
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "CLDR locale data for translated calendar info",
+          "docs": "CLDR locale data for translated calendar info.",
           "docsTags": [],
           "values": [
             {
@@ -9764,7 +9764,7 @@
           "mutable": false,
           "attr": "selection-mode",
           "reflectToAttr": true,
-          "docs": "Specifies the selection mode for `calcite-dropdown-item` children, defaults to `single`:\n- `multiple` allows any number of selected items,\n- `single` allows only one selection (default),\n- `none` doesn't allow for any selection.",
+          "docs": "Specifies the selection mode of the component, where:\n\n`\"multiple\"` allows any number of selections,\n\n`\"single\"` allows only one selection, and\n\n`\"none\"` does not allow any selections.",
           "docsTags": [],
           "default": "\"single\"",
           "values": [
@@ -10703,7 +10703,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "This event fires when the filter text changes.",
+          "docs": "Fires when the filter text changes.",
           "docsTags": []
         }
       ],
@@ -11427,7 +11427,7 @@
           },
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Array of values describing a single color stop ([offset, color, opacity])\nThese color stops should be sorted by offset value",
+          "docs": "Array of values describing a single color stop ([offset, color, opacity])\nThese color stops should be sorted by offset value.",
           "docsTags": [],
           "values": [
             {
@@ -11453,7 +11453,7 @@
           },
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Array of tuples describing a single data point ([x, y])\nThese data points should be sorted by x-axis value",
+          "docs": "Array of tuples describing a single data point ([x, y])\nThese data points should be sorted by x-axis value.",
           "docsTags": [],
           "default": "[]",
           "values": [
@@ -11475,7 +11475,7 @@
           "mutable": false,
           "attr": "highlight-max",
           "reflectToAttr": false,
-          "docs": "End of highlight color if highlighting range",
+          "docs": "End of highlight color if highlighting range.",
           "docsTags": [],
           "values": [
             {
@@ -11496,7 +11496,7 @@
           "mutable": false,
           "attr": "highlight-min",
           "reflectToAttr": false,
-          "docs": "Start of highlight color if highlighting range",
+          "docs": "Start of highlight color if highlighting range.",
           "docsTags": [],
           "values": [
             {
@@ -11517,7 +11517,7 @@
           "mutable": false,
           "attr": "max",
           "reflectToAttr": true,
-          "docs": "Highest point of the range",
+          "docs": "Highest point of the range.",
           "docsTags": [],
           "values": [
             {
@@ -11538,7 +11538,7 @@
           "mutable": false,
           "attr": "min",
           "reflectToAttr": true,
-          "docs": "Lowest point of the range",
+          "docs": "Lowest point of the range.",
           "docsTags": [],
           "values": [
             {
@@ -11607,7 +11607,7 @@
           "mutable": false,
           "attr": "drag-handle",
           "reflectToAttr": true,
-          "docs": "Value for the button title attribute",
+          "docs": "Value for the button title attribute.",
           "docsTags": [],
           "values": [
             {
@@ -11706,7 +11706,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emits whenever the component is selected or unselected.",
+          "docs": "Fires whenever the component is selected or unselected.",
           "docsTags": []
         },
         {
@@ -11726,7 +11726,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emitted when the handle is selected and the up or down arrow key is pressed.",
+          "docs": "Fires when the handle is selected and the up or down arrow key is pressed.",
           "docsTags": []
         }
       ],
@@ -14193,7 +14193,7 @@
           "mutable": true,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "Selected date as a string in ISO format (YYYY-MM-DD)",
+          "docs": "Selected date as a string in ISO format (`\"yyyy-mm-dd\"`).",
           "docsTags": [],
           "default": "\"\"",
           "values": [
@@ -17322,7 +17322,7 @@
           "mutable": false,
           "attr": "mode",
           "reflectToAttr": true,
-          "docs": "This specifies the type of `value` and the associated options presented to the user:\n\nUsing `\"offset\"` will provide options related",
+          "docs": "This specifies the type of `value` and the associated options presented to the user:\n\nUsing `\"offset\"` will provide options that show timezone offsets.\n\nUsing `\"name\"` will provide options that show the IANA time zone names.",
           "docsTags": [
             {
               "name": "default",
@@ -18626,7 +18626,7 @@
           "mutable": false,
           "attr": "selection-mode",
           "reflectToAttr": true,
-          "docs": "Specifies the selection mode - `\"multiple\"` (allow any number of selected items), `\"single\"` (allow one selected item), `\"single-persist\"` (allow one selected item and prevent de-selection), or `\"none\"` (no selected items).",
+          "docs": "Specifies the selection mode of the component, where:\n\n`\"multiple\"` allows any number of selections,\n\n`\"single\"` allows only one selection,\n\n`\"single-persist\"` allows one selection and prevents de-selection, and\n\n`\"none\"` does not allow any selections.",
           "docsTags": [],
           "default": "\"none\"",
           "values": [
@@ -18691,7 +18691,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emitted when the default slot has changes in order to notify parent lists.",
+          "docs": "Fires when the default slot has changes in order to notify parent lists.",
           "docsTags": []
         },
         {
@@ -18705,7 +18705,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emits when any of the list item selections have changed.",
+          "docs": "Fires when the component's selected items have changed.",
           "docsTags": []
         },
         {
@@ -18725,7 +18725,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emits when the component's dragging has ended.",
+          "docs": "Fires when the component's dragging has ended.",
           "docsTags": []
         },
         {
@@ -18745,7 +18745,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emits when the component's dragging has started.",
+          "docs": "Fires when the component's dragging has started.",
           "docsTags": []
         },
         {
@@ -18759,7 +18759,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emits when the component's filter has changed.",
+          "docs": "Fires when the component's filter has changed.",
           "docsTags": []
         },
         {
@@ -18779,7 +18779,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emitted when the order of the list has changed.",
+          "docs": "Fires when the component's item order changes.",
           "docsTags": []
         }
       ],
@@ -19249,7 +19249,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emits when the item's content is selected.",
+          "docs": "Fires when the component is selected.",
           "docsTags": []
         },
         {
@@ -19408,7 +19408,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "Emitted when the default slot has changes in order to notify parent lists.",
+          "docs": "Fires when changes occur in the default slot, notifying parent lists of the changes.",
           "docsTags": []
         }
       ],
@@ -20487,7 +20487,7 @@
           "mutable": false,
           "attr": "range-label-type",
           "reflectToAttr": true,
-          "docs": "When either `rangeLabels` is `true`, specifies the format of displayed labels.",
+          "docs": "When `rangeLabels` is `true`, specifies the format of displayed labels.",
           "docsTags": [],
           "default": "\"percent\"",
           "values": [
@@ -20573,7 +20573,7 @@
           "mutable": false,
           "attr": "unit-label",
           "reflectToAttr": false,
-          "docs": "When `labelType` is `\"units\"` and either `valueLabel` or `rangeLabels` are `true`, displays beside the `value` and/or  `min` values.",
+          "docs": "When `rangeLabelType` is `\"units\"` and either `valueLabel` or `rangeLabels` are `true`, displays beside the `value` and/or  `min` values.",
           "docsTags": [],
           "default": "\"\"",
           "values": [
@@ -20644,7 +20644,7 @@
           "mutable": false,
           "attr": "value-label-type",
           "reflectToAttr": true,
-          "docs": "When either `valueLabel` is `true`, specifies the format of displayed label.",
+          "docs": "When `valueLabel` is `true`, specifies the format of displayed label.",
           "docsTags": [],
           "default": "\"percent\"",
           "values": [
@@ -20840,7 +20840,7 @@
           "mutable": false,
           "attr": "fullscreen",
           "reflectToAttr": true,
-          "docs": "Sets the component to always be fullscreen (overrides `widthScale` and `--calcite-modal-width` / `--calcite-modal-height`).",
+          "docs": "Sets the component to always be fullscreen. Overrides `widthScale` and `--calcite-modal-width` / `--calcite-modal-height`.",
           "docsTags": [],
           "values": [
             {
@@ -20871,7 +20871,7 @@
           "mutable": false,
           "attr": "kind",
           "reflectToAttr": true,
-          "docs": "Specifies the kind of the component (will apply to top border).",
+          "docs": "Specifies the kind of the component, which will apply to top border.",
           "docsTags": [],
           "values": [
             {
@@ -21216,27 +21216,27 @@
         {
           "name": "--calcite-modal-content-background",
           "annotation": "prop",
-          "docs": "Specifies the background color of content placed in the `content` slot."
+          "docs": "Specifies the background color of content placed in the component's `\"content\"` slot."
         },
         {
           "name": "--calcite-modal-content-padding",
           "annotation": "prop",
-          "docs": "Specifies the padding of the modal `content` slot."
+          "docs": "Specifies the padding of the component's `\"content\"` slot."
         },
         {
           "name": "--calcite-modal-height",
           "annotation": "prop",
-          "docs": "Specifies a height of the modal, using `px`, `em`, `rem`, `vh`, or `%`. Will never exceed the height of the viewport. Will not apply if `fullscreen` if set."
+          "docs": "Specifies the height of the component, using `px`, `em`, `rem`, `vh`, or `%`. Will never exceed the height of the viewport. Will not apply if `fullscreen` if set."
         },
         {
           "name": "--calcite-modal-scrim-background",
           "annotation": "prop",
-          "docs": "Specifies the background color of the modal scrim."
+          "docs": "Specifies the background color of the component's scrim."
         },
         {
           "name": "--calcite-modal-width",
           "annotation": "prop",
-          "docs": "Specifies a width of the modal, using `px`, `em`, `rem`, `vw`, or `%`. Will never exceed the width of the viewport. Will not apply if `fullscreen` if set."
+          "docs": "Specifies the width of the component, using `px`, `em`, `rem`, `vw`, or `%`. Will never exceed the width of the viewport. Will not apply if `fullscreen` if set."
         }
       ],
       "slots": [
@@ -21397,7 +21397,7 @@
           },
           "signature": "setFocus() => Promise<void>",
           "parameters": [],
-          "docs": "When `navigation-action` is `true`, sets focus on the component's action element.",
+          "docs": "When `navigationAction` is `true`, sets focus on the component's action element.",
           "docsTags": []
         }
       ],
@@ -21413,7 +21413,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "docs": "When `navigationAction` is true, emits when the displayed action selection changes.",
+          "docs": "When `navigationAction` is `true`, emits when the displayed action selection changes.",
           "docsTags": []
         }
       ],
@@ -21510,7 +21510,7 @@
           "mutable": false,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "When true, the component is highlighted.",
+          "docs": "When `true`, the component is highlighted.",
           "docsTags": [],
           "values": [
             {
@@ -21782,7 +21782,7 @@
           "mutable": false,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "When true, the component is highlighted.",
+          "docs": "When `true`, the component is highlighted.",
           "docsTags": [],
           "values": [
             {
@@ -22080,7 +22080,7 @@
           "mutable": false,
           "attr": "kind",
           "reflectToAttr": true,
-          "docs": "Specifies the kind of the component (will apply to top border and icon).",
+          "docs": "Specifies the kind of the component, which will apply to top border and icon.",
           "docsTags": [],
           "default": "\"brand\"",
           "values": [
@@ -23500,7 +23500,7 @@
           },
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "The currently filtered data.",
+          "docs": "The component's filtered data.",
           "docsTags": [
             {
               "name": "readonly"
@@ -23530,7 +23530,7 @@
           },
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "The currently filtered items.",
+          "docs": "The component's filtered items.",
           "docsTags": [
             {
               "name": "readonly"
@@ -24418,7 +24418,7 @@
           "mutable": false,
           "attr": "closable",
           "reflectToAttr": true,
-          "docs": "When `true`, display a close button within the component.",
+          "docs": "When `true`, displays a close button within the component.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -27121,7 +27121,7 @@
         {
           "name": "--calcite-select-font-size",
           "annotation": "prop",
-          "docs": "The font size of items in the component."
+          "docs": "The font size of `calcite-option`s in the component."
         },
         {
           "name": "--calcite-select-spacing",
@@ -27476,7 +27476,7 @@
           },
           "signature": "setFocus() => Promise<void>",
           "parameters": [],
-          "docs": "Sets focus on the component's \"close\" button (the first focusable item).",
+          "docs": "Sets focus on the component's \"close\" button - the first focusable item.",
           "docsTags": []
         },
         {
@@ -27965,11 +27965,11 @@
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use `displayMode` instead."
+              "text": "Use `displayMode` instead."
             }
           ],
           "default": "false",
-          "deprecation": "use `displayMode` instead.",
+          "deprecation": "Use `displayMode` instead.",
           "values": [
             {
               "type": "boolean"
@@ -27999,10 +27999,10 @@
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use `heightScale` instead."
+              "text": "Use `heightScale` instead."
             }
           ],
-          "deprecation": "use `heightScale` instead.",
+          "deprecation": "Use `heightScale` instead.",
           "values": [
             {
               "value": "l",
@@ -28949,7 +28949,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "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.",
+          "docs": "Fires when the thumb is released on the component.\n\nNote: To constantly listen to the drag event,\nuse `calciteSliderInput` instead.",
           "docsTags": []
         },
         {
@@ -28963,7 +28963,7 @@
           },
           "cancelable": false,
           "composed": true,
-          "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.",
+          "docs": "Fires on all updates to the component.\n\nNote: Fires frequently during drag. To perform\nexpensive operations consider using a debounce or throttle to avoid\nlocking up the main thread.",
           "docsTags": []
         }
       ],
@@ -29406,7 +29406,7 @@
           "mutable": false,
           "attr": "kind",
           "reflectToAttr": true,
-          "docs": "Specifies the kind of the component (will apply to border and background if applicable).",
+          "docs": "Specifies the kind of the component, which will apply to border and background, if applicable.",
           "docsTags": [],
           "default": "\"brand\"",
           "values": [
@@ -30904,7 +30904,7 @@
           },
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "Specifies the component's selected tab-title.",
+          "docs": "Specifies the component's selected `calcite-tab-title`.",
           "docsTags": [
             {
               "name": "readonly"
@@ -31603,7 +31603,7 @@
           "mutable": false,
           "attr": "page-size",
           "reflectToAttr": true,
-          "docs": "Specifies the page size of the component. When `true`, renders `calcite-pagination`",
+          "docs": "Specifies the page size of the component. When `true`, renders `calcite-pagination`.",
           "docsTags": [],
           "default": "0",
           "values": [
@@ -31702,7 +31702,7 @@
           "mutable": false,
           "attr": "selection-mode",
           "reflectToAttr": true,
-          "docs": "Specifies the selection mode of the component.",
+          "docs": "Specifies the selection mode of the component, where:\n\n`\"multiple\"` allows any number of selections,\n\n`\"single\"` allows only one selection, and\n\n`\"none\"` does not allow any selections.",
           "docsTags": [],
           "default": "\"none\"",
           "values": [
@@ -32463,7 +32463,7 @@
           "mutable": false,
           "attr": "position",
           "reflectToAttr": true,
-          "docs": "Specifies the position of `calcite-tab-nav` and `calcite-tab-title` components in relation to the `calcite-tabs`, defaults to `top`.",
+          "docs": "Specifies the position of `calcite-tab-nav` and `calcite-tab-title` components in relation to the `calcite-tabs`.",
           "docsTags": [],
           "default": "\"top\"",
           "values": [
@@ -32496,7 +32496,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "Specifies the size of the component, defaults to `m`.",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -33778,7 +33778,7 @@
           "mutable": false,
           "attr": "type",
           "reflectToAttr": true,
-          "docs": "The selection mode of the component.\n\nUse radio for single selection, and checkbox for multiple selections.",
+          "docs": "The selection mode of the component.\n\nUse `\"radio\"` for single selection, and `\"checkbox\"` for multiple selections.",
           "docsTags": [],
           "default": "\"radio\"",
           "values": [
@@ -35228,7 +35228,7 @@
           "mutable": true,
           "attr": "lines",
           "reflectToAttr": true,
-          "docs": "Displays indentation guide lines.",
+          "docs": "When `true`, displays indentation guide lines.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -35645,7 +35645,7 @@
           },
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "When provided, the method will be called to determine whether the element can  move from the list.",
+          "docs": "When provided, the method will be called to determine whether the element can move from the list.",
           "docsTags": [],
           "values": [
             {
@@ -35996,7 +35996,7 @@
           },
           "signature": "getSelectedItems() => Promise<Map<string, HTMLCalciteValueListItemElement>>",
           "parameters": [],
-          "docs": "Returns the currently selected items",
+          "docs": "Returns the component's selected items.",
           "docsTags": []
         },
         {