@esri/calcite-components 1.0.0-next.606 → 1.0.0-next.608

package/dist/esm/{utils-703b7ab8.js → utils-fc240fcd.js}

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.606
+ * v1.0.0-next.608
  */
 function rgbToHex(color) {
   const { r, g, b } = color;

package/dist/extras/docs-json.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2022-10-24T16:41:19",
+  "timestamp": "2022-10-25T01:32:42",
   "compiler": {
     "name": "@stencil/core",
     "version": "2.18.1",
@@ -5687,10 +5687,15 @@
             "type": "Promise<void>",
             "docs": ""
           },
-          "signature": "reposition() => Promise<void>",
+          "signature": "reposition(delayed?: boolean) => Promise<void>",
           "parameters": [],
           "docs": "Updates the position of the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "delayed"
+            }
+          ]
         },
         {
           "name": "setFocus",
@@ -7655,10 +7660,15 @@
             "type": "Promise<void>",
             "docs": ""
           },
-          "signature": "reposition() => Promise<void>",
+          "signature": "reposition(delayed?: boolean) => Promise<void>",
           "parameters": [],
           "docs": "Updates the position of the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "delayed"
+            }
+          ]
         }
       ],
       "events": [
@@ -11334,10 +11344,15 @@
             "type": "Promise<void>",
             "docs": ""
           },
-          "signature": "reposition() => Promise<void>",
+          "signature": "reposition(delayed?: boolean) => Promise<void>",
           "parameters": [],
           "docs": "Updates the position of the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "delayed"
+            }
+          ]
         },
         {
           "name": "setFocus",
@@ -11503,8 +11518,18 @@
           "attr": "active",
           "reflectToAttr": true,
           "docs": "When `true`, the component is active.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use global `hidden` attribute instead."
+            },
+            {
+              "name": "mdn",
+              "text": "[hidden](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/hidden)"
+            }
+          ],
           "default": "false",
+          "deprecation": "use global `hidden` attribute instead.",
           "values": [
             {
               "type": "boolean"
@@ -13424,10 +13449,15 @@
             "type": "Promise<void>",
             "docs": ""
           },
-          "signature": "reposition() => Promise<void>",
+          "signature": "reposition(delayed?: boolean) => Promise<void>",
           "parameters": [],
           "docs": "Updates the position of the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "delayed"
+            }
+          ]
         },
         {
           "name": "setFocus",
@@ -14266,8 +14296,18 @@
           "attr": "active",
           "reflectToAttr": true,
           "docs": "When `true`, the component is active.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use global `hidden` attribute instead."
+            },
+            {
+              "name": "mdn",
+              "text": "[hidden](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/hidden)"
+            }
+          ],
           "default": "false",
+          "deprecation": "use global `hidden` attribute instead.",
           "values": [
             {
               "type": "boolean"
@@ -17350,10 +17390,15 @@
             "type": "Promise<void>",
             "docs": ""
           },
-          "signature": "reposition() => Promise<void>",
+          "signature": "reposition(delayed?: boolean) => Promise<void>",
           "parameters": [],
           "docs": "Updates the position of the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "delayed"
+            }
+          ]
         },
         {
           "name": "setFocus",
@@ -23575,10 +23620,15 @@
             "type": "Promise<void>",
             "docs": ""
           },
-          "signature": "reposition() => Promise<void>",
+          "signature": "reposition(delayed?: boolean) => Promise<void>",
           "parameters": [],
           "docs": "Updates the position of the component.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "param",
+              "text": "delayed"
+            }
+          ]
         }
       ],
       "events": [],

package/dist/loader/cdn.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.606
+ * v1.0.0-next.608
  */
 module.exports = require('../cjs/loader.cjs.js');
 module.exports.applyPolyfills = function() { return Promise.resolve() };

package/dist/loader/index.cjs.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.606
+ * v1.0.0-next.608
  */
 module.exports = require('../cjs/loader.cjs.js');
 module.exports.applyPolyfills = function() { return Promise.resolve() };

package/dist/loader/index.es2017.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.606
+ * v1.0.0-next.608
  */
 export * from '../esm/polyfills/index.js';
 export * from '../esm/loader.js';

package/dist/loader/index.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.606
+ * v1.0.0-next.608
  */
 (function(){if("undefined"!==typeof window&&void 0!==window.Reflect&&void 0!==window.customElements){var a=HTMLElement;window.HTMLElement=function(){return Reflect.construct(a,[],this.constructor)};HTMLElement.prototype=a.prototype;HTMLElement.prototype.constructor=HTMLElement;Object.setPrototypeOf(HTMLElement,a)}})();
 export * from '../esm/polyfills/index.js';

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

