@esri/calcite-components 1.0.0-beta.80 → 1.0.0-beta.83

package/dist/extras/docs-json.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2022-03-17T01:01:20",
+  "timestamp": "2022-06-07T00:59:50",
   "compiler": {
     "name": "@stencil/core",
-    "version": "2.14.1",
+    "version": "2.16.0",
     "typescriptVersion": "4.5.4"
   },
   "components": [
@@ -153,17 +153,17 @@
       "events": [],
       "listeners": [
         {
-          "event": "calciteAccordionItemKeyEvent",
+          "event": "calciteInternalAccordionItemKeyEvent",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteAccordionItemRegister",
+          "event": "calciteInternalAccordionItemRegister",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteAccordionItemSelect",
+          "event": "calciteInternalAccordionItemSelect",
           "capture": false,
           "passive": false
         }
@@ -269,7 +269,7 @@
           "passive": false
         },
         {
-          "event": "calciteAccordionChange",
+          "event": "calciteInternalAccordionChange",
           "target": "body",
           "capture": false,
           "passive": false
@@ -812,7 +812,12 @@
           "signature": "setFocus(focusId?: \"expand-toggle\") => Promise<void>",
           "parameters": [],
           "docs": "Sets focus on the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "focusId"
+            }
+          ]
         }
       ],
       "events": [
@@ -846,14 +851,12 @@
       "dependents": [],
       "dependencies": [
         "calcite-action-group",
-        "calcite-action",
-        "calcite-tooltip-manager"
+        "calcite-action"
       ],
       "dependencyGraph": {
         "calcite-action-bar": [
           "calcite-action-group",
-          "calcite-action",
-          "calcite-tooltip-manager"
+          "calcite-action"
         ],
         "calcite-action-group": [
           "calcite-action-menu",
@@ -861,7 +864,6 @@
         ],
         "calcite-action-menu": [
           "calcite-action",
-          "calcite-tooltip-manager",
           "calcite-popover"
         ],
         "calcite-action": [
@@ -1075,7 +1077,6 @@
         ],
         "calcite-action-menu": [
           "calcite-action",
-          "calcite-tooltip-manager",
           "calcite-popover"
         ],
         "calcite-action": [
@@ -1312,13 +1313,11 @@
       ],
       "dependencies": [
         "calcite-action",
-        "calcite-tooltip-manager",
         "calcite-popover"
       ],
       "dependencyGraph": {
         "calcite-action-menu": [
           "calcite-action",
-          "calcite-tooltip-manager",
           "calcite-popover"
         ],
         "calcite-action": [
@@ -1511,7 +1510,12 @@
           "signature": "setFocus(focusId?: \"expand-toggle\") => Promise<void>",
           "parameters": [],
           "docs": "Sets focus on the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "focusId"
+            }
+          ]
         }
       ],
       "events": [
@@ -1541,14 +1545,12 @@
       "dependents": [],
       "dependencies": [
         "calcite-action-group",
-        "calcite-action",
-        "calcite-tooltip-manager"
+        "calcite-action"
       ],
       "dependencyGraph": {
         "calcite-action-pad": [
           "calcite-action-group",
-          "calcite-action",
-          "calcite-tooltip-manager"
+          "calcite-action"
         ],
         "calcite-action-group": [
           "calcite-action-menu",
@@ -1556,7 +1558,6 @@
         ],
         "calcite-action-menu": [
           "calcite-action",
-          "calcite-tooltip-manager",
           "calcite-popover"
         ],
         "calcite-action": [
@@ -1840,13 +1841,13 @@
       ],
       "listeners": [
         {
-          "event": "calciteAlertSync",
+          "event": "calciteInternalAlertSync",
           "target": "window",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteAlertRegister",
+          "event": "calciteInternalAlertRegister",
           "target": "window",
           "capture": false,
           "passive": false
@@ -2149,8 +2150,14 @@
           "mutable": false,
           "attr": "intl-collapse",
           "reflectToAttr": false,
-          "docs": "Tooltip used for the toggle when expanded.",
-          "docsTags": [],
+          "docs": "Aria-label for collapsing the toggle and tooltip used for the toggle when expanded.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "\"Collapse\""
+            }
+          ],
+          "default": "TEXT.collapse",
           "values": [
             {
               "type": "string"
@@ -2165,8 +2172,14 @@
           "mutable": false,
           "attr": "intl-expand",
           "reflectToAttr": false,
-          "docs": "Tooltip used for the toggle when collapsed.",
-          "docsTags": [],
+          "docs": "Aria-label for expanding the toggle and tooltip used for the toggle when collapsed.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "\"Expand\""
+            }
+          ],
+          "default": "TEXT.expand",
           "values": [
             {
               "type": "string"
@@ -2352,7 +2365,6 @@
         ],
         "calcite-action-menu": [
           "calcite-action",
-          "calcite-tooltip-manager",
           "calcite-popover"
         ],
         "calcite-action": [
@@ -2935,12 +2947,13 @@
           "reflectToAttr": false,
           "docs": "The type attribute to apply to the button",
           "docsTags": [],
+          "default": "\"button\"",
           "values": [
             {
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -3174,6 +3187,36 @@
           ],
           "optional": false,
           "required": false
+        },
+        {
+          "name": "thumbnailPosition",
+          "type": "\"block-end\" | \"block-start\" | \"inline-end\" | \"inline-start\"",
+          "mutable": false,
+          "attr": "thumbnail-position",
+          "reflectToAttr": false,
+          "docs": "",
+          "docsTags": [],
+          "default": "\"block-start\"",
+          "values": [
+            {
+              "value": "block-end",
+              "type": "string"
+            },
+            {
+              "value": "block-start",
+              "type": "string"
+            },
+            {
+              "value": "inline-end",
+              "type": "string"
+            },
+            {
+              "value": "inline-start",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
         }
       ],
       "methods": [],
@@ -5020,7 +5063,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Called when a selected item in the combobox is dismissed via its chip *",
+          "docs": "Called when a selected item in the combobox is dismissed via its chip",
           "docsTags": []
         },
         {
@@ -5262,7 +5305,12 @@
           "signature": "toggleSelected(coerce?: boolean) => Promise<void>",
           "parameters": [],
           "docs": "Used to toggle the selection state. By default this won't trigger an event.\nThe first argument allows the value to be coerced, rather than swapping values.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "coerce"
+            }
+          ]
         }
       ],
       "events": [
@@ -6763,9 +6811,8 @@
           "mutable": false,
           "attr": "width",
           "reflectToAttr": true,
-          "docs": "specify the width of dropdown, defaults to m",
+          "docs": "specify the width of dropdown",
           "docsTags": [],
-          "default": "\"m\"",
           "values": [
             {
               "value": "l",
@@ -6780,7 +6827,7 @@
               "type": "string"
             }
           ],
-          "optional": false,
+          "optional": true,
           "required": false
         }
       ],
@@ -6804,7 +6851,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "fires when a dropdown has been closed *",
+          "docs": "fires when a dropdown has been closed",
           "docsTags": []
         },
         {
@@ -6813,7 +6860,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "fires when a dropdown has been opened *",
+          "docs": "fires when a dropdown has been opened",
           "docsTags": []
         },
         {
@@ -6822,7 +6869,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "fires when a dropdown item has been selected or deselected *",
+          "docs": "fires when a dropdown item has been selected or deselected",
           "docsTags": []
         }
       ],
