@ionic/core 8.7.18-dev.11769546281.18b0f3ba → 8.7.18-dev.11769790854.11895f8f

package/dist/collection/components/modal/modal.js

@@ -2,6 +2,7 @@
  * (C) Ionic http://ionicframework.com - MIT License
  */
 import { Host, h, writeTask } from "@stencil/core";
+import { win } from "../../utils/browser/index";
 import { findIonContent, printIonContentErrorMsg } from "../../utils/content/index";
 import { CoreDelegate, attachComponent, detachComponent } from "../../utils/framework-delegate";
 import { raf, inheritAttributes, hasLazyBuild, getElementRoot } from "../../utils/helpers";
@@ -42,6 +43,10 @@ export class Modal {
         this.inline = false;
         // Whether or not modal is being dismissed via gesture
         this.gestureAnimationDismissing = false;
+        // Whether to skip coordinate-based safe-area detection (for fullscreen phone modals)
+        this.skipSafeAreaCoordinateDetection = false;
+        // Track previous safe-area state to avoid redundant DOM writes
+        this.prevSafeAreaState = { top: false, bottom: false, left: false, right: false };
         this.presented = false;
         /** @internal */
         this.hasController = false;
@@ -232,7 +237,10 @@ export class Modal {
         }
     }
     onWindowResize() {
-        // Only handle resize for iOS card modals when no custom animations are provided
+        // Invalidate safe-area cache on resize (device rotation may change values)
+        this.cachedSafeAreas = undefined;
+        this.updateSafeAreaOverrides();
+        // Only handle view transition for iOS card modals when no custom animations are provided
         if (getIonMode(this) !== 'ios' || !this.presentingElement || this.enterAnimation || this.leaveAnimation) {
             return;
         }
@@ -255,6 +263,8 @@ export class Modal {
         this.triggerController.removeClickListener();
         this.cleanupViewTransitionListener();
         this.cleanupParentRemovalObserver();
+        // Reset safe-area state to handle removal without dismiss (e.g., framework unmount)
+        this.resetSafeAreaState();
     }
     componentWillLoad() {
         var _a;
@@ -414,6 +424,8 @@ export class Modal {
         else if (!this.keepContentsMounted) {
             await waitForMount();
         }
+        // Predict safe-area needs based on modal configuration to avoid visual snap
+        this.setInitialSafeAreaOverrides(presentingElement);
         writeTask(() => this.el.classList.add('show-modal'));
         const hasCardModal = presentingElement !== undefined;
         /**
@@ -475,6 +487,8 @@ export class Modal {
         else if (hasCardModal) {
             this.initSwipeToClose();
         }
+        // Now that animation is complete, update safe-area based on actual position
+        this.updateSafeAreaOverrides();
         // Initialize view transition listener for iOS card modals
         this.initViewTransitionListener();
         // Initialize parent removal observer
@@ -526,7 +540,7 @@ export class Modal {
                 await this.dismiss(undefined, GESTURE);
                 this.gestureAnimationDismissing = false;
             });
-        });
+        }, () => this.updateSafeAreaOverrides());
         this.gesture.enable(true);
     }
     initSheetGesture() {
@@ -547,7 +561,8 @@ export class Modal {
                 this.currentBreakpoint = breakpoint;
                 this.ionBreakpointDidChange.emit({ breakpoint });
             }
-        });
+            this.updateSafeAreaOverrides();
+        }, () => this.updateSafeAreaOverrides());
         this.gesture = gesture;
         this.moveSheetToBreakpoint = moveSheetToBreakpoint;
         this.gesture.enable(true);
@@ -625,6 +640,197 @@ export class Modal {
         // Clear the cached reference
         this.cachedPageParent = undefined;
     }
+    /**
+     * Sets initial safe-area overrides based on modal configuration before
+     * the modal becomes visible. This predicts whether the modal will touch
+     * screen edges to avoid a visual snap after animation completes.
+     */
+    setInitialSafeAreaOverrides(presentingElement) {
+        const style = this.el.style;
+        const mode = getIonMode(this);
+        const isSheetModal = this.breakpoints !== undefined && this.initialBreakpoint !== undefined;
+        // Card modals only exist in iOS mode - in MD mode, presentingElement is ignored
+        const isCardModal = presentingElement !== undefined && mode === 'ios';
+        const isTablet = window.innerWidth >= 768;
+        // Sheet modals always touch bottom edge, never top/left/right
+        if (isSheetModal) {
+            style.setProperty('--ion-safe-area-top', '0px');
+            style.setProperty('--ion-safe-area-left', '0px');
+            style.setProperty('--ion-safe-area-right', '0px');
+            return;
+        }
+        // Card modals have rounded top corners
+        if (isCardModal) {
+            style.setProperty('--ion-safe-area-top', '0px');
+            if (isTablet) {
+                // On tablets, card modals are inset from all edges
+                this.zeroAllSafeAreas();
+            }
+            else {
+                // On phones, card modals still extend to the bottom edge
+                style.setProperty('--ion-safe-area-left', '0px');
+                style.setProperty('--ion-safe-area-right', '0px');
+                this.applyFullscreenSafeArea();
+            }
+            return;
+        }
+        // Check if modal is fullscreen via CSS custom properties
+        // This applies to both phone and tablet sizes - custom modals may have
+        // non-fullscreen dimensions even on phones (e.g., --height: 70%)
+        const computedStyle = getComputedStyle(this.el);
+        const width = computedStyle.getPropertyValue('--width').trim();
+        const height = computedStyle.getPropertyValue('--height').trim();
+        const isFullscreen = width === '100%' && height === '100%';
+        if (isFullscreen) {
+            this.applyFullscreenSafeArea();
+        }
+        else if (isTablet) {
+            // Centered dialog on tablet doesn't touch edges
+            this.zeroAllSafeAreas();
+        }
+        else {
+            // Non-fullscreen modal on phone - use coordinate-based detection
+            // to determine which edges it touches (e.g., bottom-aligned custom modals)
+        }
+    }
+    /**
+     * Applies safe-area handling for fullscreen modals.
+     * Adds wrapper padding when no footer is present to prevent
+     * content from overlapping system navigation areas.
+     */
+    applyFullscreenSafeArea() {
+        this.skipSafeAreaCoordinateDetection = true;
+        this.updateFooterPadding();
+        // Watch for dynamic footer additions/removals (e.g., async data loading)
+        // Use subtree:true to support wrapped footers in framework components
+        // (e.g., <my-footer><ion-footer>...</ion-footer></my-footer>)
+        if (!this.footerObserver && win !== undefined && 'MutationObserver' in win) {
+            this.footerObserver = new MutationObserver(() => this.updateFooterPadding());
+            this.footerObserver.observe(this.el, { childList: true, subtree: true });
+        }
+    }
+    /**
+     * Updates wrapper and shadow padding based on footer presence.
+     * Called initially and when footer is dynamically added/removed.
+     * Both elements must be styled identically to prevent visual mismatches.
+     */
+    updateFooterPadding() {
+        if (!this.wrapperEl)
+            return;
+        const hasFooter = this.el.querySelector('ion-footer') !== null;
+        // Apply to both wrapper and shadow to keep them in sync
+        const elements = [this.wrapperEl, this.shadowEl].filter(Boolean);
+        if (hasFooter) {
+            elements.forEach((el) => {
+                el.style.removeProperty('padding-bottom');
+                el.style.removeProperty('box-sizing');
+            });
+        }
+        else {
+            elements.forEach((el) => {
+                el.style.setProperty('padding-bottom', 'var(--ion-safe-area-bottom, 0px)');
+                el.style.setProperty('box-sizing', 'border-box');
+            });
+        }
+    }
+    /**
+     * Sets all safe-area CSS variables to 0px for modals that
+     * don't touch screen edges.
+     */
+    zeroAllSafeAreas() {
+        const style = this.el.style;
+        style.setProperty('--ion-safe-area-top', '0px');
+        style.setProperty('--ion-safe-area-bottom', '0px');
+        style.setProperty('--ion-safe-area-left', '0px');
+        style.setProperty('--ion-safe-area-right', '0px');
+    }
+    /**
+     * Resets all safe-area related state and styles.
+     * Called during dismiss and disconnectedCallback to ensure clean state
+     * for re-presentation of inline modals.
+     */
+    resetSafeAreaState() {
+        var _a;
+        this.skipSafeAreaCoordinateDetection = false;
+        this.cachedSafeAreas = undefined;
+        this.prevSafeAreaState = { top: false, bottom: false, left: false, right: false };
+        (_a = this.footerObserver) === null || _a === void 0 ? void 0 : _a.disconnect();
+        this.footerObserver = undefined;
+        // Clear wrapper and shadow styles that may have been set for safe-area handling
+        [this.wrapperEl, this.shadowEl].forEach((el) => {
+            if (el) {
+                el.style.removeProperty('padding-bottom');
+                el.style.removeProperty('box-sizing');
+            }
+        });
+        // Clear safe-area CSS variable overrides
+        const style = this.el.style;
+        style.removeProperty('--ion-safe-area-top');
+        style.removeProperty('--ion-safe-area-bottom');
+        style.removeProperty('--ion-safe-area-left');
+        style.removeProperty('--ion-safe-area-right');
+    }
+    /**
+     * Gets the root safe-area values from the document element.
+     * Uses cached values during gestures to avoid getComputedStyle calls.
+     */
+    getSafeAreaValues() {
+        if (!this.cachedSafeAreas) {
+            const rootStyle = getComputedStyle(document.documentElement);
+            this.cachedSafeAreas = {
+                top: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-top')) || 0,
+                bottom: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-bottom')) || 0,
+                left: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-left')) || 0,
+                right: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-right')) || 0,
+            };
+        }
+        return this.cachedSafeAreas;
+    }
+    /**
+     * Updates safe-area CSS variable overrides based on whether the modal
+     * extends into each safe-area region. Called after animation
+     * and during gestures to handle dynamic position changes.
+     *
+     * Optimized to avoid redundant DOM writes by tracking previous state.
+     */
+    updateSafeAreaOverrides() {
+        if (this.skipSafeAreaCoordinateDetection) {
+            return;
+        }
+        const wrapper = this.wrapperEl;
+        if (!wrapper) {
+            return;
+        }
+        const rect = wrapper.getBoundingClientRect();
+        const safeAreas = this.getSafeAreaValues();
+        const extendsIntoTop = rect.top < safeAreas.top;
+        const extendsIntoBottom = rect.bottom > window.innerHeight - safeAreas.bottom;
+        const extendsIntoLeft = rect.left < safeAreas.left;
+        const extendsIntoRight = rect.right > window.innerWidth - safeAreas.right;
+        // Only update DOM when state actually changes
+        const prev = this.prevSafeAreaState;
+        const style = this.el.style;
+        if (extendsIntoTop !== prev.top) {
+            extendsIntoTop ? style.removeProperty('--ion-safe-area-top') : style.setProperty('--ion-safe-area-top', '0px');
+            prev.top = extendsIntoTop;
+        }
+        if (extendsIntoBottom !== prev.bottom) {
+            extendsIntoBottom
+                ? style.removeProperty('--ion-safe-area-bottom')
+                : style.setProperty('--ion-safe-area-bottom', '0px');
+            prev.bottom = extendsIntoBottom;
+        }
+        if (extendsIntoLeft !== prev.left) {
+            extendsIntoLeft ? style.removeProperty('--ion-safe-area-left') : style.setProperty('--ion-safe-area-left', '0px');
+            prev.left = extendsIntoLeft;
+        }
+        if (extendsIntoRight !== prev.right) {
+            extendsIntoRight
+                ? style.removeProperty('--ion-safe-area-right')
+                : style.setProperty('--ion-safe-area-right', '0px');
+            prev.right = extendsIntoRight;
+        }
+    }
     sheetOnDismiss() {
         /**
          * While the gesture animation is finishing
@@ -717,6 +923,8 @@ export class Modal {
         }
         this.currentBreakpoint = undefined;
         this.animation = undefined;
+        // Reset safe-area state for potential re-presentation
+        this.resetSafeAreaState();
         unlock();
         return dismissed;
     }
@@ -974,20 +1182,20 @@ export class Modal {
         const isCardModal = presentingElement !== undefined && mode === 'ios';
         const isHandleCycle = handleBehavior === 'cycle';
         const isSheetModalWithHandle = isSheetModal && showHandle;
-        return (h(Host, Object.assign({ key: '87328006ea6c75ebc518ace300438492a567223e', "no-router": true,
+        return (h(Host, Object.assign({ key: '8f42c71ec9c9270b4218ca7eec57ca998871ac07', "no-router": true,
             // Allow the modal to be navigable when the handle is focusable
             tabIndex: isHandleCycle && isSheetModalWithHandle ? 0 : -1 }, htmlAttributes, { style: {
                 zIndex: `${20000 + this.overlayIndex}`,
-            }, class: Object.assign({ [mode]: true, ['modal-default']: !isCardModal && !isSheetModal, [`modal-card`]: isCardModal, [`modal-sheet`]: isSheetModal, [`modal-no-expand-scroll`]: isSheetModal && !expandToScroll, 'overlay-hidden': true, [FOCUS_TRAP_DISABLE_CLASS]: focusTrap === false }, getClassMap(this.cssClass)), onIonBackdropTap: this.onBackdropTap, onIonModalDidPresent: this.onLifecycle, onIonModalWillPresent: this.onLifecycle, onIonModalWillDismiss: this.onLifecycle, onIonModalDidDismiss: this.onLifecycle, onFocus: this.onModalFocus }), h("ion-backdrop", { key: 'ee94ff8e09b691dd4ad4e4db1720f06bc3c5a469', ref: (el) => (this.backdropEl = el), visible: this.showBackdrop, tappable: this.backdropDismiss, part: "backdrop" }), mode === 'ios' && h("div", { key: 'bffd69b4635c22d9f249725bd952c1e93d5615c7', class: "modal-shadow" }), h("div", Object.assign({ key: '1d394d3c68916e464ff1fbf5242419f4a3d3cca1',
+            }, class: Object.assign({ [mode]: true, ['modal-default']: !isCardModal && !isSheetModal, [`modal-card`]: isCardModal, [`modal-sheet`]: isSheetModal, [`modal-no-expand-scroll`]: isSheetModal && !expandToScroll, 'overlay-hidden': true, [FOCUS_TRAP_DISABLE_CLASS]: focusTrap === false }, getClassMap(this.cssClass)), onIonBackdropTap: this.onBackdropTap, onIonModalDidPresent: this.onLifecycle, onIonModalWillPresent: this.onLifecycle, onIonModalWillDismiss: this.onLifecycle, onIonModalDidDismiss: this.onLifecycle, onFocus: this.onModalFocus }), h("ion-backdrop", { key: '2f7b08b019c66cbfceacafa9a68b91f8da1f4084', ref: (el) => (this.backdropEl = el), visible: this.showBackdrop, tappable: this.backdropDismiss, part: "backdrop" }), mode === 'ios' && h("div", { key: '6b0d1ae90e8483332f74371be5dcbd0a7b2661ba', class: "modal-shadow", ref: (el) => (this.shadowEl = el) }), h("div", Object.assign({ key: 'c96f671fb25e5de45231ea65ac52500547b2e262',
             /*
               role and aria-modal must be used on the
               same element. They must also be set inside the
               shadow DOM otherwise ion-button will not be highlighted
               when using VoiceOver: https://bugs.webkit.org/show_bug.cgi?id=247134
             */
-            role: "dialog" }, inheritedAttributes, { "aria-modal": "true", class: "modal-wrapper ion-overlay-wrapper", part: "content", ref: (el) => (this.wrapperEl = el) }), showHandle && (h("button", { key: '2dcf58792018e557e0c323baad2d672bc99c0bb1', class: "modal-handle",
+            role: "dialog" }, inheritedAttributes, { "aria-modal": "true", class: "modal-wrapper ion-overlay-wrapper", part: "content", ref: (el) => (this.wrapperEl = el) }), showHandle && (h("button", { key: 'e07419b01a588c0ba62ed9607c843cac7bd26337', class: "modal-handle",
             // Prevents the handle from receiving keyboard focus when it does not cycle
-            tabIndex: !isHandleCycle ? -1 : 0, "aria-label": "Activate to adjust the size of the dialog overlaying the screen", onClick: isHandleCycle ? this.onHandleClick : undefined, part: "handle", ref: (el) => (this.dragHandleEl = el) })), h("slot", { key: '44164b1e8710c3895400ad9f44ecd99873874ad5', onSlotchange: this.onSlotChange }))));
+            tabIndex: !isHandleCycle ? -1 : 0, "aria-label": "Activate to adjust the size of the dialog overlaying the screen", onClick: isHandleCycle ? this.onHandleClick : undefined, part: "handle", ref: (el) => (this.dragHandleEl = el) })), h("slot", { key: '65f35079df8eb8b6cd262e3a08297866715ce7ea', onSlotchange: this.onSlotChange }))));
     }
     static get is() { return "ion-modal"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/modal/modal.md.css

@@ -135,10 +135,6 @@ ion-backdrop {
   :host {
     --width: 600px;
     --height: 500px;
-    --ion-safe-area-top: 0px;
-    --ion-safe-area-bottom: 0px;
-    --ion-safe-area-right: 0px;
-    --ion-safe-area-left: 0px;
   }
 }
 @media only screen and (min-width: 768px) and (min-height: 768px) {

package/dist/collection/components/popover/animations/ios.enter.js

@@ -31,7 +31,7 @@ export const iosEnterAnimation = (baseEl, opts) => {
     const results = getPopoverPosition(isRTL, contentWidth, contentHeight, arrowWidth, arrowHeight, reference, side, align, defaultPosition, trigger, ev);
     const padding = size === 'cover' ? 0 : POPOVER_IOS_BODY_PADDING;
     const margin = size === 'cover' ? 0 : 25;
-    const { originX, originY, top, left, bottom, checkSafeAreaLeft, checkSafeAreaRight, arrowTop, arrowLeft, addPopoverBottomClass, } = calculateWindowAdjustment(side, results.top, results.left, padding, bodyWidth, bodyHeight, contentWidth, contentHeight, margin, results.originX, results.originY, results.referenceCoordinates, results.arrowTop, results.arrowLeft, arrowHeight);
+    const { originX, originY, top, left, bottom, checkSafeAreaTop, checkSafeAreaBottom, checkSafeAreaLeft, checkSafeAreaRight, arrowTop, arrowLeft, addPopoverBottomClass, } = calculateWindowAdjustment(side, results.top, results.left, padding, bodyWidth, bodyHeight, contentWidth, contentHeight, margin, results.originX, results.originY, results.referenceCoordinates, results.arrowTop, results.arrowLeft, arrowHeight);
     const baseAnimation = createAnimation();
     const backdropAnimation = createAnimation();
     const contentAnimation = createAnimation();
@@ -61,19 +61,35 @@ export const iosEnterAnimation = (baseEl, opts) => {
         if (addPopoverBottomClass) {
             baseEl.classList.add('popover-bottom');
         }
-        if (bottom !== undefined) {
-            contentEl.style.setProperty('bottom', `${bottom}px`);
-        }
+        /**
+         * Safe area CSS variable adjustments.
+         * When the popover is positioned near an edge, we add the corresponding
+         * safe-area inset to ensure the popover doesn't overlap with system UI
+         * (status bars, home indicators, navigation bars on Android API 36+, etc.)
+         */
+        const safeAreaTop = ' + var(--ion-safe-area-top, 0)';
+        const safeAreaBottom = ' + var(--ion-safe-area-bottom, 0)';
         const safeAreaLeft = ' + var(--ion-safe-area-left, 0)';
         const safeAreaRight = ' - var(--ion-safe-area-right, 0)';
+        let topValue = `${top}px`;
+        let bottomValue = bottom !== undefined ? `${bottom}px` : undefined;
         let leftValue = `${left}px`;
+        if (checkSafeAreaTop) {
+            topValue = `${top}px${safeAreaTop}`;
+        }
+        if (checkSafeAreaBottom && bottomValue !== undefined) {
+            bottomValue = `${bottom}px${safeAreaBottom}`;
+        }
         if (checkSafeAreaLeft) {
             leftValue = `${left}px${safeAreaLeft}`;
         }
         if (checkSafeAreaRight) {
             leftValue = `${left}px${safeAreaRight}`;
         }
-        contentEl.style.setProperty('top', `calc(${top}px + var(--offset-y, 0))`);
+        if (bottomValue !== undefined) {
+            contentEl.style.setProperty('bottom', `calc(${bottomValue})`);
+        }
+        contentEl.style.setProperty('top', `calc(${topValue} + var(--offset-y, 0))`);
         contentEl.style.setProperty('left', `calc(${leftValue} + var(--offset-x, 0))`);
         contentEl.style.setProperty('transform-origin', `${originY} ${originX}`);
         if (arrowEl !== null) {

package/dist/collection/components/popover/animations/md.enter.js

@@ -28,7 +28,32 @@ export const mdEnterAnimation = (baseEl, opts) => {
     };
     const results = getPopoverPosition(isRTL, contentWidth, contentHeight, 0, 0, reference, side, align, defaultPosition, trigger, ev);
     const padding = size === 'cover' ? 0 : POPOVER_MD_BODY_PADDING;
-    const { originX, originY, top, left, bottom } = calculateWindowAdjustment(side, results.top, results.left, padding, bodyWidth, bodyHeight, contentWidth, contentHeight, 0, results.originX, results.originY, results.referenceCoordinates);
+    const { originX, originY, top, left, bottom, checkSafeAreaTop, checkSafeAreaBottom, checkSafeAreaLeft, checkSafeAreaRight, } = calculateWindowAdjustment(side, results.top, results.left, padding, bodyWidth, bodyHeight, contentWidth, contentHeight, 0, results.originX, results.originY, results.referenceCoordinates);
+    /**
+     * Safe area CSS variable adjustments.
+     * When the popover is positioned near an edge, we add the corresponding
+     * safe-area inset to ensure the popover doesn't overlap with system UI
+     * (status bars, home indicators, navigation bars on Android API 36+, etc.)
+     */
+    const safeAreaTop = ' + var(--ion-safe-area-top, 0)';
+    const safeAreaBottom = ' + var(--ion-safe-area-bottom, 0)';
+    const safeAreaLeft = ' + var(--ion-safe-area-left, 0)';
+    const safeAreaRight = ' - var(--ion-safe-area-right, 0)';
+    let topValue = `${top}px`;
+    let bottomValue = bottom !== undefined ? `${bottom}px` : undefined;
+    let leftValue = `${left}px`;
+    if (checkSafeAreaTop) {
+        topValue = `${top}px${safeAreaTop}`;
+    }
+    if (checkSafeAreaBottom && bottomValue !== undefined) {
+        bottomValue = `${bottom}px${safeAreaBottom}`;
+    }
+    if (checkSafeAreaLeft) {
+        leftValue = `${left}px${safeAreaLeft}`;
+    }
+    if (checkSafeAreaRight) {
+        leftValue = `${left}px${safeAreaRight}`;
+    }
     const baseAnimation = createAnimation();
     const backdropAnimation = createAnimation();
     const wrapperAnimation = createAnimation();
@@ -45,13 +70,13 @@ export const mdEnterAnimation = (baseEl, opts) => {
     contentAnimation
         .addElement(contentEl)
         .beforeStyles({
-        top: `calc(${top}px + var(--offset-y, 0px))`,
-        left: `calc(${left}px + var(--offset-x, 0px))`,
+        top: `calc(${topValue} + var(--offset-y, 0px))`,
+        left: `calc(${leftValue} + var(--offset-x, 0px))`,
         'transform-origin': `${originY} ${originX}`,
     })
         .beforeAddWrite(() => {
-        if (bottom !== undefined) {
-            contentEl.style.setProperty('bottom', `${bottom}px`);
+        if (bottomValue !== undefined) {
+            contentEl.style.setProperty('bottom', `calc(${bottomValue})`);
         }
     })
         .fromTo('transform', 'scale(0.8)', 'scale(1)');

package/dist/collection/components/popover/utils.js

@@ -648,6 +648,8 @@ export const calculateWindowAdjustment = (side, coordTop, coordLeft, bodyPadding
     let bottom;
     let originX = contentOriginX;
     let originY = contentOriginY;
+    let checkSafeAreaTop = false;
+    let checkSafeAreaBottom = false;
     let checkSafeAreaLeft = false;
     let checkSafeAreaRight = false;
     const triggerTop = triggerCoordinates
@@ -692,10 +694,18 @@ export const calculateWindowAdjustment = (side, coordTop, coordLeft, bodyPadding
              * We chose 12 here so that the popover position looks a bit nicer as
              * it is not right up against the edge of the screen.
              */
-            top = Math.max(12, triggerTop - contentHeight - triggerHeight - (arrowHeight - 1));
+            top = Math.max(bodyPadding, triggerTop - contentHeight - triggerHeight - (arrowHeight - 1));
             arrowTop = top + contentHeight;
             originY = 'bottom';
             addPopoverBottomClass = true;
+            /**
+             * If the popover is positioned near the top edge, account for safe area.
+             * This ensures the popover doesn't overlap with status bars or notches.
+             */
+            if (top <= bodyPadding + safeAreaMargin) {
+                checkSafeAreaTop = true;
+                top = bodyPadding;
+            }
             /**
              * If not enough room for popover to appear
              * above trigger, then cut it off.
@@ -703,14 +713,35 @@ export const calculateWindowAdjustment = (side, coordTop, coordLeft, bodyPadding
         }
         else {
             bottom = bodyPadding;
+            /**
+             * When the popover is pinned to the bottom, account for safe area.
+             * This ensures the popover doesn't overlap with home indicators
+             * or navigation bars (e.g., Android API 36+ edge-to-edge).
+             */
+            checkSafeAreaBottom = true;
         }
     }
+    /**
+     * Final check: If the popover extends into any safe-area region,
+     * ensure the corresponding flag is set regardless of side.
+     * This handles cases where a side-positioned popover (left/right)
+     * still needs bottom safe-area padding because it extends into that region.
+     */
+    const popoverBottom = bottom !== undefined ? bodyHeight - bottom : top + contentHeight;
+    if (popoverBottom + safeAreaMargin > bodyHeight) {
+        checkSafeAreaBottom = true;
+    }
+    if (top < safeAreaMargin) {
+        checkSafeAreaTop = true;
+    }
     return {
         top,
         left,
         bottom,
         originX,
         originY,
+        checkSafeAreaTop,
+        checkSafeAreaBottom,
         checkSafeAreaLeft,
         checkSafeAreaRight,
         arrowTop,

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-01-27T20:39:59",
+  "timestamp": "2026-01-30T16:35:57",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.38.0",