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

package/dist/types/components/input-message/input-message.d.ts

@@ -7,14 +7,18 @@ export declare class InputMessage {
   el: HTMLCalciteInputMessageElement;
   /** Indicates whether the message is displayed. */
   active: boolean;
-  /** when used as a boolean set to true, show a default icon based on status. You can
-   * also pass a calcite-ui-icon name to this prop to display a custom icon */
+  /**
+   * when used as a boolean set to true, show a default icon based on status. You can
+   * also pass a calcite-ui-icon name to this prop to display a custom icon
+   */
   icon: boolean | string;
   /** specify the scale of the input, defaults to m */
   scale: Scale;
   /** specify the status of the input field, determines message and icons */
   status: Status;
-  /** specify the appearance of any slotted message - default (displayed under input), or floating (positioned absolutely under input)
+  /**
+   * specify the appearance of any slotted message - default (displayed under input), or floating (positioned absolutely under input)
+   *
    * @deprecated "floating" type is no longer supported
    */
   type: "default";

package/dist/types/components/input-time-picker/input-time-picker.d.ts

@@ -38,6 +38,7 @@ export declare class InputTimePicker implements LabelableComponent, FormComponen
   intlSecondUp?: string;
   /**
    * BCP 47 language tag for desired language and country format
+   *
    * @internal
    */
   locale: string;
@@ -54,6 +55,7 @@ export declare class InputTimePicker implements LabelableComponent, FormComponen
   scale: Scale;
   /**
    * Determines where the popover will be positioned relative to the input.
+   *
    * @see [PopperPlacement](https://github.com/Esri/calcite-components/blob/master/src/utils/popper.ts#L25)
    */
   placement: PopperPlacement;
@@ -77,8 +79,8 @@ export declare class InputTimePicker implements LabelableComponent, FormComponen
    * Fires when the time value is changed as a result of user input.
    */
   calciteInputTimePickerChange: EventEmitter<string>;
-  private calciteInputBlurHandler;
-  private calciteInputFocusHandler;
+  private calciteInternalInputBlurHandler;
+  private calciteInternalInputFocusHandler;
   private calciteInputInputHandler;
   clickHandler(event: MouseEvent): void;
   keyUpHandler(event: KeyboardEvent): void;

package/dist/types/components/interfaces.d.ts

@@ -3,6 +3,7 @@ export declare type Appearance = "solid" | "clear" | "outline";
 export declare type Columns = 1 | 2 | 3 | 4 | 5 | 6;
 export declare type FlipContext = "both" | "start" | "end";
 export declare type Layout = "horizontal" | "vertical" | "grid";
+export declare type LogicalFlowPosition = "inline-start" | "inline-end" | "block-start" | "block-end";
 export declare type Position = "start" | "end";
 export declare type Scale = "s" | "m" | "l";
 export declare type Status = "invalid" | "valid" | "idle";

package/dist/types/components/label/label.d.ts

@@ -9,6 +9,7 @@ export declare class Label {
   alignment: Alignment;
   /**
    * specify the status of the label and any child input / input messages
+   *
    * @deprecated set directly on child element instead
    */
   status: Status;

package/dist/types/components/link/link.d.ts

@@ -9,7 +9,8 @@ export declare class Link implements InteractiveComponent {
   el: HTMLCalciteLinkElement;
   /** is the link disabled  */
   disabled: boolean;
-  /** Prompts the user to save the linked URL instead of navigating to it. Can be used with or without a value:
+  /**
+   * Prompts the user to save the linked URL instead of navigating to it. Can be used with or without a value:
    * Without a value, the browser will suggest a filename/extension
    * See: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#attr-download
    */

package/dist/types/components/list/list.d.ts

@@ -7,11 +7,11 @@ import { InteractiveComponent } from "../../utils/interactive";
  */
 export declare class List implements InteractiveComponent {
   /**
-   * When true, disabled prevents user interaction.
+   * When true, prevents user interaction.
    */
   disabled: boolean;
   /**
-   * Number at which section headings should start for this component.
+   * Number at which section headings should start for the list.
    */
   headingLevel: HeadingLevel;
   componentDidRender(): void;

package/dist/types/components/list-item/list-item.d.ts

@@ -14,15 +14,15 @@ export declare class ListItem implements ConditionalSlotComponent, InteractiveCo
    */
   nonInteractive: boolean;
   /**
-   * An optional description for this item.  This will appear below the label text.
+   * An optional description for the list item. Displays below the label text.
    */
   description: string;
   /**
-   * When true, disabled prevents interaction.
+   * When true, prevents user interaction.
    */
   disabled: boolean;
   /**
-   * The label text of the list item. This will appear above the description text.
+   * The label text of the list item. Displays above the description text.
    */
   label: string;
   el: HTMLCalciteListItemElement;

package/dist/types/components/list-item-group/list-item-group.d.ts

@@ -5,12 +5,12 @@ import { HeadingLevel } from "../functional/Heading";
  */
 export declare class ListItemGroup {
   /**
-   * The title used for all nested `calcite-list-item` rows.
+   * The title for all nested `calcite-list-item` rows.
    *
    */
   heading: string;
   /**
-   * Number at which section headings should start for this component.
+   * Number at which section headings should start for the group.
    */
   headingLevel: HeadingLevel;
   el: HTMLCalciteListItemGroupElement;

package/dist/types/components/loader/loader.d.ts

@@ -2,25 +2,27 @@ import { VNode } from "../../stencil-public-runtime";
 import { Scale } from "../interfaces";
 export declare class Loader {
   el: HTMLCalciteLoaderElement;
-  /** Show the loader */
+  /** When true, the loader is active. */
   active: boolean;
-  /** Inline loaders are smaller and will appear to the left of the text */
+  /** When true, displays smaller and appears to the left of the text. */
   inline: boolean;
-  /** Accessible name for the component */
+  /** Accessible name for the loader. */
   label: string;
-  /** Speficy the scale of the loader. Defaults to "m" */
+  /** Specify the scale of the loader. */
   scale: Scale;
-  /** Use indeterminate if finding actual progress value is impossible */
+  /** Use indeterminate if finding actual progress value is impossible. */
   type: "indeterminate" | "determinate";
-  /** Percent complete of 100, only valid for determinate indicators */
+  /** Valid only for determinate indicators. Percent complete of 100. */
   value: number;
-  /** Text which should appear under the loading indicator (optional) */
-  text: string;
-  /** Turn off spacing around the loader */
+  /** Text that displays under the loading indicator. */
+  text?: string;
+  /** Disables spacing around the loader. */
   noPadding: boolean;
   render(): VNode;
   /**
    * Return the proper sizes based on the scale property
+   *
+   * @param scale
    */
   private getSize;
   private getInlineSize;

package/dist/types/components/modal/modal.d.ts

@@ -3,42 +3,42 @@ import { Scale } from "../interfaces";
 import { ModalBackgroundColor } from "./interfaces";
 import { ConditionalSlotComponent } from "../../utils/conditionalSlot";
 /**
- * @slot header - a slot for adding a modal header
- * @slot content - a slot for adding modal content
- * @slot primary - a slot for adding a primary button
- * @slot secondary - a slot for adding a secondary button
- * @slot back - a slot for adding a back button
+ * @slot header - A slot for adding a `calcite-modal` header.
+ * @slot content - A slot for adding `calcite-modal` content.
+ * @slot primary - A slot for adding a primary button.
+ * @slot secondary - A slot for adding a secondary button.
+ * @slot back - A slot for adding a back button.
  */
 export declare class Modal implements ConditionalSlotComponent {
   el: HTMLCalciteModalElement;
-  /** Add the active attribute to open the modal */
+  /** When true, the `calcite-modal` is active. */
   active: boolean;
-  /** Optionally pass a function to run before close */
-  beforeClose: (el: HTMLElement) => Promise<void>;
-  /** Disables the display a close button within the Modal */
+  /** Passes a function to run before the `calcite-modal` closes. */
+  beforeClose?: (el: HTMLElement) => Promise<void>;
+  /** When true, disables the close button within the `calcite-modal`. */
   disableCloseButton: boolean;
-  /** Disables the closing of the Modal when clicked outside. */
+  /** When true, disables the closing of the `calcite-modal` when clicked outside. */
   disableOutsideClose: boolean;
-  /** Aria label for the close button */
+  /** Accessible label for the close button. */
   intlClose: string;
-  /** Prevent the modal from taking up the entire screen on mobile */
+  /** When true, prevents the `calcite-modal` from expanding to the entire screen on mobile devices. */
   docked: boolean;
-  /** Specify an element to focus when the modal is first opened */
-  firstFocus?: HTMLElement;
-  /** Flag to disable the default close on escape behavior */
+  /** When true, disables the default close on escape behavior. */
   disableEscape: boolean;
-  /** specify the scale of modal, defaults to m */
+  /** Specify the scale of `calcite-modal`. */
   scale: Scale;
-  /** Set the width of the modal. Can use stock sizes or pass a number (in pixels) */
+  /** Set the width of the `calcite-modal`. Can use scale sizes or pass a number (displays in pixels). */
   width: Scale | number;
-  /** Set the modal to always be fullscreen (overrides width) */
+  /** Set the `calcite-modal` to always be fullscreen (overrides width). */
   fullscreen: boolean;
-  /** Adds a color bar at the top for visual impact,
-   * Use color to add importance to destructive/workflow dialogs. */
+  /**
+   * Adds a color bar to the top of `calcite-modal` for visual impact.
+   * Use color to add importance to destructive or workflow dialogs.
+   */
   color?: "red" | "blue";
-  /** Background color of modal content */
+  /** Sets the background color of `calcite-modal` content. */
   backgroundColor: ModalBackgroundColor;
-  /** Turn off spacing around the content area slot */
+  /** When true, disables spacing to the content area slot. */
   noPadding: boolean;
   componentWillLoad(): void;
   connectedCallback(): void;
@@ -56,23 +56,32 @@ export declare class Modal implements ConditionalSlotComponent {
   titleId: string;
   private activeTransitionProp;
   handleEscape(e: KeyboardEvent): void;
-  /** Fired when the modal finishes the open animation */
+  /** Emits when `calcite-modal` finishes the open animation. */
   calciteModalOpen: EventEmitter;
-  /** Fired when the modal finishes the close animation */
+  /** Emits when `calcite-modal` finishes the close animation. */
   calciteModalClose: EventEmitter;
   /**
-   * Focus first interactive element
+   * Focus the first interactive element.
+   *
+   * @param el
    * @deprecated use `setFocus` instead.
    */
   focusElement(el?: HTMLElement): Promise<void>;
   /**
    * Sets focus on the component.
    *
-   * By default, will try to focus on any focusable content. If there is none, it will focus on the close button.
-   * If you want to focus on the close button, you can use the `close-button` focus ID.
+   * By default, tries to focus on focusable content. If there is none, it will focus on the close button.
+   * To focus on the close button, use the `close-button` focus ID.
+   *
+   * @param focusId
    */
   setFocus(focusId?: "close-button"): Promise<void>;
-  /** Set the scroll top of the modal content */
+  /**
+   * Set the scroll top of the `calcite-modal` content.
+   *
+   * @param top
+   * @param left
+   */
   scrollContent(top?: number, left?: number): Promise<void>;
   transitionEnd: (event: TransitionEvent) => void;
   toggleModal(value: boolean, oldValue: boolean): Promise<void>;

package/dist/types/components/notice/notice.d.ts

@@ -2,50 +2,55 @@ import { EventEmitter, VNode } from "../../stencil-public-runtime";
 import { Scale, Width } from "../interfaces";
 import { StatusColor } from "../alert/interfaces";
 import { ConditionalSlotComponent } from "../../utils/conditionalSlot";
-/** Notices are intended to be used to present users with important-but-not-crucial contextual tips or copy. Because
+/**
+ * Notices are intended to be used to present users with important-but-not-crucial contextual tips or copy. Because
  * notices are displayed inline, a common use case is displaying them on page-load to present users with short hints or contextual copy.
  * They are optionally dismissible - useful for keeping track of whether or not a user has dismissed the notice. You can also choose not
  * to display a notice on page load and set the "active" attribute as needed to contextually provide inline messaging to users.
  */
 /**
- * @slot title - Title of the notice (optional)
- * @slot message - Main text of the notice
- * @slot link - Optional action to take from the notice (undo, try again, link to page, etc.)
- * @slot actions-end - Allows adding a `calcite-action` at the end of the notice. It is recommended to use 2 or less actions.
+ * @slot title - A slot for adding the title (optional).
+ * @slot message - A slot for adding the message.
+ * @slot link - A slot for adding actions to take, such as: undo, try again, link to page, etc. (optional).
+ * @slot actions-end - A slot for adding actions to the end of the `calcite-notice` (optional). It is recommended to use two or less actions.
  */
 export declare class Notice implements ConditionalSlotComponent {
   el: HTMLCalciteNoticeElement;
-  /** Is the notice currently active or not */
+  /** When true, the `calcite-notice` is active. */
   active: boolean;
-  /** Color for the notice (will apply to top border and icon) */
+  /** The color for the `calcite-notice`. Color will apply to top border and icon. */
   color: StatusColor;
-  /** Optionally show a button the user can click to dismiss the notice */
-  dismissible: boolean;
-  /** when used as a boolean set to true, show a default recommended icon. You can
-   * also pass a calcite-ui-icon name to this prop to display a requested icon */
+  /** Shows a button the user can click to dismiss the `calcite-notice`. */
+  dismissible?: boolean;
+  /**
+   * When present, shows a default recommended icon. You can
+   * also pass a calcite-ui-icon name to display a requested icon.
+   */
   icon: string | boolean;
-  /** String for the close button.
+  /**
+   * Accessible label for the close button.
+   *
    * @default "Close"
    */
   intlClose: string;
-  /** specify the scale of the notice, defaults to m */
+  /** Specify the scale of `calcite-notice`. */
   scale: Scale;
-  /** specify the width of the notice, defaults to auto */
+  /** Specify the width of the `calcite-notice`. */
   width: Width;
   updateRequestedIcon(): void;
   connectedCallback(): void;
   disconnectedCallback(): void;
   componentWillLoad(): void;
   render(): VNode;
-  /** Fired when an notice is closed */
+  /** Fired when `calcite-notice` is closed. */
   calciteNoticeClose: EventEmitter;
-  /** Fired when an Notice is opened */
+  /** Fired when `calcite-notice` is opened. */
   calciteNoticeOpen: EventEmitter;
-  /** Sets focus on the component. */
+  /** Sets focus on the `calcite-notice`. */
   setFocus(): Promise<void>;
   private close;
-  /** the close button element */
+  /** The close button element. */
   private closeButton?;
-  /** the computed icon to render */
+  /** The computed icon to render. */
   private requestedIcon?;
 }

package/dist/types/components/option/option.d.ts

@@ -24,7 +24,7 @@ export declare class Option {
   /**
    * @internal
    */
-  private calciteOptionChange;
+  private calciteInternalOptionChange;
   private ensureTextContentDependentProps;
   connectedCallback(): void;
   disconnectedCallback(): void;

package/dist/types/components/option-group/option-group.d.ts

@@ -15,6 +15,6 @@ export declare class OptionGroup {
   /**
    * @internal
    */
-  private calciteOptionGroupChange;
+  private calciteInternalOptionGroupChange;
   render(): VNode;
 }

package/dist/types/components/pagination/pagination.d.ts

@@ -1,38 +1,48 @@
 import { EventEmitter, VNode } from "../../stencil-public-runtime";
 import { Scale } from "../interfaces";
+import { GlobalAttrComponent } from "../../utils/globalAttributes";
 export interface PaginationDetail {
   start: number;
   total: number;
   num: number;
 }
-export declare class Pagination {
+export declare class Pagination implements GlobalAttrComponent {
   /** number of items per page */
   num: number;
   /** index of item that should begin the page */
   start: number;
   /** total number of items */
   total: number;
-  /** Used as an accessible label (aria-label) for the next button
+  /**
+   * Used as an accessible label (aria-label) for the next button
+   *
    * @default "Next"
    */
   textLabelNext: string;
-  /** Used as an accessible label (aria-label) of the previous button
+  /**
+   * Used as an accessible label (aria-label) of the previous button
+   *
    * @default "Previous"
    */
   textLabelPrevious: string;
   /** The scale of the pagination */
   scale: Scale;
   el: HTMLCalcitePaginationElement;
+  globalAttributes: {};
   /**
    * Emitted whenever the selected page changes.
+   *
    * @deprecated use calcitePaginationChange instead
    */
   calcitePaginationUpdate: EventEmitter<PaginationDetail>;
   /**
    * Emitted whenever the selected page changes.
+   *
    * @see [PaginationDetail](https://github.com/Esri/calcite-components/blob/master/src/components/pagination/calcite-pagination.tsx#L18)
    */
   calcitePaginationChange: EventEmitter<PaginationDetail>;
+  connectedCallback(): void;
+  disconnectedCallback(): void;
   /** Go to the next page of results */
   nextPage(): Promise<void>;
   /** Go to the previous page of results */

package/dist/types/components/panel/panel.d.ts

@@ -90,6 +90,7 @@ export declare class Panel implements ConditionalSlotComponent, InteractiveCompo
   calcitePanelDismiss: EventEmitter;
   /**
    * Emitted when the close button has been clicked.
+   *
    * @deprecated use calcitePanelDismiss instead.
    */
   calcitePanelDismissedChange: EventEmitter;
@@ -109,9 +110,14 @@ export declare class Panel implements ConditionalSlotComponent, InteractiveCompo
   dismiss: () => void;
   panelScrollHandler: () => void;
   backButtonClick: () => void;
-  /** Sets focus on the component. */
+  /**
+   * Sets focus on the component.
+   *
+   * @param focusId
+   */
   setFocus(focusId?: "dismiss-button" | "back-button"): Promise<void>;
-  /** Scrolls panel content to a particular set of coordinates.
+  /**
+   * Scrolls panel content to a particular set of coordinates.
    *
    * ```
    *   myCalcitePanel.scrollContentTo({
@@ -120,6 +126,8 @@ export declare class Panel implements ConditionalSlotComponent, InteractiveCompo
    *     behavior: "auto" // Specifies whether the scrolling should animate smoothly (smooth), or happen instantly in a single jump (auto, the default value).
    *   });
    * ```
+   *
+   * @param options
    */
   scrollContentTo(options?: ScrollToOptions): Promise<void>;
   renderBackButton(): VNode;

package/dist/types/components/pick-list/pick-list.d.ts

@@ -56,8 +56,8 @@ export declare class PickList<ItemElement extends HTMLCalcitePickListItemElement
   calciteListChange: EventEmitter<Map<string, HTMLCalcitePickListItemElement>>;
   calciteListItemRemoveHandler(event: CustomEvent<void>): void;
   calciteListItemChangeHandler(event: CustomEvent): void;
-  calciteListItemPropsChangeHandler(event: CustomEvent): void;
-  calciteListItemValueChangeHandler(event: CustomEvent): void;
+  calciteInternalListItemPropsChangeHandler(event: CustomEvent): void;
+  calciteInternalListItemValueChangeHandler(event: CustomEvent): void;
   calciteListFocusOutHandler(event: FocusEvent): void;
   setUpItems(): void;
   setUpFilter(): void;
@@ -70,7 +70,11 @@ export declare class PickList<ItemElement extends HTMLCalcitePickListItemElement
   keyDownHandler: any;
   /** Returns the currently selected items */
   getSelectedItems(): Promise<Map<string, HTMLCalcitePickListItemElement>>;
-  /** Sets focus on the component. */
+  /**
+   * Sets focus on the component.
+   *
+   * @param focusId
+   */
   setFocus(focusId?: ListFocusId): Promise<void>;
   getIconType(): ICON_TYPES;
   render(): VNode;

package/dist/types/components/pick-list/shared-list-logic.d.ts

@@ -9,7 +9,7 @@ export declare function initialize<T extends Lists>(this: List<T>): void;
 export declare function initializeObserver<T extends Lists>(this: List<T>): void;
 export declare function cleanUpObserver<T extends Lists>(this: List<T>): void;
 export declare function calciteListItemChangeHandler<T extends Lists>(this: List<T>, event: CustomEvent): void;
-export declare function calciteListItemValueChangeHandler<T extends Lists>(this: List<T>, event: CustomEvent): void;
+export declare function calciteInternalListItemValueChangeHandler<T extends Lists>(this: List<T>, event: CustomEvent): void;
 export declare function calciteListFocusOutHandler<T extends Lists>(this: List<T>, event: FocusEvent): void;
 export declare function keyDownHandler<T extends Lists>(this: List<T>, event: KeyboardEvent): void;
 export declare function moveItemIndex<T extends Lists>(list: List<T>, item: ListItemElement<T>, direction: "up" | "down"): number;

package/dist/types/components/pick-list-item/pick-list-item.d.ts

@@ -21,11 +21,12 @@ export declare class PickListItem implements ConditionalSlotComponent, Interacti
    */
   disableDeselect: boolean;
   /**
-   * @internal When true, the item cannot be selected by user interaction.
+   * @internal
    */
   nonInteractive: boolean;
   /**
    * Determines the icon SVG symbol that will be shown. Options are circle, square, grip or null.
+   *
    * @see [ICON_TYPES](https://github.com/Esri/calcite-components/blob/master/src/components/pick-list/resources.ts#L5)
    */
   icon?: ICON_TYPES | null;
@@ -50,6 +51,7 @@ export declare class PickListItem implements ConditionalSlotComponent, Interacti
   selectedWatchHandler(): void;
   /**
    * Used as an accessible label (aria-label) for the "remove item" action. Only applicable if removable is true.
+   *
    * @default "Remove"
    */
   intlRemove: string;
@@ -79,20 +81,24 @@ export declare class PickListItem implements ConditionalSlotComponent, Interacti
   calciteListItemRemove: EventEmitter<void>;
   /**
    * Emitted whenever the the item's label, description, value or metadata properties are modified.
+   *
    * @internal
    */
-  calciteListItemPropsChange: EventEmitter<void>;
+  calciteInternalListItemPropsChange: EventEmitter<void>;
   /**
    * Emitted whenever the the item's value property is modified.
+   *
    * @internal
    */
-  calciteListItemValueChange: EventEmitter<{
+  calciteInternalListItemValueChange: EventEmitter<{
     oldValue: any;
     newValue: any;
   }>;
   /**
    * Used to toggle the selection state. By default this won't trigger an event.
    * The first argument allows the value to be coerced, rather than swapping values.
+   *
+   * @param coerce
    */
   toggleSelected(coerce?: boolean): Promise<void>;
   /** Sets focus on the component. */

package/dist/types/components/popover/PopoverManager.d.ts

@@ -1,9 +1,12 @@
+import { ReferenceElement } from "../../utils/popper";
 export default class PopoverManager {
   private registeredElements;
   private registeredElementCount;
-  registerElement(referenceEl: HTMLElement, popover: HTMLCalcitePopoverElement): void;
-  unregisterElement(referenceEl: HTMLElement): void;
+  registerElement(referenceEl: ReferenceElement, popover: HTMLCalcitePopoverElement): void;
+  unregisterElement(referenceEl: ReferenceElement): void;
   private queryPopover;
+  private togglePopovers;
+  private keyHandler;
   private clickHandler;
   private addListeners;
   private removeListeners;

package/dist/types/components/popover/popover.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter, VNode } from "../../stencil-public-runtime";
-import { PopperPlacement, OverlayPositioning, ComputedPlacement } from "../../utils/popper";
+import { PopperPlacement, OverlayPositioning, ComputedPlacement, ReferenceElement } from "../../utils/popper";
 import { StrictModifiers, Instance as Popper } from "@popperjs/core";
 import { HeadingLevel } from "../functional/Heading";
 /**
@@ -12,6 +12,7 @@ export declare class Popover {
   autoClose: boolean;
   /**
    * Display a close button within the Popover.
+   *
    * @deprecated use dismissible instead.
    */
   closeButton: boolean;
@@ -44,6 +45,7 @@ export declare class Popover {
   label: string;
   /**
    * Offset the position of the popover away from the reference element.
+   *
    * @default 6
    */
   offsetDistance: number;
@@ -62,6 +64,7 @@ export declare class Popover {
   overlayPositioning: OverlayPositioning;
   /**
    * Determines where the component will be positioned relative to the referenceElement.
+   *
    * @see [PopperPlacement](https://github.com/Esri/calcite-components/blob/master/src/utils/popper.ts#L25)
    */
   placement: PopperPlacement;
@@ -69,15 +72,21 @@ export declare class Popover {
   /**
    * Reference HTMLElement used to position this component according to the placement property. As a convenience, a string ID of the reference element can be used. However, setting this property to use an HTMLElement is preferred so that the component does not need to query the DOM for the referenceElement.
    */
-  referenceElement: HTMLElement | string;
+  referenceElement: ReferenceElement | string;
   referenceElementHandler(): void;
-  /** Text for close button.
+  /**
+   * Disables automatically toggling a popover when its referenceElement has been triggered. This property can be set to true to manage when a popover is open.
+   */
+  triggerDisabled: boolean;
+  /**
+   * Text for close button.
+   *
    * @default "Close"
    */
   intlClose: string;
   filteredFlipPlacements: ComputedPlacement[];
   el: HTMLCalcitePopoverElement;
-  effectiveReferenceElement: HTMLElement;
+  effectiveReferenceElement: ReferenceElement;
   popper: Popper;
   arrowEl: HTMLDivElement;
   closeButtonEl: HTMLCalciteActionElement;
@@ -93,9 +102,17 @@ export declare class Popover {
   calcitePopoverOpen: EventEmitter;
   /** Updates the position of the component. */
   reposition(): Promise<void>;
-  /** Sets focus on the component. */
+  /**
+   * Sets focus on the component.
+   *
+   * @param focusId
+   */
   setFocus(focusId?: "close-button"): Promise<void>;
-  /** Toggles the popover's open property. */
+  /**
+   * Toggles the popover's open property.
+   *
+   * @param value
+   */
   toggle(value?: boolean): Promise<void>;
   setFilteredPlacements: () => void;
   setUpReferenceElement: () => void;
@@ -103,7 +120,7 @@ export declare class Popover {
   setExpandedAttr: () => void;
   addReferences: () => void;
   removeReferences: () => void;
-  getReferenceElement(): HTMLElement;
+  getReferenceElement(): ReferenceElement;
   getModifiers(): Partial<StrictModifiers>[];
   createPopper(): void;
   destroyPopper(): void;

package/dist/types/components/popover-manager/popover-manager.d.ts

@@ -8,6 +8,7 @@ export declare class PopoverManager {
   mutationObserver: MutationObserver;
   /**
    * 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;