@@ -6834,7 +6881,7 @@
           "passive": false
         },
         {
-          "event": "calciteDropdownCloseRequest",
+          "event": "calciteInternalDropdownCloseRequest",
           "capture": false,
           "passive": false
         },
@@ -6855,12 +6902,12 @@
           "passive": true
         },
         {
-          "event": "calciteDropdownItemKeyEvent",
+          "event": "calciteInternalDropdownItemKeyEvent",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteDropdownItemSelect",
+          "event": "calciteInternalDropdownItemSelect",
           "capture": false,
           "passive": false
         }
@@ -6979,7 +7026,7 @@
       "events": [],
       "listeners": [
         {
-          "event": "calciteDropdownItemSelect",
+          "event": "calciteInternalDropdownItemSelect",
           "capture": false,
           "passive": false
         }
@@ -7175,7 +7222,7 @@
           "passive": false
         },
         {
-          "event": "calciteDropdownItemChange",
+          "event": "calciteInternalDropdownItemChange",
           "target": "body",
           "capture": false,
           "passive": false
@@ -7615,13 +7662,11 @@
         "calcite-value-list"
       ],
       "dependencies": [
-        "calcite-input",
-        "calcite-icon"
+        "calcite-input"
       ],
       "dependencyGraph": {
         "calcite-filter": [
-          "calcite-input",
-          "calcite-icon"
+          "calcite-input"
         ],
         "calcite-input": [
           "calcite-progress",
@@ -7989,7 +8034,6 @@
         "calcite-combobox-item",
         "calcite-date-picker-month-header",
         "calcite-dropdown-item",
-        "calcite-filter",
         "calcite-handle",
         "calcite-input",
         "calcite-input-date-picker",
@@ -8049,9 +8093,6 @@
         "calcite-dropdown-item": [
           "calcite-icon"
         ],
-        "calcite-filter": [
-          "calcite-icon"
-        ],
         "calcite-handle": [
           "calcite-icon"
         ],
@@ -8342,7 +8383,7 @@
       ],
       "listeners": [
         {
-          "event": "calciteInputBlur",
+          "event": "calciteInternalInputBlur",
           "capture": false,
           "passive": false
         }
@@ -8532,6 +8573,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "intlClear",
+          "type": "string",
+          "mutable": false,
+          "attr": "intl-clear",
+          "reflectToAttr": false,
+          "docs": "A text label that will appear on the clear button for screen readers.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "intlLoading",
           "type": "string",
@@ -8545,7 +8602,7 @@
               "text": "\"Loading\""
             }
           ],
