@ionic/core 8.7.17-dev.11767895575.16ea7cef → 8.7.17-dev.11767897190.1ef0f479

package/hydrate/index.mjs

@@ -10497,7 +10497,7 @@ const isRTL$1 = (hostEl) => {
     return (document === null || document === void 0 ? void 0 : document.dir.toLowerCase()) === 'rtl';
 };
 
-const contentCss = ":host{--background:var(--ion-background-color, #fff);--color:var(--ion-text-color, #000);--padding-top:0px;--padding-bottom:0px;--padding-start:0px;--padding-end:0px;--keyboard-offset:0px;--offset-top:0px;--offset-bottom:0px;--overflow:auto;display:block;position:relative;-ms-flex:1;flex:1;width:100%;height:100%;margin:0 !important;padding:0 !important;font-family:var(--ion-font-family, inherit);contain:size style}:host(.ion-color) .inner-scroll{background:var(--ion-color-base);color:var(--ion-color-contrast)}#background-content{left:0px;right:0px;top:calc(var(--offset-top) * -1);bottom:calc(var(--offset-bottom) * -1);position:absolute;background:var(--background)}.inner-scroll{left:0px;right:0px;top:calc(var(--offset-top) * -1);bottom:calc(var(--offset-bottom) * -1);-webkit-padding-start:var(--padding-start);padding-inline-start:var(--padding-start);-webkit-padding-end:var(--padding-end);padding-inline-end:var(--padding-end);padding-top:calc(var(--padding-top) + var(--offset-top));padding-bottom:calc(var(--padding-bottom) + var(--keyboard-offset) + var(--offset-bottom));position:absolute;color:var(--color);-webkit-box-sizing:border-box;box-sizing:border-box;overflow:hidden;-ms-touch-action:pan-x pan-y pinch-zoom;touch-action:pan-x pan-y pinch-zoom}.scroll-y,.scroll-x{-webkit-overflow-scrolling:touch;z-index:0;will-change:scroll-position}.scroll-y{overflow-y:var(--overflow);overscroll-behavior-y:contain}.scroll-x{overflow-x:var(--overflow);overscroll-behavior-x:contain}.overscroll::before,.overscroll::after{position:absolute;width:1px;height:1px;content:\"\"}.overscroll::before{bottom:-1px}.overscroll::after{top:-1px}:host(.content-sizing){display:-ms-flexbox;display:flex;-ms-flex-direction:column;flex-direction:column;min-height:0;contain:none}:host(.content-sizing) .inner-scroll{position:relative;top:0;bottom:0;margin-top:calc(var(--offset-top) * -1);margin-bottom:calc(var(--offset-bottom) * -1)}.transition-effect{display:none;position:absolute;width:100%;height:100vh;opacity:0;pointer-events:none}:host(.content-ltr) .transition-effect{left:-100%;}:host(.content-rtl) .transition-effect{right:-100%;}.transition-cover{position:absolute;right:0;width:100%;height:100%;background:black;opacity:0.1}.transition-shadow{display:block;position:absolute;width:100%;height:100%;-webkit-box-shadow:inset -9px 0 9px 0 rgba(0, 0, 100, 0.03);box-shadow:inset -9px 0 9px 0 rgba(0, 0, 100, 0.03)}:host(.content-ltr) .transition-shadow{right:0;}:host(.content-rtl) .transition-shadow{left:0;-webkit-transform:scaleX(-1);transform:scaleX(-1)}::slotted([slot=fixed]){position:absolute;-webkit-transform:translateZ(0);transform:translateZ(0)}";
+const contentCss = ":host{--background:var(--ion-background-color, #fff);--color:var(--ion-text-color, #000);--padding-top:0px;--padding-bottom:0px;--padding-start:0px;--padding-end:0px;--keyboard-offset:0px;--offset-top:0px;--offset-bottom:0px;--overflow:auto;display:block;position:relative;-ms-flex:1;flex:1;width:100%;height:100%;margin:0 !important;padding:0 !important;font-family:var(--ion-font-family, inherit);contain:size style}:host(.ion-color) .inner-scroll{background:var(--ion-color-base);color:var(--ion-color-contrast)}#background-content{left:0px;right:0px;top:calc(var(--offset-top) * -1);bottom:calc(var(--offset-bottom) * -1);position:absolute;background:var(--background)}.inner-scroll{left:0px;right:0px;top:calc(var(--offset-top) * -1);bottom:calc(var(--offset-bottom) * -1);-webkit-padding-start:var(--padding-start);padding-inline-start:var(--padding-start);-webkit-padding-end:var(--padding-end);padding-inline-end:var(--padding-end);padding-top:calc(var(--padding-top) + var(--offset-top));padding-bottom:calc(var(--padding-bottom) + var(--keyboard-offset) + var(--offset-bottom));position:absolute;color:var(--color);-webkit-box-sizing:border-box;box-sizing:border-box;overflow:hidden;-ms-touch-action:pan-x pan-y pinch-zoom;touch-action:pan-x pan-y pinch-zoom}.scroll-y,.scroll-x{-webkit-overflow-scrolling:touch;z-index:0;will-change:scroll-position}.scroll-y{overflow-y:var(--overflow);overscroll-behavior-y:contain}.scroll-x{overflow-x:var(--overflow);overscroll-behavior-x:contain}.overscroll::before,.overscroll::after{position:absolute;width:1px;height:1px;content:\"\"}.overscroll::before{bottom:-1px}.overscroll::after{top:-1px}:host(.content-sizing){display:-ms-flexbox;display:flex;-ms-flex-direction:column;flex-direction:column;min-height:0;contain:none}:host(.content-sizing) .inner-scroll{position:relative;top:0;bottom:0;margin-top:calc(var(--offset-top) * -1);margin-bottom:calc(var(--offset-bottom) * -1)}.transition-effect{display:none;position:absolute;width:100%;height:100vh;opacity:0;pointer-events:none}:host(.content-ltr) .transition-effect{left:-100%;}:host(.content-rtl) .transition-effect{right:-100%;}.transition-cover{position:absolute;right:0;width:100%;height:100%;background:black;opacity:0.1}.transition-shadow{display:block;position:absolute;width:100%;height:100%;-webkit-box-shadow:inset -9px 0 9px 0 rgba(0, 0, 100, 0.03);box-shadow:inset -9px 0 9px 0 rgba(0, 0, 100, 0.03)}:host(.content-ltr) .transition-shadow{right:0;}:host(.content-rtl) .transition-shadow{left:0;-webkit-transform:scaleX(-1);transform:scaleX(-1)}:host(.safe-area-top) #background-content,:host(.safe-area-top) .inner-scroll{top:var(--ion-safe-area-top, 0px)}:host(.safe-area-bottom) #background-content,:host(.safe-area-bottom) .inner-scroll{bottom:var(--ion-safe-area-bottom, 0px)}::slotted([slot=fixed]){position:absolute;-webkit-transform:translateZ(0);transform:translateZ(0)}";
 
 /**
  * @slot - Content is placed in the scrollable area if provided without a slot.
@@ -10521,6 +10521,12 @@ class Content {
         this.isMainContent = true;
         this.resizeTimeout = null;
         this.inheritedAttributes = {};
+        /**
+         * Track whether this content has sibling header/footer elements.
+         * When absent, we need to apply safe-area padding directly.
+         */
+        this.hasHeader = false;
+        this.hasFooter = false;
         this.tabsElement = null;
         // Detail is used in a hot loop in the scroll event, by allocating it here
         // V8 will be able to inline any read/write to it since it's a monomorphic class.
