@esri/calcite-components 1.0.0-beta.93 → 1.0.0-beta.94

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

@@ -1,13 +1,13 @@
-import { ReferenceElement } from "../../utils/floating-ui";
-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;
-}
+import { ReferenceElement } from "../../utils/floating-ui";
+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,150 +1,152 @@
-import { EventEmitter, VNode } from "../../stencil-public-runtime";
-import { OverlayPositioning, FloatingUIComponent, LogicalPlacement, EffectivePlacement, ReferenceElement } from "../../utils/floating-ui";
-import { OpenCloseComponent } from "../../utils/openCloseComponent";
-import { HeadingLevel } from "../functional/Heading";
-/**
- * @slot - A slot for adding custom content.
- */
-export declare class Popover implements FloatingUIComponent, OpenCloseComponent {
-  /**
-   * When true and clicking outside of the component, automatically closes open `calcite-popover`s.
-   */
-  autoClose: boolean;
-  /**
-   * When true, a close button is added to the component.
-   *
-   * @deprecated use dismissible instead.
-   */
-  closeButton: boolean;
-  /**
-   * When true, a close button is added to the component.
-   *
-   * @deprecated use closable instead
-   */
-  dismissible: boolean;
-  handleDismissible(value: boolean): void;
-  /** When true, display a close button within the Popover */
-  closable: boolean;
-  handleClosable(value: boolean): void;
-  /**
-   * When true, prevents flipping the component's placement when overlapping its `referenceElement`.
-   */
-  disableFlip: boolean;
-  /**
-   * When true, removes the caret pointer.
-   */
-  disablePointer: boolean;
-  /**
-   * Defines the available placements that can be used when a flip occurs.
-   */
-  flipPlacements?: EffectivePlacement[];
-  flipPlacementsHandler(): void;
-  /**
-   * The component header text.
-   */
-  heading?: string;
-  /**
-   * Specifies the number at which section headings should start.
-   */
-  headingLevel: HeadingLevel;
-  /** Accessible name for the component. */
-  label: string;
-  /**
-   * Offsets the position of the popover away from the `referenceElement`.
-   *
-   * @default 6
-   */
-  offsetDistance: number;
-  offsetDistanceOffsetHandler(): void;
-  /**
-   * Offsets the position of the popover along the `referenceElement`.
-   */
-  offsetSkidding: number;
-  offsetSkiddingHandler(): void;
-  /**
-   * When true, displays and positions the component.
-   */
-  open: boolean;
-  openHandler(): void;
-  /**
-   * Determines the type of positioning to use for the overlaid content.
-   *
-   * Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
-   *
-   */
-  overlayPositioning: OverlayPositioning;
-  overlayPositioningHandler(): void;
-  /**
-   * Determines where the component will be positioned relative to the `referenceElement`.
-   *
-   * @see [LogicalPlacement](https://github.com/Esri/calcite-components/blob/master/src/utils/floating-ui.ts#L25)
-   */
-  placement: LogicalPlacement;
-  placementHandler(): void;
-  /**
-   *  The `referenceElement` used to position the component according to its "placement" value. Setting to an `HTMLElement` is preferred so the component does not need to query the DOM. However, a string `id` of the reference element can also be used.
-   */
-  referenceElement: ReferenceElement | string;
-  referenceElementHandler(): void;
-  /**
-   * When true, disables automatically toggling the component when its `referenceElement` has been triggered. This property can be set to "true" to manage when a popover is open.
-   */
-  triggerDisabled: boolean;
-  /**
-   * Accessible name for the component's close button.
-   *
-   * @default "Close"
-   */
-  intlClose: string;
-  filteredFlipPlacements: EffectivePlacement[];
-  el: HTMLCalcitePopoverElement;
-  effectiveReferenceElement: ReferenceElement;
-  arrowEl: HTMLDivElement;
-  closeButtonEl: HTMLCalciteActionElement;
-  guid: string;
-  openTransitionProp: string;
-  transitionEl: HTMLDivElement;
-  hasLoaded: boolean;
-  connectedCallback(): void;
-  componentDidLoad(): void;
-  disconnectedCallback(): void;
-  /** Fires when the component is requested to be closed and before the closing transition begins. */
-  calcitePopoverBeforeClose: EventEmitter<void>;
-  /** Fires when the component is closed and animation is complete. */
-  calcitePopoverClose: EventEmitter<void>;
-  /** Fires when the component is added to the DOM but not rendered, and before the opening transition begins. */
-  calcitePopoverBeforeOpen: EventEmitter<void>;
-  /** Fires when the component is open and animation is complete. */
-  calcitePopoverOpen: EventEmitter<void>;
-  /** Updates the position of the component. */
-  reposition(): Promise<void>;
-  /**
-   * Sets focus on the component.
-   *
-   * @param focusId
-   */
-  setFocus(focusId?: "close-button"): Promise<void>;
-  /**
-   * Toggles the component's open property.
-   *
-   * @param value
-   */
-  toggle(value?: boolean): Promise<void>;
-  private setTransitionEl;
-  setFilteredPlacements: () => void;
-  setUpReferenceElement: (warn?: boolean) => void;
-  getId: () => string;
-  setExpandedAttr: () => void;
-  addReferences: () => void;
-  removeReferences: () => void;
-  getReferenceElement(): ReferenceElement;
-  hide: () => void;
-  onBeforeOpen(): void;
-  onOpen(): void;
-  onBeforeClose(): void;
-  onClose(): void;
-  storeArrowEl: (el: HTMLDivElement) => void;
-  renderCloseButton(): VNode;
-  renderHeader(): VNode;
-  render(): VNode;
-}
+/// <reference types="lodash" />
+import { EventEmitter, VNode } from "../../stencil-public-runtime";
+import { OverlayPositioning, FloatingUIComponent, LogicalPlacement, EffectivePlacement, ReferenceElement } from "../../utils/floating-ui";
+import { OpenCloseComponent } from "../../utils/openCloseComponent";
+import { HeadingLevel } from "../functional/Heading";
+/**
+ * @slot - A slot for adding custom content.
+ */
+export declare class Popover implements FloatingUIComponent, OpenCloseComponent {
+  /**
+   * When true and clicking outside of the component, automatically closes open `calcite-popover`s.
+   */
+  autoClose: boolean;
+  /**
+   * When true, a close button is added to the component.
+   *
+   * @deprecated use dismissible instead.
+   */
+  closeButton: boolean;
+  /**
+   * When true, a close button is added to the component.
+   *
+   * @deprecated use closable instead
+   */
+  dismissible: boolean;
+  handleDismissible(value: boolean): void;
+  /** When true, display a close button within the Popover */
+  closable: boolean;
+  handleClosable(value: boolean): void;
+  /**
+   * When true, prevents flipping the component's placement when overlapping its `referenceElement`.
+   */
+  disableFlip: boolean;
+  /**
+   * When true, removes the caret pointer.
+   */
+  disablePointer: boolean;
+  /**
+   * Defines the available placements that can be used when a flip occurs.
+   */
+  flipPlacements?: EffectivePlacement[];
+  flipPlacementsHandler(): void;
+  /**
+   * The component header text.
+   */
+  heading?: string;
+  /**
+   * Specifies the number at which section headings should start.
+   */
+  headingLevel: HeadingLevel;
+  /** Accessible name for the component. */
+  label: string;
+  /**
+   * Offsets the position of the popover away from the `referenceElement`.
+   *
+   * @default 6
+   */
+  offsetDistance: number;
+  offsetDistanceOffsetHandler(): void;
+  /**
+   * Offsets the position of the popover along the `referenceElement`.
+   */
+  offsetSkidding: number;
+  offsetSkiddingHandler(): void;
+  /**
+   * When true, displays and positions the component.
+   */
+  open: boolean;
+  openHandler(): void;
+  /**
+   * Determines the type of positioning to use for the overlaid content.
+   *
+   * Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+   *
+   */
+  overlayPositioning: OverlayPositioning;
+  overlayPositioningHandler(): void;
+  /**
+   * Determines where the component will be positioned relative to the `referenceElement`.
+   *
+   * @see [LogicalPlacement](https://github.com/Esri/calcite-components/blob/master/src/utils/floating-ui.ts#L25)
+   */
+  placement: LogicalPlacement;
+  placementHandler(): void;
+  /**
+   *  The `referenceElement` used to position the component according to its "placement" value. Setting to an `HTMLElement` is preferred so the component does not need to query the DOM. However, a string `id` of the reference element can also be used.
+   */
+  referenceElement: ReferenceElement | string;
+  referenceElementHandler(): void;
+  /**
+   * When true, disables automatically toggling the component when its `referenceElement` has been triggered. This property can be set to "true" to manage when a popover is open.
+   */
+  triggerDisabled: boolean;
+  /**
+   * Accessible name for the component's close button.
+   *
+   * @default "Close"
+   */
+  intlClose: string;
+  filteredFlipPlacements: EffectivePlacement[];
+  el: HTMLCalcitePopoverElement;
+  effectiveReferenceElement: ReferenceElement;
+  arrowEl: HTMLDivElement;
+  closeButtonEl: HTMLCalciteActionElement;
+  guid: string;
+  openTransitionProp: string;
+  transitionEl: HTMLDivElement;
+  hasLoaded: boolean;
+  connectedCallback(): void;
+  componentDidLoad(): void;
+  disconnectedCallback(): void;
+  /** Fires when the component is requested to be closed and before the closing transition begins. */
+  calcitePopoverBeforeClose: EventEmitter<void>;
+  /** Fires when the component is closed and animation is complete. */
+  calcitePopoverClose: EventEmitter<void>;
+  /** Fires when the component is added to the DOM but not rendered, and before the opening transition begins. */
+  calcitePopoverBeforeOpen: EventEmitter<void>;
+  /** Fires when the component is open and animation is complete. */
+  calcitePopoverOpen: EventEmitter<void>;
+  /** Updates the position of the component. */
+  reposition(): Promise<void>;
+  /**
+   * Sets focus on the component.
+   *
+   * @param focusId
+   */
+  setFocus(focusId?: "close-button"): Promise<void>;
+  /**
+   * Toggles the component's open property.
+   *
+   * @param value
+   */
+  toggle(value?: boolean): Promise<void>;
+  debouncedReposition: import("lodash").DebouncedFunc<() => Promise<void>>;
+  private setTransitionEl;
+  setFilteredPlacements: () => void;
+  setUpReferenceElement: (warn?: boolean) => void;
+  getId: () => string;
+  setExpandedAttr: () => void;
+  addReferences: () => void;
+  removeReferences: () => void;
+  getReferenceElement(): ReferenceElement;
+  hide: () => void;
+  onBeforeOpen(): void;
+  onOpen(): void;
+  onBeforeClose(): void;
+  onClose(): void;
+  storeArrowEl: (el: HTMLDivElement) => void;
+  renderCloseButton(): VNode;
+  renderHeader(): VNode;
+  render(): VNode;
+}

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