@@ -82,8 +82,12 @@ export declare class Combobox implements LabelableComponent, FormComponent, Inte
   flipPlacementsHandler(): void;
   documentClickHandler(event: PointerEvent): void;
   calciteComboboxItemChangeHandler(event: CustomEvent<HTMLCalciteComboboxItemElement>): void;
-  /** Updates the position of the component. */
-  reposition(): Promise<void>;
+  /**
+   * Updates the position of the component.
+   *
+   * @param delayed
+   */
+  reposition(delayed?: boolean): Promise<void>;
   /** Sets focus on the component. */
   setFocus(): Promise<void>;
   /**
@@ -152,7 +156,6 @@ export declare class Combobox implements LabelableComponent, FormComponent, Inte
   private ignoreSelectedEventsFlag;
   openTransitionProp: string;
   transitionEl: HTMLDivElement;
-  private debouncedReposition;
   setFilteredPlacements: () => void;
   getValue: () => string | string[];
   onLabelClick: () => void;

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

@@ -74,8 +74,12 @@ export declare class Dropdown implements InteractiveComponent, OpenCloseComponen
   componentDidRender(): void;
   disconnectedCallback(): void;
   render(): VNode;
-  /** Updates the position of the component. */
-  reposition(): Promise<void>;
+  /**
+   * Updates the position of the component.
+   *
+   * @param delayed
+   */
+  reposition(delayed?: boolean): Promise<void>;
   /** fires when a dropdown item has been selected or deselected */
   calciteDropdownSelect: EventEmitter<Selection>;
   /** Fires when the component is requested to be closed and before the closing transition begins. */
@@ -107,7 +111,6 @@ export declare class Dropdown implements InteractiveComponent, OpenCloseComponen
   transitionEl: HTMLDivElement;
   guid: string;
   defaultAssignedElements: Element[];
-  private debouncedReposition;
   slotChangeHandler: (event: Event) => void;
   setFilteredPlacements: () => void;
   updateTriggers: (event: Event) => void;

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

@@ -174,8 +174,12 @@ export declare class InputDatePicker implements LabelableComponent, FormComponen
   calciteInputDatePickerOpen: EventEmitter<void>;
   /** Sets focus on the component. */
   setFocus(): Promise<void>;
-  /** Updates the position of the component. */
-  reposition(): Promise<void>;
+  /**
+   * Updates the position of the component.
+   *
+   * @param delayed
+   */
+  reposition(delayed?: boolean): Promise<void>;
   connectedCallback(): void;
   componentWillLoad(): Promise<void>;
   componentDidLoad(): void;
@@ -199,7 +203,6 @@ export declare class InputDatePicker implements LabelableComponent, FormComponen
   openTransitionProp: string;
   transitionEl: HTMLDivElement;
   setReferenceEl(): void;
-  private debouncedReposition;
   setFilteredPlacements: () => void;
   private setTransitionEl;
   onLabelClick(): void;

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

