@zanichelli/albe-web-components 18.6.1 → 18.6.3-RC

package/dist/components/index23.js

@@ -1,94 +1,10 @@
 import { proxyCustomElement, HTMLElement, createEvent, h, Host } from '@stencil/core/internal/client';
-import { P as PopoverPosition, g as KeyboardCode } from './index2.js';
+import { P as PopoverPosition, g as KeyboardCode, p as Device } from './index2.js';
+import { a as containsElement, i as findScrollableParent, g as getDevice, j as isElementVisibleInContainer } from './utils.js';
 
-const stylesCss = ":host{position:absolute;display:none;min-width:calc(var(--space-unit) * 8);max-width:100%;min-height:calc(var(--space-unit) * 4);max-height:100%;align-items:center;justify-content:center;padding:var(--z-popover-padding, 0);background:var(--z-popover-theme--surface, var(--color-surface01));border-radius:var(--border-radius-small);color:var(--z-popover-theme--text, var(--color-default-text));fill:currentcolor;filter:var(--z-popover-shadow-filter, drop-shadow(0 1px 2px var(--shadow-color-base)));font-family:var(--font-family-sans);text-align:center}:host([open]:not([current-position])){visibility:hidden}:host([open][current-position]),:host([open=\"true\"][current-position]){display:flex}:host([center][current-position=\"top\"]),:host([center][current-position=\"bottom\"]){transform:translateX(-50%)}:host([center][current-position=\"right\"]),:host([center][current-position=\"left\"]){transform:translateY(-50%)}:host([current-position^=\"top\"]){margin:0 0 var(--space-unit)}:host([current-position^=\"bottom\"]){margin:var(--space-unit) 0 0}:host([current-position^=\"left\"]){margin:0 var(--space-unit) 0 0}:host([current-position^=\"right\"]){margin:0 0 0 var(--space-unit)}:host([current-position])::before{--arrow-size:6px;--arrow-edge-offset:calc(100% - var(--space-unit) - (var(--arrow-size) / 2));--arrow-center-x-offset:calc(50% - (var(--arrow-size) / 2));--arrow-center-y-offset:calc(100% - (var(--arrow-size) / 2));position:absolute;display:block;width:var(--arrow-size);height:var(--arrow-size);background:var(--z-popover-theme--surface, var(--color-surface01));content:\"\";transform:rotate(45deg)}:host([show-arrow=\"false\"])::before,:host(:not([show-arrow]))::before{display:none}:host([current-position^=\"top\"])::before{top:var(--arrow-center-y-offset)}:host([current-position^=\"bottom\"])::before{bottom:var(--arrow-center-y-offset)}:host([current-position=\"top\"])::before,:host([current-position=\"bottom\"])::before{right:var(--arrow-edge-offset)}:host([current-position=\"right\"])::before,:host([current-position=\"left\"])::before{bottom:var(--arrow-edge-offset)}:host([current-position=\"right\"])::before{right:var(--arrow-center-y-offset)}:host([current-position=\"left\"])::before{left:var(--arrow-center-y-offset)}:host([current-position=\"top_right\"])::before,:host([current-position=\"bottom_right\"])::before{right:var(--arrow-edge-offset)}:host([current-position=\"top_left\"])::before,:host([current-position=\"bottom_left\"])::before{left:var(--arrow-edge-offset)}:host([current-position=\"right_top\"])::before,:host([current-position=\"left_top\"])::before{top:var(--arrow-edge-offset)}:host([current-position=\"right_top\"])::before,:host([current-position=\"right_bottom\"])::before{right:var(--arrow-center-y-offset)}:host([current-position=\"left_top\"])::before,:host([current-position=\"left_bottom\"])::before{left:var(--arrow-center-y-offset)}:host([current-position=\"right_bottom\"])::before,:host([current-position=\"left_bottom\"])::before{bottom:var(--arrow-edge-offset)}:host([center][current-position=\"top\"])::before,:host([center][current-position=\"bottom\"])::before{right:auto;left:var(--arrow-center-x-offset)}:host([center][current-position=\"right\"])::before,:host([center][current-position=\"left\"])::before{top:var(--arrow-center-x-offset);bottom:auto}::slotted(*){overflow:auto;flex:1 auto}";
+const stylesCss = ":host{position:fixed;display:none;max-width:calc(100% - var(--grid-margin) * 2);max-height:calc(100% - var(--grid-margin) * 2);padding:var(--z-popover-padding, 0);background:var(--z-popover-theme--surface, var(--color-surface01));border-radius:var(--border-radius-small);color:var(--z-popover-theme--text, var(--color-default-text));fill:currentcolor;filter:var(--z-popover-shadow-filter, drop-shadow(0 1px 2px var(--shadow-color-base)));text-align:center}:host([open]:not([current-position])){visibility:hidden}:host([open][current-position]),:host([open=\"true\"][current-position]){display:block}:host([center][current-position=\"top\"]),:host([center][current-position=\"bottom\"]){transform:translateX(-50%)}:host([center][current-position=\"right\"]),:host([center][current-position=\"left\"]){transform:translateY(-50%)}:host([current-position^=\"top\"]){margin:0 0 var(--space-unit)}:host([current-position^=\"bottom\"]){margin:var(--space-unit) 0 0}:host([current-position^=\"left\"]){margin:0 var(--space-unit) 0 0}:host([current-position^=\"right\"]){margin:0 0 0 var(--space-unit)}:host([current-position])::before{--arrow-size:6px;--arrow-edge-offset:calc(100% - var(--space-unit) - (var(--arrow-size) / 2));--arrow-center-x-offset:calc(50% - (var(--arrow-size) / 2));--arrow-center-y-offset:calc(100% - (var(--arrow-size) / 2));position:absolute;display:block;width:var(--arrow-size);height:var(--arrow-size);background:var(--z-popover-theme--surface, var(--color-surface01));content:\"\";transform:rotate(45deg)}:host([show-arrow=\"false\"])::before,:host(:not([show-arrow]))::before{display:none}:host([current-position^=\"top\"])::before{top:var(--arrow-center-y-offset)}:host([current-position^=\"bottom\"])::before{bottom:var(--arrow-center-y-offset)}:host([current-position=\"top\"])::before,:host([current-position=\"bottom\"])::before{right:var(--arrow-edge-offset)}:host([current-position=\"right\"])::before,:host([current-position=\"left\"])::before{bottom:var(--arrow-edge-offset)}:host([current-position=\"right\"])::before{right:var(--arrow-center-y-offset)}:host([current-position=\"left\"])::before{left:var(--arrow-center-y-offset)}:host([current-position=\"top_right\"])::before,:host([current-position=\"bottom_right\"])::before{right:var(--arrow-edge-offset)}:host([current-position=\"top_left\"])::before,:host([current-position=\"bottom_left\"])::before{left:var(--arrow-edge-offset)}:host([current-position=\"right_top\"])::before,:host([current-position=\"left_top\"])::before{top:var(--arrow-edge-offset)}:host([current-position=\"right_top\"])::before,:host([current-position=\"right_bottom\"])::before{right:var(--arrow-center-y-offset)}:host([current-position=\"left_top\"])::before,:host([current-position=\"left_bottom\"])::before{left:var(--arrow-center-y-offset)}:host([current-position=\"right_bottom\"])::before,:host([current-position=\"left_bottom\"])::before{bottom:var(--arrow-edge-offset)}:host([center][current-position=\"top\"])::before,:host([center][current-position=\"bottom\"])::before{right:auto;left:var(--arrow-center-x-offset)}:host([center][current-position=\"right\"])::before,:host([center][current-position=\"left\"])::before{top:var(--arrow-center-x-offset);bottom:auto}";
 const ZPopoverStyle0 = stylesCss;
 
