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

package/dist/extras/docs-json.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2022-05-10T19:59:52",
+  "timestamp": "2022-06-07T00:59:50",
   "compiler": {
     "name": "@stencil/core",
-    "version": "2.15.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": [
@@ -1505,7 +1510,12 @@
           "signature": "setFocus(focusId?: \"expand-toggle\") => Promise<void>",
           "parameters": [],
           "docs": "Sets focus on the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "focusId"
+            }
+          ]
         }
       ],
       "events": [
@@ -1831,13 +1841,13 @@
       ],
       "listeners": [
         {
-          "event": "calciteAlertSync",
+          "event": "calciteInternalAlertSync",
           "target": "window",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteAlertRegister",
+          "event": "calciteInternalAlertRegister",
           "target": "window",
           "capture": false,
           "passive": false
@@ -2141,7 +2151,12 @@
           "attr": "intl-collapse",
           "reflectToAttr": false,
           "docs": "Aria-label for collapsing the toggle and tooltip used for the toggle when expanded.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "\"Collapse\""
+            }
+          ],
           "default": "TEXT.collapse",
           "values": [
             {
@@ -2158,7 +2173,12 @@
           "attr": "intl-expand",
           "reflectToAttr": false,
           "docs": "Aria-label for expanding the toggle and tooltip used for the toggle when collapsed.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "\"Expand\""
+            }
+          ],
           "default": "TEXT.expand",
           "values": [
             {
@@ -3167,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": [],
@@ -5013,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": []
         },
         {
@@ -5255,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": [
@@ -6756,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",
@@ -6773,7 +6827,7 @@
               "type": "string"
             }
           ],
-          "optional": false,
+          "optional": true,
           "required": false
         }
       ],
@@ -6797,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": []
         },
         {
@@ -6806,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": []
         },
         {
@@ -6815,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": []
         }
       ],
@@ -6827,7 +6881,7 @@
           "passive": false
         },
         {
-          "event": "calciteDropdownCloseRequest",
+          "event": "calciteInternalDropdownCloseRequest",
           "capture": false,
           "passive": false
         },
@@ -6848,12 +6902,12 @@
           "passive": true
         },
         {
-          "event": "calciteDropdownItemKeyEvent",
+          "event": "calciteInternalDropdownItemKeyEvent",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteDropdownItemSelect",
+          "event": "calciteInternalDropdownItemSelect",
           "capture": false,
           "passive": false
         }