-          "default": "TEXT.loading",
+          "default": "COMMON_TEXT.loading",
           "values": [
             {
               "type": "string"
@@ -8601,7 +8658,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8732,6 +8789,22 @@
           "optional": true,
           "required": false
         },
+        {
+          "name": "numberingSystem",
+          "type": "string",
+          "mutable": false,
+          "attr": "numbering-system",
+          "reflectToAttr": false,
+          "docs": "standard UniCode numeral system tag for localization",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "placeholder",
           "type": "string",
@@ -8876,7 +8949,7 @@
           "mutable": false,
           "attr": "suffix-text",
           "reflectToAttr": false,
-          "docs": "optionally add suffix  *",
+          "docs": "optionally add suffix",
           "docsTags": [],
           "values": [
             {
@@ -9402,6 +9475,65 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "placement",
+          "type": "\"bottom\" | \"bottom-end\" | \"bottom-leading\" | \"bottom-start\" | \"bottom-trailing\" | \"top\" | \"top-end\" | \"top-leading\" | \"top-start\" | \"top-trailing\"",
+          "mutable": false,
+          "attr": "placement",
+          "reflectToAttr": true,
+          "docs": "Determines where the date-picker component will be positioned relative to the input.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "\"bottom-leading\""
+            }
+          ],
+          "default": "defaultMenuPlacement",
+          "values": [
+            {
+              "value": "bottom",
+              "type": "string"
+            },
+            {
+              "value": "bottom-end",
+              "type": "string"
+            },
+            {
+              "value": "bottom-leading",
+              "type": "string"
+            },
+            {
+              "value": "bottom-start",
+              "type": "string"
+            },
+            {
+              "value": "bottom-trailing",
+              "type": "string"
+            },
+            {
+              "value": "top",
+              "type": "string"
+            },
+            {
+              "value": "top-end",
+              "type": "string"
+            },
+            {
+              "value": "top-leading",
+              "type": "string"
+            },
+            {
+              "value": "top-start",
+              "type": "string"
+            },
+            {
+              "value": "top-trailing",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "proximitySelectionDisabled",
           "type": "boolean",
@@ -10068,6 +10200,34 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "placement",
+          "type": "Placement | PlacementRtl | VariationRtl",
+          "mutable": false,
+          "attr": "placement",
+          "reflectToAttr": true,
+          "docs": "Determines where the popover will be positioned relative to the input.",
+          "docsTags": [
+            {
+              "name": "see",
+              "text": "[PopperPlacement](https://github.com/Esri/calcite-components/blob/master/src/utils/popper.ts#L25)"
+            }
+          ],
+          "default": "\"auto\"",
+          "values": [
+            {
+              "type": "Placement"
+            },
+            {
+              "type": "PlacementRtl"
+            },
+            {
+              "type": "VariationRtl"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "scale",
           "type": "\"l\" | \"m\" | \"s\"",
@@ -10130,6 +10290,17 @@
         }
       ],
       "methods": [
+        {
+          "name": "reposition",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "signature": "reposition() => Promise<void>",
+          "parameters": [],
+          "docs": "Updates the position of the component.",
+          "docsTags": []
+        },
         {
           "name": "setFocus",
           "returns": {
@@ -10165,12 +10336,12 @@
           "passive": false
         },
         {
-          "event": "calciteTimePickerBlur",
+          "event": "calciteInternalTimePickerBlur",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteTimePickerFocus",
+          "event": "calciteInternalTimePickerFocus",
           "capture": false,
           "passive": false
         }
@@ -10635,7 +10806,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, disabled prevents user interaction.",
+          "docs": "When true, prevents user interaction.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -10652,7 +10823,7 @@
           "mutable": false,
           "attr": "heading-level",
           "reflectToAttr": false,
-          "docs": "Number at which section headings should start for this component.",
+          "docs": "Number at which section headings should start for the list.",
           "docsTags": [],
           "values": [
             {
@@ -10747,7 +10918,7 @@
           "mutable": false,
           "attr": "description",
           "reflectToAttr": false,
-          "docs": "An optional description for this item.  This will appear below the label text.",
+          "docs": "An optional description for the list item. Displays below the label text.",
           "docsTags": [],
           "values": [
             {
@@ -10763,7 +10934,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, disabled prevents interaction.",
+          "docs": "When true, prevents user interaction.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -10780,7 +10951,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "The label text of the list item. This will appear above the description text.",
+          "docs": "The label text of the list item. Displays above the description text.",
           "docsTags": [],
           "values": [
             {
@@ -10871,7 +11042,7 @@
           "mutable": false,
           "attr": "heading",
           "reflectToAttr": true,
-          "docs": "The title used for all nested `calcite-list-item` rows.",
+          "docs": "The title for all nested `calcite-list-item` rows.",
           "docsTags": [],
           "values": [
             {
@@ -10887,7 +11058,7 @@
           "mutable": false,
           "attr": "heading-level",
           "reflectToAttr": false,
-          "docs": "Number at which section headings should start for this component.",
+          "docs": "Number at which section headings should start for the group.",
           "docsTags": [],
           "values": [
             {
@@ -10953,7 +11124,7 @@
           "mutable": false,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "Show the loader",
+          "docs": "When true, the loader is active.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -10970,7 +11141,7 @@
           "mutable": false,
           "attr": "inline",
           "reflectToAttr": true,
-          "docs": "Inline loaders are smaller and will appear to the left of the text",
+          "docs": "When true, displays smaller and appears to the left of the text.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -10987,7 +11158,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "Accessible name for the component",
+          "docs": "Accessible name for the loader.",
           "docsTags": [],
           "values": [
             {
@@ -11003,7 +11174,7 @@
           "mutable": false,
           "attr": "no-padding",
           "reflectToAttr": false,
-          "docs": "Turn off spacing around the loader",
+          "docs": "Disables spacing around the loader.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11020,7 +11191,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "Speficy the scale of the loader. Defaults to \"m\"",
+          "docs": "Specify the scale of the loader.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -11046,7 +11217,7 @@
           "mutable": false,
           "attr": "text",
           "reflectToAttr": false,
-          "docs": "Text which should appear under the loading indicator (optional)",
+          "docs": "Text that displays under the loading indicator.",
           "docsTags": [],
           "default": "\"\"",
           "values": [
@@ -11054,7 +11225,7 @@
               "type": "string"
             }
           ],
-          "optional": false,
+          "optional": true,
           "required": false
         },
         {
@@ -11063,7 +11234,7 @@
           "mutable": false,
           "attr": "type",
           "reflectToAttr": true,
-          "docs": "Use indeterminate if finding actual progress value is impossible",
+          "docs": "Use indeterminate if finding actual progress value is impossible.",
           "docsTags": [],
           "values": [
             {
@@ -11084,7 +11255,7 @@
           "mutable": false,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "Percent complete of 100, only valid for determinate indicators",
+          "docs": "Valid only for determinate indicators. Percent complete of 100.",
           "docsTags": [],
           "default": "0",
           "values": [
@@ -11103,17 +11274,17 @@
         {
           "name": "--calcite-loader-font-size",
           "annotation": "prop",
-          "docs": "when type is determinate, the font-size of the loader percentage"
+          "docs": "When type is determinate, the font-size of the loader percentage."
         },
         {
           "name": "--calcite-loader-size",
           "annotation": "prop",
-          "docs": "the width and height of a non-inline loader"
+          "docs": "The width and height of a non-inline loader."
         },
         {
           "name": "--calcite-loader-size-inline",
           "annotation": "prop",
-          "docs": "the width and height of an inline loader"
+          "docs": "The width and height of an inline loader."
         }
       ],
       "slots": [],
@@ -11153,23 +11324,23 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "header - a slot for adding a modal header"
+          "text": "header - A slot for adding a `calcite-modal` header."
         },
         {
           "name": "slot",
-          "text": "content - a slot for adding modal content"
+          "text": "content - A slot for adding `calcite-modal` content."
         },
         {
           "name": "slot",
-          "text": "primary - a slot for adding a primary button"
+          "text": "primary - A slot for adding a primary button."
         },
         {
           "name": "slot",
-          "text": "secondary - a slot for adding a secondary button"
+          "text": "secondary - A slot for adding a secondary button."
         },
         {
           "name": "slot",
-          "text": "back - a slot for adding a back button"
+          "text": "back - A slot for adding a back button."
         }
       ],
       "usage": {
@@ -11184,7 +11355,7 @@
           "mutable": true,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "Add the active attribute to open the modal",
+          "docs": "When true, the `calcite-modal` is active.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11201,7 +11372,7 @@
           "mutable": false,
           "attr": "background-color",
           "reflectToAttr": true,
-          "docs": "Background color of modal content",
+          "docs": "Sets the background color of `calcite-modal` content.",
           "docsTags": [],
           "default": "\"white\"",
           "values": [
@@ -11222,7 +11393,7 @@
           "type": "(el: HTMLElement) => Promise<void>",
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Optionally pass a function to run before close",
+          "docs": "Passes a function to run before the `calcite-modal` closes.",
           "docsTags": [],
           "default": "() => Promise.resolve()",
           "values": [
@@ -11230,7 +11401,7 @@
               "type": "(el: HTMLElement) => Promise<void>"
             }
           ],
-          "optional": false,
+          "optional": true,
           "required": false
         },
         {
@@ -11239,7 +11410,7 @@
           "mutable": false,
           "attr": "color",
           "reflectToAttr": true,
-          "docs": "Adds a color bar at the top for visual impact,\nUse color to add importance to destructive/workflow dialogs.",
+          "docs": "Adds a color bar to the top of `calcite-modal` for visual impact.\nUse color to add importance to destructive or workflow dialogs.",
           "docsTags": [],
           "values": [
             {
@@ -11260,7 +11431,7 @@
           "mutable": false,
           "attr": "disable-close-button",
           "reflectToAttr": false,
-          "docs": "Disables the display a close button within the Modal",
+          "docs": "When true, disables the close button within the `calcite-modal`.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11277,7 +11448,7 @@
           "mutable": false,
           "attr": "disable-escape",
           "reflectToAttr": false,
-          "docs": "Flag to disable the default close on escape behavior",
+          "docs": "When true, disables the default close on escape behavior.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11294,7 +11465,7 @@
           "mutable": false,
           "attr": "disable-outside-close",
           "reflectToAttr": false,
-          "docs": "Disables the closing of the Modal when clicked outside.",
+          "docs": "When true, disables the closing of the `calcite-modal` when clicked outside.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11311,7 +11482,7 @@
           "mutable": false,
           "attr": "docked",
           "reflectToAttr": true,
-          "docs": "Prevent the modal from taking up the entire screen on mobile",
+          "docs": "When true, prevents the `calcite-modal` from expanding to the entire screen on mobile devices.",
           "docsTags": [],
           "values": [
             {
@@ -11321,28 +11492,13 @@
           "optional": false,
           "required": false
         },
-        {
-          "name": "firstFocus",
-          "type": "HTMLElement",
-          "mutable": false,
-          "reflectToAttr": false,
-          "docs": "Specify an element to focus when the modal is first opened",
-          "docsTags": [],
-          "values": [
-            {
-              "type": "HTMLElement"
-            }
-          ],
-          "optional": true,
-          "required": false
-        },
         {
           "name": "fullscreen",
           "type": "boolean",
           "mutable": false,
           "attr": "fullscreen",
           "reflectToAttr": true,
-          "docs": "Set the modal to always be fullscreen (overrides width)",
+          "docs": "Set the `calcite-modal` to always be fullscreen (overrides width).",
           "docsTags": [],
           "values": [
             {
@@ -11358,7 +11514,7 @@
           "mutable": false,
           "attr": "intl-close",
           "reflectToAttr": false,
-          "docs": "Aria label for the close button",
+          "docs": "Accessible label for the close button.",
           "docsTags": [],
           "default": "TEXT.close",
           "values": [
@@ -11375,7 +11531,7 @@
           "mutable": false,
           "attr": "no-padding",
           "reflectToAttr": false,
-          "docs": "Turn off spacing around the content area slot",
+          "docs": "When true, disables spacing to the content area slot.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11392,7 +11548,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of modal, defaults to m",
+          "docs": "Specify the scale of `calcite-modal`.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -11418,7 +11574,7 @@
           "mutable": false,
           "attr": "width",
           "reflectToAttr": true,
-          "docs": "Set the width of the modal. Can use stock sizes or pass a number (in pixels)",
+          "docs": "Set the width of the `calcite-modal`. Can use scale sizes or pass a number (displays in pixels).",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -11451,8 +11607,12 @@
           },
           "signature": "focusElement(el?: HTMLElement) => Promise<void>",
           "parameters": [],
-          "docs": "Focus first interactive element",
+          "docs": "Focus the first interactive element.",
           "docsTags": [
+            {
+              "name": "param",
+              "text": "el"
+            },
             {
               "name": "deprecated",
               "text": "use `setFocus` instead."
@@ -11468,8 +11628,17 @@
           },
           "signature": "scrollContent(top?: number, left?: number) => Promise<void>",
           "parameters": [],
-          "docs": "Set the scroll top of the modal content",
-          "docsTags": []
+          "docs": "Set the scroll top of the `calcite-modal` content.",
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "top"
+            },
+            {
+              "name": "param",
+              "text": "left"
+            }
+          ]
         },
         {
           "name": "setFocus",
@@ -11479,8 +11648,13 @@
           },
           "signature": "setFocus(focusId?: \"close-button\") => Promise<void>",
           "parameters": [],
-          "docs": "Sets focus on the component.\n\nBy default, will try to focus on any focusable content. If there is none, it will focus on the close button.\nIf you want to focus on the close button, you can use the `close-button` focus ID.",
-          "docsTags": []
+          "docs": "Sets focus on the component.\n\nBy default, tries to focus on focusable content. If there is none, it will focus on the close button.\nTo focus on the close button, use the `close-button` focus ID.",
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "focusId"
+            }
+          ]
         }
       ],
       "events": [
@@ -11490,7 +11664,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Fired when the modal finishes the close animation",
+          "docs": "Emits when `calcite-modal` finishes the close animation.",
           "docsTags": []
         },
         {
@@ -11499,7 +11673,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Fired when the modal finishes the open animation",
+          "docs": "Emits when `calcite-modal` finishes the open animation.",
           "docsTags": []
         }
       ],
@@ -11515,49 +11689,49 @@
         {
           "name": "--calcite-modal-content-text",
           "annotation": "prop",
-          "docs": "the font-size of the modal content"
+          "docs": "The `calcite-modal` content font size."
         },
         {
           "name": "--calcite-modal-padding",
           "annotation": "prop",
-          "docs": "the top/bottom padding around items in the modal"
+          "docs": "The top/bottom padding around items in the `calcite-modal`."
         },
         {
           "name": "--calcite-modal-padding-large",
           "annotation": "prop",
-          "docs": "the left/right padding around items in the modal"
+          "docs": "The left/right padding around items in the `calcite-modal`."
         },
         {
           "name": "--calcite-modal-title-text",
           "annotation": "prop",
-          "docs": "the font-size of the modal title"
+          "docs": "The `calcite-modal` title font size."
         },
         {
           "name": "--calcite-scrim-background",
           "annotation": "prop",
-          "docs": "the semi-transparent background color behind modal"
+          "docs": "The semi-transparent background color behind the `calcite-modal`."
         }
       ],
       "slots": [
         {
           "name": "back",
-          "docs": "a slot for adding a back button"
+          "docs": "A slot for adding a back button."
         },
         {
           "name": "content",
-          "docs": "a slot for adding modal content"
+          "docs": "A slot for adding `calcite-modal` content."
         },
         {
           "name": "header",
-          "docs": "a slot for adding a modal header"
+          "docs": "A slot for adding a `calcite-modal` header."
         },
         {
           "name": "primary",
-          "docs": "a slot for adding a primary button"
+          "docs": "A slot for adding a primary button."
         },
         {
           "name": "secondary",
-          "docs": "a slot for adding a secondary button"
+          "docs": "A slot for adding a secondary button."
         }
       ],
       "parts": [],
@@ -11585,19 +11759,19 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "title - Title of the notice (optional)"
+          "text": "title - A slot for adding the title (optional)."
         },
         {
           "name": "slot",
-          "text": "message - Main text of the notice"
+          "text": "message - A slot for adding the message."
         },
         {
           "name": "slot",
-          "text": "link - Optional action to take from the notice (undo, try again, link to page, etc.)"
+          "text": "link - A slot for adding actions to take, such as: undo, try again, link to page, etc. (optional)."
         },
         {
           "name": "slot",
-          "text": "actions-end - Allows adding a `calcite-action` at the end of the notice. It is recommended to use 2 or less actions."
+          "text": "actions-end - A slot for adding actions to the end of the `calcite-notice` (optional). It is recommended to use two or less actions."
         }
       ],
       "usage": {
@@ -11611,7 +11785,7 @@
           "mutable": true,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "Is the notice currently active or not",
+          "docs": "When true, the `calcite-notice` is active.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11628,7 +11802,7 @@
           "mutable": false,
           "attr": "color",
           "reflectToAttr": true,
-          "docs": "Color for the notice (will apply to top border and icon)",
+          "docs": "The color for the `calcite-notice`. Color will apply to top border and icon.",
           "docsTags": [],
           "default": "\"blue\"",
           "values": [
@@ -11658,7 +11832,7 @@
           "mutable": false,
           "attr": "dismissible",
           "reflectToAttr": true,
-          "docs": "Optionally show a button the user can click to dismiss the notice",
+          "docs": "Shows a button the user can click to dismiss the `calcite-notice`.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11666,7 +11840,7 @@
               "type": "boolean"
             }
           ],
-          "optional": false,
+          "optional": true,
           "required": false
         },
         {
@@ -11675,7 +11849,7 @@
           "mutable": false,
           "attr": "icon",
           "reflectToAttr": true,
-          "docs": "when used as a boolean set to true, show a default recommended icon. You can\nalso pass a calcite-ui-icon name to this prop to display a requested icon",
+          "docs": "When present, shows a default recommended icon. You can\nalso pass a calcite-ui-icon name to display a requested icon.",
           "docsTags": [],
           "values": [
             {
@@ -11694,7 +11868,7 @@
           "mutable": false,
           "attr": "intl-close",
           "reflectToAttr": false,
-          "docs": "String for the close button.",
+          "docs": "Accessible label for the close button.",
           "docsTags": [
             {
               "name": "default",
@@ -11716,7 +11890,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of the notice, defaults to m",
+          "docs": "Specify the scale of `calcite-notice`.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -11742,7 +11916,7 @@
           "mutable": false,
           "attr": "width",
           "reflectToAttr": true,
-          "docs": "specify the width of the notice, defaults to auto",
+          "docs": "Specify the width of the `calcite-notice`.",
           "docsTags": [],
           "default": "\"auto\"",
           "values": [
@@ -11772,7 +11946,7 @@
           },
           "signature": "setFocus() => Promise<void>",
           "parameters": [],
-          "docs": "Sets focus on the component.",
+          "docs": "Sets focus on the `calcite-notice`.",
           "docsTags": []
         }
       ],
@@ -11783,7 +11957,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Fired when an notice is closed",
+          "docs": "Fired when `calcite-notice` is closed.",
           "docsTags": []
         },
         {
@@ -11792,7 +11966,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Fired when an Notice is opened",
+          "docs": "Fired when `calcite-notice` is opened.",
           "docsTags": []
         }
       ],
@@ -11801,25 +11975,25 @@
         {
           "name": "--calcite-notice-width",
           "annotation": "prop",
-          "docs": "the width of the notice"
+          "docs": "The width of `calcite-notice`."
         }
       ],
       "slots": [
         {
           "name": "actions-end",
-          "docs": "Allows adding a `calcite-action` at the end of the notice. It is recommended to use 2 or less actions."
+          "docs": "A slot for adding actions to the end of the `calcite-notice` (optional). It is recommended to use two or less actions."
         },
         {
           "name": "link",
-          "docs": "Optional action to take from the notice (undo, try again, link to page, etc.)"
+          "docs": "A slot for adding actions to take, such as: undo, try again, link to page, etc. (optional)."
         },
         {
           "name": "message",
-          "docs": "Main text of the notice"
+          "docs": "A slot for adding the message."
         },
         {
           "name": "title",
-          "docs": "Title of the notice (optional)"
+          "docs": "A slot for adding the title (optional)."
         }
       ],
       "parts": [],
@@ -12530,8 +12704,13 @@
           },
           "signature": "scrollContentTo(options?: ScrollToOptions) => Promise<void>",
           "parameters": [],
-          "docs": "Scrolls panel content to a particular set of coordinates.\n\n```\n myCalcitePanel.scrollContentTo({\n   left: 0, // Specifies the number of pixels along the X axis to scroll the window or element.\n   top: 0, // Specifies the number of pixels along the Y axis to scroll the window or element\n   behavior: \"auto\" // Specifies whether the scrolling should animate smoothly (smooth), or happen instantly in a single jump (auto, the default value).\n });\n```",
-          "docsTags": []
+          "docs": "Scrolls panel content to a particular set of coordinates.\n\n```\n  myCalcitePanel.scrollContentTo({\n    left: 0, // Specifies the number of pixels along the X axis to scroll the window or element.\n    top: 0, // Specifies the number of pixels along the Y axis to scroll the window or element\n    behavior: \"auto\" // Specifies whether the scrolling should animate smoothly (smooth), or happen instantly in a single jump (auto, the default value).\n  });\n```",
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "options"
+            }
+          ]
         },
         {
           "name": "setFocus",
@@ -12542,7 +12721,12 @@
           "signature": "setFocus(focusId?: \"dismiss-button\" | \"back-button\") => Promise<void>",
           "parameters": [],
           "docs": "Sets focus on the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "focusId"
+            }
+          ]
         }
       ],
       "events": [
@@ -12556,7 +12740,7 @@
           "docsTags": []
         },
         {
-          "event": "calcitePanelDismissedChange",
+          "event": "calcitePanelDismiss",
           "detail": "any",
           "bubbles": true,
           "cancelable": true,
@@ -12564,6 +12748,21 @@
           "docs": "Emitted when the close button has been clicked.",
           "docsTags": []
         },
+        {
+          "event": "calcitePanelDismissedChange",
+          "detail": "any",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted when the close button has been clicked.",
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use calcitePanelDismiss instead."
+            }
+          ],
+          "deprecation": "use calcitePanelDismiss instead."
+        },
         {
           "event": "calcitePanelScroll",
           "detail": "any",
@@ -12645,7 +12844,6 @@
         ],
         "calcite-action-menu": [
           "calcite-action",
-          "calcite-tooltip-manager",
           "calcite-popover"
         ],
         "calcite-popover": [
@@ -12839,7 +13037,12 @@
           "signature": "setFocus(focusId?: ListFocusId) => Promise<void>",
           "parameters": [],
           "docs": "Sets focus on the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "focusId"
+            }
+          ]
         }
       ],
       "events": [
@@ -12865,12 +13068,12 @@
           "passive": false
         },
         {
-          "event": "calciteListItemPropsChange",
+          "event": "calciteInternalListItemPropsChange",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteListItemValueChange",
+          "event": "calciteInternalListItemValueChange",
           "capture": false,
           "passive": false
         },
@@ -12903,8 +13106,7 @@
           "calcite-scrim"
         ],
         "calcite-filter": [
-          "calcite-input",
-          "calcite-icon"
+          "calcite-input"
         ],
         "calcite-input": [
           "calcite-progress",
@@ -13219,7 +13421,12 @@
           "signature": "toggleSelected(coerce?: boolean) => Promise<void>",
           "parameters": [],
           "docs": "Used to toggle the selection state. By default this won't trigger an event.\nThe first argument allows the value to be coerced, rather than swapping values.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "coerce"
+            }
+          ]
         }
       ],
       "events": [
@@ -13289,9 +13496,27 @@
         }
       ],
       "usage": {
-        "Manager": "```html\n<calcite-popover reference-element=\"popover-button\">Hello! I am some popover content!</calcite-popover>\n\n<calcite-popover-manager\n  ><calcite-button id=\"popover-button\">Clickable popover</calcite-button></calcite-popover-manager\n>\n```\n"
+        "Basic": "```html\n<calcite-popover reference-element=\"popover-button\">Hello! I am some popover content!</calcite-popover>\n\n<calcite-button id=\"popover-button\">Clickable popover</calcite-button>\n```\n",
+        "Virtual": "```html\n<!-- virtually positioned popover -->\n<calcite-popover id=\"virtual-popover\" label=\"Hello world!\" open>\n  <p>Hello! I am some virtual popover content!</p>\n</calcite-popover>\n\n<script>\n  function generateGetBoundingClientRect() {\n    return () => ({\n      width: 0,\n      height: 0,\n      top: 100,\n      right: 100,\n      bottom: 100,\n      left: 600\n    });\n  }\n\n  const virtualElement = {\n    getBoundingClientRect: generateGetBoundingClientRect()\n  };\n\n  const popover = document.getElementById(\"virtual-popover\");\n  popover.referenceElement = virtualElement;\n</script>\n```\n"
       },
       "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": "closeButton",
           "type": "boolean",