@@ -1,19 +1,19 @@
-export declare const CSS: {
-  container: string;
-  arrow: string;
-  imageContainer: string;
-  closeButtonContainer: string;
-  closeButton: string;
-  content: string;
-  hasHeader: string;
-  header: string;
-  headerContent: string;
-  heading: string;
-};
-export declare const TEXT: {
-  close: string;
-};
-export declare const defaultPopoverPlacement = "auto";
-export declare const ARIA_CONTROLS = "aria-controls";
-export declare const ARIA_EXPANDED = "aria-expanded";
-export declare const HEADING_LEVEL = 2;
+export declare const CSS: {
+  container: string;
+  arrow: string;
+  imageContainer: string;
+  closeButtonContainer: string;
+  closeButton: string;
+  content: string;
+  hasHeader: string;
+  header: string;
+  headerContent: string;
+  heading: string;
+};
+export declare const TEXT: {
+  close: string;
+};
+export declare const defaultPopoverPlacement = "auto";
+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,24 +1,24 @@
-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;
-  /**
-   * Automatically closes any currently open popovers when clicking outside of a popover.
-   */
-  autoClose: boolean;
-  autoCloseHandler(): void;
-  connectedCallback(): void;
-  disconnectedCallback(): void;
-  render(): VNode;
-  setAutoClose(): void;
-}
+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;
+  /**
+   * Automatically closes any currently open popovers when clicking outside of a popover.
+   */
+  autoClose: boolean;
+  autoCloseHandler(): void;
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+  render(): VNode;
+  setAutoClose(): void;
+}

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