@@ -6972,7 +7026,7 @@
       "events": [],
       "listeners": [
         {
-          "event": "calciteDropdownItemSelect",
+          "event": "calciteInternalDropdownItemSelect",
           "capture": false,
           "passive": false
         }
@@ -7168,7 +7222,7 @@
           "passive": false
         },
         {
-          "event": "calciteDropdownItemChange",
+          "event": "calciteInternalDropdownItemChange",
           "target": "body",
           "capture": false,
           "passive": false
@@ -8329,7 +8383,7 @@
       ],
       "listeners": [
         {
-          "event": "calciteInputBlur",
+          "event": "calciteInternalInputBlur",
           "capture": false,
           "passive": false
         }
@@ -8604,7 +8658,7 @@
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
@@ -8735,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",
@@ -8879,7 +8949,7 @@
           "mutable": false,
           "attr": "suffix-text",
           "reflectToAttr": false,
-          "docs": "optionally add suffix  *",
+          "docs": "optionally add suffix",
           "docsTags": [],
           "values": [
             {
@@ -10266,12 +10336,12 @@
           "passive": false
         },
         {
-          "event": "calciteTimePickerBlur",
+          "event": "calciteInternalTimePickerBlur",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteTimePickerFocus",
+          "event": "calciteInternalTimePickerFocus",
           "capture": false,
           "passive": false
         }
@@ -10736,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": [
@@ -10753,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": [
             {
@@ -10848,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": [
             {
@@ -10864,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": [
@@ -10881,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": [
             {
@@ -10972,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": [
             {
@@ -10988,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": [
             {
@@ -11054,7 +11124,7 @@
           "mutable": false,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "Show the loader",
+          "docs": "When true, the loader is active.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11071,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": [
@@ -11088,7 +11158,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "Accessible name for the component",
+          "docs": "Accessible name for the loader.",
           "docsTags": [],
           "values": [
             {
@@ -11104,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": [
@@ -11121,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": [
@@ -11147,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": [
@@ -11155,7 +11225,7 @@
               "type": "string"
             }
           ],
-          "optional": false,
+          "optional": true,
           "required": false
         },
         {
@@ -11164,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": [
             {
@@ -11185,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": [
@@ -11204,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": [],
@@ -11254,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": {
@@ -11285,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": [
@@ -11302,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": [
@@ -11323,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": [
@@ -11331,7 +11401,7 @@
               "type": "(el: HTMLElement) => Promise<void>"
             }
           ],
-          "optional": false,
+          "optional": true,
           "required": false
         },
         {
@@ -11340,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": [
             {
@@ -11361,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": [
@@ -11378,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": [
@@ -11395,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": [
@@ -11412,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": [
             {
@@ -11422,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": [
             {
@@ -11459,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": [
@@ -11476,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": [
@@ -11493,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": [
@@ -11519,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": [
@@ -11552,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."
@@ -11569,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",
@@ -11580,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": [
@@ -11591,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": []
         },
         {
@@ -11600,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": []
         }
       ],
@@ -11616,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": [],
@@ -11686,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": {
@@ -11712,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": [
@@ -11729,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": [
@@ -11759,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": [
@@ -11767,7 +11840,7 @@
               "type": "boolean"
             }
           ],
-          "optional": false,
+          "optional": true,
           "required": false
         },
         {
@@ -11776,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": [
             {
@@ -11795,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",
@@ -11817,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": [
@@ -11843,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": [
@@ -11873,7 +11946,7 @@
           },
           "signature": "setFocus() => Promise<void>",
           "parameters": [],
-          "docs": "Sets focus on the component.",
+          "docs": "Sets focus on the `calcite-notice`.",
           "docsTags": []
         }
       ],
@@ -11884,7 +11957,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Fired when an notice is closed",
+          "docs": "Fired when `calcite-notice` is closed.",
           "docsTags": []
         },
         {
@@ -11893,7 +11966,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Fired when an Notice is opened",
+          "docs": "Fired when `calcite-notice` is opened.",
           "docsTags": []
         }
       ],
@@ -11902,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": [],
@@ -12631,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",
@@ -12643,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": [
@@ -12954,7 +13037,12 @@
           "signature": "setFocus(focusId?: ListFocusId) => Promise<void>",
           "parameters": [],
           "docs": "Sets focus on the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "focusId"
+            }
+          ]
         }
       ],
       "events": [
@@ -12980,12 +13068,12 @@
           "passive": false
         },
         {
-          "event": "calciteListItemPropsChange",
+          "event": "calciteInternalListItemPropsChange",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteListItemValueChange",
+          "event": "calciteInternalListItemValueChange",
           "capture": false,
           "passive": false
         },
@@ -13333,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": [
@@ -13403,7 +13496,8 @@
         }
       ],
       "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": [
         {
@@ -13711,7 +13805,7 @@
         },
         {
           "name": "referenceElement",
-          "type": "HTMLElement | string",
+          "type": "Element | string | ({ getBoundingClientRect: () => ClientRect | DOMRect; contextElement?: Element; })",
           "mutable": false,
           "attr": "reference-element",
           "reflectToAttr": false,
@@ -13719,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": [
@@ -13750,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",
@@ -13761,7 +13883,12 @@
           "signature": "toggle(value?: boolean) => Promise<void>",
           "parameters": [],
           "docs": "Toggles the popover's open property.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "value"
+            }
+          ]
         }
       ],
       "events": [
@@ -14578,7 +14705,7 @@
       ],
       "listeners": [
         {
-          "event": "calciteRadioGroupItemChange",
+          "event": "calciteInternalRadioGroupItemChange",
           "capture": false,
           "passive": false
         },
@@ -15251,12 +15378,12 @@
       ],
       "listeners": [
         {
-          "event": "calciteOptionChange",
+          "event": "calciteInternalOptionChange",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteOptionGroupChange",
+          "event": "calciteInternalOptionGroupChange",
           "capture": false,
           "passive": false
         }
@@ -16813,7 +16940,12 @@
           "signature": "goToStep(step: number) => Promise<void>",
           "parameters": [],
           "docs": "set the requested step as active",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "step"
+            }
+          ]
         },
         {
           "name": "nextStep",
@@ -16852,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
         }