@@ -13580,7 +13805,7 @@
         },
         {
           "name": "referenceElement",
-          "type": "HTMLElement | string",
+          "type": "Element | string | ({ getBoundingClientRect: () => ClientRect | DOMRect; contextElement?: Element; })",
           "mutable": false,
           "attr": "reference-element",
           "reflectToAttr": false,
@@ -13588,14 +13813,37 @@
           "docsTags": [],
           "values": [
             {
-              "type": "HTMLElement"
+              "type": "Element"
             },
             {
               "type": "string"
+            },
+            {
+              "type": "({ getBoundingClientRect: () => ClientRect"
+            },
+            {
+              "type": "DOMRect; contextElement?: Element; })"
             }
           ],
           "optional": false,
           "required": true
+        },
+        {
+          "name": "triggerDisabled",
+          "type": "boolean",
+          "mutable": false,
+          "attr": "trigger-disabled",
+          "reflectToAttr": true,
+          "docs": "Disables automatically toggling a popover when its referenceElement has been triggered. This property can be set to true to manage when a popover is open.",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
         }
       ],
       "methods": [
@@ -13619,7 +13867,12 @@
           "signature": "setFocus(focusId?: \"close-button\") => Promise<void>",
           "parameters": [],
           "docs": "Sets focus on the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "focusId"
+            }
+          ]
         },
         {
           "name": "toggle",
@@ -13630,7 +13883,12 @@
           "signature": "toggle(value?: boolean) => Promise<void>",
           "parameters": [],
           "docs": "Toggles the popover's open property.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "value"
+            }
+          ]
         }
       ],
       "events": [
@@ -13697,6 +13955,10 @@
         {
           "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": {},
@@ -13731,7 +13993,7 @@
               "text": "`[data-calcite-popover-reference]`"
             }
           ],