-const DOCUMENT_ELEMENT = document.documentElement;
-function getParentElement(element) {
-    if (element.parentNode === element.shadowRoot) {
-        return element.shadowRoot.host;
-    }
-    return element.parentElement;
-}
-/**
- * Find the closest scrollable parent of a node.
- *
- * @param {Element} element The node
- */
-function findScrollableParent(element) {
-    let parent = getParentElement(element);
-    while (parent && parent !== DOCUMENT_ELEMENT) {
-        const style = window.getComputedStyle(parent);
-        const { overflow, overflowX, overflowY } = style;
-        // Check for hidden overflow first (early return)
-        if (overflow === "hidden" || overflowY === "hidden" || overflowX === "hidden") {
-            return parent;
-        }
-        // Only check scrollable if overflow is not visible
-        const isOverflowNotVisible = overflow !== "visible";
-        const isOverflowYNotVisible = overflowY !== "visible";
-        const isOverflowXNotVisible = overflowX !== "visible";
-        if ((parent.scrollHeight > parent.clientHeight && isOverflowNotVisible && isOverflowYNotVisible) ||
-            (parent.scrollWidth > parent.clientWidth && isOverflowNotVisible && isOverflowXNotVisible)) {
-            return parent;
-        }
-        parent = getParentElement(parent);
-    }
-    return DOCUMENT_ELEMENT;
-}
-/**
- * Calculate computed offset.
- * It includes matrix transformations.
- * @param element The target element.
- * @param targetParentOffset The relative offset parent.
- */
-function computeOffset(element, targetParentOffset) {
-    const rect = element.getBoundingClientRect();
-    const { width, height } = rect;
-    let top = 0;
-    let left = 0;
-    let offsetParent = element;
-    while (offsetParent && offsetParent !== targetParentOffset) {
-        left += offsetParent.offsetLeft;
-        // document.body sometimes has offsetTop == 0 but still has an offset because of children margins!
-        if (offsetParent === document.body) {
-            top += offsetParent.getBoundingClientRect().top + window.scrollY;
-        }
-        else {
-            top += offsetParent.offsetTop;
-        }
-        // Handle CSS transforms only when DOMMatrix is available
-        if (window.DOMMatrix) {
-            const style = window.getComputedStyle(offsetParent);
-            const { transform } = style;
-            if (transform && transform !== "none") {
-                const domMatrix = new DOMMatrix(transform);
-                left += domMatrix.m41;
-                if (offsetParent !== document.body) {
-                    top += domMatrix.m42;
-                }
-            }
-        }
-        if (!offsetParent.offsetParent) {
-            break;
-        }
-        offsetParent = offsetParent.offsetParent;
-    }
-    let parentWidth;
-    let parentHeight;
-    if (offsetParent === document.body) {
-        parentWidth = window.innerWidth;
-        parentHeight = window.innerHeight;
-    }
-    else {
-        parentWidth = offsetParent.offsetWidth;
-        parentHeight = offsetParent.offsetHeight;
-    }
-    const right = parentWidth - left - width;
-    const bottom = parentHeight - top - height;
-    return { top, right, bottom, left, width, height };
-}
 const ZPopover = /*@__PURE__*/ proxyCustomElement(class ZPopover extends HTMLElement {
     constructor() {
         super();
@@ -96,7 +12,8 @@ const ZPopover = /*@__PURE__*/ proxyCustomElement(class ZPopover extends HTMLEle
         this.__attachShadow();
         this.positionChange = createEvent(this, "positionChange", 7);
         this.openChange = createEvent(this, "openChange", 7);
-        this.spaceTolerance = 3; // 3px tolerance for space calculations
+        /** space tolerance for space calculations */
+        this.spaceTolerance = 3;
         this.position = PopoverPosition.TOP;
         this.open = false;
         this.bindTo = undefined;
@@ -114,71 +31,97 @@ const ZPopover = /*@__PURE__*/ proxyCustomElement(class ZPopover extends HTMLEle
      * Close the popover when clicking outside of its content.
      * Stop event propagation if the click was fired by popover's trigger element,
      * to prevent close and reopen glitches.
-     * @param {MouseEvent} e
      */
     handleOutsideClick(e) {
-        if (!this.closable || !this.open) {
+        const target = e.target;
+        if (!this.closable || !this.open || containsElement(this.host, target)) {
             return;
         }
-        const eventPath = e.composedPath();
-        if (!eventPath.includes(this.host)) {
-            const target = e.target;
-            let triggerElemClicked = false;
-            if (typeof this.bindTo === "string") {
-                triggerElemClicked = !!target.closest(this.bindTo);
-            }
-            else if (this.bindTo) {
-                triggerElemClicked = this.bindTo.contains(target);
-            }
-            if (triggerElemClicked) {
-                // stop propagation if the click was on the trigger element to prevent close and reopen glitches
-                e.stopPropagation();
-            }
-            this.open = false;
-            this.positionChange.emit({ position: this.currentPosition });
+        if (containsElement(this.boundElement, target)) {
+            // stop propagation if the click was on the trigger element to prevent close and reopen glitches
+            e.stopPropagation();
         }
+        this.open = false;
     }
     validatePosition(newValue) {
         if (!Object.values(PopoverPosition).includes(newValue) || newValue === PopoverPosition.AUTO) {
             newValue = PopoverPosition.TOP;
+            this.position = newValue;
         }
-        this.position = newValue;
         this.currentPosition = newValue;
-        this.positionChange.emit({ position: this.currentPosition });
-        this.setPosition();
+        if (this.open) {
+            this.setPosition();
+        }
     }
-    /**
-     * Setup popover behaviors on opening.
-     */
+    /** Setup popover behaviors when `open` changes. */
     onOpen() {
         cancelAnimationFrame(this.animationFrameRequestId);
-        if (this.open) {
-            const setPosition = () => {
-                if (this.open) {
-                    this.setPosition();
-                    this.animationFrameRequestId = requestAnimationFrame(setPosition);
-                }
-            };
-            // call `setPosition` after a tick to ensure the DOM is ready and sizes are available
-            setTimeout(() => {
-                setPosition();
-            }, 0);
-        }
         this.openChange.emit({ open: this.open });
+        if (!this.open) {
+            return;
+        }
+        const updatePositionLoop = () => {
+            if (!this.open) {
+                return;
+            }
+            this.setPosition();
+            this.animationFrameRequestId = requestAnimationFrame(updatePositionLoop);
+        };
+        // call `setPosition` after a tick to ensure the DOM is ready and sizes are available
+        setTimeout(() => {
+            updatePositionLoop();
+        }, 0);
+    }
+    onBindingChange() {
+        this.findBoundElement();
+    }
+    /** Returns the offset modifier to use in calculations to align the popover with the bound element. */
+    get offsetModifier() {
+        return this.center ? 0.5 : 0;
+    }
+    findBoundElement() {
+        if (typeof this.bindTo === "string") {
+            this.boundElement = this.host.ownerDocument.querySelector(this.bindTo);
+        }
+        else if (this.bindTo) {
+            this.boundElement = this.bindTo;
+        }
+        else {
+            this.boundElement = this.host.parentElement;
+        }
     }
     /**
-     * Helper functions for space calculation
+     * Check if element has enough space to the right and left to be centered.
+     * Used for `TOP` and `BOTTOM` position.
+     * When `center` is not enabled, only one side needs to be checked and `RIGHT` is the default.
      */
-    hasCenteredHorizontalSpace(availableLeft, availableRight, hostWidth, boundWidth, offsetModifier) {
-        const requiredSpace = (hostWidth - boundWidth) * (1 - offsetModifier);
-        return (availableLeft >= requiredSpace - this.spaceTolerance && availableRight >= requiredSpace - this.spaceTolerance);
+    hasCenteredHorizontalSpace(availableLeft, availableRight, hostWidth, boundElementWidth) {
+        const requiredSideSpace = (hostWidth - boundElementWidth) * (1 - this.offsetModifier);
+        if (!this.center) {
+            return availableRight >= requiredSideSpace - this.spaceTolerance;
+        }
+        return (availableRight >= requiredSideSpace - this.spaceTolerance &&
+            availableLeft >= requiredSideSpace - this.spaceTolerance);
     }
-    hasCenteredVerticalSpace(availableTop, availableBottom, hostHeight, boundHeight, offsetModifier) {
-        const requiredSpace = (hostHeight - boundHeight) * (1 - offsetModifier);
-        return (availableTop >= requiredSpace - this.spaceTolerance && availableBottom >= requiredSpace - this.spaceTolerance);
+    /**
+     * Check if element has enough space to the top and bottom to be centered.
+     * Used for `RIGHT` and `LEFT` position.
+     * When `center` is not enabled, only one side needs to be checked and `BOTTOM` is the default.
+     */
+    hasCenteredVerticalSpace(availableTop, availableBottom, hostHeight, boundElementHeight) {
+        const requiredSideSpace = (hostHeight - boundElementHeight) * (1 - this.offsetModifier);
+        if (!this.center) {
+            return availableBottom >= requiredSideSpace - this.spaceTolerance;
+        }
+        return (availableTop >= requiredSideSpace - this.spaceTolerance &&
+            availableBottom >= requiredSideSpace - this.spaceTolerance);
     }
-    hasOffsetSpace(availableSpace, hostSize, boundSize, offsetModifier) {
-        return availableSpace >= hostSize - boundSize * (1 - offsetModifier) - this.spaceTolerance;
+    /**
+     * Check if there is enough space in the given direction to fit the popover.
+     * Used for composed positions like TOP_RIGHT, LEFT_BOTTOM, etc.
+     */
+    hasEnoughSideSpace(availableSpace, hostSize, boundElementSize, offsetModifier) {
+        return availableSpace >= hostSize - boundElementSize * (1 - offsetModifier) - this.spaceTolerance;
     }
     /**
      * Given a desired position and available space around the bound element, returns the best position
@@ -186,51 +129,52 @@ const ZPopover = /*@__PURE__*/ proxyCustomElement(class ZPopover extends HTMLEle
      * Takes into account offsetModifier for centering.
      * @param desiredPosition The desired position of the popover.
      * @param availableSpace The available space around the bound element.
-     * @param boundElemSizes The sizes of the bound element.
-     * @param offsetModifier The modifier to apply to the offset for centering.
      */
-    getOptimalPopoverPosition(desiredPosition, availableSpace, boundElemSizes, offsetModifier) {
+    getOptimalPopoverPosition(desiredPosition, availableSpace) {
         const hostWidth = this.host.offsetWidth;
         const hostHeight = this.host.offsetHeight;
-        // Check if the desired position has enough space
+        const boundElementWidth = this.boundElement.getBoundingClientRect().width;
+        const boundElementHeight = this.boundElement.getBoundingClientRect().height;
+        const offsetModifier = this.offsetModifier;
+        /** Check if there is enough space to fit the popover in the desired position */
         const fits = (pos) => {
             switch (pos) {
                 case PopoverPosition.TOP:
-                    return (availableSpace.top >= hostHeight &&
-                        this.hasCenteredHorizontalSpace(availableSpace.left, availableSpace.right, hostWidth, boundElemSizes.width, offsetModifier));
+                    return (availableSpace.top >= hostHeight - this.spaceTolerance &&
+                        this.hasCenteredHorizontalSpace(availableSpace.left, availableSpace.right, hostWidth, boundElementWidth));
                 case PopoverPosition.TOP_RIGHT:
                     return (availableSpace.top >= hostHeight &&
-                        this.hasOffsetSpace(availableSpace.right, hostWidth, boundElemSizes.width, offsetModifier));
+                        this.hasEnoughSideSpace(availableSpace.right, hostWidth, boundElementWidth, offsetModifier));
                 case PopoverPosition.TOP_LEFT:
                     return (availableSpace.top >= hostHeight &&
-                        this.hasOffsetSpace(availableSpace.left, hostWidth, boundElemSizes.width, offsetModifier));
+                        this.hasEnoughSideSpace(availableSpace.left, hostWidth, boundElementWidth, offsetModifier));
                 case PopoverPosition.RIGHT:
                     return (availableSpace.right >= hostWidth &&
-                        this.hasCenteredVerticalSpace(availableSpace.top, availableSpace.bottom, hostHeight, boundElemSizes.height, offsetModifier));
+                        this.hasCenteredVerticalSpace(availableSpace.top, availableSpace.bottom, hostHeight, boundElementHeight));
                 case PopoverPosition.RIGHT_BOTTOM:
                     return (availableSpace.right >= hostWidth &&
-                        this.hasOffsetSpace(availableSpace.bottom, hostHeight, boundElemSizes.height, offsetModifier));
+                        this.hasEnoughSideSpace(availableSpace.bottom, hostHeight, boundElementHeight, offsetModifier));
                 case PopoverPosition.RIGHT_TOP:
                     return (availableSpace.right >= hostWidth &&
-                        this.hasOffsetSpace(availableSpace.top, hostHeight, boundElemSizes.height, offsetModifier));
+                        this.hasEnoughSideSpace(availableSpace.top, hostHeight, boundElementHeight, offsetModifier));
                 case PopoverPosition.BOTTOM:
                     return (availableSpace.bottom >= hostHeight &&
-                        this.hasCenteredHorizontalSpace(availableSpace.left, availableSpace.right, hostWidth, boundElemSizes.width, offsetModifier));
+                        this.hasCenteredHorizontalSpace(availableSpace.left, availableSpace.right, hostWidth, boundElementWidth));
                 case PopoverPosition.BOTTOM_LEFT:
                     return (availableSpace.bottom >= hostHeight &&
-                        this.hasOffsetSpace(availableSpace.left, hostWidth, boundElemSizes.width, offsetModifier));
+                        this.hasEnoughSideSpace(availableSpace.left, hostWidth, boundElementWidth, offsetModifier));
                 case PopoverPosition.BOTTOM_RIGHT:
                     return (availableSpace.bottom >= hostHeight &&
-                        this.hasOffsetSpace(availableSpace.right, hostWidth, boundElemSizes.width, offsetModifier));
+                        this.hasEnoughSideSpace(availableSpace.right, hostWidth, boundElementWidth, offsetModifier));
                 case PopoverPosition.LEFT:
                     return (availableSpace.left >= hostWidth &&
-                        this.hasCenteredVerticalSpace(availableSpace.top, availableSpace.bottom, hostHeight, boundElemSizes.height, offsetModifier));
+                        this.hasCenteredVerticalSpace(availableSpace.top, availableSpace.bottom, hostHeight, boundElementHeight));
                 case PopoverPosition.LEFT_TOP:
                     return (availableSpace.left >= hostWidth &&
-                        this.hasOffsetSpace(availableSpace.top, hostHeight, boundElemSizes.height, offsetModifier));
+                        this.hasEnoughSideSpace(availableSpace.top, hostHeight, boundElementHeight, offsetModifier));
                 case PopoverPosition.LEFT_BOTTOM:
                     return (availableSpace.left >= hostWidth &&
-                        this.hasOffsetSpace(availableSpace.bottom, hostHeight, boundElemSizes.height, offsetModifier));
+                        this.hasEnoughSideSpace(availableSpace.bottom, hostHeight, boundElementHeight, offsetModifier));
                 default:
                     return false;
             }
@@ -256,27 +200,25 @@ const ZPopover = /*@__PURE__*/ proxyCustomElement(class ZPopover extends HTMLEle
         // If no position fits, find the best fallback based on available space
         return this.findBestFallbackPosition(availableSpace);
     }
-    /**
-     * Find the best fallback position based on available space when no position fits perfectly
-     */
+    /** Find the best fallback position based on available space when no position fits perfectly. */
     findBestFallbackPosition(availableSpace) {
-        // Determine the directions with the most space
+        // Determine which horizontal and vertical direction has the most available space
         const bestHorizontalDirection = availableSpace.right >= availableSpace.left ? PopoverPosition.RIGHT : PopoverPosition.LEFT;
         const bestVerticalDirection = availableSpace.bottom >= availableSpace.top ? PopoverPosition.BOTTOM : PopoverPosition.TOP;
-        // Choose the main direction based on which has more space
+        // Choose the main direction based on which axis has more space overall
         const maxHorizontalSpace = Math.max(availableSpace.right, availableSpace.left);
         const maxVerticalSpace = Math.max(availableSpace.bottom, availableSpace.top);
         const mainDirection = maxVerticalSpace >= maxHorizontalSpace ? bestVerticalDirection : bestHorizontalDirection;
-        // Check if secondary direction is necessary
-        // Only add secondary direction if the difference between min and max in that direction is at least double
+        // Decide if a secondary direction is needed
+        // Only add a secondary direction if the difference between min and max in that axis is at least double
         let needsSecondaryDirection = false;
         if (mainDirection === bestVerticalDirection) {
-            // Main direction is vertical, check horizontal space difference
+            // If main direction is vertical, check horizontal space difference
             const minHorizontalSpace = Math.min(availableSpace.right, availableSpace.left);
             needsSecondaryDirection = maxHorizontalSpace >= minHorizontalSpace * 2;
         }
         else {
-            // Main direction is horizontal, check vertical space difference
+            // If main direction is horizontal, check vertical space difference
             const minVerticalSpace = Math.min(availableSpace.bottom, availableSpace.top);
             needsSecondaryDirection = maxVerticalSpace >= minVerticalSpace * 2;
         }
@@ -284,169 +226,194 @@ const ZPopover = /*@__PURE__*/ proxyCustomElement(class ZPopover extends HTMLEle
             return mainDirection;
         }
         const secondaryDirection = mainDirection === bestVerticalDirection ? bestHorizontalDirection : bestVerticalDirection;
-        // Create a combined position (e.g., "bottom_right")
+        // Return a combined position (e.g., "bottom_right")
         return `${mainDirection}_${secondaryDirection}`;
     }
     /**
-     * Calculate available space around the bound element
+     * Calculate available space around the element bound with the popover, based on its nearest scrollable ancestor.
+     *
+     * Calculations for `right` and `bottom` can be a little bit confusing because `boundingRect.right` and `bottom` may not be what you expect...
+     * For more information see the explanation in the docs.
+     * @link https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect#return_value
      */
-    calculateAvailableSpace(boundElementRect, scrollContainer, scrollingBoundingRect) {
-        const top = boundElementRect.top - scrollContainer.scrollTop;
-        const bottom = scrollingBoundingRect.height - (boundElementRect.top + boundElementRect.height) + scrollContainer.scrollTop;
-        const left = boundElementRect.left - scrollContainer.scrollLeft;
-        const right = scrollingBoundingRect.width - (boundElementRect.left + boundElementRect.width) + scrollContainer.scrollLeft;
-        const overflowBottom = Math.max(0, scrollingBoundingRect.top + scrollingBoundingRect.height - window.innerHeight);
-        const overflowRight = Math.max(0, scrollingBoundingRect.left + scrollingBoundingRect.width - window.innerWidth);
-        return {
-            top: Math.min(top, top + scrollingBoundingRect.top),
-            bottom: Math.min(bottom, bottom - overflowBottom),
-            left: Math.min(left, left + scrollingBoundingRect.left),
-            right: Math.min(right, right - overflowRight),
+    calculateAvailableSpace() {
+        const boundElementRect = this.boundElement.getBoundingClientRect();
+        if (this.lastBoundRect &&
+            this.lastBoundRect.x === boundElementRect.x &&
+            this.lastBoundRect.y === boundElementRect.y &&
+            this.lastBoundRect.width === boundElementRect.width &&
+            this.lastBoundRect.height === boundElementRect.height &&
+            this.cachedAvailableSpace) {
+            // If the bound element's rect hasn't changed, return the cached rect
+            return this.cachedAvailableSpace;
+        }
+        this.lastBoundRect = boundElementRect;
+        const scrollableParent = findScrollableParent(this.boundElement);
+        const scrollableParentRect = scrollableParent.getBoundingClientRect();
+        const hasNestedScrollableParent = scrollableParent !== this.boundElement.ownerDocument.documentElement;
+        const documentWidth = this.boundElement.ownerDocument.documentElement.clientWidth;
+        const documentHeight = this.boundElement.ownerDocument.documentElement.clientHeight;
+        const safeSpace = 8; // extra space to avoid popover being too close to the edges
+        // These deltas represent the offset between the scrollable parent and the viewport.
+        // They are used to adjust the available space calculations when the scrollable parent is not the document or body,
+        // to try to fit the popover inside the scrollable parent.
+        const deltaTop = hasNestedScrollableParent ? scrollableParentRect.top : 0;
+        const deltaRight = hasNestedScrollableParent ? documentWidth - scrollableParentRect.right : 0;
+        const deltaBottom = hasNestedScrollableParent ? documentHeight - scrollableParentRect.bottom : 0;
+        const deltaLeft = hasNestedScrollableParent ? scrollableParentRect.left : 0;
+        this.cachedAvailableSpace = {
+            top: boundElementRect.top - deltaTop - safeSpace,
+            right: documentWidth - boundElementRect.right - deltaRight - safeSpace,
+            bottom: documentHeight - boundElementRect.bottom - deltaBottom - safeSpace,
+            left: boundElementRect.left - deltaLeft - safeSpace,
         };
+        return this.cachedAvailableSpace;
     }
-    /**
-     * Calculate relative offsets for positioning
-     */
-    calculateRelativeOffsets(boundElementRect, relativeBoundingRect) {
+    /** Calculate the space around an element relative to the viewport. */
+    calculateElementOffsets(element) {
+        const elementRect = element.getBoundingClientRect();
+        const viewportWidth = element.ownerDocument.documentElement.clientWidth;
+        const viewportHeight = element.ownerDocument.documentElement.clientHeight;
         return {
-            top: boundElementRect.top - relativeBoundingRect.top,
-            right: boundElementRect.right - relativeBoundingRect.right,
-            bottom: boundElementRect.bottom - relativeBoundingRect.bottom,
-            left: boundElementRect.left - relativeBoundingRect.left,
+            top: elementRect.top,
+            right: viewportWidth - elementRect.right,
+            bottom: viewportHeight - elementRect.bottom,
+            left: elementRect.left,
         };
     }
-    /**
-     * Apply positioning styles based on position
-     */
-    applyPositionStyles(position, style, offsets, boundElementSizes, availableSpace, offsetModifier, arrowModifier) {
-        const distanceFromBound = 8; // 8px is the distance of the popover from the bound element
-        // Reset all positioning properties
-        style.top = "auto";
-        style.right = "auto";
-        style.bottom = "auto";
-        style.left = "auto";
-        style.maxWidth = "";
-        style.maxHeight = "";
+    /** Apply positioning styles based on passed position. */
+    applyPositionStyles(position, availableSpace) {
+        const boundElementWidth = this.boundElement.offsetWidth;
+        const boundElementHeight = this.boundElement.offsetHeight;
+        /** Distance between the popover and the bound element */
+        const distanceFromBound = 8;
+        const offsetModifier = this.offsetModifier;
+        /** Distance between the arrow center and the popover edge. Needed to align the center of the arrow with the center of the bound element when `showArrow` and `center` are enabled. */
+        const arrowModifier = this.showArrow && this.center ? 8 : 0;
+        const hostStyle = this.host.style;
+        const boundElementOffsets = this.calculateElementOffsets(this.boundElement);
+        let maxWidth;
+        let maxHeight;
         switch (position) {
             case PopoverPosition.TOP:
             case PopoverPosition.TOP_RIGHT:
-                style.bottom = `${offsets.bottom + boundElementSizes.height}px`;
-                style.left = `${offsets.left + boundElementSizes.width * offsetModifier - (position === PopoverPosition.TOP_RIGHT ? arrowModifier : 0)}px`;
-                style.maxHeight = `${availableSpace.top - distanceFromBound}px`;
+                hostStyle.bottom = `${boundElementOffsets.bottom + boundElementHeight}px`;
+                hostStyle.left = `${boundElementOffsets.left + boundElementWidth * offsetModifier - (position === PopoverPosition.TOP_RIGHT ? arrowModifier : 0)}px`;
+                maxHeight = availableSpace.top - distanceFromBound;
                 if (position === PopoverPosition.TOP_RIGHT) {
-                    style.maxWidth = `${availableSpace.right + boundElementSizes.width * offsetModifier}px`;
+                    maxWidth = availableSpace.right + boundElementWidth * offsetModifier;
                 }
                 break;
             case PopoverPosition.TOP_LEFT:
-                style.right = `${offsets.right + boundElementSizes.width * offsetModifier - arrowModifier}px`;
-                style.bottom = `${offsets.bottom + boundElementSizes.height}px`;
-                style.maxWidth = `${availableSpace.left}px`;
-                style.maxHeight = `${availableSpace.top - distanceFromBound}px`;
+                hostStyle.right = `${boundElementOffsets.right + boundElementWidth * offsetModifier - arrowModifier}px`;
+                hostStyle.bottom = `${boundElementOffsets.bottom + boundElementHeight}px`;
+                maxWidth = availableSpace.left + boundElementWidth * offsetModifier;
+                maxHeight = availableSpace.top - distanceFromBound;
                 break;
             case PopoverPosition.BOTTOM:
             case PopoverPosition.BOTTOM_RIGHT:
-                style.top = `${offsets.top + boundElementSizes.height}px`;
-                style.left = `${offsets.left + boundElementSizes.width * offsetModifier - (position === PopoverPosition.BOTTOM_RIGHT ? arrowModifier : 0)}px`;
-                style.maxHeight = `${availableSpace.bottom - distanceFromBound}px`;
+                hostStyle.top = `${boundElementOffsets.top + boundElementHeight}px`;
+                hostStyle.left = `${boundElementOffsets.left + boundElementWidth * offsetModifier - (position === PopoverPosition.BOTTOM_RIGHT ? arrowModifier : 0)}px`;
+                maxHeight = availableSpace.bottom - distanceFromBound;
                 if (position === PopoverPosition.BOTTOM_RIGHT) {
-                    style.maxWidth = `${availableSpace.right + boundElementSizes.width * offsetModifier}px`;
+                    maxWidth = availableSpace.right + boundElementWidth * offsetModifier;
                 }
                 break;
             case PopoverPosition.BOTTOM_LEFT:
-                style.top = `${offsets.top + boundElementSizes.height}px`;
-                style.right = `${offsets.right + boundElementSizes.width * offsetModifier - arrowModifier}px`;
-                style.maxWidth = `${availableSpace.left}px`;
-                style.maxHeight = `${availableSpace.bottom - distanceFromBound}px`;
+                hostStyle.top = `${boundElementOffsets.top + boundElementHeight}px`;
+                hostStyle.right = `${boundElementOffsets.right + boundElementWidth * offsetModifier - arrowModifier}px`;
+                maxWidth = availableSpace.left + boundElementWidth * offsetModifier;
+                maxHeight = availableSpace.bottom - distanceFromBound;
                 break;
             case PopoverPosition.RIGHT:
             case PopoverPosition.RIGHT_BOTTOM:
-                style.top = `${offsets.top + boundElementSizes.height * offsetModifier - (position === PopoverPosition.RIGHT_BOTTOM ? arrowModifier : 0)}px`;
-                style.left = `${offsets.left + boundElementSizes.width}px`;
-                style.maxWidth = `${availableSpace.right - distanceFromBound}px`;
+                hostStyle.top = `${boundElementOffsets.top + boundElementHeight * offsetModifier - (position === PopoverPosition.RIGHT_BOTTOM ? arrowModifier : 0)}px`;
+                hostStyle.left = `${boundElementOffsets.left + boundElementWidth}px`;
+                maxWidth = availableSpace.right - distanceFromBound;
                 if (position === PopoverPosition.RIGHT) {
-                    style.maxHeight = `${Math.min(availableSpace.top + availableSpace.bottom + boundElementSizes.height, window.innerHeight - 20)}px`;
+                    maxHeight = availableSpace.top + availableSpace.bottom + boundElementHeight;
                 }
                 else {
-                    style.maxHeight = `${availableSpace.bottom + boundElementSizes.height * offsetModifier}px`;
+                    maxHeight = availableSpace.bottom + boundElementHeight * offsetModifier;
                 }
                 break;
             case PopoverPosition.RIGHT_TOP:
-                style.bottom = `${offsets.bottom + boundElementSizes.height * offsetModifier - arrowModifier}px`;
-                style.left = `${offsets.left + boundElementSizes.width}px`;
-                style.maxWidth = `${availableSpace.right - distanceFromBound}px`;
-                if (position === PopoverPosition.RIGHT_TOP) {
-                    style.maxHeight = `${availableSpace.top + boundElementSizes.height * offsetModifier}px`;
-                }
+                hostStyle.bottom = `${boundElementOffsets.bottom + boundElementHeight * offsetModifier - arrowModifier}px`;
+                hostStyle.left = `${boundElementOffsets.left + boundElementWidth}px`;
+                maxWidth = availableSpace.right - distanceFromBound;
+                maxHeight = availableSpace.top + boundElementHeight * offsetModifier;
                 break;
             case PopoverPosition.LEFT:
             case PopoverPosition.LEFT_BOTTOM:
-                style.top = `${offsets.top + boundElementSizes.height * offsetModifier - (position === PopoverPosition.LEFT_BOTTOM ? arrowModifier : 0)}px`;
-                style.right = `${offsets.right + boundElementSizes.width}px`;
-                style.maxWidth = `${availableSpace.left - distanceFromBound}px`;
+                hostStyle.top = `${boundElementOffsets.top + boundElementHeight * offsetModifier - (position === PopoverPosition.LEFT_BOTTOM ? arrowModifier : 0)}px`;
+                hostStyle.right = `${boundElementOffsets.right + boundElementWidth}px`;
+                maxWidth = availableSpace.left - distanceFromBound;
                 if (position === PopoverPosition.LEFT_BOTTOM) {
-                    style.maxHeight = `${availableSpace.bottom + boundElementSizes.height * offsetModifier}px`;
+                    maxHeight = availableSpace.bottom + boundElementHeight * offsetModifier;
                 }
                 break;
             case PopoverPosition.LEFT_TOP:
-                style.right = `${offsets.right + boundElementSizes.width}px`;
-                style.bottom = `${offsets.bottom + boundElementSizes.height * offsetModifier - arrowModifier}px`;
-                style.maxWidth = `${availableSpace.left - distanceFromBound}px`;
-                if (position === PopoverPosition.LEFT_TOP) {
-                    style.maxHeight = `${availableSpace.top + boundElementSizes.height * offsetModifier}px`;
-                }
+                hostStyle.right = `${boundElementOffsets.right + boundElementWidth}px`;
+                hostStyle.bottom = `${boundElementOffsets.bottom + boundElementHeight * offsetModifier - arrowModifier}px`;
+                maxWidth = availableSpace.left - distanceFromBound;
+                maxHeight = availableSpace.top + boundElementHeight * offsetModifier;
                 break;
         }
+        if (getDevice() !== Device.MOBILE) {
+            // Only force max sizes on non-mobile viewports
+            hostStyle.maxWidth = maxWidth ? `${maxWidth}px` : "";
+            hostStyle.maxHeight = maxHeight ? `${maxHeight}px` : "";
+        }
     }
-    /**
-     * Set the position of the popover.
-     */
+    /** Set the position of the popover. */
     setPosition() {
-        let boundElement;
-        if (typeof this.bindTo === "string") {
-            boundElement = this.host.ownerDocument.querySelector(this.bindTo);
-        }
-        else if (this.bindTo) {
-            boundElement = this.bindTo;
-        }
-        else {
-            boundElement = this.host.parentElement;
+        if (!this.boundElement) {
+            return;
         }
-        if (!boundElement) {
+        if (!isElementVisibleInContainer(this.boundElement, findScrollableParent(this.boundElement))) {
+            // If the bound element is not visible, hide the popover too
+            this.open = false;
             return;
         }
-        const scrollContainer = findScrollableParent(boundElement);
-        const scrollingBoundingRect = scrollContainer.getBoundingClientRect();
-        const offsetContainer = this.host.offsetParent;
-        const relativeBoundingRect = offsetContainer
-            ? computeOffset(offsetContainer, scrollContainer)
-            : { top: 0, right: 0, bottom: 0, left: 0 };
-        const boundElementRect = computeOffset(boundElement, scrollContainer);
-        const availableSpace = this.calculateAvailableSpace(boundElementRect, scrollContainer, scrollingBoundingRect);
-        const offsets = this.calculateRelativeOffsets(boundElementRect, relativeBoundingRect);
-        const offsetModifier = this.center ? 0.5 : 0;
-        const arrowModifier = this.showArrow && this.center ? 8 : 0; // 8px is the distance of the arrow center from the edge of the popover
-        const position = this.getOptimalPopoverPosition(this.position, availableSpace, { width: boundElementRect.width, height: boundElementRect.height }, offsetModifier);
-        const style = this.host.style;
-        this.applyPositionStyles(position, style, offsets, boundElementRect, availableSpace, offsetModifier, arrowModifier);
+        Object.assign(this.host.style, {
+            // Reset all positioning properties
+            top: "auto",
+            right: "auto",
+            bottom: "auto",
+            left: "auto",
+            maxWidth: "",
+            maxHeight: "",
+            // Set initial visibility to hidden while calculating position...
+            visibility: "hidden",
+        });
+        const availableSpace = this.calculateAvailableSpace();
+        const position = this.getOptimalPopoverPosition(this.position, availableSpace);
+        this.applyPositionStyles(position, availableSpace);
         this.currentPosition = position;
+        this.positionChange.emit({ position: this.currentPosition });
+        // ...then restore the visibility
+        this.host.style.visibility = "visible";
     }
     componentWillLoad() {
         this.validatePosition(this.position);
-        this.onOpen();
     }
     componentDidLoad() {
-        this.setPosition();
+        this.findBoundElement();
+        if (this.open) {
+            this.onOpen();
+        }
     }
     disconnectedCallback() {
         cancelAnimationFrame(this.animationFrameRequestId);
     }
     render() {
-        return (h(Host, { key: '8628b0f299deb808e4c554047c76b82f392782c9', "current-position": this.currentPosition }, h("slot", { key: '144294e8216d7ad673e4ee3a96651c053703d135' })));
+        return (h(Host, { key: '1eafd1bd08aa31a81378354542b0e74edc4cb0ce', "current-position": this.currentPosition }, h("slot", { key: '2ad916cf0e13766e2e5f92f4f964a4fe909cdc7a' })));
     }
     get host() { return this; }
     static get watchers() { return {
         "position": ["validatePosition"],
-        "open": ["onOpen"]
+        "open": ["onOpen"],
+        "bindTo": ["onBindingChange"]
     }; }
     static get style() { return ZPopoverStyle0; }
 }, [1, "z-popover", {
@@ -459,21 +426,22 @@ const ZPopover = /*@__PURE__*/ proxyCustomElement(class ZPopover extends HTMLEle
         "currentPosition": [32]
     }, [[8, "keyup", "closePopoverWithKeyboard"], [18, "click", "handleOutsideClick"]], {
         "position": ["validatePosition"],
-        "open": ["onOpen"]
+        "open": ["onOpen"],
+        "bindTo": ["onBindingChange"]
     }]);
 // Clockwise order of positions.
 ZPopover.positionOrder = [
-    PopoverPosition.TOP_RIGHT,
     PopoverPosition.TOP,
+    PopoverPosition.TOP_RIGHT,
     PopoverPosition.TOP_LEFT,
-    PopoverPosition.RIGHT_BOTTOM,
     PopoverPosition.RIGHT,
+    PopoverPosition.RIGHT_BOTTOM,
     PopoverPosition.RIGHT_TOP,
-    PopoverPosition.BOTTOM_LEFT,
     PopoverPosition.BOTTOM,
+    PopoverPosition.BOTTOM_LEFT,
     PopoverPosition.BOTTOM_RIGHT,
-    PopoverPosition.LEFT_TOP,
     PopoverPosition.LEFT,
+    PopoverPosition.LEFT_TOP,
     PopoverPosition.LEFT_BOTTOM,
 ];
 function defineCustomElement() {