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

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

@@ -81,11 +81,18 @@ export declare class Panel implements ConditionalSlotComponent, InteractiveCompo
   dismissButtonEl: HTMLCalciteActionElement;
   containerEl: HTMLElement;
   panelScrollEl: HTMLElement;
+  resizeObserver: ResizeObserver;
   connectedCallback(): void;
   disconnectedCallback(): void;
   /**
    * Emitted when the close button has been clicked.
    */
+  calcitePanelDismiss: EventEmitter;
+  /**
+   * Emitted when the close button has been clicked.
+   *
+   * @deprecated use calcitePanelDismiss instead.
+   */
   calcitePanelDismissedChange: EventEmitter;
   /**
    * Emitted when the content has been scrolled.
@@ -95,6 +102,7 @@ export declare class Panel implements ConditionalSlotComponent, InteractiveCompo
    * Emitted when the back button has been clicked.
    */
   calcitePanelBackClick: EventEmitter;
+  resizeHandler: () => void;
   setContainerRef: (node: HTMLElement) => void;
   setDismissRef: (node: HTMLCalciteActionElement) => void;
   setBackRef: (node: HTMLCalciteActionElement) => void;
@@ -102,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({
@@ -113,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;
@@ -126,6 +141,7 @@ export declare class Panel implements ConditionalSlotComponent, InteractiveCompo
   renderMenu(): VNode;
   renderHeaderNode(): VNode;
   renderFooterNode(): VNode;
+  setPanelScrollEl: (el: HTMLElement) => void;
   renderContent(): VNode;
   renderFab(): VNode;
   render(): 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

@@ -0,0 +1,13 @@
+import { ReferenceElement } from "../../utils/popper";
+export default class PopoverManager {
+  private registeredElements;
+  private registeredElementCount;
+  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,13 +1,18 @@
 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";
 /**
  * @slot - A slot for adding custom content.
  */
 export declare class Popover {
+  /**
+   * Automatically closes any currently open popovers when clicking outside of a popover.
+   */
+  autoClose: boolean;
   /**
    * Display a close button within the Popover.
+   *
    * @deprecated use dismissible instead.
    */
   closeButton: boolean;
@@ -27,6 +32,7 @@ export declare class Popover {
    * Defines the available placements that can be used when a flip occurs.
    */
   flipPlacements?: ComputedPlacement[];
+  flipPlacementsHandler(): void;
   /**
    * Heading text.
    */
@@ -39,6 +45,7 @@ export declare class Popover {
   label: string;
   /**
    * Offset the position of the popover away from the reference element.
+   *
    * @default 6
    */
   offsetDistance: number;
@@ -57,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;
@@ -64,19 +72,27 @@ 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;
   guid: string;
   private activeTransitionProp;
+  connectedCallback(): void;
   componentWillLoad(): void;
   componentDidLoad(): void;
   disconnectedCallback(): void;
@@ -86,16 +102,25 @@ 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;
   getId: () => string;
   setExpandedAttr: () => void;
   addReferences: () => void;
   removeReferences: () => void;
-  getReferenceElement(): HTMLElement;
+  getReferenceElement(): ReferenceElement;
   getModifiers(): Partial<StrictModifiers>[];
   createPopper(): void;
   destroyPopper(): void;

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

@@ -14,7 +14,6 @@ export declare const TEXT: {
   close: string;
 };
 export declare const defaultPopoverPlacement = "auto";
-export declare const POPOVER_REFERENCE = "data-calcite-popover-reference";
 export declare const ARIA_CONTROLS = "aria-controls";
 export declare const ARIA_EXPANDED = "aria-expanded";
 export declare const HEADING_LEVEL = 2;

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

@@ -1,11 +1,14 @@
 import { VNode } from "../../stencil-public-runtime";
 /**
  * @slot - A slot for adding elements that reference a 'calcite-popover' by the 'selector' property.
+ * @deprecated No longer required for popover usage.
  */
 export declare class PopoverManager {
   el: HTMLCalcitePopoverManagerElement;
+  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;
@@ -13,7 +16,9 @@ export declare class PopoverManager {
    * Automatically closes any currently open popovers when clicking outside of a popover.
    */
   autoClose: boolean;
+  autoCloseHandler(): void;
+  connectedCallback(): void;
+  disconnectedCallback(): void;
   render(): VNode;
-  queryPopover: (composedPath: EventTarget[]) => HTMLCalcitePopoverElement;
-  closeOpenPopovers(event: Event): void;
+  setAutoClose(): void;
 }

package/dist/types/components/radio-button/radio-button.d.ts

@@ -12,6 +12,7 @@ export declare class RadioButton implements LabelableComponent, CheckableFormCom
   disabled: boolean;
   /**
    * The focused state of the radio button.
+   *
    * @internal
    */
   focused: boolean;
@@ -21,11 +22,13 @@ export declare class RadioButton implements LabelableComponent, CheckableFormCom
   hidden: boolean;
   /**
    * The hovered state of the radio button.
+   *
    * @internal
    */
   hovered: boolean;
   /**
    * The label of the radio input
+   *
    * @internal
    */
   label?: string;
@@ -60,6 +63,7 @@ export declare class RadioButton implements LabelableComponent, CheckableFormCom
   private getTabIndex;
   /**
    * Fires when the radio button is blurred.
+   *
    * @internal
    */
   calciteInternalRadioButtonBlur: EventEmitter;
@@ -73,11 +77,13 @@ export declare class RadioButton implements LabelableComponent, CheckableFormCom
   /**
    * Fires when the checked property changes.  This is an internal event used for styling purposes only.
    * Use calciteRadioButtonChange or calciteRadioButtonGroupChange for responding to changes in the checked value for forms.
+   *
    * @internal
    */
   calciteInternalRadioButtonCheckedChange: EventEmitter;
   /**
    * Fires when the radio button is focused.
+   *
    * @internal
    */
   calciteInternalRadioButtonFocus: EventEmitter;

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

@@ -18,7 +18,8 @@ export declare class RadioGroupItem {
   render(): VNode;
   /**
    * Fires when the item has been selected.
+   *
    * @internal
    */
-  calciteRadioGroupItemChange: EventEmitter;
+  calciteInternalRadioGroupItemChange: EventEmitter;
 }

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

@@ -21,11 +21,15 @@ export declare class Rating implements LabelableComponent, FormComponent, Intera
   average?: number;
   /** The name of the rating */
   name: string;
-  /** Localized string for "Rating" (used for aria label)
+  /**
+   * Localized string for "Rating" (used for aria label)
+   *
    * @default "Rating"
    */
   intlRating?: string;
-  /** Localized string for labelling each star, `${num}` in the string will be replaced by the number
+  /**
+   * Localized string for labelling each star, `${num}` in the string will be replaced by the number
+   *
    * @default "Stars: ${num}"
    */
   intlStars?: string;

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

@@ -3,7 +3,9 @@ import { VNode } from "../../stencil-public-runtime";
  * @slot - A slot for adding custom content, primarily loading information.
  */
 export declare class Scrim {
-  /** string to override English loading text
+  /**
+   * string to override English loading text
+   *
    * @default "Loading"
    */
   intlLoading?: string;

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

@@ -29,6 +29,7 @@ export declare class ShellPanel implements ConditionalSlotComponent {
   position: Position;
   /**
    * Accessible label for resize separator.
+   *
    * @default "Resize"
    */
   intlResize: string;
@@ -51,6 +52,8 @@ export declare class ShellPanel implements ConditionalSlotComponent {
   stepMultiplier: number;
   /**
    * Emitted when collapse has been toggled.
+   *
+   * @deprecated use a resizeObserver on the shell-panel to listen for changes to its size.
    */
   calciteShellPanelToggle: EventEmitter;
   renderHeader(): VNode;

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

@@ -12,6 +12,7 @@ export declare class Slider implements LabelableComponent, FormComponent, Intera
   hasHistogram: boolean;
   /**
    * List of x,y coordinates within the slider's min and max, displays above the slider track.
+   *
    * @see [DataSeries](https://github.com/Esri/calcite-components/blob/master/src/components/graph/interfaces.ts#L5)
    */
   histogram?: DataSeries;
@@ -59,7 +60,9 @@ export declare class Slider implements LabelableComponent, FormComponent, Intera
   /** Show tick marks on the number line at provided interval */
   ticks?: number;
   /** Currently selected number (if single select) */
-  value: null | number;
+  value: null | number | number[];
+  valueHandler(): void;
+  minMaxValueHandler(): void;
   /**
    * Specify the scale of the slider, defaults to m
    */
@@ -93,6 +96,7 @@ export declare class Slider implements LabelableComponent, FormComponent, Intera
    * :warning: Will be fired frequently during drag. If you are performing any
    * expensive operations consider using a debounce or throttle to avoid
    * locking up the main thread.
+   *
    * @deprecated use calciteSliderInput instead
    */
   calciteSliderUpdate: EventEmitter;
@@ -102,7 +106,6 @@ export declare class Slider implements LabelableComponent, FormComponent, Intera
   formEl: HTMLFormElement;
   defaultValue: Slider["value"];
   private guid;
-  private isRange;
   private dragProp;
   private lastDragProp;
   private lastDragPropValue;
@@ -114,6 +117,8 @@ export declare class Slider implements LabelableComponent, FormComponent, Intera
   private minValueDragRange;
   private maxValueDragRange;
   private tickValues;
+  setValueFromMinMax(): void;
+  setMinMaxFromValue(): void;
   onLabelClick(): void;
   private shouldMirror;
   private shouldUseMinValue;
@@ -127,28 +132,37 @@ export declare class Slider implements LabelableComponent, FormComponent, Intera
   private removeDragListeners;
   /**
    * Set the prop value if changed at the component level
+   *
    * @param valueProp
    * @param value
    */
   private setValue;
   /**
    * Set the reference of the track Element
+   *
    * @internal
    * @param node
    */
   private storeTrackRef;
   /**
    * If number is outside range, constrain to min or max
+   *
+   * @param value
+   * @param prop
    * @internal
    */
   private clamp;
   /**
    * Translate a pixel position to value along the range
+   *
+   * @param x
    * @internal
    */
   private translate;
   /**
    * Get closest allowed value along stepped values
+   *
+   * @param num
    * @internal
    */
   private getClosestStep;
@@ -157,6 +171,8 @@ export declare class Slider implements LabelableComponent, FormComponent, Intera
   private getFontSizeForElement;
   /**
    * Get position of value along range as fractional value
+   *
+   * @param num
    * @return {number} number in the unit interval [0,1]
    * @internal
    */
@@ -169,24 +185,30 @@ export declare class Slider implements LabelableComponent, FormComponent, Intera
   private hideObscuredBoundingTickLabels;
   /**
    * Returns an integer representing the number of pixels to offset on the left or right side based on desired position behavior.
+   *
+   * @param leftBounds
+   * @param rightBounds
    * @internal
    */
   private getHostOffset;
   /**
    * Returns an integer representing the number of pixels that the two given span elements are overlapping, taking into account
    * a space in between the two spans equal to the font-size set on them to account for the space needed to render a hyphen.
+   *
    * @param leftLabel
    * @param rightLabel
    */
   private getRangeLabelOverlap;
   /**
    * Returns a boolean value representing if the minLabel span element is obscured (being overlapped) by the given handle div element.
+   *
    * @param minLabel
    * @param handle
    */
   private isMinTickLabelObscured;
   /**
    * Returns a boolean value representing if the maxLabel span element is obscured (being overlapped) by the given handle div element.
+   *
    * @param maxLabel
    * @param handle
    */