-          "default": "`[${POPOVER_REFERENCE}]`",
+          "default": "\"[data-calcite-popover-reference]\"",
           "values": [
             {
               "type": "string"
@@ -13743,14 +14005,7 @@
       ],
       "methods": [],
       "events": [],
-      "listeners": [
-        {
-          "event": "click",
-          "target": "window",
-          "capture": true,
-          "passive": false
-        }
-      ],
+      "listeners": [],
       "styles": [],
       "slots": [
         {
@@ -13761,7 +14016,8 @@
       "parts": [],
       "dependents": [],
       "dependencies": [],
-      "dependencyGraph": {}
+      "dependencyGraph": {},
+      "deprecation": "No longer required for popover usage."
     },
     {
       "filePath": "./src/components/progress/progress.tsx",
@@ -14449,7 +14705,7 @@
       ],
       "listeners": [
         {
-          "event": "calciteRadioGroupItemChange",
+          "event": "calciteInternalRadioGroupItemChange",
           "capture": false,
           "passive": false
         },
@@ -15122,12 +15378,12 @@
       ],
       "listeners": [
         {
-          "event": "calciteOptionChange",
+          "event": "calciteInternalOptionChange",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteOptionGroupChange",
+          "event": "calciteInternalOptionGroupChange",
           "capture": false,
           "passive": false
         }
@@ -15542,7 +15798,13 @@
           "cancelable": true,
           "composed": true,
           "docs": "Emitted when collapse has been toggled.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use a resizeObserver on the shell-panel to listen for changes to its size."
+            }
+          ],
+          "deprecation": "use a resizeObserver on the shell-panel to listen for changes to its size."
         }
       ],
       "listeners": [],