@@ -10575,7 +10581,13 @@ class Content {
         this.inheritedAttributes = inheritAriaAttributes(this.el);
     }
     connectedCallback() {
-        this.isMainContent = this.el.closest('ion-menu, ion-popover, ion-modal') === null;
+        var _a;
+        // Content is "main" if not inside menu/popover/modal and not nested in another ion-content
+        this.isMainContent =
+            this.el.closest('ion-menu, ion-popover, ion-modal') === null &&
+                ((_a = this.el.parentElement) === null || _a === void 0 ? void 0 : _a.closest('ion-content')) === null;
+        // Detect sibling header/footer for safe-area handling
+        this.detectSiblingElements();
         /**
          * The fullscreen content offsets need to be
          * computed after the tab bar has loaded. Since
@@ -10606,13 +10618,79 @@ class Content {
                  * bubbles, we can catch any instances of child tab bars loading by listening
                  * on IonTabs.
                  */
-                this.tabsLoadCallback = () => this.resize();
+                this.tabsLoadCallback = () => {
+                    this.resize();
+                    // Re-detect footer when tab bar loads (it may not exist during initial detection)
+                    this.updateSiblingDetection();
+                };
                 closestTabs.addEventListener('ionTabBarLoaded', this.tabsLoadCallback);
             }
         }
     }