@@ -5,7 +5,12 @@ import { Scale, Status } from "../interfaces";
  */
 export declare class InputMessage {
   el: HTMLCalciteInputMessageElement;
-  /** When `true`, the component is active. */
+  /**
+   * When `true`, the component is active.
+   *
+   * @deprecated use global `hidden` attribute instead.
+   * @mdn [hidden](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/hidden)
+   */
   active: boolean;
   /** Specifies an icon to display. */
   icon: boolean | string;

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

@@ -119,8 +119,12 @@ export declare class InputTimePicker implements LabelableComponent, FormComponen
   timePickerFocusHandler(event: CustomEvent): void;
   /** Sets focus on the component. */
   setFocus(): Promise<void>;
-  /** Updates the position of the component. */
-  reposition(): Promise<void>;
+  /**
+   * Updates the position of the component.
+   *
+   * @param delayed
+   */
+  reposition(delayed?: boolean): Promise<void>;
   keyDownHandler: (event: KeyboardEvent) => void;
   onLabelClick(): void;
   private shouldIncludeSeconds;

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

@@ -2,7 +2,12 @@ import { VNode } from "../../stencil-public-runtime";
 import { Scale } from "../interfaces";
 export declare class Loader {
   el: HTMLCalciteLoaderElement;
-  /** When `true`, the component is active. */
+  /**
+   * When `true`, the component is active.
+   *
+   * @deprecated use global `hidden` attribute instead.
+   * @mdn [hidden](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/hidden)
+   */
   active: boolean;
   /** When `true`, displays smaller and appears to the left of the text. */
   inline: boolean;

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

@@ -65,7 +65,7 @@ export declare class Popover implements FloatingUIComponent, OpenCloseComponent
    * When `true`, displays and positions the component.
    */
   open: boolean;
-  openHandler(): void;
+  openHandler(value: boolean): void;
   /**
    * Determines the type of positioning to use for the overlaid content.
    *
@@ -120,8 +120,12 @@ export declare class Popover implements FloatingUIComponent, OpenCloseComponent
   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>;
+  /**
+   * Updates the position of the component.
+   *
+   * @param delayed
+   */
+  reposition(delayed?: boolean): Promise<void>;
   /**
    * Sets focus on the component.
    *
@@ -134,7 +138,6 @@ export declare class Popover implements FloatingUIComponent, OpenCloseComponent
    * @param value
    */
   toggle(value?: boolean): Promise<void>;
-  private debouncedReposition;
   private setTransitionEl;
   setFilteredPlacements: () => void;
   setUpReferenceElement: (warn?: boolean) => void;

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

@@ -24,7 +24,7 @@ export declare class Tooltip implements FloatingUIComponent {
    * When `true`, the component is open.
    */
   open: boolean;
-  openHandler(): void;
+  openHandler(value: boolean): void;
   /**
    * Determines the type of positioning to use for the overlaid content.
    *
@@ -59,9 +59,12 @@ export declare class Tooltip implements FloatingUIComponent {
   connectedCallback(): void;
   componentDidLoad(): void;
   disconnectedCallback(): void;
-  /** Updates the position of the component. */
-  reposition(): Promise<void>;
-  private debouncedReposition;
+  /**
+   * Updates the position of the component.
+   *
+   * @param delayed
+   */
+  reposition(delayed?: boolean): Promise<void>;
   setUpReferenceElement: (warn?: boolean) => void;
   getId: () => string;
   addReferences: () => void;

package/dist/types/components.d.ts

@@ -942,8 +942,9 @@ export namespace Components {
         "placeholderIcon"?: string;
         /**
           * Updates the position of the component.
+          * @param delayed
          */
-        "reposition": () => Promise<void>;
+        "reposition": (delayed?: boolean) => Promise<void>;
         /**
           * When `true`, the component must have a value in order for the form to submit.
          */
@@ -1281,8 +1282,9 @@ export namespace Components {
         "placement": MenuPlacement;
         /**
           * Updates the position of the component.
+          * @param delayed
          */
-        "reposition": () => Promise<void>;
+        "reposition": (delayed?: boolean) => Promise<void>;
         /**
           * specify the scale of dropdown, defaults to m
          */
@@ -1889,8 +1891,9 @@ export namespace Components {
         "readOnly": boolean;
         /**
           * Updates the position of the component.
+          * @param delayed
          */
-        "reposition": () => Promise<void>;
+        "reposition": (delayed?: boolean) => Promise<void>;
         /**
           * When `true`, the component must have a value in order for the form to submit.
          */
@@ -1925,6 +1928,8 @@ export namespace Components {
     interface CalciteInputMessage {
         /**
           * When `true`, the component is active.
+          * @deprecated use global `hidden` attribute instead.
+          * @mdn [hidden](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/hidden)
          */
         "active": boolean;
         /**
@@ -2290,8 +2295,9 @@ export namespace Components {
         "readOnly": boolean;
         /**
           * Updates the position of the component.
+          * @param delayed
          */
-        "reposition": () => Promise<void>;
+        "reposition": (delayed?: boolean) => Promise<void>;
         /**
           * When `true`, the component must have a value in order for the form to submit.
          */
@@ -2433,6 +2439,8 @@ export namespace Components {
     interface CalciteLoader {
         /**
           * When `true`, the component is active.
+          * @deprecated use global `hidden` attribute instead.
+          * @mdn [hidden](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/hidden)
          */
         "active": boolean;
         /**
@@ -2929,8 +2937,9 @@ export namespace Components {
         "referenceElement": ReferenceElement | string;
         /**
           * Updates the position of the component.
+          * @param delayed
          */
-        "reposition": () => Promise<void>;
+        "reposition": (delayed?: boolean) => Promise<void>;
         /**
           * Sets focus on the component.
           * @param focusId
@@ -4001,8 +4010,9 @@ export namespace Components {
         "referenceElement": ReferenceElement | string;
         /**
           * Updates the position of the component.
+          * @param delayed
          */
-        "reposition": () => Promise<void>;
+        "reposition": (delayed?: boolean) => Promise<void>;
     }
     interface CalciteTooltipManager {
         /**
@@ -7053,6 +7063,8 @@ declare namespace LocalJSX {
     interface CalciteInputMessage {
         /**
           * When `true`, the component is active.
+          * @deprecated use global `hidden` attribute instead.
+          * @mdn [hidden](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/hidden)
          */
         "active"?: boolean;
         /**
@@ -7533,6 +7545,8 @@ declare namespace LocalJSX {
     interface CalciteLoader {
         /**
           * When `true`, the component is active.
+          * @deprecated use global `hidden` attribute instead.
+          * @mdn [hidden](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/hidden)
          */
         "active"?: boolean;
         /**

package/dist/types/utils/config.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This module helps users provide custom configuration for component internals.
+ *
+ * @internal
+ */
+declare const config: any;
+export { config };

package/dist/types/utils/floating-ui/nonChromiumPlatformUtils.d.ts

@@ -0,0 +1,16 @@
+import { Strategy } from "@floating-ui/core";
+import type { ElementRects } from "@floating-ui/dom";
+import { FloatingElement, ReferenceElement } from "@floating-ui/dom/src/types";
+declare function getElementRects(_ref: {
+  reference: ReferenceElement;
+  floating: FloatingElement;
+  strategy: Strategy;
+}): ElementRects;
+export { getClippingRect, getElementRects, getOffsetParent };
+declare function getOffsetParent(element: any): any;
+declare function getClippingRect(_ref: any): {
+  width: number;
+  height: number;
+  x: any;
+  y: any;
+};

package/dist/types/utils/floating-ui.d.ts

@@ -1,4 +1,7 @@
 import { Placement, Strategy, VirtualElement } from "@floating-ui/dom";
+/**
+ * Exported for testing purposes only
+ */
 export declare const repositionDebounceTimeout = 100;
 export declare type ReferenceElement = VirtualElement | Element;
 declare type UIType = "menu" | "tooltip" | "popover";
@@ -57,8 +60,10 @@ export interface FloatingUIComponent {
   placement: LogicalPlacement;
   /**
    * Updates the position of the component.
+   *
+   * @param delayed – (internal) when true, it will reposition the component after a delay. the default is false. This is useful for components that have multiple watched properties that schedule repositioning.
    */
-  reposition(): Promise<void>;
+  reposition(delayed?: boolean): Promise<void>;
 }
 export declare const FloatingCSS: {
   animation: string;
@@ -66,9 +71,31 @@ export declare const FloatingCSS: {
 };
 export declare function filterComputedPlacements(placements: string[], el: HTMLElement): EffectivePlacement[];
 export declare function getEffectivePlacement(floatingEl: HTMLElement, placement: LogicalPlacement): EffectivePlacement;
+/**
+ * Convenience function to manage `reposition` calls for FloatingUIComponents that use `positionFloatingUI.
+ *
+ * Note: this is not needed for components that use `calcite-popover`.
+ *
+ * @param component
+ * @param options
+ * @param options.referenceEl
+ * @param options.floatingEl
+ * @param options.overlayPositioning
+ * @param options.placement
+ * @param options.disableFlip
+ * @param options.flipPlacements
+ * @param options.offsetDistance
+ * @param options.offsetSkidding
+ * @param options.arrowEl
+ * @param options.type
+ * @param delayed
+ */
+export declare function reposition(component: FloatingUIComponent, options: Parameters<typeof positionFloatingUI>[0], delayed?: boolean): Promise<void>;
 /**
  * Positions the floating element relative to the reference element.
  *
+ * **Note:** exported for testing purposes only
+ *
  * @param root0
  * @param root0.referenceEl
  * @param root0.floatingEl
@@ -80,8 +107,9 @@ export declare function getEffectivePlacement(floatingEl: HTMLElement, placement
  * @param root0.offsetSkidding
  * @param root0.arrowEl
  * @param root0.type
+ * @param root0.includeArrow
  */
-export declare function positionFloatingUI({ referenceEl, floatingEl, overlayPositioning, placement, disableFlip, flipPlacements, offsetDistance, offsetSkidding, arrowEl, type }: {
+export declare function positionFloatingUI({ referenceEl, floatingEl, overlayPositioning, placement, disableFlip, flipPlacements, offsetDistance, offsetSkidding, includeArrow, arrowEl, type }: {
   referenceEl: ReferenceElement;
   floatingEl: HTMLElement;
   overlayPositioning: Strategy;
@@ -91,8 +119,15 @@ export declare function positionFloatingUI({ referenceEl, floatingEl, overlayPos
   offsetDistance?: number;
   offsetSkidding?: number;
   arrowEl?: HTMLElement;
+  includeArrow?: boolean;
   type: UIType;
 }): Promise<void>;
+/**
+ * Exported for testing purposes only
+ *
+ * @internal
+ */
+export declare const cleanupMap: WeakMap<FloatingUIComponent, () => void>;
 /**
  * Helper to set up floating element interactions on connectedCallback.
  *
@@ -115,4 +150,12 @@ export declare function disconnectFloatingUI(component: FloatingUIComponent, ref
  * @default 6
  */
 export declare const defaultOffsetDistance: number;
+/**
+ * This utils applies floating element styles to avoid affecting layout when closed.
+ *
+ * This should be called when the closing transition will start.
+ *
+ * @param floatingEl
+ */
+export declare function updateAfterClose(floatingEl: HTMLElement): void;
 export {};