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

package/dist/types/components.d.ts

@@ -65,11 +65,6 @@ export namespace Components {
         "selectionMode": AccordionSelectionMode;
     }
     interface CalciteAccordionItem {
-        /**
-          * When `true`, the component is active.
-          * @deprecated use `expanded` instead.
-         */
-        "active": boolean;
         /**
           * Specifies a description for the component.
          */
@@ -82,11 +77,6 @@ export namespace Components {
           * Specifies heading text for the component.
          */
         "heading"?: string;
-        /**
-          * Specifies an icon to display.
-          * @deprecated use `iconStart` or `iconEnd` instead.
-         */
-        "icon"?: string;
         /**
           * Specifies an icon to display at the end of the component.
          */
@@ -95,16 +85,6 @@ export namespace Components {
           * Specifies an icon to display at the start of the component.
          */
         "iconStart"?: string;
-        /**
-          * Specifies a subtitle for the component.
-          * @deprecated Use `description` instead.
-         */
-        "itemSubtitle"?: string;
-        /**
-          * Specifies a title for the component.
-          * @deprecated Use `heading` instead.
-         */
-        "itemTitle"?: string;
     }
     interface CalciteAction {
         /**
@@ -1023,102 +1003,102 @@ export namespace Components {
     }
     interface CalciteDatePicker {
         /**
-          * Active date
+          * Specifies the component's active date.
          */
         "activeDate": Date;
         /**
-          * Active range
+          * When `range` is true, specifies the active `range`. Where `"start"` specifies the starting range date and `"end"` the ending range date.
          */
-        "activeRange"?: "start" | "end";
+        "activeRange": "start" | "end";
         /**
-          * Selected end date
-          * @deprecated use value instead
+          * Specifies the selected end date.
+          * @deprecated use `value` instead.
          */
-        "end"?: string;
+        "end": string;
         /**
-          * Selected end date as full date object
-          * @deprecated use valueAsDate instead
+          * Specifies the selected end date as a full date object.
+          * @deprecated use `valueAsDate` instead.
          */
-        "endAsDate"?: Date;
+        "endAsDate": Date;
         /**
-          * Number at which section headings should start for this component.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel": HeadingLevel;
         /**
-          * Localized string for "next month" (used for aria label)
+          * Accessible name for the component's next month button.
           * @default "Next month"
          */
-        "intlNextMonth"?: string;
+        "intlNextMonth": string;
         /**
-          * Localized string for "previous month" (used for aria label)
+          * Accessible name for the component's previous month button.
           * @default "Previous month"
          */
-        "intlPrevMonth"?: string;
+        "intlPrevMonth": string;
         /**
-          * Localized string for "year" (used for aria label)
+          * Accessible name for the component's year input.
           * @default "Year"
          */
-        "intlYear"?: string;
+        "intlYear": string;
         /**
           * Specifies the BCP 47 language tag for the desired language and country format.
           * @deprecated set the global `lang` attribute on the element instead.
           * @mdn [lang](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang)
          */
-        "locale"?: string;
+        "locale": string;
         /**
-          * Latest allowed date ("yyyy-mm-dd")
+          * Specifies the latest allowed date (`"yyyy-mm-dd"`).
          */
-        "max"?: string;
+        "max": string;
         /**
-          * Latest allowed date as full date object
+          * Specifies the latest allowed date as a full date object (`new Date("yyyy-mm-dd")`).
          */
-        "maxAsDate"?: Date;
+        "maxAsDate": Date;
         /**
-          * Earliest allowed date ("yyyy-mm-dd")
+          * Specifies the earliest allowed date (`"yyyy-mm-dd"`).
          */
-        "min"?: string;
+        "min": string;
         /**
-          * Earliest allowed date as full date object
+          * Specifies the earliest allowed date as a full date object (`new Date("yyyy-mm-dd")`).
          */
-        "minAsDate"?: Date;
+        "minAsDate": Date;
         /**
           * Specifies the Unicode numeral system used by the component for localization. This property cannot be dynamically changed.
          */
-        "numberingSystem"?: NumberingSystem;
+        "numberingSystem": NumberingSystem;
         /**
-          * Disables the default behaviour on the third click of narrowing or extending the range and instead starts a new range.
+          * When `true`, disables the default behavior on the third click of narrowing or extending the range and instead starts a new range.
          */
         "proximitySelectionDisabled": boolean;
         /**
-          * Range mode activation
+          * When `true`, activates the component's range mode to allow a start and end date.
          */
         "range": boolean;
         /**
-          * specify the scale of the date picker
+          * Specifies the size of the component.
          */
         "scale": "s" | "m" | "l";
         /**
-          * Selected start date
-          * @deprecated use value instead
+          * Specifies the selected start date.
+          * @deprecated use `value` instead.
          */
-        "start"?: string;
+        "start": string;
         /**
-          * Selected start date as full date object
-          * @deprecated use valueAsDate instead
+          * Specifies the selected start date as a full date object.
+          * @deprecated use `valueAsDate` instead.
          */
-        "startAsDate"?: Date;
+        "startAsDate": Date;
         /**
-          * Selected date
+          * Specifies the selected date as a string (`"yyyy-mm-dd"`), or an array of strings for `range` values (`["yyyy-mm-dd", "yyyy-mm-dd"]`).
          */
-        "value"?: string | string[];
+        "value": string | string[];
         /**
-          * Selected date as full date object
+          * Specifies the selected date as a full date object (`new Date("yyyy-mm-dd")`), or an array containing full date objects (`[new Date("yyyy-mm-dd"), new Date("yyyy-mm-dd")]`).
          */
-        "valueAsDate"?: Date | Date[];
+        "valueAsDate": Date | Date[];
     }
     interface CalciteDatePickerDay {
         /**
-          * Date is actively in focus for keyboard navigation
+          * When `true`, the component is active.
          */
         "active": boolean;
         /**
@@ -1130,7 +1110,7 @@ export namespace Components {
          */
         "day": number;
         /**
-          * Date is outside of range and can't be selected
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
@@ -1142,7 +1122,7 @@ export namespace Components {
          */
         "highlighted": boolean;
         /**
-          * Showing date range
+          * When `true`, activates the component's range mode to allow a start and end date.
          */
         "range": boolean;
         /**
@@ -1150,11 +1130,11 @@ export namespace Components {
          */
         "rangeHover": boolean;
         /**
-          * specify the scale of the date picker
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
-          * Date is the current selected date of the picker
+          * When `true`, the component is selected.
          */
         "selected": boolean;
         /**
@@ -1162,7 +1142,7 @@ export namespace Components {
          */
         "startOfRange": boolean;
         /**
-          * Date value for the day.
+          * The component's value.
          */
         "value": Date;
     }
@@ -1184,15 +1164,15 @@ export namespace Components {
          */
         "localeData": DateLocaleData;
         /**
-          * Maximum date of the calendar above which is disabled.
+          * Specifies the latest allowed date (`"yyyy-mm-dd"`).
          */
         "max": Date;
         /**
-          * Minimum date of the calendar below which is disabled.
+          * Specifies the earliest allowed date (`"yyyy-mm-dd"`).
          */
         "min": Date;
         /**
-          * specify the scale of the date picker
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
@@ -1210,19 +1190,19 @@ export namespace Components {
          */
         "activeDate": Date;
         /**
-          * Number at which section headings should start for this component.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel": HeadingLevel;
         /**
-          * Localized string for next month.
+          * Accessible name for the component's next month button.
          */
         "intlNextMonth": string;
         /**
-          * Localized string for previous month.
+          * Accessible name for the component's previous month button.
          */
         "intlPrevMonth": string;
         /**
-          * Localized string for year.
+          * Accessible name for the component's year input.
          */
         "intlYear": string;
         /**
@@ -1230,15 +1210,15 @@ export namespace Components {
          */
         "localeData": DateLocaleData;
         /**
-          * Maximum date of the calendar above which is disabled.
+          * Specifies the latest allowed date (`"yyyy-mm-dd"`).
          */
         "max": Date;
         /**
-          * Minimum date of the calendar below which is disabled.
+          * Specifies the earliest allowed date (`"yyyy-mm-dd"`).
          */
         "min": Date;
         /**
-          * specify the scale of the date picker
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
@@ -1248,28 +1228,28 @@ export namespace Components {
     }
     interface CalciteDropdown {
         /**
-          * Opens or closes the dropdown
-          * @deprecated use open instead.
+          * When `true`, displays and positions the component.
+          * @deprecated use `open` instead.
          */
         "active": boolean;
         /**
-          * allow the dropdown to remain open after a selection is made if the selection-mode of the selected item's containing group is "none", the dropdown will always close
+          * When `true`, the component will remain open after a selection is made.  If the `selectionMode` of the selected `calcite-dropdown-item`'s containing `calcite-dropdown-group` is `"none"`, the component will always close.
          */
         "disableCloseOnSelect": boolean;
         /**
-          * is the dropdown disabled
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
           * Defines the available placements that can be used when a flip occurs.
          */
-        "flipPlacements"?: EffectivePlacement[];
+        "flipPlacements": EffectivePlacement[];
         /**
-          * specify the maximum number of calcite-dropdown-items to display before showing the scroller, must be greater than 0 - this value does not include groupTitles passed to calcite-dropdown-group
+          * Specifies the maximum number of `calcite-dropdown-item`s to display before showing a scroller. Value must be greater than `0`, and does not include `groupTitle`'s from `calcite-dropdown-group`.
          */
         "maxItems": number;
         /**
-          * When true, opens the dropdown
+          * When `true`, displays and positions the component.
          */
         "open": boolean;
         /**
@@ -1277,7 +1257,7 @@ export namespace Components {
          */
         "overlayPositioning": OverlayPositioning;
         /**
-          * Determines where the dropdown will be positioned relative to the button.
+          * Determines where the component will be positioned relative to the container element.
           * @default "bottom-start"
          */
         "placement": MenuPlacement;
@@ -1287,69 +1267,69 @@ export namespace Components {
          */
         "reposition": (delayed?: boolean) => Promise<void>;
         /**
-          * specify the scale of dropdown, defaults to m
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
-          * **read-only** The currently selected items
+          * Specifies the component's selected items.
           * @readonly
          */
         "selectedItems": HTMLCalciteDropdownItemElement[];
         /**
-          * specify whether the dropdown is opened by hover or click of a trigger element
+          * Specifies the action to open the component from the container element.
          */
         "type": "hover" | "click";
         /**
-          * specify the width of dropdown
+          * Specifies the width of the component.
          */
-        "width"?: Scale;
+        "width": Scale;
     }
     interface CalciteDropdownGroup {
         /**
-          * optionally set a group title for display
+          * Specifies and displays a group title.
          */
-        "groupTitle"?: string;
+        "groupTitle": string;
         /**
-          * Specifies the size of the action.
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
-          * specify the selection mode - multiple (allow any number of (or no) active items), single (allow and require one active item), none (no active items), defaults to single
+          * Specifies the component's selection mode, where `"multi"` allows any number of (or no) selected `calcite-dropdown-item`s, `"single"` allows and requires one selected `calcite-dropdown-item`, and `"none"` does not allow selection on `calcite-dropdown-item`s.
          */
         "selectionMode": SelectionMode;
     }
     interface CalciteDropdownItem {
         /**
-          * Indicates whether the item is active.
-          * @deprecated Use selected instead.
+          * When `true`, the component is selected.
+          * @deprecated Use `selected` instead.
          */
         "active": boolean;
         /**
-          * optionally pass a href - used to determine if the component should render as anchor
+          * Specifies the URL of the linked resource, which can be set as an absolute or relative path.  Determines if the component will render as an anchor.
          */
-        "href"?: string;
+        "href": string;
         /**
           * Specifies an icon to display at the end of the component.
          */
-        "iconEnd"?: string;
+        "iconEnd": string;
         /**
-          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
+          * When `true`, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
-        "iconFlipRtl"?: FlipContext;
+        "iconFlipRtl": FlipContext;
         /**
           * Specifies an icon to display at the start of the component.
          */
-        "iconStart"?: string;
+        "iconStart": string;
         /**
-          * Applies to the aria-label attribute on the button or hyperlink
+          * Accessible name for the component.
          */
-        "label"?: string;
+        "label": string;
         /**
-          * The rel attribute to apply to the hyperlink
+          * Specifies the relationship to the linked document defined in `href`.
          */
-        "rel"?: string;
+        "rel": string;
         /**
-          * When true, item is selected
+          * When `true`, the component is selected.
          */
         "selected": boolean;
         /**
@@ -1357,38 +1337,38 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * The target attribute to apply to the hyperlink
+          * Specifies the frame or window to open the linked document.
          */
-        "target"?: string;
+        "target": string;
     }
     interface CalciteFab {
         /**
-          * Used to set the button's appearance. Default is outline.
+          * Specifies the appearance style of the component.
          */
         "appearance": Extract<"solid" | "outline", Appearance>;
         /**
-          * Used to set the button's color. Default is light.
+          * Specifies the color of the component.
          */
         "color": ButtonColor;
         /**
-          * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
           * Specifies an icon to display.
           * @default "plus"
          */
-        "icon"?: string;
+        "icon": string;
         /**
-          * Label of the FAB, exposed on hover when textEnabled is false. If no label is provided, the label inherits what's provided for the `text` prop.
+          * Accessible name for the component.
          */
-        "label"?: string;
+        "label": string;
         /**
-          * When true, content is waiting to be loaded. This state shows a busy indicator.
+          * When `true`, a busy indicator is displayed.
          */
         "loading": boolean;
         /**
-          * Specifies the size of the fab.
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
@@ -1396,42 +1376,42 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * Text that accompanies the FAB icon.
+          * Specifies text to accompany the component's icon.
          */
-        "text"?: string;
+        "text": string;
         /**
-          * Indicates whether the text is displayed.
+          * When `true`, displays the `text` value in the component.
          */
         "textEnabled": boolean;
     }
     interface CalciteFilter {
         /**
-          * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * The resulting items after filtering.
+          * The component's resulting items after filtering.
           * @readonly
          */
         "filteredItems": object[];
         /**
-          * A text label that will appear on the clear button.
+          * Accessible name for the component's clear button.
          */
-        "intlClear"?: string;
+        "intlClear": string;
         /**
-          * A text label that will appear next to the input field.
+          * Accessible name for the component.
          */
-        "intlLabel"?: string;
+        "intlLabel": string;
         /**
-          * The items to filter through. The filter uses this as the starting point, and returns items that contain the string entered in the input, using a partial match and recursive search.  This property is required.
+          * Defines the items to filter. The component uses the values as the starting point, and returns items  that contain the string entered in the input, using a partial match and recursive search.  This property is needed to conduct filtering.
          */
         "items": object[];
         /**
-          * Placeholder text for the input element's placeholder attribute
+          * Specifies placeholder text for the input element.
          */
-        "placeholder"?: string;
+        "placeholder": string;
         /**
-          * specify the scale of filter, defaults to m
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
@@ -1439,7 +1419,7 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * Filter value.
+          * The component's value.
          */
         "value": string;
     }
@@ -1451,15 +1431,15 @@ export namespace Components {
     }
     interface CalciteFlowItem {
         /**
-          * When provided, this method will be called before it is removed from the parent flow.
+          * When provided, the method will be called before it is removed from its parent `calcite-flow`.
          */
-        "beforeBack"?: () => Promise<void>;
+        "beforeBack": () => Promise<void>;
         /**
-          * When true, displays a close button in the trailing side of the header
+          * When `true`, displays a close button in the trailing side of the component's header.
          */
         "closable": boolean;
         /**
-          * When true, flow-item will be hidden
+          * When `true`, the component will be hidden.
          */
         "closed": boolean;
         /**
@@ -1467,13 +1447,13 @@ export namespace Components {
          */
         "description": string;
         /**
-          * When true, interaction is prevented and the component is displayed with lower opacity.
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
           * The component header text.
          */
-        "heading"?: string;
+        "heading": string;
         /**
           * Specifies the number at which section headings should start.
          */
@@ -1481,25 +1461,25 @@ export namespace Components {
         /**
           * Specifies the maximum height of the component.
          */
-        "heightScale"?: Scale;
+        "heightScale": Scale;
         /**
-          * Accessible name for the component's back button. The back button will only be shown when 'showBackButton' is true.
+          * When `showBackButton` is `true`, the accessible name for the component's back button.
          */
-        "intlBack"?: string;
+        "intlBack": string;
         /**
-          * Accessible name for the component's close button. The close button will only be shown when 'closable' is true.
+          * When `closable` is `true`, the accessible name for the component's close button.
          */
-        "intlClose"?: string;
+        "intlClose": string;
         /**
           * Accessible name for the component's actions menu.
          */
-        "intlOptions"?: string;
+        "intlOptions": string;
         /**
-          * When true, a busy indicator is displayed.
+          * When `true`, a busy indicator is displayed.
          */
         "loading": boolean;
         /**
-          * When true, the action menu items in the `header-menu-actions` slot are open.
+          * When `true`, the action menu items in the `header-menu-actions` slot are open.
          */
         "menuOpen": boolean;
         /**
@@ -1513,13 +1493,13 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * When true, displays a back button in the header.
+          * When `true`, displays a back button in the component's header.
          */
         "showBackButton": boolean;
         /**
           * Specifies the width of the component.
          */
-        "widthScale"?: Scale;
+        "widthScale": Scale;
     }
     interface CalciteGraph {
         /**
@@ -1560,62 +1540,63 @@ export namespace Components {
     }
     interface CalciteIcon {
         /**
-          * When true, the icon will be flipped when the element direction is 'rtl'.
+          * When `true`, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "flipRtl": boolean;
         /**
-          * The name of the icon to display. The value of this property must match the icon name from https://esri.github.io/calcite-ui-icons/.
+          * Displays a specific icon.
+          * @see [Icons](https://esri.github.io/calcite-ui-icons)
          */
         "icon": string;
         /**
-          * Icon scale.
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
-          * The icon label.  It is recommended to set this value if your icon is semantic.
+          * Accessible name for the component.  It is recommended to set this value if your icon is semantic.
          */
         "textLabel": string;
     }
     interface CalciteInlineEditable {
         /**
-          * when controls, specify a callback to be executed prior to disabling editing. when provided, loading state will be handled automatically.
+          * Specifies a callback to be executed prior to disabling editing via the controls. When provided, the component's loading state will be handled automatically.
          */
-        "afterConfirm"?: () => Promise<void>;
+        "afterConfirm": () => Promise<void>;
         /**
-          * specify whether save/cancel controls should be displayed when editingEnabled is true, defaults to false
+          * When `true` and `editingEnabled` is `true`, displays save and cancel controls on the component.
          */
         "controls": boolean;
         /**
-          * specify whether editing can be enabled
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * specify whether the wrapped input element is editable, defaults to false
+          * When `true`, inline editing is enabled on the component.
          */
         "editingEnabled": boolean;
         /**
-          * specify text to be user for the cancel editing button's aria-label, defaults to `Cancel`
+          * Accessible name for the component's cancel editing button.
           * @default "Cancel"
          */
         "intlCancelEditing": string;
         /**
-          * specify text to be user for the confirm changes button's aria-label, defaults to `Save`
+          * Accessible name for the component's confirm edits button.
           * @default "Save"
          */
         "intlConfirmChanges": string;
         /**
-          * specify text to be user for the enable editing button's aria-label, defaults to `Click to edit`
+          * Accessible name for the component's enable editing button.
           * @default "Click to edit"
          */
         "intlEnableEditing": string;
         /**
-          * specify whether the confirm button should display a loading state, defaults to false
+          * When `true`, a busy indicator is displayed.
          */
         "loading": boolean;
         /**
-          * specify the scale of the inline-editable component, defaults to the scale of the wrapped calcite-input or the scale of the closest wrapping component with a set scale
+          * Specifies the size of the component. Defaults to the scale of the wrapped `calcite-input` or the scale of the closest wrapping component with a set scale.
          */
-        "scale"?: Scale;
+        "scale": Scale;
         "setFocus": () => Promise<void>;
     }
     interface CalciteInput {
@@ -3048,17 +3029,6 @@ export namespace Components {
          */
         "triggerDisabled": boolean;
     }
-    interface CalcitePopoverManager {
-        /**
-          * Automatically closes any currently open popovers when clicking outside of a popover.
-         */
-        "autoClose": boolean;
-        /**
-          * CSS Selector to match reference elements for popovers. Reference elements will be identified by this selector in order to open their associated popover.
-          * @default `[data-calcite-popover-reference]`
-         */
-        "selector": string;
-    }
     interface CalciteProgress {
         /**
           * Accessible name for the component.
@@ -4899,12 +4869,6 @@ declare global {
         prototype: HTMLCalcitePopoverElement;
         new (): HTMLCalcitePopoverElement;
     };
-    interface HTMLCalcitePopoverManagerElement extends Components.CalcitePopoverManager, HTMLStencilElement {
-    }
-    var HTMLCalcitePopoverManagerElement: {
-        prototype: HTMLCalcitePopoverManagerElement;
-        new (): HTMLCalcitePopoverManagerElement;
-    };
     interface HTMLCalciteProgressElement extends Components.CalciteProgress, HTMLStencilElement {
     }
     var HTMLCalciteProgressElement: {
@@ -5162,7 +5126,6 @@ declare global {
         "calcite-pick-list-group": HTMLCalcitePickListGroupElement;
         "calcite-pick-list-item": HTMLCalcitePickListItemElement;
         "calcite-popover": HTMLCalcitePopoverElement;
-        "calcite-popover-manager": HTMLCalcitePopoverManagerElement;
         "calcite-progress": HTMLCalciteProgressElement;
         "calcite-radio-button": HTMLCalciteRadioButtonElement;
         "calcite-radio-button-group": HTMLCalciteRadioButtonGroupElement;
@@ -5222,11 +5185,6 @@ declare namespace LocalJSX {
         "selectionMode"?: AccordionSelectionMode;
     }
     interface CalciteAccordionItem {
-        /**
-          * When `true`, the component is active.
-          * @deprecated use `expanded` instead.
-         */
-        "active"?: boolean;
         /**
           * Specifies a description for the component.
          */
@@ -5239,11 +5197,6 @@ declare namespace LocalJSX {
           * Specifies heading text for the component.
          */
         "heading"?: string;
-        /**
-          * Specifies an icon to display.
-          * @deprecated use `iconStart` or `iconEnd` instead.
-         */
-        "icon"?: string;
         /**
           * Specifies an icon to display at the end of the component.
          */
@@ -5252,16 +5205,6 @@ declare namespace LocalJSX {
           * Specifies an icon to display at the start of the component.
          */
         "iconStart"?: string;
-        /**
-          * Specifies a subtitle for the component.
-          * @deprecated Use `description` instead.
-         */
-        "itemSubtitle"?: string;
-        /**
-          * Specifies a title for the component.
-          * @deprecated Use `heading` instead.
-         */
-        "itemTitle"?: string;
     }
     interface CalciteAction {
         /**
@@ -6202,39 +6145,39 @@ declare namespace LocalJSX {
     }
     interface CalciteDatePicker {
         /**
-          * Active date
+          * Specifies the component's active date.
          */
         "activeDate"?: Date;
         /**
-          * Active range
+          * When `range` is true, specifies the active `range`. Where `"start"` specifies the starting range date and `"end"` the ending range date.
          */
         "activeRange"?: "start" | "end";
         /**
-          * Selected end date
-          * @deprecated use value instead
+          * Specifies the selected end date.
+          * @deprecated use `value` instead.
          */
         "end"?: string;
         /**
-          * Selected end date as full date object
-          * @deprecated use valueAsDate instead
+          * Specifies the selected end date as a full date object.
+          * @deprecated use `valueAsDate` instead.
          */
         "endAsDate"?: Date;
         /**
-          * Number at which section headings should start for this component.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel"?: HeadingLevel;
         /**
-          * Localized string for "next month" (used for aria label)
+          * Accessible name for the component's next month button.
           * @default "Next month"
          */
         "intlNextMonth"?: string;
         /**
-          * Localized string for "previous month" (used for aria label)
+          * Accessible name for the component's previous month button.
           * @default "Previous month"
          */
         "intlPrevMonth"?: string;
         /**
-          * Localized string for "year" (used for aria label)
+          * Accessible name for the component's year input.
           * @default "Year"
          */
         "intlYear"?: string;
@@ -6245,19 +6188,19 @@ declare namespace LocalJSX {
          */
         "locale"?: string;
         /**
-          * Latest allowed date ("yyyy-mm-dd")
+          * Specifies the latest allowed date (`"yyyy-mm-dd"`).
          */
         "max"?: string;
         /**
-          * Latest allowed date as full date object
+          * Specifies the latest allowed date as a full date object (`new Date("yyyy-mm-dd")`).
          */
         "maxAsDate"?: Date;
         /**
-          * Earliest allowed date ("yyyy-mm-dd")
+          * Specifies the earliest allowed date (`"yyyy-mm-dd"`).
          */
         "min"?: string;
         /**
-          * Earliest allowed date as full date object
+          * Specifies the earliest allowed date as a full date object (`new Date("yyyy-mm-dd")`).
          */
         "minAsDate"?: Date;
         /**
@@ -6265,48 +6208,48 @@ declare namespace LocalJSX {
          */
         "numberingSystem"?: NumberingSystem;
         /**
-          * Trigger calcite date change when a user changes the date.
+          * Emits when a user changes the component's date. For `range` events, use `calciteDatePickerRangeChange`.
          */
         "onCalciteDatePickerChange"?: (event: CalciteDatePickerCustomEvent<Date>) => void;
         /**
-          * Trigger calcite date change when a user changes the date range.
+          * Emits when a user changes the component's date `range`. For components without `range` use `calciteDatePickerChange`.
           * @see [DateRangeChange](https://github.com/Esri/calcite-components/blob/master/src/components/date-picker/interfaces.ts#L1)
          */
         "onCalciteDatePickerRangeChange"?: (event: CalciteDatePickerCustomEvent<DateRangeChange>) => void;
         /**
-          * Disables the default behaviour on the third click of narrowing or extending the range and instead starts a new range.
+          * When `true`, disables the default behavior on the third click of narrowing or extending the range and instead starts a new range.
          */
         "proximitySelectionDisabled"?: boolean;
         /**
-          * Range mode activation
+          * When `true`, activates the component's range mode to allow a start and end date.
          */
         "range"?: boolean;
         /**
-          * specify the scale of the date picker
+          * Specifies the size of the component.
          */
         "scale"?: "s" | "m" | "l";
         /**
-          * Selected start date
-          * @deprecated use value instead
+          * Specifies the selected start date.
+          * @deprecated use `value` instead.
          */
         "start"?: string;
         /**
-          * Selected start date as full date object
-          * @deprecated use valueAsDate instead
+          * Specifies the selected start date as a full date object.
+          * @deprecated use `valueAsDate` instead.
          */
         "startAsDate"?: Date;
         /**
-          * Selected date
+          * Specifies the selected date as a string (`"yyyy-mm-dd"`), or an array of strings for `range` values (`["yyyy-mm-dd", "yyyy-mm-dd"]`).
          */
         "value"?: string | string[];
         /**
-          * Selected date as full date object
+          * Specifies the selected date as a full date object (`new Date("yyyy-mm-dd")`), or an array containing full date objects (`[new Date("yyyy-mm-dd"), new Date("yyyy-mm-dd")]`).
          */
         "valueAsDate"?: Date | Date[];
     }
     interface CalciteDatePickerDay {
         /**
-          * Date is actively in focus for keyboard navigation
+          * When `true`, the component is active.
          */
         "active"?: boolean;
         /**
@@ -6318,7 +6261,7 @@ declare namespace LocalJSX {
          */
         "day": number;
         /**
-          * Date is outside of range and can't be selected
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
@@ -6334,7 +6277,7 @@ declare namespace LocalJSX {
          */
         "onCalciteDaySelect"?: (event: CalciteDatePickerDayCustomEvent<void>) => void;
         /**
-          * Showing date range
+          * When `true`, activates the component's range mode to allow a start and end date.
          */
         "range"?: boolean;
         /**
@@ -6342,11 +6285,11 @@ declare namespace LocalJSX {
          */
         "rangeHover"?: boolean;
         /**
-          * specify the scale of the date picker
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * Date is the current selected date of the picker
+          * When `true`, the component is selected.
          */
         "selected"?: boolean;
         /**
@@ -6354,7 +6297,7 @@ declare namespace LocalJSX {
          */
         "startOfRange"?: boolean;
         /**
-          * Date value for the day.
+          * The component's value.
          */
         "value"?: Date;
     }
@@ -6372,11 +6315,11 @@ declare namespace LocalJSX {
          */
         "hoverRange"?: HoverRange;
         /**
-          * Maximum date of the calendar above which is disabled.
+          * Specifies the latest allowed date (`"yyyy-mm-dd"`).
          */
         "max"?: Date;
         /**
-          * Minimum date of the calendar below which is disabled.
+          * Specifies the earliest allowed date (`"yyyy-mm-dd"`).
          */
         "min"?: Date;
         /**
@@ -6388,7 +6331,7 @@ declare namespace LocalJSX {
          */
         "onCalciteDatePickerSelect"?: (event: CalciteDatePickerMonthCustomEvent<Date>) => void;
         /**
-          * specify the scale of the date picker
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
@@ -6406,19 +6349,19 @@ declare namespace LocalJSX {
          */
         "activeDate"?: Date;
         /**
-          * Number at which section headings should start for this component.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel"?: HeadingLevel;
         /**
-          * Localized string for next month.
+          * Accessible name for the component's next month button.
          */
         "intlNextMonth"?: string;
         /**
-          * Localized string for previous month.
+          * Accessible name for the component's previous month button.
          */
         "intlPrevMonth"?: string;
         /**
-          * Localized string for year.
+          * Accessible name for the component's year input.
          */
         "intlYear"?: string;
         /**
@@ -6426,11 +6369,11 @@ declare namespace LocalJSX {
          */
         "localeData"?: DateLocaleData;
         /**
-          * Maximum date of the calendar above which is disabled.
+          * Specifies the latest allowed date (`"yyyy-mm-dd"`).
          */
         "max"?: Date;
         /**
-          * Minimum date of the calendar below which is disabled.
+          * Specifies the earliest allowed date (`"yyyy-mm-dd"`).
          */
         "min"?: Date;
         /**
@@ -6438,7 +6381,7 @@ declare namespace LocalJSX {
          */
         "onCalciteDatePickerSelect"?: (event: CalciteDatePickerMonthHeaderCustomEvent<Date>) => void;
         /**
-          * specify the scale of the date picker
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
@@ -6448,16 +6391,16 @@ declare namespace LocalJSX {
     }
     interface CalciteDropdown {
         /**
-          * Opens or closes the dropdown
-          * @deprecated use open instead.
+          * When `true`, displays and positions the component.
+          * @deprecated use `open` instead.
          */
         "active"?: boolean;
         /**
-          * allow the dropdown to remain open after a selection is made if the selection-mode of the selected item's containing group is "none", the dropdown will always close
+          * When `true`, the component will remain open after a selection is made.  If the `selectionMode` of the selected `calcite-dropdown-item`'s containing `calcite-dropdown-group` is `"none"`, the component will always close.
          */
         "disableCloseOnSelect"?: boolean;
         /**
-          * is the dropdown disabled
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
@@ -6465,7 +6408,7 @@ declare namespace LocalJSX {
          */
         "flipPlacements"?: EffectivePlacement[];
         /**
-          * specify the maximum number of calcite-dropdown-items to display before showing the scroller, must be greater than 0 - this value does not include groupTitles passed to calcite-dropdown-group
+          * Specifies the maximum number of `calcite-dropdown-item`s to display before showing a scroller. Value must be greater than `0`, and does not include `groupTitle`'s from `calcite-dropdown-group`.
          */
         "maxItems"?: number;
         /**
@@ -6485,11 +6428,11 @@ declare namespace LocalJSX {
          */
         "onCalciteDropdownOpen"?: (event: CalciteDropdownCustomEvent<void>) => void;
         /**
-          * fires when a dropdown item has been selected or deselected
+          * Fires when a `calcite-dropdown-item`'s selection changes.
          */
         "onCalciteDropdownSelect"?: (event: CalciteDropdownCustomEvent<Selection>) => void;
         /**
-          * When true, opens the dropdown
+          * When `true`, displays and positions the component.
          */
         "open"?: boolean;
         /**
@@ -6497,50 +6440,50 @@ declare namespace LocalJSX {
          */
         "overlayPositioning"?: OverlayPositioning;
         /**
-          * Determines where the dropdown will be positioned relative to the button.
+          * Determines where the component will be positioned relative to the container element.
           * @default "bottom-start"
          */
         "placement"?: MenuPlacement;
         /**
-          * specify the scale of dropdown, defaults to m
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * **read-only** The currently selected items
+          * Specifies the component's selected items.
           * @readonly
          */
         "selectedItems"?: HTMLCalciteDropdownItemElement[];
         /**
-          * specify whether the dropdown is opened by hover or click of a trigger element
+          * Specifies the action to open the component from the container element.
          */
         "type"?: "hover" | "click";
         /**
-          * specify the width of dropdown
+          * Specifies the width of the component.
          */
         "width"?: Scale;
     }
     interface CalciteDropdownGroup {
         /**
-          * optionally set a group title for display
+          * Specifies and displays a group title.
          */
         "groupTitle"?: string;
         /**
-          * Specifies the size of the action.
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * specify the selection mode - multiple (allow any number of (or no) active items), single (allow and require one active item), none (no active items), defaults to single
+          * Specifies the component's selection mode, where `"multi"` allows any number of (or no) selected `calcite-dropdown-item`s, `"single"` allows and requires one selected `calcite-dropdown-item`, and `"none"` does not allow selection on `calcite-dropdown-item`s.
          */
         "selectionMode"?: SelectionMode;
     }
     interface CalciteDropdownItem {
         /**
-          * Indicates whether the item is active.
-          * @deprecated Use selected instead.
+          * When `true`, the component is selected.
+          * @deprecated Use `selected` instead.
          */
         "active"?: boolean;
         /**
-          * optionally pass a href - used to determine if the component should render as anchor
+          * Specifies the URL of the linked resource, which can be set as an absolute or relative path.  Determines if the component will render as an anchor.
          */
         "href"?: string;
         /**
@@ -6548,7 +6491,7 @@ declare namespace LocalJSX {
          */
         "iconEnd"?: string;
         /**
-          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
+          * When `true`, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl"?: FlipContext;
         /**
@@ -6556,33 +6499,33 @@ declare namespace LocalJSX {
          */
         "iconStart"?: string;
         /**
-          * Applies to the aria-label attribute on the button or hyperlink
+          * Accessible name for the component.
          */
         "label"?: string;
         /**
-          * The rel attribute to apply to the hyperlink
+          * Specifies the relationship to the linked document defined in `href`.
          */
         "rel"?: string;
         /**
-          * When true, item is selected
+          * When `true`, the component is selected.
          */
         "selected"?: boolean;
         /**
-          * The target attribute to apply to the hyperlink
+          * Specifies the frame or window to open the linked document.
          */
         "target"?: string;
     }
     interface CalciteFab {
         /**
-          * Used to set the button's appearance. Default is outline.
+          * Specifies the appearance style of the component.
          */
         "appearance"?: Extract<"solid" | "outline", Appearance>;
         /**
-          * Used to set the button's color. Default is light.
+          * Specifies the color of the component.
          */
         "color"?: ButtonColor;
         /**
-          * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
@@ -6591,62 +6534,62 @@ declare namespace LocalJSX {
          */
         "icon"?: string;
         /**
-          * Label of the FAB, exposed on hover when textEnabled is false. If no label is provided, the label inherits what's provided for the `text` prop.
+          * Accessible name for the component.
          */
         "label"?: string;
         /**
-          * When true, content is waiting to be loaded. This state shows a busy indicator.
+          * When `true`, a busy indicator is displayed.
          */
         "loading"?: boolean;
         /**
-          * Specifies the size of the fab.
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * Text that accompanies the FAB icon.
+          * Specifies text to accompany the component's icon.
          */
         "text"?: string;
         /**
-          * Indicates whether the text is displayed.
+          * When `true`, displays the `text` value in the component.
          */
         "textEnabled"?: boolean;
     }
     interface CalciteFilter {
         /**
-          * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * The resulting items after filtering.
+          * The component's resulting items after filtering.
           * @readonly
          */
         "filteredItems"?: object[];
         /**
-          * A text label that will appear on the clear button.
+          * Accessible name for the component's clear button.
          */
         "intlClear"?: string;
         /**
-          * A text label that will appear next to the input field.
+          * Accessible name for the component.
          */
         "intlLabel"?: string;
         /**
-          * The items to filter through. The filter uses this as the starting point, and returns items that contain the string entered in the input, using a partial match and recursive search.  This property is required.
+          * Defines the items to filter. The component uses the values as the starting point, and returns items  that contain the string entered in the input, using a partial match and recursive search.  This property is needed to conduct filtering.
          */
         "items"?: object[];
         /**
-          * This event fires when the filter text changes.
+          * Fires when the component's text changes.
          */
         "onCalciteFilterChange"?: (event: CalciteFilterCustomEvent<void>) => void;
         /**
-          * Placeholder text for the input element's placeholder attribute
+          * Specifies placeholder text for the input element.
          */
         "placeholder"?: string;
         /**
-          * specify the scale of filter, defaults to m
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * Filter value.
+          * The component's value.
          */
         "value"?: string;
     }
@@ -6654,15 +6597,15 @@ declare namespace LocalJSX {
     }
     interface CalciteFlowItem {
         /**
-          * When provided, this method will be called before it is removed from the parent flow.
+          * When provided, the method will be called before it is removed from its parent `calcite-flow`.
          */
         "beforeBack"?: () => Promise<void>;
         /**
-          * When true, displays a close button in the trailing side of the header
+          * When `true`, displays a close button in the trailing side of the component's header.
          */
         "closable"?: boolean;
         /**
-          * When true, flow-item will be hidden
+          * When `true`, the component will be hidden.
          */
         "closed"?: boolean;
         /**
@@ -6670,7 +6613,7 @@ declare namespace LocalJSX {
          */
         "description"?: string;
         /**
-          * When true, interaction is prevented and the component is displayed with lower opacity.
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
@@ -6686,11 +6629,11 @@ declare namespace LocalJSX {
          */
         "heightScale"?: Scale;
         /**
-          * Accessible name for the component's back button. The back button will only be shown when 'showBackButton' is true.
+          * When `showBackButton` is `true`, the accessible name for the component's back button.
          */
         "intlBack"?: string;
         /**
-          * Accessible name for the component's close button. The close button will only be shown when 'closable' is true.
+          * When `closable` is `true`, the accessible name for the component's close button.
          */
         "intlClose"?: string;
         /**
@@ -6698,11 +6641,11 @@ declare namespace LocalJSX {
          */
         "intlOptions"?: string;
         /**
-          * When true, a busy indicator is displayed.
+          * When `true`, a busy indicator is displayed.
          */
         "loading"?: boolean;
         /**
-          * When true, the action menu items in the `header-menu-actions` slot are open.
+          * When `true`, the action menu items in the `header-menu-actions` slot are open.
          */
         "menuOpen"?: boolean;
         /**
@@ -6718,7 +6661,7 @@ declare namespace LocalJSX {
          */
         "onCalciteFlowItemScroll"?: (event: CalciteFlowItemCustomEvent<void>) => void;
         /**
-          * When true, displays a back button in the header.
+          * When `true`, displays a back button in the component's header.
          */
         "showBackButton"?: boolean;
         /**
@@ -6764,68 +6707,69 @@ declare namespace LocalJSX {
     }
     interface CalciteIcon {
         /**
-          * When true, the icon will be flipped when the element direction is 'rtl'.
+          * When `true`, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "flipRtl"?: boolean;
         /**
-          * The name of the icon to display. The value of this property must match the icon name from https://esri.github.io/calcite-ui-icons/.
+          * Displays a specific icon.
+          * @see [Icons](https://esri.github.io/calcite-ui-icons)
          */
         "icon"?: string;
         /**
-          * Icon scale.
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * The icon label.  It is recommended to set this value if your icon is semantic.
+          * Accessible name for the component.  It is recommended to set this value if your icon is semantic.
          */
         "textLabel"?: string;
     }
     interface CalciteInlineEditable {
         /**
-          * when controls, specify a callback to be executed prior to disabling editing. when provided, loading state will be handled automatically.
+          * Specifies a callback to be executed prior to disabling editing via the controls. When provided, the component's loading state will be handled automatically.
          */
         "afterConfirm"?: () => Promise<void>;
         /**
-          * specify whether save/cancel controls should be displayed when editingEnabled is true, defaults to false
+          * When `true` and `editingEnabled` is `true`, displays save and cancel controls on the component.
          */
         "controls"?: boolean;
         /**
-          * specify whether editing can be enabled
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * specify whether the wrapped input element is editable, defaults to false
+          * When `true`, inline editing is enabled on the component.
          */
         "editingEnabled"?: boolean;
         /**
-          * specify text to be user for the cancel editing button's aria-label, defaults to `Cancel`
+          * Accessible name for the component's cancel editing button.
           * @default "Cancel"
          */
         "intlCancelEditing"?: string;
         /**
-          * specify text to be user for the confirm changes button's aria-label, defaults to `Save`
+          * Accessible name for the component's confirm edits button.
           * @default "Save"
          */
         "intlConfirmChanges"?: string;
         /**
-          * specify text to be user for the enable editing button's aria-label, defaults to `Click to edit`
+          * Accessible name for the component's enable editing button.
           * @default "Click to edit"
          */
         "intlEnableEditing"?: string;
         /**
-          * specify whether the confirm button should display a loading state, defaults to false
+          * When `true`, a busy indicator is displayed.
          */
         "loading"?: boolean;
         /**
-          * Emitted when the cancel button gets clicked.
+          * Emits when the component's "cancel editing" button is pressed.
          */
         "onCalciteInlineEditableEditCancel"?: (event: CalciteInlineEditableCustomEvent<void>) => void;
         /**
-          * Emitted when the check button gets clicked.
+          * Emits when the component's "confirm edits" button is pressed.
          */
         "onCalciteInlineEditableEditConfirm"?: (event: CalciteInlineEditableCustomEvent<void>) => void;
         /**
-          * specify the scale of the inline-editable component, defaults to the scale of the wrapped calcite-input or the scale of the closest wrapping component with a set scale
+          * Specifies the size of the component. Defaults to the scale of the wrapped `calcite-input` or the scale of the closest wrapping component with a set scale.
          */
         "scale"?: Scale;
     }
@@ -8232,17 +8176,6 @@ declare namespace LocalJSX {
          */
         "triggerDisabled"?: boolean;
     }
-    interface CalcitePopoverManager {
-        /**
-          * Automatically closes any currently open popovers when clicking outside of a popover.
-         */
-        "autoClose"?: boolean;
-        /**
-          * CSS Selector to match reference elements for popovers. Reference elements will be identified by this selector in order to open their associated popover.
-          * @default `[data-calcite-popover-reference]`
-         */
-        "selector"?: string;
-    }
     interface CalciteProgress {
         /**
           * Accessible name for the component.
@@ -9459,7 +9392,6 @@ declare namespace LocalJSX {
         "calcite-pick-list-group": CalcitePickListGroup;
         "calcite-pick-list-item": CalcitePickListItem;
         "calcite-popover": CalcitePopover;
-        "calcite-popover-manager": CalcitePopoverManager;
         "calcite-progress": CalciteProgress;
         "calcite-radio-button": CalciteRadioButton;
         "calcite-radio-button-group": CalciteRadioButtonGroup;
@@ -9557,7 +9489,6 @@ declare module "@stencil/core" {
             "calcite-pick-list-group": LocalJSX.CalcitePickListGroup & JSXBase.HTMLAttributes<HTMLCalcitePickListGroupElement>;
             "calcite-pick-list-item": LocalJSX.CalcitePickListItem & JSXBase.HTMLAttributes<HTMLCalcitePickListItemElement>;
             "calcite-popover": LocalJSX.CalcitePopover & JSXBase.HTMLAttributes<HTMLCalcitePopoverElement>;
-            "calcite-popover-manager": LocalJSX.CalcitePopoverManager & JSXBase.HTMLAttributes<HTMLCalcitePopoverManagerElement>;
             "calcite-progress": LocalJSX.CalciteProgress & JSXBase.HTMLAttributes<HTMLCalciteProgressElement>;
             "calcite-radio-button": LocalJSX.CalciteRadioButton & JSXBase.HTMLAttributes<HTMLCalciteRadioButtonElement>;
             "calcite-radio-button-group": LocalJSX.CalciteRadioButtonGroup & JSXBase.HTMLAttributes<HTMLCalciteRadioButtonGroupElement>;