+    /**
+     * Detects sibling ion-header and ion-footer elements and sets up
+     * a mutation observer to handle dynamic changes (e.g., conditional rendering).
+     */
+    detectSiblingElements() {
+        this.updateSiblingDetection();
+        // Watch for dynamic header/footer changes (common in React conditional rendering)
+        const parent = this.el.parentElement;
+        if (parent && !this.parentMutationObserver && win$1 !== undefined && 'MutationObserver' in win$1) {
+            this.parentMutationObserver = new MutationObserver(() => {
+                this.updateSiblingDetection();
+            });
+            this.parentMutationObserver.observe(parent, { childList: true });
+        }
+    }
+    /**
+     * Updates hasHeader/hasFooter based on current DOM state.
+     * Checks both direct siblings and elements wrapped in custom components
+     * (e.g., <my-header><ion-header>...</ion-header></my-header>).
+     */
+    updateSiblingDetection() {
+        const parent = this.el.parentElement;
+        if (parent) {
+            // First check for direct ion-header/ion-footer siblings
+            this.hasHeader = parent.querySelector(':scope > ion-header') !== null;
+            this.hasFooter = parent.querySelector(':scope > ion-footer') !== null;
+            // If not found, check if any sibling contains them (wrapped components)
+            if (!this.hasHeader) {
+                this.hasHeader = this.siblingContainsElement(parent, 'ion-header');
+            }
+            if (!this.hasFooter) {
+                this.hasFooter = this.siblingContainsElement(parent, 'ion-footer');
+            }
+        }
+        // If no footer found, check if we're inside ion-tabs which has ion-tab-bar
+        if (!this.hasFooter) {
+            const tabs = this.el.closest('ion-tabs');
+            if (tabs) {
+                this.hasFooter = tabs.querySelector(':scope > ion-tab-bar') !== null;
+            }
+        }
+    }
+    /**
+     * Checks if any sibling element of ion-content contains the specified element.
+     * Only searches one level deep to avoid finding elements in nested pages.
+     */
+    siblingContainsElement(parent, tagName) {
+        for (const sibling of parent.children) {
+            // Skip ion-content itself
+            if (sibling === this.el)
+                continue;
+            // Check if this sibling contains the target element as an immediate child
+            if (sibling.querySelector(`:scope > ${tagName}`) !== null) {
+                return true;
+            }
+        }
+        return false;
+    }
     disconnectedCallback() {
+        var _a;
         this.onScrollEnd();
+        // Clean up mutation observer to prevent memory leaks
+        (_a = this.parentMutationObserver) === null || _a === void 0 ? void 0 : _a.disconnect();
+        this.parentMutationObserver = undefined;
         if (hasLazyBuild(this.el)) {
             /**
              * The event listener and tabs caches need to
@@ -10841,26 +10919,28 @@ class Content {
         }
     }
     render() {
-        const { fixedSlotPlacement, inheritedAttributes, isMainContent, scrollX, scrollY, el } = this;
+        const { fixedSlotPlacement, hasFooter, hasHeader, inheritedAttributes, isMainContent, scrollX, scrollY, el } = this;
         const rtl = isRTL$1(el) ? 'rtl' : 'ltr';
         const mode = getIonMode$1(this);
         const forceOverscroll = this.shouldForceOverscroll();
         const transitionShadow = mode === 'ios';
         this.resize();
-        return (hAsync(Host, Object.assign({ key: 'cd8781f848d8dc926fe66f43d43c49564425a507', role: isMainContent ? 'main' : undefined, class: createColorClasses$1(this.color, {
+        return (hAsync(Host, Object.assign({ key: 'f7218f733e4022a30875441bd949747537d28aa1', role: isMainContent ? 'main' : undefined, class: createColorClasses$1(this.color, {
                 [mode]: true,
                 'content-sizing': hostContext('ion-popover', this.el),
                 overscroll: forceOverscroll,
                 [`content-${rtl}`]: true,
+                'safe-area-top': isMainContent && !hasHeader,
+                'safe-area-bottom': isMainContent && !hasFooter,
             }), style: {
                 '--offset-top': `${this.cTop}px`,
                 '--offset-bottom': `${this.cBottom}px`,
-            } }, inheritedAttributes), hAsync("div", { key: '95b112d7cae30f22ef778ceffb88edb4d941c170', ref: (el) => (this.backgroundContentEl = el), id: "background-content", part: "background" }), fixedSlotPlacement === 'before' ? hAsync("slot", { name: "fixed" }) : null, hAsync("div", { key: '2fdfcbc39fb66f11b6191911f2941c660f4c12e5', class: {
+            } }, inheritedAttributes), hAsync("div", { key: 'b735ec68c18c0b99c3595bb194029830e6542cde', ref: (el) => (this.backgroundContentEl = el), id: "background-content", part: "background" }), fixedSlotPlacement === 'before' ? hAsync("slot", { name: "fixed" }) : null, hAsync("div", { key: 'e76c00d030342d44ade6648c3f9e32ca990787ba', class: {
                 'inner-scroll': true,
                 'scroll-x': scrollX,
                 'scroll-y': scrollY,
                 overscroll: (scrollX || scrollY) && forceOverscroll,
-            }, ref: (scrollEl) => (this.scrollEl = scrollEl), onScroll: this.scrollEvents ? (ev) => this.onScroll(ev) : undefined, part: "scroll" }, hAsync("slot", { key: '6bc77e0054ec8e21635a7f2abfe0ca46e0962e03' })), transitionShadow ? (hAsync("div", { class: "transition-effect" }, hAsync("div", { class: "transition-cover" }), hAsync("div", { class: "transition-shadow" }))) : null, fixedSlotPlacement === 'after' ? hAsync("slot", { name: "fixed" }) : null));
+            }, ref: (scrollEl) => (this.scrollEl = scrollEl), onScroll: this.scrollEvents ? (ev) => this.onScroll(ev) : undefined, part: "scroll" }, hAsync("slot", { key: '9049be4cea9b5da5ec1e1012248b05286fddeb7a' })), transitionShadow ? (hAsync("div", { class: "transition-effect" }, hAsync("div", { class: "transition-cover" }), hAsync("div", { class: "transition-shadow" }))) : null, fixedSlotPlacement === 'after' ? hAsync("slot", { name: "fixed" }) : null));
     }
     get el() { return getElement(this); }
     static get style() { return contentCss; }
@@ -21531,7 +21611,7 @@ const calculateSpringStep = (t) => {
 const SwipeToCloseDefaults = {
     MIN_PRESENTING_SCALE: 0.915,
 };
-const createSwipeToCloseGesture = (el, animation, statusBarStyle, onDismiss) => {
+const createSwipeToCloseGesture = (el, animation, statusBarStyle, onDismiss, onGestureMove) => {
     /**
      * The step value at which a card modal
      * is eligible for dismissing via gesture.
@@ -21688,6 +21768,8 @@ const createSwipeToCloseGesture = (el, animation, statusBarStyle, onDismiss) =>
         const processedStep = isAttemptingDismissWithCanDismiss ? calculateSpringStep(step / maxStep) : step;
         const clampedStep = clamp(0.0001, processedStep, maxStep);
         animation.progressStep(clampedStep);
+        // Notify modal of position change for safe-area updates
+        onGestureMove === null || onGestureMove === void 0 ? void 0 : onGestureMove();
         /**
          * When swiping down half way, the status bar style
          * should be reset to its default value.
@@ -22231,7 +22313,7 @@ const mdLeaveAnimation$2 = (baseEl, opts) => {
     return baseAnimation;
 };
 
-const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, backdropBreakpoint, animation, breakpoints = [], expandToScroll, getCurrentBreakpoint, onDismiss, onBreakpointChange) => {
+const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, backdropBreakpoint, animation, breakpoints = [], expandToScroll, getCurrentBreakpoint, onDismiss, onBreakpointChange, onGestureMove) => {
     // Defaults for the sheet swipe animation
     const defaultBackdrop = [
         { offset: 0, opacity: 'var(--backdrop-opacity)' },
@@ -22562,6 +22644,8 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
             : step;
         offset = clamp(0.0001, processedStep, maxStep);
         animation.progressStep(offset);
+        // Notify modal of position change for safe-area updates
+        onGestureMove === null || onGestureMove === void 0 ? void 0 : onGestureMove();
     };
     const onEnd = (detail) => {
         /**
@@ -22756,9 +22840,9 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
     };
 };
 
-const modalIosCss = ":host{--width:100%;--min-width:auto;--max-width:auto;--height:100%;--min-height:auto;--max-height:auto;--overflow:hidden;--border-radius:0;--border-width:0;--border-style:none;--border-color:transparent;--background:var(--ion-background-color, #fff);--box-shadow:none;--backdrop-opacity:0;left:0;right:0;top:0;bottom:0;display:-ms-flexbox;display:flex;position:absolute;-ms-flex-align:center;align-items:center;-ms-flex-pack:center;justify-content:center;outline:none;color:var(--ion-text-color, #000);contain:strict}.modal-wrapper,ion-backdrop{pointer-events:auto}:host(.overlay-hidden){display:none}.modal-wrapper,.modal-shadow{border-radius:var(--border-radius);width:var(--width);min-width:var(--min-width);max-width:var(--max-width);height:var(--height);min-height:var(--min-height);max-height:var(--max-height);border-width:var(--border-width);border-style:var(--border-style);border-color:var(--border-color);background:var(--background);-webkit-box-shadow:var(--box-shadow);box-shadow:var(--box-shadow);overflow:var(--overflow);z-index:10}.modal-shadow{position:absolute;background:transparent}@media only screen and (min-width: 768px) and (min-height: 600px){: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){:host{--width:600px;--height:600px}}.modal-handle{left:0px;right:0px;top:5px;border-radius:8px;-webkit-margin-start:auto;margin-inline-start:auto;-webkit-margin-end:auto;margin-inline-end:auto;position:absolute;width:36px;height:5px;-webkit-transform:translateZ(0);transform:translateZ(0);border:0;background:var(--ion-color-step-350, var(--ion-background-color-step-350, #c0c0be));cursor:pointer;z-index:11}.modal-handle::before{-webkit-padding-start:4px;padding-inline-start:4px;-webkit-padding-end:4px;padding-inline-end:4px;padding-top:4px;padding-bottom:4px;position:absolute;width:36px;height:5px;-webkit-transform:translate(-50%, -50%);transform:translate(-50%, -50%);content:\"\"}:host(.modal-sheet){--height:calc(100% - (var(--ion-safe-area-top) + 10px))}:host(.modal-sheet) .modal-wrapper,:host(.modal-sheet) .modal-shadow{position:absolute;bottom:0}:host(.modal-sheet.modal-no-expand-scroll) ion-footer{position:absolute;bottom:0;width:var(--width)}:host{--backdrop-opacity:var(--ion-backdrop-opacity, 0.4)}:host(.modal-card),:host(.modal-sheet){--border-radius:10px}@media only screen and (min-width: 768px) and (min-height: 600px){:host{--border-radius:10px}}.modal-wrapper{-webkit-transform:translate3d(0,  100%,  0);transform:translate3d(0,  100%,  0)}@media screen and (max-width: 767px){@supports (width: max(0px, 1px)){:host(.modal-card){--height:calc(100% - max(30px, var(--ion-safe-area-top)) - 10px)}}@supports not (width: max(0px, 1px)){:host(.modal-card){--height:calc(100% - 40px)}}:host(.modal-card) .modal-wrapper{border-start-start-radius:var(--border-radius);border-start-end-radius:var(--border-radius);border-end-end-radius:0;border-end-start-radius:0}:host(.modal-card){--backdrop-opacity:0;--width:100%;-ms-flex-align:end;align-items:flex-end}:host(.modal-card) .modal-shadow{display:none}:host(.modal-card) ion-backdrop{pointer-events:none}}@media screen and (min-width: 768px){:host(.modal-card){--width:calc(100% - 120px);--height:calc(100% - (120px + var(--ion-safe-area-top) + var(--ion-safe-area-bottom)));--max-width:720px;--max-height:1000px;--backdrop-opacity:0;--box-shadow:0px 0px 30px 10px rgba(0, 0, 0, 0.1);-webkit-transition:all 0.5s ease-in-out;transition:all 0.5s ease-in-out}:host(.modal-card) .modal-wrapper{-webkit-box-shadow:none;box-shadow:none}:host(.modal-card) .modal-shadow{-webkit-box-shadow:var(--box-shadow);box-shadow:var(--box-shadow)}}:host(.modal-sheet) .modal-wrapper{border-start-start-radius:var(--border-radius);border-start-end-radius:var(--border-radius);border-end-end-radius:0;border-end-start-radius:0}";
+const modalIosCss = ":host{--width:100%;--min-width:auto;--max-width:auto;--height:100%;--min-height:auto;--max-height:auto;--overflow:hidden;--border-radius:0;--border-width:0;--border-style:none;--border-color:transparent;--background:var(--ion-background-color, #fff);--box-shadow:none;--backdrop-opacity:0;left:0;right:0;top:0;bottom:0;display:-ms-flexbox;display:flex;position:absolute;-ms-flex-align:center;align-items:center;-ms-flex-pack:center;justify-content:center;outline:none;color:var(--ion-text-color, #000);contain:strict}.modal-wrapper,ion-backdrop{pointer-events:auto}:host(.overlay-hidden){display:none}.modal-wrapper,.modal-shadow{border-radius:var(--border-radius);width:var(--width);min-width:var(--min-width);max-width:var(--max-width);height:var(--height);min-height:var(--min-height);max-height:var(--max-height);border-width:var(--border-width);border-style:var(--border-style);border-color:var(--border-color);background:var(--background);-webkit-box-shadow:var(--box-shadow);box-shadow:var(--box-shadow);overflow:var(--overflow);z-index:10}.modal-shadow{position:absolute;background:transparent}@media only screen and (min-width: 768px) and (min-height: 600px){:host{--width:600px;--height:500px}}@media only screen and (min-width: 768px) and (min-height: 768px){:host{--width:600px;--height:600px}}.modal-handle{left:0px;right:0px;top:5px;border-radius:8px;-webkit-margin-start:auto;margin-inline-start:auto;-webkit-margin-end:auto;margin-inline-end:auto;position:absolute;width:36px;height:5px;-webkit-transform:translateZ(0);transform:translateZ(0);border:0;background:var(--ion-color-step-350, var(--ion-background-color-step-350, #c0c0be));cursor:pointer;z-index:11}.modal-handle::before{-webkit-padding-start:4px;padding-inline-start:4px;-webkit-padding-end:4px;padding-inline-end:4px;padding-top:4px;padding-bottom:4px;position:absolute;width:36px;height:5px;-webkit-transform:translate(-50%, -50%);transform:translate(-50%, -50%);content:\"\"}:host(.modal-sheet){--height:calc(100% - (var(--ion-safe-area-top) + 10px))}:host(.modal-sheet) .modal-wrapper,:host(.modal-sheet) .modal-shadow{position:absolute;bottom:0}:host(.modal-sheet.modal-no-expand-scroll) ion-footer{position:absolute;bottom:0;width:var(--width)}:host{--backdrop-opacity:var(--ion-backdrop-opacity, 0.4)}:host(.modal-card),:host(.modal-sheet){--border-radius:10px}@media only screen and (min-width: 768px) and (min-height: 600px){:host{--border-radius:10px}}.modal-wrapper{-webkit-transform:translate3d(0,  100%,  0);transform:translate3d(0,  100%,  0)}@media screen and (max-width: 767px){@supports (width: max(0px, 1px)){:host(.modal-card){--height:calc(100% - max(30px, var(--ion-safe-area-top)) - 10px)}}@supports not (width: max(0px, 1px)){:host(.modal-card){--height:calc(100% - 40px)}}:host(.modal-card) .modal-wrapper{border-start-start-radius:var(--border-radius);border-start-end-radius:var(--border-radius);border-end-end-radius:0;border-end-start-radius:0}:host(.modal-card){--backdrop-opacity:0;--width:100%;-ms-flex-align:end;align-items:flex-end}:host(.modal-card) .modal-shadow{display:none}:host(.modal-card) ion-backdrop{pointer-events:none}}@media screen and (min-width: 768px){:host(.modal-card){--width:calc(100% - 120px);--height:calc(100% - (120px + var(--ion-safe-area-top) + var(--ion-safe-area-bottom)));--max-width:720px;--max-height:1000px;--backdrop-opacity:0;--box-shadow:0px 0px 30px 10px rgba(0, 0, 0, 0.1);-webkit-transition:all 0.5s ease-in-out;transition:all 0.5s ease-in-out}:host(.modal-card) .modal-wrapper{-webkit-box-shadow:none;box-shadow:none}:host(.modal-card) .modal-shadow{-webkit-box-shadow:var(--box-shadow);box-shadow:var(--box-shadow)}}:host(.modal-sheet) .modal-wrapper{border-start-start-radius:var(--border-radius);border-start-end-radius:var(--border-radius);border-end-end-radius:0;border-end-start-radius:0}";
 
-const modalMdCss = ":host{--width:100%;--min-width:auto;--max-width:auto;--height:100%;--min-height:auto;--max-height:auto;--overflow:hidden;--border-radius:0;--border-width:0;--border-style:none;--border-color:transparent;--background:var(--ion-background-color, #fff);--box-shadow:none;--backdrop-opacity:0;left:0;right:0;top:0;bottom:0;display:-ms-flexbox;display:flex;position:absolute;-ms-flex-align:center;align-items:center;-ms-flex-pack:center;justify-content:center;outline:none;color:var(--ion-text-color, #000);contain:strict}.modal-wrapper,ion-backdrop{pointer-events:auto}:host(.overlay-hidden){display:none}.modal-wrapper,.modal-shadow{border-radius:var(--border-radius);width:var(--width);min-width:var(--min-width);max-width:var(--max-width);height:var(--height);min-height:var(--min-height);max-height:var(--max-height);border-width:var(--border-width);border-style:var(--border-style);border-color:var(--border-color);background:var(--background);-webkit-box-shadow:var(--box-shadow);box-shadow:var(--box-shadow);overflow:var(--overflow);z-index:10}.modal-shadow{position:absolute;background:transparent}@media only screen and (min-width: 768px) and (min-height: 600px){: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){:host{--width:600px;--height:600px}}.modal-handle{left:0px;right:0px;top:5px;border-radius:8px;-webkit-margin-start:auto;margin-inline-start:auto;-webkit-margin-end:auto;margin-inline-end:auto;position:absolute;width:36px;height:5px;-webkit-transform:translateZ(0);transform:translateZ(0);border:0;background:var(--ion-color-step-350, var(--ion-background-color-step-350, #c0c0be));cursor:pointer;z-index:11}.modal-handle::before{-webkit-padding-start:4px;padding-inline-start:4px;-webkit-padding-end:4px;padding-inline-end:4px;padding-top:4px;padding-bottom:4px;position:absolute;width:36px;height:5px;-webkit-transform:translate(-50%, -50%);transform:translate(-50%, -50%);content:\"\"}:host(.modal-sheet){--height:calc(100% - (var(--ion-safe-area-top) + 10px))}:host(.modal-sheet) .modal-wrapper,:host(.modal-sheet) .modal-shadow{position:absolute;bottom:0}:host(.modal-sheet.modal-no-expand-scroll) ion-footer{position:absolute;bottom:0;width:var(--width)}:host{--backdrop-opacity:var(--ion-backdrop-opacity, 0.32)}@media only screen and (min-width: 768px) and (min-height: 600px){:host{--border-radius:2px;--box-shadow:0 28px 48px rgba(0, 0, 0, 0.4)}}.modal-wrapper{-webkit-transform:translate3d(0,  40px,  0);transform:translate3d(0,  40px,  0);opacity:0.01}";
+const modalMdCss = ":host{--width:100%;--min-width:auto;--max-width:auto;--height:100%;--min-height:auto;--max-height:auto;--overflow:hidden;--border-radius:0;--border-width:0;--border-style:none;--border-color:transparent;--background:var(--ion-background-color, #fff);--box-shadow:none;--backdrop-opacity:0;left:0;right:0;top:0;bottom:0;display:-ms-flexbox;display:flex;position:absolute;-ms-flex-align:center;align-items:center;-ms-flex-pack:center;justify-content:center;outline:none;color:var(--ion-text-color, #000);contain:strict}.modal-wrapper,ion-backdrop{pointer-events:auto}:host(.overlay-hidden){display:none}.modal-wrapper,.modal-shadow{border-radius:var(--border-radius);width:var(--width);min-width:var(--min-width);max-width:var(--max-width);height:var(--height);min-height:var(--min-height);max-height:var(--max-height);border-width:var(--border-width);border-style:var(--border-style);border-color:var(--border-color);background:var(--background);-webkit-box-shadow:var(--box-shadow);box-shadow:var(--box-shadow);overflow:var(--overflow);z-index:10}.modal-shadow{position:absolute;background:transparent}@media only screen and (min-width: 768px) and (min-height: 600px){:host{--width:600px;--height:500px}}@media only screen and (min-width: 768px) and (min-height: 768px){:host{--width:600px;--height:600px}}.modal-handle{left:0px;right:0px;top:5px;border-radius:8px;-webkit-margin-start:auto;margin-inline-start:auto;-webkit-margin-end:auto;margin-inline-end:auto;position:absolute;width:36px;height:5px;-webkit-transform:translateZ(0);transform:translateZ(0);border:0;background:var(--ion-color-step-350, var(--ion-background-color-step-350, #c0c0be));cursor:pointer;z-index:11}.modal-handle::before{-webkit-padding-start:4px;padding-inline-start:4px;-webkit-padding-end:4px;padding-inline-end:4px;padding-top:4px;padding-bottom:4px;position:absolute;width:36px;height:5px;-webkit-transform:translate(-50%, -50%);transform:translate(-50%, -50%);content:\"\"}:host(.modal-sheet){--height:calc(100% - (var(--ion-safe-area-top) + 10px))}:host(.modal-sheet) .modal-wrapper,:host(.modal-sheet) .modal-shadow{position:absolute;bottom:0}:host(.modal-sheet.modal-no-expand-scroll) ion-footer{position:absolute;bottom:0;width:var(--width)}:host{--backdrop-opacity:var(--ion-backdrop-opacity, 0.32)}@media only screen and (min-width: 768px) and (min-height: 600px){:host{--border-radius:2px;--box-shadow:0 28px 48px rgba(0, 0, 0, 0.4)}}.modal-wrapper{-webkit-transform:translate3d(0,  40px,  0);transform:translate3d(0,  40px,  0);opacity:0.01}";
 
 // TODO(FW-2832): types
 /**
@@ -22791,6 +22875,10 @@ 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;
@@ -22981,7 +23069,10 @@ 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$1(this) !== 'ios' || !this.presentingElement || this.enterAnimation || this.leaveAnimation) {
             return;
         }
@@ -23004,6 +23095,8 @@ 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;
@@ -23163,6 +23256,8 @@ 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;
         /**
@@ -23224,6 +23319,8 @@ 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
@@ -23275,7 +23372,7 @@ class Modal {
                 await this.dismiss(undefined, GESTURE);
                 this.gestureAnimationDismissing = false;
             });
-        });
+        }, () => this.updateSafeAreaOverrides());
         this.gesture.enable(true);
     }
     initSheetGesture() {
@@ -23296,7 +23393,8 @@ class Modal {
                 this.currentBreakpoint = breakpoint;
                 this.ionBreakpointDidChange.emit({ breakpoint });
             }
-        });
+            this.updateSafeAreaOverrides();
+        }, () => this.updateSafeAreaOverrides());
         this.gesture = gesture;
         this.moveSheetToBreakpoint = moveSheetToBreakpoint;
         this.gesture.enable(true);
@@ -23374,6 +23472,187 @@ 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$1(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;
+        }
+        // Phone-sized fullscreen modals inherit safe areas and use wrapper padding
+        if (!isTablet) {
+            this.applyFullscreenSafeArea();
+            return;
+        }
+        // Check if tablet modal is fullscreen via CSS custom properties
+        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 {
+            // Centered dialog doesn't touch edges
+            this.zeroAllSafeAreas();
+        }
+    }
+    /**
+     * 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$1 !== undefined && 'MutationObserver' in win$1) {
+            this.footerObserver = new MutationObserver(() => this.updateFooterPadding());
+            this.footerObserver.observe(this.el, { childList: true, subtree: true });
+        }
+    }
+    /**
+     * Updates wrapper padding based on footer presence.
+     * Called initially and when footer is dynamically added/removed.
+     */
+    updateFooterPadding() {
+        if (!this.wrapperEl)
+            return;
+        const hasFooter = this.el.querySelector('ion-footer') !== null;
+        if (hasFooter) {
+            this.wrapperEl.style.removeProperty('padding-bottom');
+            this.wrapperEl.style.removeProperty('box-sizing');
+        }
+        else {
+            this.wrapperEl.style.setProperty('padding-bottom', 'var(--ion-safe-area-bottom, 0px)');
+            this.wrapperEl.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 styles that may have been set for safe-area handling
+        if (this.wrapperEl) {
+            this.wrapperEl.style.removeProperty('padding-bottom');
+            this.wrapperEl.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
@@ -23466,6 +23745,8 @@ class Modal {
         }
         this.currentBreakpoint = undefined;
         this.animation = undefined;
+        // Reset safe-area state for potential re-presentation
+        this.resetSafeAreaState();
         unlock();
         return dismissed;
     }
@@ -23715,20 +23996,20 @@ class Modal {
         const isCardModal = presentingElement !== undefined && mode === 'ios';
         const isHandleCycle = handleBehavior === 'cycle';
         const isSheetModalWithHandle = isSheetModal && showHandle;
-        return (hAsync(Host, Object.assign({ key: '87328006ea6c75ebc518ace300438492a567223e', "no-router": true,
+        return (hAsync(Host, Object.assign({ key: '44022099fcaf047b97d1c2cb45b9b51c930e707c', "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 }), hAsync("ion-backdrop", { key: 'ee94ff8e09b691dd4ad4e4db1720f06bc3c5a469', ref: (el) => (this.backdropEl = el), visible: this.showBackdrop, tappable: this.backdropDismiss, part: "backdrop" }), mode === 'ios' && hAsync("div", { key: 'bffd69b4635c22d9f249725bd952c1e93d5615c7', class: "modal-shadow" }), hAsync("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 }), hAsync("ion-backdrop", { key: 'ddd7e4f6eef51ac1f62ac70e0af10fb01e707f07', ref: (el) => (this.backdropEl = el), visible: this.showBackdrop, tappable: this.backdropDismiss, part: "backdrop" }), mode === 'ios' && hAsync("div", { key: '58620980e3e4ec273c6787bde026e1c010b904b7', class: "modal-shadow" }), hAsync("div", Object.assign({ key: '3fb7f6218644ba898fc504467775593eb89426a0',
             /*
               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 && (hAsync("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 && (hAsync("button", { key: '9745cd590fdaa9d023a14b487ec2c87ddbafd7f7', 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) })), hAsync("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) })), hAsync("slot", { key: 'b9a8b5d2d3d3c9b06f99179f496c9f08907d0bad', onSlotchange: this.onSlotChange }))));
     }
     get el() { return getElement(this); }
     static get watchers() { return {
@@ -27306,6 +27587,8 @@ const calculateWindowAdjustment = (side, coordTop, coordLeft, bodyPadding, bodyW
     let bottom;
     let originX = contentOriginX;
     let originY = contentOriginY;
+    let checkSafeAreaTop = false;
+    let checkSafeAreaBottom = false;
     let checkSafeAreaLeft = false;
     let checkSafeAreaRight = false;
     const triggerTop = triggerCoordinates
@@ -27350,10 +27633,18 @@ const calculateWindowAdjustment = (side, coordTop, coordLeft, bodyPadding, bodyW
              * 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.
@@ -27361,14 +27652,35 @@ const calculateWindowAdjustment = (side, coordTop, coordLeft, bodyPadding, bodyW
         }
         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,
@@ -27429,7 +27741,7 @@ const iosEnterAnimation$1 = (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();
@@ -27459,19 +27771,35 @@ const iosEnterAnimation$1 = (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) {
@@ -27547,7 +27875,32 @@ const mdEnterAnimation$1 = (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();
@@ -27564,13 +27917,13 @@ const mdEnterAnimation$1 = (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)');
@@ -34988,7 +35341,6 @@ class TabBar {
         this.ionTabBarChanged = createEvent(this, "ionTabBarChanged", 7);
         this.ionTabBarLoaded = createEvent(this, "ionTabBarLoaded", 7);
         this.keyboardCtrl = null;
-        this.keyboardCtrlPromise = null;
         this.didLoad = false;
         this.keyboardVisible = false;
         /**
@@ -35024,7 +35376,7 @@ class TabBar {
         }
     }
     async connectedCallback() {
-        const promise = createKeyboardController(async (keyboardOpen, waitForResize) => {
+        this.keyboardCtrl = await createKeyboardController(async (keyboardOpen, waitForResize) => {
             /**
              * If the keyboard is hiding, then we need to wait
              * for the webview to resize. Otherwise, the tab bar
@@ -35035,40 +35387,21 @@ class TabBar {
             }
             this.keyboardVisible = keyboardOpen; // trigger re-render by updating state
         });
-        this.keyboardCtrlPromise = promise;
-        const keyboardCtrl = await promise;
-        /**
-         * Only assign if this is still the current promise.
-         * Otherwise, a new connectedCallback has started or
-         * disconnectedCallback was called, so destroy this instance.
-         */
-        if (this.keyboardCtrlPromise === promise) {
-            this.keyboardCtrl = keyboardCtrl;
-            this.keyboardCtrlPromise = null;
-        }
-        else {
-            keyboardCtrl.destroy();
-        }
     }
     disconnectedCallback() {
-        if (this.keyboardCtrlPromise) {
-            this.keyboardCtrlPromise.then((ctrl) => ctrl.destroy());
-            this.keyboardCtrlPromise = null;
-        }
         if (this.keyboardCtrl) {
             this.keyboardCtrl.destroy();
-            this.keyboardCtrl = null;
         }
     }
     render() {
         const { color, translucent, keyboardVisible } = this;
         const mode = getIonMode$1(this);
         const shouldHide = keyboardVisible && this.el.getAttribute('slot') !== 'top';
-        return (hAsync(Host, { key: '9daf4e2acaff6e3ce3878cf9dd5109fb1afbbebe', role: "tablist", "aria-hidden": shouldHide ? 'true' : null, class: createColorClasses$1(color, {
+        return (hAsync(Host, { key: '388ec37ce308035bab78d6c9a016bb616e9517a9', role: "tablist", "aria-hidden": shouldHide ? 'true' : null, class: createColorClasses$1(color, {
                 [mode]: true,
                 'tab-bar-translucent': translucent,
                 'tab-bar-hidden': shouldHide,
-            }) }, hAsync("slot", { key: '1d15aa2da8501e8e7eff11ad4a491478be845c43' })));
+            }) }, hAsync("slot", { key: 'ce10ade2b86725e24f3254516483eeedd8ecb16a' })));
     }
     get el() { return getElement(this); }
     static get watchers() { return {