@@ -16998,7 +17130,7 @@
       "events": [],
       "listeners": [
         {
-          "event": "calciteStepperItemChange",
+          "event": "calciteInternalStepperItemChange",
           "target": "body",
           "capture": false,
           "passive": false
@@ -17361,12 +17493,12 @@
       ],
       "listeners": [
         {
-          "event": "calciteTabsFocusPrevious",
+          "event": "calciteInternalTabsFocusPrevious",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteTabsFocusNext",
+          "event": "calciteInternalTabsFocusNext",
           "capture": false,
           "passive": false
         },
@@ -17381,7 +17513,7 @@
           "passive": false
         },
         {
-          "event": "calciteTabTitleRegister",
+          "event": "calciteInternalTabTitleRegister",
           "capture": false,
           "passive": false
         },
@@ -17715,7 +17847,7 @@
       "events": [],
       "listeners": [
         {
-          "event": "calciteTabTitleRegister",
+          "event": "calciteInternalTabTitleRegister",
           "capture": false,
           "passive": false
         },
@@ -17726,7 +17858,7 @@
           "passive": false
         },
         {
-          "event": "calciteTabRegister",
+          "event": "calciteInternalTabRegister",
           "capture": false,
           "passive": false
         },
@@ -18692,7 +18824,12 @@
           "signature": "setFocus(target: TimePart) => Promise<void>",
           "parameters": [],
           "docs": "Sets focus on the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "target"
+            }
+          ]
         }
       ],
       "events": [],
@@ -19207,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<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"
+        "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": [
             {
@@ -19232,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",
@@ -19254,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": [
@@ -19271,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": [
@@ -19288,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": [
@@ -19310,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",
@@ -19334,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,
@@ -19445,7 +19606,7 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "- A slot for calcite-tree-item elements."
+          "text": "- A slot for `calcite-tree-item` elements."
         }
       ],
       "usage": {
@@ -19591,7 +19752,7 @@
           "passive": false
         },
         {
-          "event": "calciteTreeItemSelect",
+          "event": "calciteInternalTreeItemSelect",
           "capture": false,
           "passive": false
         },
@@ -19605,7 +19766,7 @@
       "slots": [
         {
           "name": "",
-          "docs": "A slot for calcite-tree-item elements."
+          "docs": "A slot for `calcite-tree-item` elements."
         }
       ],
       "parts": [],
@@ -19626,7 +19787,7 @@
         },
         {
           "name": "slot",
-          "text": "children - A slot for adding nested calcite-tree elements."
+          "text": "children - A slot for adding nested `calcite-tree` elements."
         }
       ],
       "usage": {},
@@ -19688,7 +19849,7 @@
         },
         {
           "name": "children",
-          "docs": "A slot for adding nested calcite-tree elements."
+          "docs": "A slot for adding nested `calcite-tree` elements."
         }
       ],
       "parts": [],
@@ -19713,7 +19874,7 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "- A slot for adding calcite-value-list-item elements. List 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",
@@ -19882,7 +20043,12 @@
           "signature": "setFocus(focusId?: ListFocusId) => Promise<void>",
           "parameters": [],
           "docs": "Sets focus on the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "focusId"
+            }
+          ]
         }
       ],
       "events": [
@@ -19922,12 +20088,12 @@
           "passive": false
         },
         {
-          "event": "calciteListItemPropsChange",
+          "event": "calciteInternalListItemPropsChange",
           "capture": false,
           "passive": false
         },
         {
-          "event": "calciteListItemValueChange",
+          "event": "calciteInternalListItemValueChange",
           "capture": false,
           "passive": false
         }
@@ -19936,7 +20102,7 @@
       "slots": [
         {
           "name": "",
-          "docs": "A slot for adding calcite-value-list-item elements. List 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",
@@ -20165,7 +20331,12 @@
           "signature": "toggleSelected(coerce?: boolean) => Promise<void>",
           "parameters": [],
           "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": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "coerce"
+            }
+          ]
         }
       ],
       "events": [