@esri/calcite-components 1.0.0-next.647 → 1.0.0-next.649

package/dist/extras/docs-json.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2022-11-29T22:41:44",
+  "timestamp": "2022-11-30T18:01:31",
   "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": [],
@@ -1410,11 +1321,11 @@
       "events": [
         {
           "event": "calciteActionMenuOpenChange",
-          "detail": "any",
+          "detail": "void",
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Emits when the `open` property has changed.\n\n**Note:**: The event payload is deprecated, please use the `open` property on the component instead",
+          "docs": "Emits when the `open` property has changed.",
           "docsTags": []
         }
       ],
@@ -2303,9 +2214,9 @@
       ],
       "usage": {
         "Always-open": "Renders a header and content that remains open - no collapsible option.\n\n```html\n<calcite-block heading=\"When your son becomes a priest, do you call him...\" open>\n  <div>Father or Son?</div>\n</calcite-block>\n```\n",
-        "Basic": "Renders a basic, non-collapsible block.\n\n```html\n<calcite-block heading=\"Fruit\" summary=\"It's nature's candy\"> </calcite-block>\n```\n",
+        "Basic": "Renders a basic, non-collapsible block.\n\n```html\n<calcite-block heading=\"Fruit\" description=\"It's nature's candy\"> </calcite-block>\n```\n",
         "Collapsible": "Renders a header with a clickable icon to toggle the block open and closed.\n\n```html\n<calcite-block heading=\"Domestic pets\" open collapsible>\n  <calcite-block-section text=\"puppers rool, kittehs drule\"> </calcite-block-section>\n</calcite-block>\n```\n",
-        "Header-with-control": "Renders a header and control with a slot for adding a single HTML element (in the header).\n\n```html\n<calcite-block heading=\"This header\" summary=\"it has an input\">\n  <calcite-action icon=\"pencil\" text=\"edit\" slot=\"control\"></calcite-action>\n</calcite-block>\n```\n",
+        "Header-with-control": "Renders a header and control with a slot for adding a single HTML element (in the header).\n\n```html\n<calcite-block heading=\"This header\" description=\"it has an input\">\n  <calcite-action icon=\"pencil\" text=\"edit\" slot=\"control\"></calcite-action>\n</calcite-block>\n```\n",
         "Header-with-icon": "Renders a header and icon with the icon.\n\n```html\n<calcite-block heading=\"Icon't believe it!\">\n  <div slot=\"icon\">🤯</div>\n</calcite-block>\n```\n"
       },
       "props": [
@@ -2342,29 +2253,6 @@
           "optional": false,
           "required": false
         },
-        {
-          "name": "disablePadding",
-          "type": "boolean",
-          "mutable": false,
-          "attr": "disable-padding",
-          "reflectToAttr": true,
-          "docs": "When `true`, removes padding for the slotted content.",
-          "docsTags": [
-            {
-              "name": "deprecated",
-              "text": "Use `--calcite-block-padding` CSS variable instead."
-            }
-          ],
-          "default": "false",
-          "deprecation": "Use `--calcite-block-padding` CSS variable instead.",
-          "values": [
-            {
-              "type": "boolean"
-            }
-          ],
-          "optional": false,
-          "required": false
-        },
         {
           "name": "disabled",
           "type": "boolean",
@@ -2598,28 +2486,6 @@
           ],
           "optional": true,
           "required": false
-        },
-        {
-          "name": "summary",
-          "type": "string",
-          "mutable": false,
-          "attr": "summary",
-          "reflectToAttr": false,
-          "docs": "A description for the component, which displays below the heading.",
-          "docsTags": [
-            {
-              "name": "deprecated",
-              "text": "use `description` instead"
-            }
-          ],
-          "deprecation": "use `description` instead",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false
         }
       ],
       "methods": [],
@@ -6115,7 +5981,7 @@
           "type": "Date",
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "Active date",
+          "docs": "Specifies the component's active date.",
           "docsTags": [],
           "values": [
             {
@@ -6131,7 +5997,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 +6009,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6152,20 +6018,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 +6039,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 +6061,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 +6098,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 +6111,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6254,7 +6120,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 +6133,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6276,7 +6142,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 +6155,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6315,7 +6181,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6324,14 +6190,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 +6205,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 +6221,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 +6236,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 +6344,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6487,7 +6353,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 +6370,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 +6387,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 +6413,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 +6434,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 +6456,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 +6466,7 @@
               "type": "string[]"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -6608,7 +6474,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 +6484,7 @@
               "type": "Date[]"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         }
       ],
@@ -6630,7 +6496,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 +6505,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 +6556,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 +6606,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 +6657,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 +6691,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 +6716,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 +6749,7 @@
           "type": "Date",
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Date value for the day.",
+          "docs": "The component's value.",
           "docsTags": [],
           "values": [
             {
@@ -6986,7 +6852,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 +6867,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 +6883,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 +7009,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 +7046,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 +7062,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 +7078,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 +7108,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 +7123,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 +7139,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 +7233,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 +7256,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 +7273,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 +7296,7 @@
               "type": "Placement[]"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -7439,7 +7305,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 +7322,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 +7361,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 +7404,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 +7429,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 +7450,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 +7472,7 @@
           "mutable": false,
           "attr": "width",
           "reflectToAttr": true,
-          "docs": "specify the width of dropdown",
+          "docs": "Specifies the width of the component.",
           "docsTags": [],
           "values": [
             {
@@ -7622,7 +7488,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         }
       ],
@@ -7687,7 +7553,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 +7600,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 +7633,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 +7644,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 +7660,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 +7685,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 +7723,7 @@
       "slots": [
         {
           "name": "",
-          "docs": "A slot for adding `calcite-dropdown-item` components."
+          "docs": "A slot for adding `calcite-dropdown-item`s."
         }
       ],
       "parts": [],
@@ -7885,15 +7751,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 +7774,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 +7797,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -7940,7 +7806,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 +7822,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -7972,7 +7838,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -7981,14 +7847,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 +7863,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 +7879,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 +7896,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 +7976,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 +7998,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 +8028,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 +8058,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8201,14 +8067,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 +8083,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 +8100,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 +8126,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 +8142,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 +8201,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 +8217,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 +8238,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 +8254,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 +8269,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 +8286,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 +8302,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 +8328,7 @@
           "mutable": true,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "Filter value.",
+          "docs": "The component's value.",
           "docsTags": [],
           "default": "\"\"",
           "values": [
@@ -8494,7 +8360,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 +8458,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 +8478,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 +8492,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 +8508,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 +8525,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 +8558,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 +8582,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8778,7 +8644,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8787,14 +8653,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 +8669,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 +8692,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8835,7 +8701,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 +8718,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 +8735,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 +8768,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         }
       ],
@@ -8981,27 +8847,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 +9113,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 +9130,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 +9152,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "Icon scale.",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -9307,7 +9178,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 +9196,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 +9370,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 +9386,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 +9403,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 +9420,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 +9437,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 +9459,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 +9481,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 +9503,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 +9520,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 +9536,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         }
       ],
@@ -9689,7 +9560,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 +9569,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 +17586,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",