@esri/calcite-components 1.0.0-next.605 → 1.0.0-next.607

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 {};