@@ -15936,16 +16198,19 @@
         },
         {
           "name": "value",
-          "type": "number",
+          "type": "number | number[]",
           "mutable": true,
           "attr": "value",
           "reflectToAttr": true,
           "docs": "Currently selected number (if single select)",
           "docsTags": [],
-          "default": "null",
+          "default": "0",
           "values": [
             {
               "type": "number"
+            },
+            {
+              "type": "number[]"
             }
           ],
           "optional": false,
@@ -16672,10 +16937,15 @@
             "type": "Promise<void>",
             "docs": ""
           },
-          "signature": "goToStep(num: number) => Promise<void>",
+          "signature": "goToStep(step: number) => Promise<void>",
           "parameters": [],
           "docs": "set the requested step as active",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "step"
+            }
+          ]
         },
         {
           "name": "nextStep",
@@ -16714,17 +16984,17 @@
       "events": [],
       "listeners": [
         {
-          "event": "calciteStepperItemKeyEvent",
+          "event": "calciteInternalStepperItemKeyEvent",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteStepperItemRegister",
+          "event": "calciteInternalStepperItemRegister",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteStepperItemSelect",
+          "event": "calciteInternalStepperItemSelect",
           "capture": false,
           "passive": false
         }
@@ -16860,12 +17130,7 @@
       "events": [],
       "listeners": [
         {
-          "event": "keydown",
-          "capture": false,
-          "passive": false
-        },
-        {
-          "event": "calciteStepperItemChange",
+          "event": "calciteInternalStepperItemChange",
           "target": "body",
           "capture": false,
           "passive": false
@@ -17136,7 +17401,7 @@
       "events": [],
       "listeners": [
         {
-          "event": "calciteTabChange",
+          "event": "calciteInternalTabChange",
           "target": "body",
           "capture": false,
           "passive": false
@@ -17228,18 +17493,17 @@
       ],
       "listeners": [
         {
-          "event": "resize",
-          "target": "window",
+          "event": "calciteInternalTabsFocusPrevious",
           "capture": false,
-          "passive": true
+          "passive": false
         },
         {
-          "event": "calciteTabsFocusPrevious",
+          "event": "calciteInternalTabsFocusNext",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteTabsFocusNext",
+          "event": "calciteInternalTabsActivate",
           "capture": false,
           "passive": false
         },
@@ -17249,12 +17513,12 @@
           "passive": false
         },
         {
-          "event": "calciteTabTitleRegister",
+          "event": "calciteInternalTabTitleRegister",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteTabChange",
+          "event": "calciteInternalTabChange",
           "target": "body",
           "capture": false,
           "passive": false
@@ -17420,7 +17684,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Fires when a specific tab is activated (`event.details`)",
+          "docs": "Fires when a specific tab is activated. Emits the \"tab\" property or the index position.",
           "docsTags": [
             {
               "name": "see",
@@ -17431,7 +17695,7 @@
       ],
       "listeners": [
         {
-          "event": "calciteTabChange",
+          "event": "calciteInternalTabChange",
           "target": "body",
           "capture": false,
           "passive": false
@@ -17583,7 +17847,7 @@
       "events": [],
       "listeners": [
         {
-          "event": "calciteTabTitleRegister",
+          "event": "calciteInternalTabTitleRegister",
           "capture": false,
           "passive": false
         },
@@ -17594,7 +17858,7 @@
           "passive": false
         },
         {
-          "event": "calciteTabRegister",
+          "event": "calciteInternalTabRegister",
           "capture": false,
           "passive": false
         },
@@ -18560,7 +18824,12 @@
           "signature": "setFocus(target: TimePart) => Promise<void>",
           "parameters": [],
           "docs": "Sets focus on the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "target"
+            }
+          ]
         }
       ],
       "events": [],
@@ -18847,7 +19116,7 @@
           "mutable": true,
           "attr": "closed",
           "reflectToAttr": true,
-          "docs": "Alternate text for closing the `calcite-tip-manager`.",
+          "docs": "Closed state of the `calcite-tip-manager`.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19001,6 +19270,15 @@
         }
       ],
       "events": [
+        {
+          "event": "calciteTipManagerClose",
+          "detail": "any",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted when the `calcite-tip-manager` has been closed.",
+          "docsTags": []
+        },
         {
           "event": "calciteTipManagerToggle",
           "detail": "any",
@@ -19008,7 +19286,13 @@
           "cancelable": true,
           "composed": true,
           "docs": "Emitted when the `calcite-tip-manager` has been toggled open or closed.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use calciteTipManagerClose instead."
+            }
+          ],
+          "deprecation": "use calciteTipManagerClose instead."
         }
       ],
       "listeners": [],
@@ -19060,16 +19344,34 @@
         }
       ],
       "usage": {
-        "Basic": "```html\n<calcite-tooltip placement=\"auto\" reference-element=\"tooltip-button\"\n  >This is the message of the tooltip</calcite-tooltip\n>\n<calcite-tooltip-manager>\n  <p>\n    Lorem <a id=\"tooltip-button\" href=\"#\">ipsum</a> dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor\n    incididunt ut labore et dolore magna aliqua.\n  </p>\n</calcite-tooltip-manager>\n```\n"
+        "Basic": "```html\n<calcite-tooltip placement=\"auto\" reference-element=\"tooltip-button\"\n  >This is the message of the tooltip</calcite-tooltip\n>\n<p>\n  Lorem <a id=\"tooltip-button\" href=\"#\">ipsum</a> dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor\n  incididunt ut labore et dolore magna aliqua.\n</p>\n```\n",
+        "Virtual": "```html\n<!-- virtually positioned tooltip -->\n<calcite-tooltip id=\"virtual-tooltip\" open>This is the message of the tooltip</calcite-tooltip>\n\n<script>\n  function generateGetBoundingClientRect() {\n    return () => ({\n      width: 0,\n      height: 0,\n      top: 100,\n      right: 100,\n      bottom: 100,\n      left: 600\n    });\n  }\n\n  const virtualElement = {\n    getBoundingClientRect: generateGetBoundingClientRect()\n  };\n\n  const tooltip = document.getElementById(\"virtual-tooltip\");\n  tooltip.referenceElement = virtualElement;\n</script>\n```\n"
       },
       "props": [
+        {
+          "name": "closeOnClick",
+          "type": "boolean",
+          "mutable": false,
+          "attr": "close-on-click",
+          "reflectToAttr": false,
+          "docs": "Closes the `calcite-tooltip` when the `referenceElement` is clicked.",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "label",
           "type": "string",
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "Accessible name for the component",
+          "docs": "Accessible name for the `calcite-tooltip`.",
           "docsTags": [],
           "values": [
             {
@@ -19085,7 +19387,7 @@
           "mutable": false,
           "attr": "offset-distance",
           "reflectToAttr": true,
-          "docs": "Offset the position of the tooltip away from the reference element.",
+          "docs": "Offset the position of the `calcite-tooltip` away from the `referenceElement`.",
           "docsTags": [
             {
               "name": "default",
@@ -19107,7 +19409,7 @@
           "mutable": false,
           "attr": "offset-skidding",
           "reflectToAttr": true,
-          "docs": "Offset the position of the tooltip along the reference element.",
+          "docs": "Offset the position of the `calcite-tooltip` along the `referenceElement`.",
           "docsTags": [],
           "default": "0",
           "values": [
@@ -19124,7 +19426,7 @@
           "mutable": false,
           "attr": "open",
           "reflectToAttr": true,
-          "docs": "Display and position the component.",
+          "docs": "When true, the `calcite-tooltip` is open.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19141,7 +19443,7 @@
           "mutable": false,
           "attr": "overlay-positioning",
           "reflectToAttr": false,
-          "docs": "Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value.",
+          "docs": "Describes the positioning type to use for the overlaid content. If the `referenceElement` is in a fixed container, use the \"fixed\" value.",
           "docsTags": [],
           "default": "\"absolute\"",
           "values": [
@@ -19163,7 +19465,7 @@
           "mutable": false,
           "attr": "placement",
           "reflectToAttr": true,
-          "docs": "Determines where the component will be positioned relative to the referenceElement.",
+          "docs": "Determines where the component will be positioned relative to the `referenceElement`.",
           "docsTags": [
             {
               "name": "see",
@@ -19187,18 +19489,24 @@
         },
         {
           "name": "referenceElement",
-          "type": "HTMLElement | string",
+          "type": "Element | string | ({ getBoundingClientRect: () => ClientRect | DOMRect; contextElement?: Element; })",
           "mutable": false,
           "attr": "reference-element",
           "reflectToAttr": false,
-          "docs": "Reference HTMLElement used to position this component according to the placement property. As a convenience, a string ID of the reference element can be used. However, setting this property to use an HTMLElement is preferred so that the component does not need to query the DOM for the referenceElement.",
+          "docs": "The `referenceElement` to position `calcite-tooltip` according to its \"placement\" value. Setting to the `HTMLElement` is preferred so `calcite-tooltip` does not need to query the DOM for the `referenceElement`. However, a string ID of the reference element can be used.",
           "docsTags": [],
           "values": [
             {
-              "type": "HTMLElement"
+              "type": "Element"
             },
             {
               "type": "string"
+            },
+            {
+              "type": "({ getBoundingClientRect: () => ClientRect"
+            },
+            {
+              "type": "DOMRect; contextElement?: Element; })"
             }
           ],
           "optional": false,
@@ -19242,6 +19550,10 @@
         {
           "name": "slot",
           "text": "- A slot for adding elements that reference a 'calcite-tooltip' by the 'selector' property."
+        },
+        {
+          "name": "deprecated",
+          "text": "No longer required for tooltip usage."
         }
       ],
       "usage": {},
@@ -19259,7 +19571,7 @@
               "text": "`[data-calcite-tooltip-reference]`"
             }
           ],
-          "default": "`[${TOOLTIP_REFERENCE}]`",
+          "default": "\"[data-calcite-tooltip-reference]\"",
           "values": [
             {
               "type": "string"
@@ -19271,39 +19583,7 @@
       ],
       "methods": [],
       "events": [],
-      "listeners": [
-        {
-          "event": "keyup",
-          "target": "document",
-          "capture": false,
-          "passive": false
-        },
-        {
-          "event": "mouseover",
-          "capture": true,
-          "passive": true
-        },
-        {
-          "event": "mouseout",
-          "capture": true,
-          "passive": true
-        },
-        {
-          "event": "click",
-          "capture": true,
-          "passive": false
-        },
-        {
-          "event": "focus",
-          "capture": true,
-          "passive": false
-        },
-        {
-          "event": "blur",
-          "capture": true,
-          "passive": false
-        }
-      ],
+      "listeners": [],
       "styles": [],
       "slots": [
         {
@@ -19312,23 +19592,10 @@
         }
       ],
       "parts": [],
-      "dependents": [
-        "calcite-action-bar",
-        "calcite-action-menu",
-        "calcite-action-pad"
-      ],
+      "dependents": [],
       "dependencies": [],
-      "dependencyGraph": {
-        "calcite-action-bar": [
-          "calcite-tooltip-manager"
-        ],
-        "calcite-action-menu": [
-          "calcite-tooltip-manager"
-        ],
-        "calcite-action-pad": [
-          "calcite-tooltip-manager"
-        ]
-      }
+      "dependencyGraph": {},
+      "deprecation": "No longer required for tooltip usage."
     },
     {
       "filePath": "./src/components/tree/tree.tsx",
@@ -19356,11 +19623,11 @@
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use \"ancestors\" selection-mode for checkbox input"
+              "text": "Use \"ancestors\" selection-mode for checkbox input."
             }
           ],
           "default": "false",
-          "deprecation": "use \"ancestors\" selection-mode for checkbox input",
+          "deprecation": "Use \"ancestors\" selection-mode for checkbox input.",
           "values": [
             {
               "type": "boolean"
@@ -19375,7 +19642,7 @@
           "mutable": true,
           "attr": "lines",
           "reflectToAttr": true,
-          "docs": "Display indentation guide lines",
+          "docs": "Display indentation guide lines.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19392,7 +19659,7 @@
           "mutable": true,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "Specify the scale of the tree, defaults to m",
+          "docs": "Specify the scale of the tree.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -19418,7 +19685,7 @@
           "mutable": true,
           "attr": "selection-mode",
           "reflectToAttr": true,
-          "docs": "Customize how tree selection works (single, multi, children, multi-children, ancestors)",
+          "docs": "Customize how tree selection works.",
           "docsTags": [
             {
               "name": "default",
@@ -19459,7 +19726,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when user selects/deselects tree items. An object including an array of selected items will be passed in the event's `detail` property.",
+          "docs": "Emits when the user selects/deselects tree items. An object including an array of selected items will be passed in the event's \"detail\" property.",
           "docsTags": [
             {
               "name": "see",
@@ -19485,7 +19752,7 @@
           "passive": false
         },
         {
-          "event": "calciteTreeItemSelect",
+          "event": "calciteInternalTreeItemSelect",
           "capture": false,
           "passive": false
         },
@@ -19531,7 +19798,7 @@
           "mutable": true,
           "attr": "expanded",
           "reflectToAttr": true,
-          "docs": "True if the item is in an expanded state",
+          "docs": "Expanded state of the item.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19548,7 +19815,7 @@
           "mutable": true,
           "attr": "selected",
           "reflectToAttr": true,
-          "docs": "Is the item currently selected",
+          "docs": "Selected state of the item.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19607,11 +19874,11 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "- A slot for adding `calcite-value-list-item` elements. Items are displayed as a vertical list."
+          "text": "- A slot for adding `calcite-value-list-item` elements. List items are displayed as a vertical list."
         },
         {
           "name": "slot",
-          "text": "menu-actions - A slot for adding a button + menu combo for performing actions like sorting."
+          "text": "menu-actions - A slot for adding a button and menu combination for performing actions, such as sorting."
         }
       ],
       "usage": {
@@ -19626,7 +19893,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, disabled prevents interaction. This state shows items with lower opacity/grayed.",
+          "docs": "When true, prevents user interaction. This state shows list items grayed out and with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19643,7 +19910,7 @@
           "mutable": false,
           "attr": "drag-enabled",
           "reflectToAttr": true,
-          "docs": "When true, the items will be sortable via drag and drop.",
+          "docs": "When true, list items are sortable via a draggable button.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19660,7 +19927,7 @@
           "mutable": false,
           "attr": "filter-enabled",
           "reflectToAttr": true,
-          "docs": "When true, an input appears at the top of the list that can be used by end users to filter items in the list.",
+          "docs": "When true, an input appears at the top of the list that can be used by end users to filter list items.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19677,7 +19944,7 @@
           "mutable": false,
           "attr": "filter-placeholder",
           "reflectToAttr": true,
-          "docs": "Placeholder text for the filter input field.",
+          "docs": "Placeholder text for the filter's input field.",
           "docsTags": [],
           "values": [
             {
@@ -19726,7 +19993,7 @@
           "mutable": false,
           "attr": "multiple",
           "reflectToAttr": true,
-          "docs": "Multiple Works similar to standard radio buttons and checkboxes.\nWhen true, a user can select multiple items at a time.\nWhen false, only a single item can be selected at a time\nand selecting a new item will deselect any other selected items.",
+          "docs": "Similar to standard radio buttons and checkboxes.\nWhen true, a user can select multiple list items at a time.\nWhen false, only a single list item can be selected at a time,\nand selecting a new list item will deselect any other selected list items.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19743,7 +20010,7 @@
           "mutable": false,
           "attr": "selection-follows-focus",
           "reflectToAttr": false,
-          "docs": "When true and single-selection is enabled, the selection will change when navigating items via the keyboard.",
+          "docs": "When true and single-selection is enabled, the selection changes when navigating list items via the keyboard.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19776,7 +20043,12 @@
           "signature": "setFocus(focusId?: ListFocusId) => Promise<void>",
           "parameters": [],
           "docs": "Sets focus on the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "focusId"
+            }
+          ]
         }
       ],
       "events": [
@@ -19786,7 +20058,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when any of the item selections have changed.",
+          "docs": "Emits when any of the list item selections have changed.",
           "docsTags": []
         },
         {
@@ -19795,7 +20067,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when the order of the list has changed.",
+          "docs": "Emits when the order of the list has changed.",
           "docsTags": []
         }
       ],
@@ -19816,12 +20088,12 @@
           "passive": false
         },
         {
-          "event": "calciteListItemPropsChange",
+          "event": "calciteInternalListItemPropsChange",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteListItemValueChange",
+          "event": "calciteInternalListItemValueChange",
           "capture": false,
           "passive": false
         }
@@ -19830,11 +20102,11 @@
       "slots": [
         {
           "name": "",
-          "docs": "A slot for adding `calcite-value-list-item` elements. Items are displayed as a vertical list."
+          "docs": "A slot for adding `calcite-value-list-item` elements. List items are displayed as a vertical list."
         },
         {
           "name": "menu-actions",
-          "docs": "A slot for adding a button + menu combo for performing actions like sorting."
+          "docs": "A slot for adding a button and menu combination for performing actions, such as sorting."
         }
       ],
       "parts": [],
@@ -19849,8 +20121,7 @@
           "calcite-scrim"
         ],
         "calcite-filter": [
-          "calcite-input",
-          "calcite-icon"
+          "calcite-input"
         ],
         "calcite-input": [
           "calcite-progress",
@@ -19885,7 +20156,7 @@
           "mutable": false,
           "attr": "description",
           "reflectToAttr": true,
-          "docs": "An optional description for this item. Will appear below the label text.",
+          "docs": "An optional description for the list item that displays below the label text.",
           "docsTags": [],
           "values": [
             {
@@ -19901,7 +20172,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, the item cannot be clicked and is visually muted",
+          "docs": "When true, the list item cannot be clicked and is visually muted.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19946,7 +20217,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": true,
-          "docs": "The main label for this item. Appears next to the icon.",
+          "docs": "The main label for the list item. Appears next to the icon.",
           "docsTags": [],
           "values": [
             {
@@ -19961,7 +20232,7 @@
           "type": "{ [x: string]: unknown; }",
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Used to provide additional metadata to an item, primarily used when the parent list has a filter.",
+          "docs": "Provides additional metadata to a list item. Primary use is for a filter on the parent list.",
           "docsTags": [],
           "values": [
             {
@@ -19994,7 +20265,7 @@
           "mutable": false,
           "attr": "removable",
           "reflectToAttr": true,
-          "docs": "Set this to true to display a remove action that removes the item from the list.",
+          "docs": "When true, adds an action to remove the list item.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -20011,7 +20282,7 @@
           "mutable": true,
           "attr": "selected",
           "reflectToAttr": true,
-          "docs": "Set this to true to pre-select an item. Toggles when an item is checked/unchecked.",
+          "docs": "When true, preselects the list item. Toggles when an item is checked/unchecked.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -20028,7 +20299,7 @@
           "mutable": false,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "The item's associated value.",
+          "docs": "The list item's associated value.",
           "docsTags": [],
           "values": [
             {
@@ -20048,7 +20319,7 @@
           },
           "signature": "setFocus() => Promise<void>",
           "parameters": [],
-          "docs": "Sets focus on the component.",
+          "docs": "Set focus on the component.",
           "docsTags": []
         },
         {
@@ -20059,8 +20330,13 @@
           },
           "signature": "toggleSelected(coerce?: boolean) => Promise<void>",
           "parameters": [],
-          "docs": "Used to toggle the selection state. By default this won't trigger an event.\nThe first argument allows the value to be coerced, rather than swapping values.",
-          "docsTags": []
+          "docs": "Toggle the selection state. By default this won't trigger an event.\nThe first argument allows the value to be coerced, rather than swapping values.",
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "coerce"
+            }
+          ]
         }
       ],
       "events": [
@@ -20070,7 +20346,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted whenever the remove button is pressed.",
+          "docs": "Emits when the remove button is pressed.",
           "docsTags": []
         }
       ],