@@ -1,15 +1,15 @@
-import { VNode } from "../../stencil-public-runtime";
-export declare class Progress {
-  el: HTMLCalciteProgressElement;
-  /** Use indeterminate if finding actual progress value is impossible. */
-  type: "indeterminate" | "determinate";
-  /** The component's progress value, with a range of 0.0 - 1.0. */
-  value: number;
-  /** Accessible name for the component. */
-  label: string;
-  /** Text that displays under the component's indicator. */
-  text: string;
-  /** When true and for indeterminate progress bars, reverses the animation direction. */
-  reversed: boolean;
-  render(): VNode;
-}
+import { VNode } from "../../stencil-public-runtime";
+export declare class Progress {
+  el: HTMLCalciteProgressElement;
+  /** Use indeterminate if finding actual progress value is impossible. */
+  type: "indeterminate" | "determinate";
+  /** The component's progress value, with a range of 0.0 - 1.0. */
+  value: number;
+  /** Accessible name for the component. */
+  label: string;
+  /** Text that displays under the component's indicator. */
+  text: string;
+  /** When true and for indeterminate progress bars, reverses the animation direction. */
+  reversed: boolean;
+  render(): VNode;
+}

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

@@ -1,101 +1,101 @@
-import { EventEmitter, VNode } from "../../stencil-public-runtime";
-import { Scale } from "../interfaces";
-import { LabelableComponent } from "../../utils/label";
-import { CheckableFormComponent } from "../../utils/form";
-import { InteractiveComponent } from "../../utils/interactive";
-export declare class RadioButton implements LabelableComponent, CheckableFormComponent, InteractiveComponent {
-  el: HTMLCalciteRadioButtonElement;
-  /** When true, the component is checked. */
-  checked: boolean;
-  checkedChanged(newChecked: boolean): void;
-  /** When true, interaction is prevented and the component is displayed with lower opacity. */
-  disabled: boolean;
-  /**
-   * The focused state of the component.
-   *
-   * @internal
-   */
-  focused: boolean;
-  /** The id attribute of the component. When omitted, a globally unique identifier is used. */
-  guid: string;
-  /** When true, the component is not displayed and is not focusable or checkable. */
-  hidden: boolean;
-  /**
-   * The hovered state of the component.
-   *
-   * @internal
-   */
-  hovered: boolean;
-  /**
-   * Accessible name for the component.
-   *
-   * @internal
-   */
-  label?: string;
-  /** Specifies the name of the component, passed from the `calcite-radio-button-group` on form submission. */
-  name: string;
-  nameChanged(): void;
-  /** When true, the component must have a value selected from the `calcite-radio-button-group` on form submission. */
-  required: boolean;
-  /** Specifies the size of the component inherited from the `calcite-radio-button-group`. */
-  scale: Scale;
-  /** The component's value. */
-  value: any;
-  labelEl: HTMLCalciteLabelElement;
-  formEl: HTMLFormElement;
-  defaultChecked: boolean;
-  defaultValue: RadioButton["value"];
-  rootNode: HTMLElement;
-  containerEl: HTMLDivElement;
-  /** Sets focus on the component. */
-  setFocus(): Promise<void>;
-  selectItem: (items: HTMLCalciteRadioButtonElement[], selectedIndex: number) => void;
-  queryButtons: () => HTMLCalciteRadioButtonElement[];
-  isDefaultSelectable: () => boolean;
-  check: () => void;
-  private clickHandler;
-  onLabelClick(event: CustomEvent): void;
-  private checkLastRadioButton;
-  /** @internal */
-  emitCheckedChange(): Promise<void>;
-  private setContainerEl;
-  private uncheckAllRadioButtonsInGroup;
-  private uncheckOtherRadioButtonsInGroup;
-  private getTabIndex;
-  /**
-   * Fires when the radio button is blurred.
-   *
-   * @internal
-   */
-  calciteInternalRadioButtonBlur: EventEmitter<void>;
-  /**
-   * Fires only when the radio button is checked.  This behavior is identical to the native HTML input element.
-   * Since this event does not fire when the radio button is unchecked, it's not recommended to attach a listener for this event
-   * directly on the element, but instead either attach it to a node that contains all of the radio buttons in the group
-   * or use the calciteRadioButtonGroupChange event if using this with calcite-radio-button-group.
-   */
-  calciteRadioButtonChange: EventEmitter<void>;
-  /**
-   * 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<void>;
-  /**
-   * Fires when the radio button is focused.
-   *
-   * @internal
-   */
-  calciteInternalRadioButtonFocus: EventEmitter<void>;
-  mouseenter(): void;
-  mouseleave(): void;
-  handleKeyDown: (event: KeyboardEvent) => void;
-  private onContainerBlur;
-  private onContainerFocus;
-  connectedCallback(): void;
-  componentDidLoad(): void;
-  disconnectedCallback(): void;
-  componentDidRender(): void;
-  render(): VNode;
-}
+import { EventEmitter, VNode } from "../../stencil-public-runtime";
+import { Scale } from "../interfaces";
+import { LabelableComponent } from "../../utils/label";
+import { CheckableFormComponent } from "../../utils/form";
+import { InteractiveComponent } from "../../utils/interactive";
+export declare class RadioButton implements LabelableComponent, CheckableFormComponent, InteractiveComponent {
+  el: HTMLCalciteRadioButtonElement;
+  /** When true, the component is checked. */
+  checked: boolean;
+  checkedChanged(newChecked: boolean): void;
+  /** When true, interaction is prevented and the component is displayed with lower opacity. */
+  disabled: boolean;
+  /**
+   * The focused state of the component.
+   *
+   * @internal
+   */
+  focused: boolean;
+  /** The id attribute of the component. When omitted, a globally unique identifier is used. */
+  guid: string;
+  /** When true, the component is not displayed and is not focusable or checkable. */
+  hidden: boolean;
+  /**
+   * The hovered state of the component.
+   *
+   * @internal
+   */
+  hovered: boolean;
+  /**
+   * Accessible name for the component.
+   *
+   * @internal
+   */
+  label?: string;
+  /** Specifies the name of the component, passed from the `calcite-radio-button-group` on form submission. */
+  name: string;
+  nameChanged(): void;
+  /** When true, the component must have a value selected from the `calcite-radio-button-group` on form submission. */
+  required: boolean;
+  /** Specifies the size of the component inherited from the `calcite-radio-button-group`. */
+  scale: Scale;
+  /** The component's value. */
+  value: any;
+  labelEl: HTMLCalciteLabelElement;
+  formEl: HTMLFormElement;
+  defaultChecked: boolean;
+  defaultValue: RadioButton["value"];
+  rootNode: HTMLElement;
+  containerEl: HTMLDivElement;
+  /** Sets focus on the component. */
+  setFocus(): Promise<void>;
+  selectItem: (items: HTMLCalciteRadioButtonElement[], selectedIndex: number) => void;
+  queryButtons: () => HTMLCalciteRadioButtonElement[];
+  isDefaultSelectable: () => boolean;
+  check: () => void;
+  private clickHandler;
+  onLabelClick(event: CustomEvent): void;
+  private checkLastRadioButton;
+  /** @internal */
+  emitCheckedChange(): Promise<void>;
+  private setContainerEl;
+  private uncheckAllRadioButtonsInGroup;
+  private uncheckOtherRadioButtonsInGroup;
+  private getTabIndex;
+  /**
+   * Fires when the radio button is blurred.
+   *
+   * @internal
+   */
+  calciteInternalRadioButtonBlur: EventEmitter<void>;
+  /**
+   * Fires only when the radio button is checked.  This behavior is identical to the native HTML input element.
+   * Since this event does not fire when the radio button is unchecked, it's not recommended to attach a listener for this event
+   * directly on the element, but instead either attach it to a node that contains all of the radio buttons in the group
+   * or use the calciteRadioButtonGroupChange event if using this with calcite-radio-button-group.
+   */
+  calciteRadioButtonChange: EventEmitter<void>;
+  /**
+   * 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<void>;
+  /**
+   * Fires when the radio button is focused.
+   *
+   * @internal
+   */
+  calciteInternalRadioButtonFocus: EventEmitter<void>;
+  mouseenter(): void;
+  mouseleave(): void;
+  handleKeyDown: (event: KeyboardEvent) => void;
+  private onContainerBlur;
+  private onContainerFocus;
+  connectedCallback(): void;
+  componentDidLoad(): void;
+  disconnectedCallback(): void;
+  componentDidRender(): void;
+  render(): VNode;
+}