@esri/calcite-components 1.0.0-next.605 → 1.0.0-next.607

package/dist/extras/docs-json.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2022-10-22T01:56:11",
+  "timestamp": "2022-10-24T20:29:28",
   "compiler": {
     "name": "@stencil/core",
     "version": "2.18.1",
@@ -2316,11 +2316,11 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "- A slot for adding content to the block."
+          "text": "- A slot for adding content to the component."
         },
         {
           "name": "slot",
-          "text": "icon - A slot for adding a leading header icon."
+          "text": "icon - A slot for adding a leading header icon with `calcite-icon`."
         },
         {
           "name": "slot",
@@ -2328,7 +2328,7 @@
         },
         {
           "name": "slot",
-          "text": "header-menu-actions - a slot for adding an overflow menu with actions inside a dropdown."
+          "text": "header-menu-actions - A slot for adding an overflow menu with `calcite-action`s inside a dropdown."
         }
       ],
       "usage": {
@@ -2345,7 +2345,7 @@
           "mutable": false,
           "attr": "collapsible",
           "reflectToAttr": true,
-          "docs": "When true, this block will be collapsible.",
+          "docs": "When `true`, the component is collapsible.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -2362,7 +2362,7 @@
           "mutable": false,
           "attr": "description",
           "reflectToAttr": false,
-          "docs": "Block description",
+          "docs": "A description for the component, which displays below the heading.",
           "docsTags": [],
           "values": [
             {
@@ -2378,7 +2378,7 @@
           "mutable": false,
           "attr": "disable-padding",
           "reflectToAttr": true,
-          "docs": "When true, removes padding for the slotted content",
+          "docs": "When `true`, removes padding for the slotted content.",
           "docsTags": [
             {
               "name": "deprecated",
@@ -2401,7 +2401,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, disabled prevents interaction. This state shows items with lower opacity/grayed.",
+          "docs": "When `true`, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -2418,7 +2418,7 @@
           "mutable": false,
           "attr": "drag-handle",
           "reflectToAttr": true,
-          "docs": "When true, displays a drag handle in the header.",
+          "docs": "When `true`, displays a drag handle in the header.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -2435,7 +2435,7 @@
           "mutable": false,
           "attr": "heading",
           "reflectToAttr": false,
-          "docs": "Block heading.",
+          "docs": "The component header text.",
           "docsTags": [],
           "values": [
             {
@@ -2451,7 +2451,7 @@
           "mutable": false,
           "attr": "heading-level",
           "reflectToAttr": true,
-          "docs": "Number at which section headings should start for this component.",
+          "docs": "Specifies the number at which section headings should start.",
           "docsTags": [],
           "values": [
             {
@@ -2488,7 +2488,7 @@
           "mutable": false,
           "attr": "intl-collapse",
           "reflectToAttr": false,
-          "docs": "Aria-label for collapsing the toggle and tooltip used for the toggle when expanded.",
+          "docs": "Accessible name for the component's collapse button.",
           "docsTags": [
             {
               "name": "default",
@@ -2510,7 +2510,7 @@
           "mutable": false,
           "attr": "intl-expand",
           "reflectToAttr": false,
-          "docs": "Aria-label for expanding the toggle and tooltip used for the toggle when collapsed.",
+          "docs": "Accessible name for the component's expand button.",
           "docsTags": [
             {
               "name": "default",
@@ -2532,7 +2532,7 @@
           "mutable": false,
           "attr": "intl-loading",
           "reflectToAttr": false,
-          "docs": "string to override English loading text",
+          "docs": "Accessible name when the component is loading.",
           "docsTags": [
             {
               "name": "default",
@@ -2554,7 +2554,7 @@
           "mutable": false,
           "attr": "intl-options",
           "reflectToAttr": false,
-          "docs": "Text string used for the actions menu",
+          "docs": "Accessible name for the component's options button.",
           "docsTags": [
             {
               "name": "default",
@@ -2576,7 +2576,7 @@
           "mutable": false,
           "attr": "loading",
           "reflectToAttr": true,
-          "docs": "When true, content is waiting to be loaded. This state shows a busy indicator.",
+          "docs": "When `true`, a busy indicator is displayed.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -2593,7 +2593,7 @@
           "mutable": true,
           "attr": "open",
           "reflectToAttr": true,
-          "docs": "When true, the block's content will be displayed.",
+          "docs": "When `true`, expands the component and its contents.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -2610,7 +2610,7 @@
           "mutable": false,
           "attr": "status",
           "reflectToAttr": true,
-          "docs": "Block status. Updates or adds icon to show related icon and color.",
+          "docs": "Displays a status-related indicator icon.",
           "docsTags": [],
           "values": [
             {
@@ -2635,14 +2635,14 @@
           "mutable": false,
           "attr": "summary",
           "reflectToAttr": false,
-          "docs": "Block summary.",
+          "docs": "A description for the component, which displays below the heading.",
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use description instead"
+              "text": "use `description` instead"
             }
           ],
-          "deprecation": "use description instead",
+          "deprecation": "use `description` instead",
           "values": [
             {
               "type": "string"
@@ -2660,7 +2660,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Emitted when the header has been clicked.",
+          "docs": "Emits when the component's header is clicked.",
           "docsTags": []
         }
       ],
@@ -2669,7 +2669,7 @@
       "slots": [
         {
           "name": "",
-          "docs": "A slot for adding content to the block."
+          "docs": "A slot for adding content to the component."
         },
         {
           "name": "control",
@@ -2677,11 +2677,11 @@
         },
         {
           "name": "header-menu-actions",
-          "docs": "a slot for adding an overflow menu with actions inside a dropdown."
+          "docs": "A slot for adding an overflow menu with `calcite-action`s inside a dropdown."
         },
         {
           "name": "icon",
-          "docs": "A slot for adding a leading header icon."
+          "docs": "A slot for adding a leading header icon with `calcite-icon`."
         }
       ],
       "parts": [],
@@ -2730,7 +2730,7 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "- A slot for adding content to the block section."
+          "text": "- A slot for adding content to the component."
         }
       ],
       "usage": {},
@@ -2741,7 +2741,7 @@
           "mutable": false,
           "attr": "intl-collapse",
           "reflectToAttr": false,
-          "docs": "Tooltip used for the toggle when expanded.",
+          "docs": "Accessible name for the component's collapse button.",
           "docsTags": [],
           "values": [
             {
@@ -2757,7 +2757,7 @@
           "mutable": false,
           "attr": "intl-expand",
           "reflectToAttr": false,
-          "docs": "Tooltip used for the toggle when collapsed.",
+          "docs": "Accessible name for the component's expand button.",
           "docsTags": [],
           "values": [
             {
@@ -2773,7 +2773,7 @@
           "mutable": true,
           "attr": "open",
           "reflectToAttr": true,
-          "docs": "When true, the block's section content will be displayed.",
+          "docs": "When `true`, expands the component and its contents.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -2790,7 +2790,7 @@
           "mutable": false,
           "attr": "status",
           "reflectToAttr": true,
-          "docs": "BlockSection status. Adds indicator to show valid or invalid status.",
+          "docs": "Displays a status-related indicator icon.",
           "docsTags": [],
           "values": [
             {
@@ -2815,7 +2815,7 @@
           "mutable": false,
           "attr": "text",
           "reflectToAttr": false,
-          "docs": "Text displayed in the button.",
+          "docs": "The component header text.",
           "docsTags": [],
           "values": [
             {
@@ -2831,7 +2831,7 @@
           "mutable": false,
           "attr": "toggle-display",
           "reflectToAttr": true,
-          "docs": "This property determines the look of the section toggle.\nIf the value is \"switch\", a toggle-switch will be displayed.\nIf the value is \"button\", a clickable header is displayed.",
+          "docs": "Specifies the component's toggle display -\n\n`\"button\"` (selectable header), or\n\n`\"switch\"` (toggle switch).",
           "docsTags": [],
           "default": "\"button\"",
           "values": [
@@ -2856,7 +2856,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Emitted when the header has been clicked.",
+          "docs": "Emits when the header has been clicked.",
           "docsTags": []
         }
       ],
@@ -2865,7 +2865,7 @@
       "slots": [
         {
           "name": "",
-          "docs": "A slot for adding content to the block section."
+          "docs": "A slot for adding content to the component."
         }
       ],
       "parts": [],
@@ -2908,7 +2908,7 @@
           "mutable": false,
           "attr": "alignment",
           "reflectToAttr": true,
-          "docs": "optionally specify alignment of button elements.",
+          "docs": "Specifies the alignment of the component's elements.",
           "docsTags": [],
           "default": "\"center\"",
           "values": [
@@ -2946,7 +2946,7 @@
           "mutable": false,
           "attr": "appearance",
           "reflectToAttr": true,
-          "docs": "specify the appearance style of the button, defaults to solid.",
+          "docs": "Specifies the appearance style of the component.",
           "docsTags": [],
           "default": "\"solid\"",
           "values": [
@@ -2980,7 +2980,7 @@
           "mutable": false,
           "attr": "color",
           "reflectToAttr": true,
-          "docs": "specify the color of the button, defaults to blue",
+          "docs": "Specifies the color of the component.",
           "docsTags": [],
           "default": "\"blue\"",
           "values": [
@@ -3010,7 +3010,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "is the button disabled",
+          "docs": "When `true`, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -3027,14 +3027,14 @@
           "mutable": false,
           "attr": "form",
           "reflectToAttr": false,
-          "docs": "The form ID to associate with the component",
+          "docs": "The form ID to associate with the component.",
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "– this property is no longer needed if placed inside a form."
+              "text": "– The property is no longer needed if the component is placed inside a form."
             }
           ],
-          "deprecation": "– this property is no longer needed if placed inside a form.",
+          "deprecation": "– The property is no longer needed if the component is placed inside a form.",
           "values": [
             {
               "type": "string"
@@ -3049,7 +3049,7 @@
           "mutable": false,
           "attr": "href",
           "reflectToAttr": true,
-          "docs": "optionally pass a href - used to determine if the component should render as a button or an anchor",
+          "docs": "Specifies the URL of the linked resource, which can be set as an absolute or relative path.",
           "docsTags": [],
           "values": [
             {
@@ -3081,7 +3081,7 @@
           "mutable": false,
           "attr": "icon-flip-rtl",
           "reflectToAttr": true,
-          "docs": "When true, the icon will be flipped when the element direction is right-to-left (`\"rtl\"`).",
+          "docs": "When `true`, the icon will be flipped when the element direction is right-to-left (`\"rtl\"`).",
           "docsTags": [],
           "values": [
             {
@@ -3122,7 +3122,7 @@
           "mutable": false,
           "attr": "intl-loading",
           "reflectToAttr": false,
-          "docs": "string to override English loading text",
+          "docs": "Accessible name when the component is loading.",
           "docsTags": [
             {
               "name": "default",
@@ -3144,7 +3144,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "Applies to the aria-label attribute on the button or hyperlink",
+          "docs": "Accessible name for the component.",
           "docsTags": [],
           "values": [
             {
@@ -3160,7 +3160,7 @@
           "mutable": false,
           "attr": "loading",
           "reflectToAttr": true,
-          "docs": "optionally add a calcite-loader component to the button, disabling interaction.",
+          "docs": "When `true`, a busy indicator is displayed and interaction is disabled.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -3177,7 +3177,7 @@
           "mutable": false,
           "attr": "name",
           "reflectToAttr": true,
-          "docs": "The name attribute to apply to the button",
+          "docs": "Specifies the name of the component on form submission.",
           "docsTags": [],
           "values": [
             {
@@ -3193,8 +3193,13 @@
           "mutable": false,
           "attr": "rel",
           "reflectToAttr": true,
-          "docs": "The rel attribute to apply to the hyperlink",
-          "docsTags": [],
+          "docs": "Defines the relationship between the `href` value and the current document.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[rel](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel)"
+            }
+          ],
           "values": [
             {
               "type": "string"
@@ -3209,7 +3214,7 @@
           "mutable": false,
           "attr": "round",
           "reflectToAttr": true,
-          "docs": "optionally add a round style to the button",
+          "docs": "When `true`, adds a round style to the component.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -3226,7 +3231,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of the button, defaults to m",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -3252,7 +3257,7 @@
           "mutable": false,
           "attr": "split-child",
           "reflectToAttr": true,
-          "docs": "is the button a child of a calcite-split-button",
+          "docs": "Specifies if the component is a child of a `calcite-split-button`.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -3277,8 +3282,13 @@
           "mutable": false,
           "attr": "target",
           "reflectToAttr": true,
-          "docs": "The target attribute to apply to the hyperlink",
-          "docsTags": [],
+          "docs": "Specifies where to open the linked document defined in the `href` property.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[target](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#attr-target)"
+            }
+          ],
           "values": [
             {
               "type": "string"
@@ -3293,8 +3303,13 @@
           "mutable": true,
           "attr": "type",
           "reflectToAttr": true,
-          "docs": "The type attribute to apply to the button",
-          "docsTags": [],
+          "docs": "Specifies the default behavior of the button.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[type](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-type)"
+            }
+          ],
           "default": "\"button\"",
           "values": [
             {
@@ -3310,7 +3325,7 @@
           "mutable": false,
           "attr": "width",
           "reflectToAttr": true,
-          "docs": "specify the width of the button, defaults to auto",
+          "docs": "Specifies the width of the component.",
           "docsTags": [],
           "default": "\"auto\"",
           "values": [
@@ -3396,15 +3411,15 @@
         },
         {
           "name": "slot",
-          "text": "thumbnail - A slot for adding a thumbnail to the card."
+          "text": "thumbnail - A slot for adding a thumbnail to the component."
         },
         {
           "name": "slot",
-          "text": "title - A slot for adding a card title."
+          "text": "title - A slot for adding a title."
         },
         {
           "name": "slot",
-          "text": "subtitle - A slot for adding a card subtitle or short summary."
+          "text": "subtitle - A slot for adding a subtitle or short summary."
         },
         {
           "name": "slot",
@@ -3425,7 +3440,7 @@
           "mutable": false,
           "attr": "intl-deselect",
           "reflectToAttr": false,
-          "docs": "string to override English deselect text for checkbox when selectable is true",
+          "docs": "When `selectable` is `true`, the accessible name for the component's checkbox for deselection.",
           "docsTags": [
             {
               "name": "default",
@@ -3447,7 +3462,7 @@
           "mutable": false,
           "attr": "intl-loading",
           "reflectToAttr": false,
-          "docs": "string to override English loading text",
+          "docs": "Accessible name when the component is loading.",
           "docsTags": [
             {
               "name": "default",
@@ -3469,7 +3484,7 @@
           "mutable": false,
           "attr": "intl-select",
           "reflectToAttr": false,
-          "docs": "string to override English select text for checkbox when selectable is true",
+          "docs": "When `selectable` is `true`, the accessible name for the component's checkbox for selection.",
           "docsTags": [
             {
               "name": "default",
@@ -3491,7 +3506,7 @@
           "mutable": false,
           "attr": "loading",
           "reflectToAttr": true,
-          "docs": "When true, the cards content is waiting to be loaded. This state shows a busy indicator.",
+          "docs": "When `true`, a busy indicator is displayed.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -3508,7 +3523,7 @@
           "mutable": false,
           "attr": "selectable",
           "reflectToAttr": true,
-          "docs": "Indicates whether the card is selectable.",
+          "docs": "When `true`, the component is selectable.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -3525,7 +3540,7 @@
           "mutable": true,
           "attr": "selected",
           "reflectToAttr": true,
-          "docs": "Indicates whether the card is selected.",
+          "docs": "When `true`, the component is selected.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -3542,7 +3557,7 @@
           "mutable": false,
           "attr": "thumbnail-position",
           "reflectToAttr": true,
-          "docs": "",
+          "docs": "Sets the placement of the thumbnail defined in the `thumbnail` slot.",
           "docsTags": [],
           "default": "\"block-start\"",
           "values": [
@@ -3575,7 +3590,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Fired when a selectable card is selected",
+          "docs": "Fires when `selectable` is `true` and the component is selected.",
           "docsTags": []
         }
       ],
@@ -3596,15 +3611,15 @@
         },
         {
           "name": "subtitle",
-          "docs": "A slot for adding a card subtitle or short summary."
+          "docs": "A slot for adding a subtitle or short summary."
         },
         {
           "name": "thumbnail",
-          "docs": "A slot for adding a thumbnail to the card."
+          "docs": "A slot for adding a thumbnail to the component."
         },
         {
           "name": "title",
-          "docs": "A slot for adding a card title."
+          "docs": "A slot for adding a title."
         }
       ],
       "parts": [],
@@ -3642,7 +3657,7 @@
           "mutable": true,
           "attr": "checked",
           "reflectToAttr": true,
-          "docs": "The checked state of the checkbox.",
+          "docs": "When `true`, the component is checked.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -3659,7 +3674,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "True if the checkbox is disabled",
+          "docs": "When `true`, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -3676,7 +3691,7 @@
           "mutable": true,
           "attr": "guid",
           "reflectToAttr": true,
-          "docs": "The id attribute of the checkbox.  When omitted, a globally unique identifier is used.",
+          "docs": "The `id` attribute of the component. When omitted, a globally unique identifier is used.",
           "docsTags": [],
           "values": [
             {
@@ -3692,8 +3707,13 @@
           "mutable": true,
           "attr": "indeterminate",
           "reflectToAttr": true,
-          "docs": "True if the checkbox is initially indeterminate,\nwhich is independent from its checked state\nhttps://css-tricks.com/indeterminate-checkboxes/",
-          "docsTags": [],
+          "docs": "When `true`, the component is initially indeterminate, which is independent from its `checked` value.\n\nThe state is visual only, and can look different across browsers.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[indeterminate](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/checkbox#indeterminate_state_checkboxes)"
+            }
+          ],
           "default": "false",
           "values": [
             {
@@ -3709,7 +3729,7 @@
           "mutable": false,
           "attr": "name",
           "reflectToAttr": true,
-          "docs": "The name of the checkbox input",
+          "docs": "Specifies the name of the component on form submission.",
           "docsTags": [],
           "values": [
             {
@@ -3725,7 +3745,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of the checkbox, defaults to m",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -3751,7 +3771,7 @@
           "mutable": false,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "The value of the checkbox input",
+          "docs": "The component's value.",
           "docsTags": [],
           "values": [
             {
@@ -3782,7 +3802,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Emitted when the checkbox checked status changes",
+          "docs": "Emits when the component's `checked` status changes.",
           "docsTags": []
         }
       ],
@@ -3791,7 +3811,7 @@
         {
           "name": "--calcite-checkbox-size",
           "annotation": "prop",
-          "docs": "the width and height of the checkbox"
+          "docs": "Specifies the component's height and width."
         }
       ],
       "slots": [],
@@ -3836,7 +3856,7 @@
           "mutable": false,
           "attr": "appearance",
           "reflectToAttr": true,
-          "docs": "specify the appearance style of the button, defaults to solid.",
+          "docs": "Specifies the appearance style of the component.",
           "docsTags": [],
           "default": "\"solid\"",
           "values": [
@@ -3858,7 +3878,7 @@
           "mutable": true,
           "attr": "closable",
           "reflectToAttr": true,
-          "docs": "When true, show abutton user can click to dismiss the chip.",
+          "docs": "When `true`, a close button is added to the component.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -3875,7 +3895,7 @@
           "mutable": true,
           "attr": "closed",
           "reflectToAttr": true,
-          "docs": "When true, hides the chip",
+          "docs": "When `true`, hides the component.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -3892,7 +3912,7 @@
           "mutable": false,
           "attr": "color",
           "reflectToAttr": true,
-          "docs": "specify the color of the button, defaults to blue",
+          "docs": "Specifies the color for the component.",
           "docsTags": [],
           "default": "\"grey\"",
           "values": [
@@ -3926,7 +3946,7 @@
           "mutable": false,
           "attr": "dismiss-label",
           "reflectToAttr": false,
-          "docs": "Aria label for the \"x\" button",
+          "docs": "Accessible name for the component's close button.",
           "docsTags": [
             {
               "name": "default",
@@ -3948,15 +3968,15 @@
           "mutable": true,
           "attr": "dismissible",
           "reflectToAttr": true,
-          "docs": "Optionally show a button the user can click to dismiss the chip",
+          "docs": "When `true`, a close button is added to the component.",
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use closable instead"
+              "text": "use `closable` instead."
             }
           ],
           "default": "false",
-          "deprecation": "use closable instead",
+          "deprecation": "use `closable` instead.",
           "values": [
             {
               "type": "boolean"
@@ -3987,7 +4007,7 @@
           "mutable": false,
           "attr": "icon-flip-rtl",
           "reflectToAttr": true,
-          "docs": "When true, the icon will be flipped when the element direction is right-to-left (`\"rtl\"`).",
+          "docs": "When `true`, the icon will be flipped when the element direction is right-to-left (`\"rtl\"`).",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -4004,7 +4024,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of the chip, defaults to m",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -4030,7 +4050,7 @@
           "mutable": false,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "The assigned value for the chip",
+          "docs": "The component's value.",
           "docsTags": [],
           "values": [
             {
@@ -4061,7 +4081,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Emitted when the dismiss button is clicked\n\n**Note:**: The `el` event payload props is deprecated, please use the event's `target`/`currentTarget` instead",
+          "docs": "Fires when the dismiss button is clicked.\n\n**Note:**: The `el` event payload props is deprecated, please use the event's `target`/`currentTarget` instead.",
           "docsTags": []
         }
       ],
@@ -4119,7 +4139,7 @@
           "mutable": false,
           "attr": "allow-empty",
           "reflectToAttr": true,
-          "docs": "When false, empty color (null) will be allowed as a value. Otherwise, a color value is always enforced by the component.\n\nWhen true, clearing the input and blurring will restore the last valid color set. When false, it will set it to empty.",
+          "docs": "When `false`, an empty color (`null`) will be allowed as a `value`. Otherwise, a color value is enforced on the component.\n\nWhen `true`, a color value is enforced, and clearing the input or blurring will restore the last valid `value`. When `false`, an empty color (`null`) will be allowed as a `value`.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -4136,7 +4156,7 @@
           "mutable": false,
           "attr": "appearance",
           "reflectToAttr": true,
-          "docs": "specify the appearance - solid (containing border), or minimal (no containing border)",
+          "docs": "Specifies the appearance style of the component -\n\n`\"solid\"` (containing border) or `\"minimal\"` (no containing border).",
           "docsTags": [],
           "default": "\"solid\"",
           "values": [
@@ -4162,7 +4182,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, disabled prevents user interaction.",
+          "docs": "When `true`, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -4179,7 +4199,7 @@
           "mutable": false,
           "attr": "format",
           "reflectToAttr": true,
-          "docs": "The format of the value property.\n\nWhen \"auto\", the format will be inferred from `value` when set.",
+          "docs": "The format of `value`.\n\nWhen `\"auto\"`, the format will be inferred from `value` when set.",
           "docsTags": [
             {
               "name": "default",
@@ -4250,7 +4270,7 @@
           "mutable": false,
           "attr": "hide-channels",
           "reflectToAttr": true,
-          "docs": "When true, hides the RGB/HSV channel inputs",
+          "docs": "When `true`, hides the RGB/HSV channel inputs.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -4267,7 +4287,7 @@
           "mutable": false,
           "attr": "hide-hex",
           "reflectToAttr": true,
-          "docs": "When true, hides the hex input",
+          "docs": "When `true`, hides the Hex input.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -4284,7 +4304,7 @@
           "mutable": false,
           "attr": "hide-saved",
           "reflectToAttr": true,
-          "docs": "When true, hides the saved colors section",
+          "docs": "When `true`, hides the saved colors section.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -4301,7 +4321,7 @@
           "mutable": false,
           "attr": "intl-b",
           "reflectToAttr": false,
-          "docs": "Label used for the blue channel",
+          "docs": "Accessible name for the RGB section's blue channel.",
           "docsTags": [
             {
               "name": "default",
@@ -4323,7 +4343,7 @@
           "mutable": false,
           "attr": "intl-blue",
           "reflectToAttr": false,
-          "docs": "Label used for the blue channel description",
+          "docs": "Accessible name for the RGB section's blue channel description.",
           "docsTags": [
             {
               "name": "default",
@@ -4345,7 +4365,7 @@
           "mutable": false,
           "attr": "intl-delete-color",
           "reflectToAttr": false,
-          "docs": "Label used for the delete color button.",
+          "docs": "Accessible name for the delete color button.",
           "docsTags": [
             {
               "name": "default",
@@ -4367,7 +4387,7 @@
           "mutable": false,
           "attr": "intl-g",
           "reflectToAttr": false,
-          "docs": "Label used for the green channel",
+          "docs": "Accessible name for the RGB section's green channel.",
           "docsTags": [
             {
               "name": "default",
@@ -4389,7 +4409,7 @@
           "mutable": false,
           "attr": "intl-green",
           "reflectToAttr": false,
-          "docs": "Label used for the green channel description",
+          "docs": "Accessible name for the RGB section's green channel description.",
           "docsTags": [
             {
               "name": "default",
@@ -4411,7 +4431,7 @@
           "mutable": false,
           "attr": "intl-h",
           "reflectToAttr": false,
-          "docs": "Label used for the hue channel",
+          "docs": "Accessible name for the HSV section's hue channel.",
           "docsTags": [
             {
               "name": "default",
@@ -4433,7 +4453,7 @@
           "mutable": false,
           "attr": "intl-hex",
           "reflectToAttr": false,
-          "docs": "Label used for the hex input",
+          "docs": "Accessible name for the Hex input.",
           "docsTags": [
             {
               "name": "default",
@@ -4455,7 +4475,7 @@
           "mutable": false,
           "attr": "intl-hsv",
           "reflectToAttr": false,
-          "docs": "Label used for the HSV mode",
+          "docs": "Accessible name for the HSV mode.",
           "docsTags": [
             {
               "name": "default",
@@ -4477,7 +4497,7 @@
           "mutable": false,
           "attr": "intl-hue",
           "reflectToAttr": false,
-          "docs": "Label used for the hue channel description",
+          "docs": "Accessible name for the HSV section's hue channel description.",
           "docsTags": [
             {
               "name": "default",
@@ -4499,7 +4519,7 @@
           "mutable": false,
           "attr": "intl-no-color",
           "reflectToAttr": false,
-          "docs": "Label used for the hex input when there is no color selected.",
+          "docs": "Accessible name for the Hex input when there is no color selected.",
           "docsTags": [
             {
               "name": "default",
@@ -4521,7 +4541,7 @@
           "mutable": false,
           "attr": "intl-r",
           "reflectToAttr": false,
-          "docs": "Label used for the red channel",
+          "docs": "Accessible name for the RGB section's red channel.",
           "docsTags": [
             {
               "name": "default",
@@ -4543,7 +4563,7 @@
           "mutable": false,
           "attr": "intl-red",
           "reflectToAttr": false,
-          "docs": "Label used for the red channel description",
+          "docs": "Accessible name for the RGB section's red channel description.",
           "docsTags": [
             {
               "name": "default",
@@ -4565,7 +4585,7 @@
           "mutable": false,
           "attr": "intl-rgb",
           "reflectToAttr": false,
-          "docs": "Label used for the RGB mode",
+          "docs": "Accessible name for the RGB mode.",
           "docsTags": [
             {
               "name": "default",
@@ -4587,7 +4607,7 @@
           "mutable": false,
           "attr": "intl-s",
           "reflectToAttr": false,
-          "docs": "Label used for the saturation channel",
+          "docs": "Accessible name for the HSV section's saturation channel.",
           "docsTags": [
             {
               "name": "default",
@@ -4609,7 +4629,7 @@
           "mutable": false,
           "attr": "intl-saturation",
           "reflectToAttr": false,
-          "docs": "Label used for the saturation channel description",
+          "docs": "Accessible name for the HSV section's saturation channel description.",
           "docsTags": [
             {
               "name": "default",
@@ -4631,7 +4651,7 @@
           "mutable": false,
           "attr": "intl-save-color",
           "reflectToAttr": false,
-          "docs": "Label used for the save color button.",
+          "docs": "Accessible name for the save color button.",
           "docsTags": [
             {
               "name": "default",
@@ -4653,7 +4673,7 @@
           "mutable": false,
           "attr": "intl-saved",
           "reflectToAttr": false,
-          "docs": "Label used for the saved colors section",
+          "docs": "Accessible name for the saved colors section.",
           "docsTags": [
             {
               "name": "default",
@@ -4675,7 +4695,7 @@
           "mutable": false,
           "attr": "intl-v",
           "reflectToAttr": false,
-          "docs": "Label used for the value channel",
+          "docs": "Accessible name for the HSV section's value channel.",
           "docsTags": [
             {
               "name": "default",
@@ -4697,7 +4717,7 @@
           "mutable": false,
           "attr": "intl-value",
           "reflectToAttr": false,
-          "docs": "Label used for the",
+          "docs": "Accessible name for the HSV section's value channel description.",
           "docsTags": [
             {
               "name": "default",
@@ -4820,7 +4840,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "The scale of the color picker.",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -4846,7 +4866,7 @@
           "mutable": false,
           "attr": "storage-id",
           "reflectToAttr": true,
-          "docs": "Storage ID for colors.",
+          "docs": "Specifies the storage ID for colors.",
           "docsTags": [],
           "values": [
             {
@@ -4862,7 +4882,7 @@
           "mutable": true,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "The component's value.\n\nThis value can be either a CSS color string,\na RGB, HSL or HSV object.\n\nThe type will be preserved as the color is updated.",
+          "docs": "The component's value, where the value can be a CSS color string, or a RGB, HSL or HSV object.\n\nThe type will be preserved as the color is updated.",
           "docsTags": [
             {
               "name": "default",
@@ -4934,7 +4954,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Fires as the color value changes.\n\nThis is similar to the change event with the exception of dragging. When dragging the color field or hue slider thumb, this event fires as the thumb is moved.",
+          "docs": "Fires as the color value changes.\n\nSimilar to the `calciteColorPickerChange` event with the exception of dragging. When dragging the color field or hue slider thumb, this event fires as the thumb is moved.",
           "docsTags": []
         }
       ],
@@ -5007,7 +5027,7 @@
           "mutable": false,
           "attr": "allow-empty",
           "reflectToAttr": false,
-          "docs": "When false, empty color (null) will be allowed as a value. Otherwise, a color value is always enforced by the component.\n\nWhen true, clearing the input and blurring will restore the last valid color set. When false, it will set it to empty.",
+          "docs": "When `false`, an empty color (`null`) will be allowed as a `value`. Otherwise, a color value is enforced on the component.\n\nWhen `true`, a color value is enforced, and clearing the input or blurring will restore the last valid `value`. When `false`, an empty color (`null`) will be allowed as a `value`.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -5024,7 +5044,7 @@
           "mutable": false,
           "attr": "intl-hex",
           "reflectToAttr": false,
-          "docs": "Label used for the hex input.",
+          "docs": "Accessible name for the Hex input.",
           "docsTags": [
             {
               "name": "default",
@@ -5046,7 +5066,7 @@
           "mutable": false,
           "attr": "intl-no-color",
           "reflectToAttr": false,
-          "docs": "Label used for the hex input when there is no color selected.",
+          "docs": "Accessible name for the Hex input when there is no color selected.",
           "docsTags": [
             {
               "name": "default",
@@ -5169,7 +5189,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "The component's scale.",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -5195,7 +5215,7 @@
           "mutable": true,
           "attr": "value",
           "reflectToAttr": true,
-          "docs": "The hex value.",
+          "docs": "The Hex value.",
           "docsTags": [],
           "default": "normalizeHex(DEFAULT_COLOR.hex())",
           "values": [
@@ -5277,7 +5297,7 @@
           "mutable": false,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "Used to display whether the swatch is active or not.",
+          "docs": "When `true`, the component is active.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -5315,7 +5335,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "The component scale.",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -5380,15 +5400,15 @@
           "mutable": true,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "When true, opens the combobox",
+          "docs": "When `true`, displays and positions the component.",
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use open instead"
+              "text": "use `open` instead."
             }
           ],
           "default": "false",
-          "deprecation": "use open instead",
+          "deprecation": "use `open` instead.",
           "values": [
             {
               "type": "boolean"
@@ -5403,7 +5423,7 @@
           "mutable": false,
           "attr": "allow-custom-values",
           "reflectToAttr": true,
-          "docs": "Allow entry of custom values which are not in the original set of items",
+          "docs": "When `true`, allows entry of custom values, which are not in the original set of items.",
           "docsTags": [],
           "values": [
             {
@@ -5419,7 +5439,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "Disable combobox input",
+          "docs": "When `true`, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -5451,7 +5471,7 @@
           "mutable": false,
           "attr": "intl-remove-tag",
           "reflectToAttr": false,
-          "docs": "string to override the English \"Remove tag\" text for when an item is selected.",
+          "docs": "Accessible name for the component's remove tag when a `calcite-combobox-item` is selected.",
           "docsTags": [
             {
               "name": "default",
@@ -5473,7 +5493,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "Aria label for combobox (required)",
+          "docs": "Accessible name for the component.",
           "docsTags": [],
           "values": [
             {
@@ -5489,7 +5509,7 @@
           "mutable": false,
           "attr": "max-items",
           "reflectToAttr": true,
-          "docs": "Specify the maximum number of combobox items (including nested children) to display before showing the scroller",
+          "docs": "Specifies the maximum number of `calcite-combobox-item`s (including nested children) to display before displaying a scrollbar.",
           "docsTags": [],
           "default": "0",
           "values": [
@@ -5506,7 +5526,7 @@
           "mutable": false,
           "attr": "name",
           "reflectToAttr": true,
-          "docs": "The name of the switch input",
+          "docs": "Specifies the name of the component on form submission.",
           "docsTags": [],
           "values": [
             {
@@ -5522,7 +5542,7 @@
           "mutable": true,
           "attr": "open",
           "reflectToAttr": true,
-          "docs": "When true, opens the combobox",
+          "docs": "When `true`, displays and positions the component.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -5561,7 +5581,7 @@
           "mutable": false,
           "attr": "placeholder",
           "reflectToAttr": false,
-          "docs": "Placeholder text for input",
+          "docs": "Specifies the placeholder text for the input.",
           "docsTags": [],
           "values": [
             {
@@ -5577,7 +5597,7 @@
           "mutable": false,
           "attr": "placeholder-icon",
           "reflectToAttr": true,
-          "docs": "Placeholder icon for input",
+          "docs": "Specifies the placeholder icon for the input.",
           "docsTags": [],
           "values": [
             {
@@ -5593,7 +5613,7 @@
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "Specify the scale of the combobox, defaults to m",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -5619,7 +5639,7 @@
           "mutable": false,
           "attr": "selection-mode",
           "reflectToAttr": true,
-          "docs": "specify the selection mode\n- multi: allow any number of selected items (default)\n- single: only one selection)\n- ancestors: like multi, but show ancestors of selected items as selected, only deepest children shown in chips",
+          "docs": "Specifies the selection mode -\n`\"multi\"` (allow any number of selected items),\n`\"single\"` (allow only one selection), or\n`\"ancestors\"` (like `\"multi\"`, but show ancestors of selected items as selected. Only the deepest children are shown in `calcite-chip`s).",
           "docsTags": [],
           "default": "\"multi\"",
           "values": [
@@ -5645,7 +5665,7 @@
           "mutable": true,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "The value(s) of the selectedItem(s)",
+          "docs": "The component's value(s) from the selected `calcite-combobox-item`(s).",
           "docsTags": [],
           "default": "null",
           "values": [
@@ -5667,10 +5687,15 @@
             "type": "Promise<void>",
             "docs": ""
           },
-          "signature": "reposition() => Promise<void>",
+          "signature": "reposition(delayed?: boolean) => Promise<void>",
           "parameters": [],
           "docs": "Updates the position of the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "delayed"
+            }
+          ]
         },
         {
           "name": "setFocus",
@@ -5691,7 +5716,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Fires when the component is requested to be closed and before the closing transition begins.",
+          "docs": "Fires when the component is requested to be closed, and before the closing transition begins.",
           "docsTags": []
         },
         {
@@ -5709,7 +5734,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Called when the selected item(s) changes.",
+          "docs": "Fires when the selected item(s) changes.",
           "docsTags": []
         },
         {
@@ -5718,7 +5743,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Called when a selected item in the combobox is dismissed via its chip\n\n**Note:**: The event payload is deprecated, please use the `value` property on the component to determine removed value instead",
+          "docs": "Fires when a selected item in the component is dismissed via its `calcite-chip`.\n\n**Note:**: The event payload is deprecated, please use the `value` property on the component to determine the removed value instead.",
           "docsTags": []
         },
         {
@@ -5736,7 +5761,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Called when the user has entered text to filter the options list",
+          "docs": "Fires when text is added to filter the options list.",
           "docsTags": []
         },
         {
@@ -5754,14 +5779,14 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Called when the selected items set changes",
+          "docs": "Fires when the selected items set changes.",
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use calciteComboboxChange instead"
+              "text": "use `calciteComboboxChange` instead."
             }
           ],
-          "deprecation": "use calciteComboboxChange instead"
+          "deprecation": "use `calciteComboboxChange` instead."
         }
       ],
       "listeners": [
@@ -5781,7 +5806,7 @@
         {
           "name": "--calcite-combobox-input-height",
           "annotation": "prop",
-          "docs": "the height of the combobox input"
+          "docs": "Specifies the height of the component's input."
         }
       ],
       "slots": [
@@ -5826,7 +5851,7 @@
           "mutable": false,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "True when item is highlighted either from keyboard or mouse hover",
+          "docs": "When `true`, the component is active.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -5842,7 +5867,7 @@
           "type": "ComboboxChildElement[]",
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "Parent and grandparent combobox items, this is set internally for use from combobox",
+          "docs": "Specifies the parent and grandparent items, which are set on `calcite-combobox`.",
           "docsTags": [],
           "values": [
             {
@@ -5858,14 +5883,14 @@
           "mutable": false,
           "attr": "constant",
           "reflectToAttr": true,
-          "docs": "Don't filter this item based on the search text",
+          "docs": "When `true`, omits the component from the `calcite-combobox` filtered search results.",
           "docsTags": [
             {
               "name": "deprecated",
-              "text": "use filterDisabled instead"
+              "text": "use `filterDisabled` instead."
             }
           ],
-          "deprecation": "use filterDisabled instead",
+          "deprecation": "use `filterDisabled` instead.",
           "values": [
             {
               "type": "boolean"
@@ -5880,7 +5905,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, the item cannot be clicked and is visually muted.",
+          "docs": "When `true`, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -5897,7 +5922,7 @@
           "mutable": false,
           "attr": "filter-disabled",
           "reflectToAttr": true,
-          "docs": "Do not filter this item based on the search text",
+          "docs": "When `true`, omits the component from the `calcite-combobox` filtered search results.",
           "docsTags": [],
           "values": [
             {
@@ -5913,7 +5938,7 @@
           "mutable": false,
           "attr": "guid",
           "reflectToAttr": true,
-          "docs": "Unique identifier, used for accessibility",
+          "docs": "The `id` attribute of the component. When omitted, a globally unique identifier is used.",
           "docsTags": [],
           "default": "guid()",
           "values": [
@@ -5930,7 +5955,7 @@
           "mutable": false,
           "attr": "icon",
           "reflectToAttr": true,
-          "docs": "Custom icon to display both in combobox chips and next to combobox item text",
+          "docs": "Specifies an icon to display.",
           "docsTags": [],
           "values": [
             {
@@ -5946,7 +5971,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`, the component is selected.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -5963,7 +5988,7 @@
           "mutable": false,
           "attr": "text-label",
           "reflectToAttr": true,
-          "docs": "The main label for this item.",
+          "docs": "The component's text.",
           "docsTags": [],
           "values": [
             {
@@ -5979,7 +6004,7 @@
           "mutable": false,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "The item's associated value",
+          "docs": "The component's value.",
           "docsTags": [],
           "values": [
             {
@@ -6015,7 +6040,7 @@
           "bubbles": true,
           "cancelable": false,
           "composed": true,
-          "docs": "Emitted whenever the item is selected or unselected.\n\n**Note:**: The event's payload is deprecated, please use the event's `target`/`currentTarget` instead",
+          "docs": "Emits whenever the component is selected or unselected.\n\n**Note:**: The event's payload is deprecated, please use the event's `target`/`currentTarget` instead",
           "docsTags": []
         }
       ],
@@ -6057,7 +6082,7 @@
           "type": "ComboboxChildElement[]",
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "Parent and grandparent combobox items, this is set internally for use from combobox",
+          "docs": "Specifies the parent and grandparent `calcite-combobox-item`s, which are set on `calcite-combobox`.",
           "docsTags": [],
           "values": [
             {
@@ -6073,7 +6098,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "Title of the group",
+          "docs": "Specifies the title of the component.",
           "docsTags": [],
           "values": [
             {
@@ -7635,10 +7660,15 @@
             "type": "Promise<void>",
             "docs": ""
           },
-          "signature": "reposition() => Promise<void>",
+          "signature": "reposition(delayed?: boolean) => Promise<void>",
           "parameters": [],
           "docs": "Updates the position of the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "delayed"
+            }
+          ]
         }
       ],
       "events": [
@@ -10624,7 +10654,7 @@
           "mutable": true,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "When true, the component is active.",
+          "docs": "When `true`, the component is active.",
           "docsTags": [
             {
               "name": "deprecated",
@@ -10647,7 +10677,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, interaction is prevented and the component is displayed with lower opacity.",
+          "docs": "When `true`, interaction is prevented and the component is displayed with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11052,7 +11082,7 @@
           "mutable": true,
           "attr": "open",
           "reflectToAttr": true,
-          "docs": "When true, displays the `calcite-date-picker` component.",
+          "docs": "When `true`, displays the `calcite-date-picker` component.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11150,7 +11180,7 @@
           "mutable": false,
           "attr": "proximity-selection-disabled",
           "reflectToAttr": false,
-          "docs": "When true, disables the default behavior on the third click of narrowing or extending the range.\nInstead starts a new range.",
+          "docs": "When `true`, disables the default behavior on the third click of narrowing or extending the range.\nInstead starts a new range.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11167,7 +11197,7 @@
           "mutable": false,
           "attr": "range",
           "reflectToAttr": true,
-          "docs": "When true, activates a range for the component.",
+          "docs": "When `true`, activates a range for the component.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -11184,7 +11214,7 @@
           "mutable": false,
           "attr": "read-only",
           "reflectToAttr": true,
-          "docs": "When true, the component's value can be read, but controls are not accessible and the value cannot be modified.",
+          "docs": "When `true`, the component's value can be read, but controls are not accessible and the value cannot be modified.",
           "docsTags": [
             {
               "name": "mdn",
@@ -11314,10 +11344,15 @@
             "type": "Promise<void>",
             "docs": ""
           },
-          "signature": "reposition() => Promise<void>",
+          "signature": "reposition(delayed?: boolean) => Promise<void>",
           "parameters": [],
           "docs": "Updates the position of the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "delayed"
+            }
+          ]
         },
         {
           "name": "setFocus",
@@ -13404,10 +13439,15 @@
             "type": "Promise<void>",
             "docs": ""
           },
-          "signature": "reposition() => Promise<void>",
+          "signature": "reposition(delayed?: boolean) => Promise<void>",
           "parameters": [],
           "docs": "Updates the position of the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "delayed"
+            }
+          ]
         },
         {
           "name": "setFocus",
@@ -16960,7 +17000,7 @@
           "mutable": false,
           "attr": "auto-close",
           "reflectToAttr": true,
-          "docs": "When true and clicking outside of the component, automatically closes open `calcite-popover`s.",
+          "docs": "When `true`, clicking outside of the component automatically closes open `calcite-popover`s.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -17330,10 +17370,15 @@
             "type": "Promise<void>",
             "docs": ""
           },
-          "signature": "reposition() => Promise<void>",
+          "signature": "reposition(delayed?: boolean) => Promise<void>",
           "parameters": [],
           "docs": "Updates the position of the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "delayed"
+            }
+          ]
         },
         {
           "name": "setFocus",
@@ -23032,7 +23077,7 @@
           "mutable": false,
           "attr": "selected",
           "reflectToAttr": true,
-          "docs": "When true and if it has a parent `calcite-tip-manager`, the component is selected.\n\nOnly one tip can be selected within the `calcite-tip-manager` parent.",
+          "docs": "When `true`, the component is selected if it has a parent `calcite-tip-manager`.\n\nOnly one tip can be selected within the `calcite-tip-manager` parent.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -23555,10 +23600,15 @@
             "type": "Promise<void>",
             "docs": ""
           },
-          "signature": "reposition() => Promise<void>",
+          "signature": "reposition(delayed?: boolean) => Promise<void>",
           "parameters": [],
           "docs": "Updates the position of the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "delayed"
+            }
+          ]
         }
       ],
       "events": [],