@esri/calcite-components 1.0.0-next.646 → 1.0.0-next.648

package/dist/extras/docs-json.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2022-11-29T22:23:33",
+  "timestamp": "2022-11-30T17:32:46",
   "compiler": {
     "name": "@stencil/core",
-    "version": "2.18.1",
+    "version": "2.19.3",
     "typescriptVersion": "4.7.4"
   },
   "components": [
@@ -10,8 +10,8 @@
       "filePath": "./src/components/accordion/accordion.tsx",
       "encapsulation": "shadow",
       "tag": "calcite-accordion",
-      "readme": "# calcite-accordion\n\n`calcite-accordion` can be used to present content in collapsible sections. Configuration options exist for visual style (icon-position, scale, appearance), and selection functionality. Selection modes include \"multi\", \"single\", and \"single-persist\".\n",
-      "docs": "`calcite-accordion` can be used to present content in collapsible sections. Configuration options exist for visual style (icon-position, scale, appearance), and selection functionality. Selection modes include \"multi\", \"single\", and \"single-persist\".",
+      "readme": "# calcite-accordion\n\n`calcite-accordion` can be used to present content in collapsible sections. Configuration options exist for visual style (icon-position, scale, appearance), and selection functionality.\n",
+      "docs": "`calcite-accordion` can be used to present content in collapsible sections. Configuration options exist for visual style (icon-position, scale, appearance), and selection functionality.",
       "docsTags": [
         {
           "name": "slot",
@@ -19,7 +19,7 @@
         }
       ],
       "usage": {
-        "Basic": "```html\n<calcite-accordion>\n  <calcite-accordion-item heading=\"Accordion Item\">Accordion Section Content </calcite-accordion-item>\n  <calcite-accordion-item heading=\"Accordion Item 2\" active>Accordion Section Content </calcite-accordion-item>\n  <calcite-accordion-item heading=\"Accordion Item 3\">Accordion Section Content </calcite-accordion-item>\n</calcite-accordion>\n```\n"
+        "Basic": "```html\n<calcite-accordion>\n  <calcite-accordion-item heading=\"Accordion Item\">Accordion Section Content </calcite-accordion-item>\n  <calcite-accordion-item heading=\"Accordion Item 2\" expanded>Accordion Section Content </calcite-accordion-item>\n  <calcite-accordion-item heading=\"Accordion Item 3\">Accordion Section Content </calcite-accordion-item>\n</calcite-accordion>\n```\n"
       },
       "props": [
         {
@@ -202,29 +202,6 @@
       ],
       "usage": {},
       "props": [
-        {
-          "name": "active",
-          "type": "boolean",
-          "mutable": true,
-          "attr": "active",
-          "reflectToAttr": true,
-          "docs": "When `true`, the component is active.",
-          "docsTags": [
-            {
-              "name": "deprecated",
-              "text": "use `expanded` instead."
-            }
-          ],
-          "default": "false",
-          "deprecation": "use `expanded` instead.",
-          "values": [
-            {
-              "type": "boolean"
-            }
-          ],
-          "optional": false,
-          "required": false
-        },
         {
           "name": "description",
           "type": "string",
@@ -274,28 +251,6 @@
           "optional": true,
           "required": false
         },
-        {
-          "name": "icon",
-          "type": "string",
-          "mutable": true,
-          "attr": "icon",
-          "reflectToAttr": true,
-          "docs": "Specifies an icon to display.",
-          "docsTags": [
-            {
-              "name": "deprecated",
-              "text": "use `iconStart` or `iconEnd` instead."
-            }
-          ],
-          "deprecation": "use `iconStart` or `iconEnd` instead.",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": true,
-          "required": false
-        },
         {
           "name": "iconEnd",
           "type": "string",
@@ -327,50 +282,6 @@
           ],
           "optional": true,
           "required": false
-        },
-        {
-          "name": "itemSubtitle",
-          "type": "string",
-          "mutable": false,
-          "attr": "item-subtitle",
-          "reflectToAttr": false,
-          "docs": "Specifies a subtitle for the component.",
-          "docsTags": [
-            {
-              "name": "deprecated",
-              "text": "Use `description` instead."
-            }
-          ],
-          "deprecation": "Use `description` instead.",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": true,
-          "required": false
-        },
-        {
-          "name": "itemTitle",
-          "type": "string",
-          "mutable": false,
-          "attr": "item-title",
-          "reflectToAttr": false,
-          "docs": "Specifies a title for the component.",
-          "docsTags": [
-            {
-              "name": "deprecated",
-              "text": "Use `heading` instead."
-            }
-          ],
-          "deprecation": "Use `heading` instead.",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": true,
-          "required": false
         }
       ],
       "methods": [],
@@ -6115,7 +6026,7 @@
           "type": "Date",
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "Active date",
+          "docs": "Specifies the component's active date.",
           "docsTags": [],
           "values": [
             {
@@ -6131,7 +6042,7 @@
           "mutable": false,
           "attr": "active-range",
           "reflectToAttr": true,
-          "docs": "Active range",
+          "docs": "When `range` is true, specifies the active `range`. Where `\"start\"` specifies the starting range date and `\"end\"` the ending range date.",
           "docsTags": [],
           "values": [
             {
@@ -6143,7 +6054,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6152,20 +6063,20 @@
           "mutable": true,
           "attr": "end",
           "reflectToAttr": true,
-          "docs": "Selected end date",
+          "docs": "Specifies the selected end date.",
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use value instead"
+              "text": "use `value` instead."
             }
           ],
-          "deprecation": "use value instead",
+          "deprecation": "use `value` instead.",
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6173,20 +6084,20 @@
           "type": "Date",
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "Selected end date as full date object",
+          "docs": "Specifies the selected end date as a full date object.",
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use valueAsDate instead"
+              "text": "use `valueAsDate` instead."
             }
           ],
-          "deprecation": "use valueAsDate instead",
+          "deprecation": "use `valueAsDate` instead.",
           "values": [
             {
               "type": "Date"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6195,7 +6106,7 @@
           "mutable": false,
           "attr": "heading-level",
           "reflectToAttr": true,
-          "docs": "Number at which section headings should start for this component.",
+          "docs": "Specifies the number at which section headings should start.",
           "docsTags": [],
           "values": [
             {
@@ -6232,7 +6143,7 @@
           "mutable": false,
           "attr": "intl-next-month",
           "reflectToAttr": false,
-          "docs": "Localized string for \"next month\" (used for aria label)",
+          "docs": "Accessible name for the component's next month button.",
           "docsTags": [
             {
               "name": "default",
@@ -6245,7 +6156,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6254,7 +6165,7 @@
           "mutable": false,
           "attr": "intl-prev-month",
           "reflectToAttr": false,
-          "docs": "Localized string for \"previous month\" (used for aria label)",
+          "docs": "Accessible name for the component's previous month button.",
           "docsTags": [
             {
               "name": "default",
@@ -6267,7 +6178,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6276,7 +6187,7 @@
           "mutable": false,
           "attr": "intl-year",
           "reflectToAttr": false,
-          "docs": "Localized string for \"year\" (used for aria label)",
+          "docs": "Accessible name for the component's year input.",
           "docsTags": [
             {
               "name": "default",
@@ -6289,7 +6200,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6315,7 +6226,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6324,14 +6235,14 @@
           "mutable": true,
           "attr": "max",
           "reflectToAttr": true,
-          "docs": "Latest allowed date (\"yyyy-mm-dd\")",
+          "docs": "Specifies the latest allowed date (`\"yyyy-mm-dd\"`).",
           "docsTags": [],
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6339,14 +6250,14 @@
           "type": "Date",
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "Latest allowed date as full date object",
+          "docs": "Specifies the latest allowed date as a full date object (`new Date(\"yyyy-mm-dd\")`).",
           "docsTags": [],
           "values": [
             {
               "type": "Date"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6355,14 +6266,14 @@
           "mutable": true,
           "attr": "min",
           "reflectToAttr": true,
-          "docs": "Earliest allowed date (\"yyyy-mm-dd\")",
+          "docs": "Specifies the earliest allowed date (`\"yyyy-mm-dd\"`).",
           "docsTags": [],
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6370,14 +6281,14 @@
           "type": "Date",
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "Earliest allowed date as full date object",
+          "docs": "Specifies the earliest allowed date as a full date object (`new Date(\"yyyy-mm-dd\")`).",
           "docsTags": [],
           "values": [
             {
               "type": "Date"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6478,7 +6389,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6487,7 +6398,7 @@
           "mutable": false,
           "attr": "proximity-selection-disabled",
           "reflectToAttr": true,
-          "docs": "Disables the default behaviour on the third click of narrowing or extending the range and instead starts a new range.",
+          "docs": "When `true`, disables the default behavior on the third click of narrowing or extending the range and instead starts a new range.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -6504,7 +6415,7 @@
           "mutable": false,
           "attr": "range",
           "reflectToAttr": true,
-          "docs": "Range mode activation",
+          "docs": "When `true`, activates the component's range mode to allow a start and end date.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -6521,7 +6432,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of the date picker",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -6547,20 +6458,20 @@
           "mutable": true,
           "attr": "start",
           "reflectToAttr": true,
-          "docs": "Selected start date",
+          "docs": "Specifies the selected start date.",
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use value instead"
+              "text": "use `value` instead."
             }
           ],
-          "deprecation": "use value instead",
+          "deprecation": "use `value` instead.",
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6568,20 +6479,20 @@
           "type": "Date",
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "Selected start date as full date object",
+          "docs": "Specifies the selected start date as a full date object.",
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use valueAsDate instead"
+              "text": "use `valueAsDate` instead."
             }
           ],
-          "deprecation": "use valueAsDate instead",
+          "deprecation": "use `valueAsDate` instead.",
           "values": [
             {
               "type": "Date"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6590,7 +6501,7 @@
           "mutable": true,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "Selected date",
+          "docs": "Specifies the selected date as a string (`\"yyyy-mm-dd\"`), or an array of strings for `range` values (`[\"yyyy-mm-dd\", \"yyyy-mm-dd\"]`).",
           "docsTags": [],
           "values": [
             {
@@ -6600,7 +6511,7 @@
               "type": "string[]"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6608,7 +6519,7 @@
           "type": "Date | Date[]",
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "Selected date as full date object",
+          "docs": "Specifies the selected date as a full date object (`new Date(\"yyyy-mm-dd\")`), or an array containing full date objects (`[new Date(\"yyyy-mm-dd\"), new Date(\"yyyy-mm-dd\")]`).",
           "docsTags": [],
           "values": [
             {
@@ -6618,7 +6529,7 @@
               "type": "Date[]"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         }
       ],
@@ -6630,7 +6541,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Trigger calcite date change when a user changes the date.",
+          "docs": "Emits when a user changes the component's date. For `range` events, use `calciteDatePickerRangeChange`.",
           "docsTags": []
         },
         {
@@ -6639,7 +6550,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Trigger calcite date change when a user changes the date range.",
+          "docs": "Emits when a user changes the component's date `range`. For components without `range` use `calciteDatePickerChange`.",
           "docsTags": [
             {
               "name": "see",
@@ -6690,7 +6601,7 @@
           "mutable": false,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "Date is actively in focus for keyboard navigation",
+          "docs": "When `true`, the component is active.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -6740,7 +6651,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "Date is outside of range and can't be selected",
+          "docs": "When `true`, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -6791,7 +6702,7 @@
           "mutable": false,
           "attr": "range",
           "reflectToAttr": true,
-          "docs": "Showing date range",
+          "docs": "When `true`, activates the component's range mode to allow a start and end date.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -6825,7 +6736,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of the date picker",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "values": [
             {
@@ -6850,7 +6761,7 @@
           "mutable": false,
           "attr": "selected",
           "reflectToAttr": true,
-          "docs": "Date is the current selected date of the picker",
+          "docs": "When `true`, the component is selected.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -6883,7 +6794,7 @@
           "type": "Date",
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Date value for the day.",
+          "docs": "The component's value.",
           "docsTags": [],
           "values": [
             {
@@ -6986,7 +6897,7 @@
           "type": "Date",
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Maximum date of the calendar above which is disabled.",
+          "docs": "Specifies the latest allowed date (`\"yyyy-mm-dd\"`).",
           "docsTags": [],
           "values": [
             {
@@ -7001,7 +6912,7 @@
           "type": "Date",
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Minimum date of the calendar below which is disabled.",
+          "docs": "Specifies the earliest allowed date (`\"yyyy-mm-dd\"`).",
           "docsTags": [],
           "values": [
             {
@@ -7017,7 +6928,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of the date picker",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "values": [
             {
@@ -7143,7 +7054,7 @@
           "mutable": false,
           "attr": "heading-level",
           "reflectToAttr": false,
-          "docs": "Number at which section headings should start for this component.",
+          "docs": "Specifies the number at which section headings should start.",
           "docsTags": [],
           "values": [
             {
@@ -7180,7 +7091,7 @@
           "mutable": false,
           "attr": "intl-next-month",
           "reflectToAttr": false,
-          "docs": "Localized string for next month.",
+          "docs": "Accessible name for the component's next month button.",
           "docsTags": [],
           "values": [
             {
@@ -7196,7 +7107,7 @@
           "mutable": false,
           "attr": "intl-prev-month",
           "reflectToAttr": false,
-          "docs": "Localized string for previous month.",
+          "docs": "Accessible name for the component's previous month button.",
           "docsTags": [],
           "values": [
             {
@@ -7212,7 +7123,7 @@
           "mutable": false,
           "attr": "intl-year",
           "reflectToAttr": false,
-          "docs": "Localized string for year.",
+          "docs": "Accessible name for the component's year input.",
           "docsTags": [],
           "values": [
             {
@@ -7242,7 +7153,7 @@
           "type": "Date",
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Maximum date of the calendar above which is disabled.",
+          "docs": "Specifies the latest allowed date (`\"yyyy-mm-dd\"`).",
           "docsTags": [],
           "values": [
             {
@@ -7257,7 +7168,7 @@
           "type": "Date",
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Minimum date of the calendar below which is disabled.",
+          "docs": "Specifies the earliest allowed date (`\"yyyy-mm-dd\"`).",
           "docsTags": [],
           "values": [
             {
@@ -7273,7 +7184,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of the date picker",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "values": [
             {
@@ -7367,15 +7278,15 @@
           "mutable": true,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "Opens or closes the dropdown",
+          "docs": "When `true`, displays and positions the component.",
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use open instead."
+              "text": "use `open` instead."
             }
           ],
           "default": "false",
-          "deprecation": "use open instead.",
+          "deprecation": "use `open` instead.",
           "values": [
             {
               "type": "boolean"
@@ -7390,7 +7301,7 @@
           "mutable": false,
           "attr": "disable-close-on-select",
           "reflectToAttr": true,
-          "docs": "allow the dropdown to remain open after a selection is made\nif the selection-mode of the selected item's containing group is \"none\", the dropdown will always close",
+          "docs": "When `true`, the component will remain open after a selection is made.\n\nIf the `selectionMode` of the selected `calcite-dropdown-item`'s containing `calcite-dropdown-group` is `\"none\"`, the component will always close.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -7407,7 +7318,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "is the dropdown disabled",
+          "docs": "When `true`, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -7430,7 +7341,7 @@
               "type": "Placement[]"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -7439,7 +7350,7 @@
           "mutable": false,
           "attr": "max-items",
           "reflectToAttr": true,
-          "docs": "specify the maximum number of calcite-dropdown-items to display before showing the scroller, must be greater than 0 -\nthis value does not include groupTitles passed to calcite-dropdown-group",
+          "docs": "Specifies the maximum number of `calcite-dropdown-item`s to display before showing a scroller.\nValue must be greater than `0`, and does not include `groupTitle`'s from `calcite-dropdown-group`.",
           "docsTags": [],
           "default": "0",
           "values": [
@@ -7456,7 +7367,7 @@
           "mutable": true,
           "attr": "open",
           "reflectToAttr": true,
-          "docs": "When true, opens the dropdown",
+          "docs": "When `true`, displays and positions the component.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -7495,7 +7406,7 @@
           "mutable": false,
           "attr": "placement",
           "reflectToAttr": true,
-          "docs": "Determines where the dropdown will be positioned relative to the button.",
+          "docs": "Determines where the component will be positioned relative to the container element.",
           "docsTags": [
             {
               "name": "default",
@@ -7538,7 +7449,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of dropdown, defaults to m",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -7563,7 +7474,7 @@
           "type": "HTMLCalciteDropdownItemElement[]",
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "**read-only** The currently selected items",
+          "docs": "Specifies the component's selected items.",
           "docsTags": [
             {
               "name": "readonly"
@@ -7584,7 +7495,7 @@
           "mutable": false,
           "attr": "type",
           "reflectToAttr": true,
-          "docs": "specify whether the dropdown is opened by hover or click of a trigger element",
+          "docs": "Specifies the action to open the component from the container element.",
           "docsTags": [],
           "default": "\"click\"",
           "values": [
@@ -7606,7 +7517,7 @@
           "mutable": false,
           "attr": "width",
           "reflectToAttr": true,
-          "docs": "specify the width of dropdown",
+          "docs": "Specifies the width of the component.",
           "docsTags": [],
           "values": [
             {
@@ -7622,7 +7533,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         }
       ],
@@ -7687,7 +7598,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "fires when a dropdown item has been selected or deselected",
+          "docs": "Fires when a `calcite-dropdown-item`'s selection changes.",
           "docsTags": []
         }
       ],
@@ -7734,7 +7645,7 @@
         {
           "name": "--calcite-dropdown-width",
           "annotation": "prop",
-          "docs": "the width of the dropdown wrapper"
+          "docs": "Specifies the width of the component's wrapper."
         }
       ],
       "slots": [
@@ -7767,7 +7678,7 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "- A slot for adding `calcite-dropdown-item` components."
+          "text": "- A slot for adding `calcite-dropdown-item`s."
         }
       ],
       "usage": {},
@@ -7778,14 +7689,14 @@
           "mutable": false,
           "attr": "group-title",
           "reflectToAttr": true,
-          "docs": "optionally set a group title for display",
+          "docs": "Specifies and displays a group title.",
           "docsTags": [],
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -7794,7 +7705,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "Specifies the size of the action.",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "values": [
             {
@@ -7819,7 +7730,7 @@
           "mutable": false,
           "attr": "selection-mode",
           "reflectToAttr": true,
-          "docs": "specify the selection mode - multiple (allow any number of (or no) active items), single (allow and require one active item),\nnone (no active items), defaults to single",
+          "docs": "Specifies the component's selection mode, where\n`\"multi\"` allows any number of (or no) selected `calcite-dropdown-item`s,\n`\"single\"` allows and requires one selected `calcite-dropdown-item`, and\n`\"none\"` does not allow selection on `calcite-dropdown-item`s.",
           "docsTags": [],
           "default": "\"single\"",
           "values": [
@@ -7857,7 +7768,7 @@
       "slots": [
         {
           "name": "",
-          "docs": "A slot for adding `calcite-dropdown-item` components."
+          "docs": "A slot for adding `calcite-dropdown-item`s."
         }
       ],
       "parts": [],
@@ -7885,15 +7796,15 @@
           "mutable": true,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "Indicates whether the item is active.",
+          "docs": "When `true`, the component is selected.",
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "Use selected instead."
+              "text": "Use `selected` instead."
             }
           ],
           "default": "false",
-          "deprecation": "Use selected instead.",
+          "deprecation": "Use `selected` instead.",
           "values": [
             {
               "type": "boolean"
@@ -7908,14 +7819,14 @@
           "mutable": false,
           "attr": "href",
           "reflectToAttr": true,
-          "docs": "optionally pass a href - used to determine if the component should render as anchor",
+          "docs": "Specifies the URL of the linked resource, which can be set as an absolute or relative path.\n\nDetermines if the component will render as an anchor.",
           "docsTags": [],
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -7931,7 +7842,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -7940,7 +7851,7 @@
           "mutable": false,
           "attr": "icon-flip-rtl",
           "reflectToAttr": true,
-          "docs": "When true, the icon will be flipped when the element direction is right-to-left (`\"rtl\"`).",
+          "docs": "When `true`, the icon will be flipped when the element direction is right-to-left (`\"rtl\"`).",
           "docsTags": [],
           "values": [
             {
@@ -7956,7 +7867,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -7972,7 +7883,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -7981,14 +7892,14 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "Applies to the aria-label attribute on the button or hyperlink",
+          "docs": "Accessible name for the component.",
           "docsTags": [],
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -7997,14 +7908,14 @@
           "mutable": false,
           "attr": "rel",
           "reflectToAttr": true,
-          "docs": "The rel attribute to apply to the hyperlink",
+          "docs": "Specifies the relationship to the linked document defined in `href`.",
           "docsTags": [],
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8013,7 +7924,7 @@
           "mutable": true,
           "attr": "selected",
           "reflectToAttr": true,
-          "docs": "When true, item is selected",
+          "docs": "When `true`, the component is selected.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8030,14 +7941,14 @@
           "mutable": false,
           "attr": "target",
           "reflectToAttr": true,
-          "docs": "The target attribute to apply to the hyperlink",
+          "docs": "Specifies the frame or window to open the linked document.",
           "docsTags": [],
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         }
       ],
@@ -8110,7 +8021,7 @@
           "mutable": false,
           "attr": "appearance",
           "reflectToAttr": true,
-          "docs": "Used to set the button's appearance. Default is outline.",
+          "docs": "Specifies the appearance style of the component.",
           "docsTags": [],
           "default": "\"outline\"",
           "values": [
@@ -8132,7 +8043,7 @@
           "mutable": false,
           "attr": "color",
           "reflectToAttr": true,
-          "docs": "Used to set the button's color. Default is light.",
+          "docs": "Specifies the color of the component.",
           "docsTags": [],
           "default": "\"neutral\"",
           "values": [
@@ -8162,7 +8073,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, disabled prevents interaction. This state shows items with lower opacity/grayed.",
+          "docs": "When `true`, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8192,7 +8103,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8201,14 +8112,14 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "Label of the FAB, exposed on hover when textEnabled is false. If no label is provided, the label inherits what's provided for the `text` prop.",
+          "docs": "Accessible name for the component.",
           "docsTags": [],
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8217,7 +8128,7 @@
           "mutable": false,
           "attr": "loading",
           "reflectToAttr": true,
-          "docs": "When true, content is waiting to be loaded. This state shows a busy indicator.",
+          "docs": "When `true`, a busy indicator is displayed.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8234,7 +8145,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "Specifies the size of the fab.",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -8260,14 +8171,14 @@
           "mutable": false,
           "attr": "text",
           "reflectToAttr": false,
-          "docs": "Text that accompanies the FAB icon.",
+          "docs": "Specifies text to accompany the component's icon.",
           "docsTags": [],
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8276,7 +8187,7 @@
           "mutable": false,
           "attr": "text-enabled",
           "reflectToAttr": true,
-          "docs": "Indicates whether the text is displayed.",
+          "docs": "When `true`, displays the `text` value in the component.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8335,7 +8246,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, disabled prevents interaction. This state shows items with lower opacity/grayed.",
+          "docs": "When `true`, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8351,7 +8262,7 @@
           "type": "object[]",
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "The resulting items after filtering.",
+          "docs": "The component's resulting items after filtering.",
           "docsTags": [
             {
               "name": "readonly"
@@ -8372,14 +8283,14 @@
           "mutable": false,
           "attr": "intl-clear",
           "reflectToAttr": false,
-          "docs": "A text label that will appear on the clear button.",
+          "docs": "Accessible name for the component's clear button.",
           "docsTags": [],
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8388,14 +8299,14 @@
           "mutable": false,
           "attr": "intl-label",
           "reflectToAttr": false,
-          "docs": "A text label that will appear next to the input field.",
+          "docs": "Accessible name for the component.",
           "docsTags": [],
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8403,7 +8314,7 @@
           "type": "object[]",
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "The items to filter through. The filter uses this as the starting point, and returns items\nthat contain the string entered in the input, using a partial match and recursive search.\n\nThis property is required.",
+          "docs": "Defines the items to filter. The component uses the values as the starting point, and returns items\n\nthat contain the string entered in the input, using a partial match and recursive search.\n\nThis property is needed to conduct filtering.",
           "docsTags": [],
           "default": "[]",
           "values": [
@@ -8420,14 +8331,14 @@
           "mutable": false,
           "attr": "placeholder",
           "reflectToAttr": false,
-          "docs": "Placeholder text for the input element's placeholder attribute",
+          "docs": "Specifies placeholder text for the input element.",
           "docsTags": [],
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8436,7 +8347,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of filter, defaults to m",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -8462,7 +8373,7 @@
           "mutable": true,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "Filter value.",
+          "docs": "The component's value.",
           "docsTags": [],
           "default": "\"\"",
           "values": [
@@ -8494,7 +8405,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "This event fires when the filter text changes.",
+          "docs": "Fires when the component's text changes.",
           "docsTags": []
         }
       ],
@@ -8592,19 +8503,19 @@
         },
         {
           "name": "slot",
-          "text": "header-actions-start - A slot for adding actions or content to the start side of the header."
+          "text": "header-actions-start - A slot for adding `calcite-action`s or content to the start side of the component's header."
         },
         {
           "name": "slot",
-          "text": "header-actions-end - A slot for adding actions or content to the end side of the header."
+          "text": "header-actions-end - A slot for adding `calcite-action`s or content to the end side of the component's header."
         },
         {
           "name": "slot",
-          "text": "header-content - A slot for adding custom content to the header."
+          "text": "header-content - A slot for adding custom content to the component's header."
         },
         {
           "name": "slot",
-          "text": "header-menu-actions - A slot for adding an overflow menu with actions inside a `calcite-dropdown`."
+          "text": "header-menu-actions - A slot for adding an overflow menu with `calcite-action`s inside a `calcite-dropdown`."
         },
         {
           "name": "slot",
@@ -8612,11 +8523,11 @@
         },
         {
           "name": "slot",
-          "text": "footer-actions - A slot for adding buttons to the footer."
+          "text": "footer-actions - A slot for adding `calcite-button`s to the component's footer."
         },
         {
           "name": "slot",
-          "text": "footer - A slot for adding custom content to the footer."
+          "text": "footer - A slot for adding custom content to the component's footer."
         }
       ],
       "usage": {},
@@ -8626,14 +8537,14 @@
           "type": "() => Promise<void>",
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "When provided, this method will be called before it is removed from the parent flow.",
+          "docs": "When provided, the method will be called before it is removed from its parent `calcite-flow`.",
           "docsTags": [],
           "values": [
             {
               "type": "() => Promise<void>"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8642,7 +8553,7 @@
           "mutable": true,
           "attr": "closable",
           "reflectToAttr": true,
-          "docs": "When true, displays a close button in the trailing side of the header",
+          "docs": "When `true`, displays a close button in the trailing side of the component's header.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8659,7 +8570,7 @@
           "mutable": true,
           "attr": "closed",
           "reflectToAttr": true,
-          "docs": "When true, flow-item will be hidden",
+          "docs": "When `true`, the component will be hidden.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8692,7 +8603,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, interaction is prevented and the component is displayed with lower opacity.",
+          "docs": "When `true`, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8716,7 +8627,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8778,7 +8689,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8787,14 +8698,14 @@
           "mutable": false,
           "attr": "intl-back",
           "reflectToAttr": false,
-          "docs": "Accessible name for the component's back button. The back button will only be shown when 'showBackButton' is true.",
+          "docs": "When `showBackButton` is `true`, the accessible name for the component's back button.",
           "docsTags": [],
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8803,14 +8714,14 @@
           "mutable": false,
           "attr": "intl-close",
           "reflectToAttr": false,
-          "docs": "Accessible name for the component's close button. The close button will only be shown when 'closable' is true.",
+          "docs": "When `closable` is `true`, the accessible name for the component's close button.",
           "docsTags": [],
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8826,7 +8737,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8835,7 +8746,7 @@
           "mutable": false,
           "attr": "loading",
           "reflectToAttr": true,
-          "docs": "When true, a busy indicator is displayed.",
+          "docs": "When `true`, a busy indicator is displayed.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8852,7 +8763,7 @@
           "mutable": false,
           "attr": "menu-open",
           "reflectToAttr": true,
-          "docs": "When true, the action menu items in the `header-menu-actions` slot are open.",
+          "docs": "When `true`, the action menu items in the `header-menu-actions` slot are open.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8869,7 +8780,7 @@
           "mutable": false,
           "attr": "show-back-button",
           "reflectToAttr": true,
-          "docs": "When true, displays a back button in the header.",
+          "docs": "When `true`, displays a back button in the component's header.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8902,7 +8813,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         }
       ],
@@ -8981,27 +8892,27 @@
         },
         {
           "name": "footer",
-          "docs": "A slot for adding custom content to the footer."
+          "docs": "A slot for adding custom content to the component's footer."
         },
         {
           "name": "footer-actions",
-          "docs": "A slot for adding buttons to the footer."
+          "docs": "A slot for adding `calcite-button`s to the component's footer."
         },
         {
           "name": "header-actions-end",
-          "docs": "A slot for adding actions or content to the end side of the header."
+          "docs": "A slot for adding `calcite-action`s or content to the end side of the component's header."
         },
         {
           "name": "header-actions-start",
-          "docs": "A slot for adding actions or content to the start side of the header."
+          "docs": "A slot for adding `calcite-action`s or content to the start side of the component's header."
         },
         {
           "name": "header-content",
-          "docs": "A slot for adding custom content to the header."
+          "docs": "A slot for adding custom content to the component's header."
         },
         {
           "name": "header-menu-actions",
-          "docs": "A slot for adding an overflow menu with actions inside a `calcite-dropdown`."
+          "docs": "A slot for adding an overflow menu with `calcite-action`s inside a `calcite-dropdown`."
         }
       ],
       "parts": [],
@@ -9247,7 +9158,7 @@
           "mutable": false,
           "attr": "flip-rtl",
           "reflectToAttr": true,
-          "docs": "When true, the icon will be flipped when the element direction is 'rtl'.",
+          "docs": "When `true`, the icon will be flipped when the element direction is right-to-left (`\"rtl\"`).",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -9264,8 +9175,13 @@
           "mutable": false,
           "attr": "icon",
           "reflectToAttr": true,
-          "docs": "The name of the icon to display. The value of this property must match the icon name from https://esri.github.io/calcite-ui-icons/.",
-          "docsTags": [],
+          "docs": "Displays a specific icon.",
+          "docsTags": [
+            {
+              "name": "see",
+              "text": "[Icons](https://esri.github.io/calcite-ui-icons)"
+            }
+          ],
           "default": "null",
           "values": [
             {
@@ -9281,7 +9197,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "Icon scale.",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -9307,7 +9223,7 @@
           "mutable": false,
           "attr": "text-label",
           "reflectToAttr": false,
-          "docs": "The icon label.\n\nIt is recommended to set this value if your icon is semantic.",
+          "docs": "Accessible name for the component.\n\nIt is recommended to set this value if your icon is semantic.",
           "docsTags": [],
           "values": [
             {
@@ -9325,7 +9241,7 @@
         {
           "name": "--calcite-ui-icon-color",
           "annotation": "prop",
-          "docs": "the color of the icon. Defaults to 'currentColor'."
+          "docs": "The component's color. Defaults to `currentColor`."
         }
       ],
       "slots": [],
@@ -9499,14 +9415,14 @@
           "type": "() => Promise<void>",
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "when controls, specify a callback to be executed prior to disabling editing. when provided, loading state will be handled automatically.",
+          "docs": "Specifies a callback to be executed prior to disabling editing via the controls. When provided, the component's loading state will be handled automatically.",
           "docsTags": [],
           "values": [
             {
               "type": "() => Promise<void>"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -9515,7 +9431,7 @@
           "mutable": false,
           "attr": "controls",
           "reflectToAttr": true,
-          "docs": "specify whether save/cancel controls should be displayed when editingEnabled is true, defaults to false",
+          "docs": "When `true` and `editingEnabled` is `true`, displays save and cancel controls on the component.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -9532,7 +9448,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "specify whether editing can be enabled",
+          "docs": "When `true`, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -9549,7 +9465,7 @@
           "mutable": true,
           "attr": "editing-enabled",
           "reflectToAttr": true,
-          "docs": "specify whether the wrapped input element is editable, defaults to false",
+          "docs": "When `true`, inline editing is enabled on the component.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -9566,7 +9482,7 @@
           "mutable": false,
           "attr": "intl-cancel-editing",
           "reflectToAttr": true,
-          "docs": "specify text to be user for the cancel editing button's aria-label, defaults to `Cancel`",
+          "docs": "Accessible name for the component's cancel editing button.",
           "docsTags": [
             {
               "name": "default",
@@ -9588,7 +9504,7 @@
           "mutable": false,
           "attr": "intl-confirm-changes",
           "reflectToAttr": true,
-          "docs": "specify text to be user for the confirm changes button's aria-label, defaults to `Save`",
+          "docs": "Accessible name for the component's confirm edits button.",
           "docsTags": [
             {
               "name": "default",
@@ -9610,7 +9526,7 @@
           "mutable": false,
           "attr": "intl-enable-editing",
           "reflectToAttr": true,
-          "docs": "specify text to be user for the enable editing button's aria-label, defaults to `Click to edit`",
+          "docs": "Accessible name for the component's enable editing button.",
           "docsTags": [
             {
               "name": "default",
@@ -9632,7 +9548,7 @@
           "mutable": true,
           "attr": "loading",
           "reflectToAttr": true,
-          "docs": "specify whether the confirm button should display a loading state, defaults to false",
+          "docs": "When `true`, a busy indicator is displayed.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -9649,7 +9565,7 @@
           "mutable": true,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of the inline-editable component, defaults to the scale of the wrapped calcite-input or the scale of the closest wrapping component with a set scale",
+          "docs": "Specifies the size of the component. Defaults to the scale of the wrapped `calcite-input` or the scale of the closest wrapping component with a set scale.",
           "docsTags": [],
           "values": [
             {
@@ -9665,7 +9581,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         }
       ],
@@ -9689,7 +9605,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Emitted when the cancel button gets clicked.",
+          "docs": "Emits when the component's \"cancel editing\" button is pressed.",
           "docsTags": []
         },
         {
@@ -9698,7 +9614,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Emitted when the check button gets clicked.",
+          "docs": "Emits when the component's \"confirm edits\" button is pressed.",
           "docsTags": []
         }
       ],
@@ -17715,80 +17631,6 @@
         ]
       }
     },
-    {
-      "filePath": "./src/components/popover-manager/popover-manager.tsx",
-      "encapsulation": "shadow",
-      "tag": "calcite-popover-manager",
-      "readme": "# calcite-popover-manager\n",
-      "docs": "",
-      "docsTags": [
-        {
-          "name": "slot",
-          "text": "- A slot for adding elements that reference a 'calcite-popover' by the 'selector' property."
-        },
-        {
-          "name": "deprecated",
-          "text": "No longer required for popover usage."
-        }
-      ],
-      "usage": {},
-      "props": [
-        {
-          "name": "autoClose",
-          "type": "boolean",
-          "mutable": false,
-          "attr": "auto-close",
-          "reflectToAttr": true,
-          "docs": "Automatically closes any currently open popovers when clicking outside of a popover.",
-          "docsTags": [],
-          "default": "false",
-          "values": [
-            {
-              "type": "boolean"
-            }
-          ],
-          "optional": false,
-          "required": false
-        },
-        {
-          "name": "selector",
-          "type": "string",
-          "mutable": false,
-          "attr": "selector",
-          "reflectToAttr": true,
-          "docs": "CSS Selector to match reference elements for popovers. Reference elements will be identified by this selector in order to open their associated popover.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "`[data-calcite-popover-reference]`"
-            }
-          ],
-          "default": "\"[data-calcite-popover-reference]\"",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false
-        }
-      ],
-      "methods": [],
-      "events": [],
-      "listeners": [],
-      "styles": [],
-      "slots": [
-        {
-          "name": "",
-          "docs": "A slot for adding elements that reference a 'calcite-popover' by the 'selector' property."
-        }
-      ],
-      "parts": [],
-      "dependents": [],
-      "dependencies": [],
-      "dependencyGraph": {},
-      "deprecation": "No longer required for popover usage."
-    },
     {
       "filePath": "./src/components/progress/progress.tsx",
       "encapsulation": "shadow",