@ionic/core 8.8.17 → 8.8.18-dev.11786108988.1fd94742

package/dist/cjs/ion-modal.cjs.entry.js

@@ -3,24 +3,24 @@
  */
 'use strict';
 
-var index$3 = require('./index-Ct7gcRif.js');
-var index$2 = require('./index-CIrkNXqJ.js');
-var frameworkDelegate = require('./framework-delegate-BtICZDHr.js');
-var helpers = require('./helpers-Cv23MFHM.js');
+var index$3 = require('./index-CAThePqm.js');
+var index$2 = require('./index-BnhnwL1o.js');
+var frameworkDelegate = require('./framework-delegate-Bdvk3JQO.js');
+var helpers = require('./helpers-DURh1XdY.js');
 var lockController = require('./lock-controller-aDB9wrEf.js');
 var capacitor = require('./capacitor-DmA66EwP.js');
-var overlays = require('./overlays-DdtIYQUH.js');
-var theme = require('./theme-CeDs6Hcv.js');
-var index$4 = require('./index-BERfRao3.js');
-var ionicGlobal = require('./ionic-global-B-cA6LkY.js');
-var keyboard = require('./keyboard-hHzlEQpk.js');
-var animation = require('./animation-BJq0kcy2.js');
+var overlays = require('./overlays-C2qrqpHm.js');
+var theme = require('./theme-Bw0rpaNN.js');
+var index$4 = require('./index-DsoHs7Ly.js');
+var ionicGlobal = require('./ionic-global-dMut1Czp.js');
+var keyboard = require('./keyboard-Cix5TVkD.js');
+var animation = require('./animation-D5WDBRvT.js');
 var cubicBezier = require('./cubic-bezier-DAjy1V-e.js');
-var index$1 = require('./index-CAvQ7Tka.js');
+var index$1 = require('./index-P1nQxrpZ.js');
 var index = require('./index-DkNv4J_i.js');
-require('./hardware-back-button-iUuF_76h.js');
-require('./gesture-controller-dtqlP_q4.js');
-require('./keyboard-UuAS4D_9.js');
+require('./hardware-back-button-zr8zeYaH.js');
+require('./gesture-controller-BDUH7687.js');
+require('./keyboard-cHxZlTyz.js');
 
 var Style;
 (function (Style) {
@@ -31,7 +31,7 @@ var Style;
 const StatusBar = {
     getEngine() {
         const capacitor$1 = capacitor.getCapacitor();
-        if (capacitor$1 === null || capacitor$1 === void 0 ? void 0 : capacitor$1.isPluginAvailable('StatusBar')) {
+        if (capacitor$1?.isPluginAvailable('StatusBar')) {
             return capacitor$1.Plugins.StatusBar;
         }
         return undefined;
@@ -333,14 +333,13 @@ const createSwipeToCloseGesture = (el, animation, statusBarStyle, onDismiss, onD
         return false;
     };
     const onStart = (detail) => {
-        var _a;
         const { deltaY } = detail;
         /**
          * Firefox automatically selects the header text during drag
          * due to the focusable wrapper (tabindex="-1"). Remove any
          * selection that may have occurred.
          */
-        (_a = window.getSelection()) === null || _a === void 0 ? void 0 : _a.removeAllRanges();
+        window.getSelection()?.removeAllRanges();
         /**
          * Get the initial scrollY value so
          * that we can correctly reset the scrollY
@@ -640,7 +639,7 @@ const iosEnterAnimation = (baseEl, opts) => {
     wrapperAnimation.addElement(root.querySelectorAll('.modal-wrapper, .modal-shadow')).beforeStyles({ opacity: 1 });
     // The content animation is only added if scrolling is enabled for
     // all the breakpoints.
-    !expandToScroll && (contentAnimation === null || contentAnimation === void 0 ? void 0 : contentAnimation.addElement(baseEl.querySelector('.ion-page')));
+    !expandToScroll && contentAnimation?.addElement(baseEl.querySelector('.ion-page'));
     const baseAnimation = animation.createAnimation('entering-base')
         .addElement(baseEl)
         .easing('cubic-bezier(0.32,0.72,0,1)')
@@ -973,7 +972,7 @@ const mdEnterAnimation = (baseEl, opts) => {
     wrapperAnimation.addElement(root.querySelector('.modal-wrapper'));
     // The content animation is only added if scrolling is enabled for
     // all the breakpoints.
-    !expandToScroll && (contentAnimation === null || contentAnimation === void 0 ? void 0 : contentAnimation.addElement(baseEl.querySelector('.ion-page')));
+    !expandToScroll && contentAnimation?.addElement(baseEl.querySelector('.ion-page'));
     const baseAnimation = animation.createAnimation()
         .addElement(baseEl)
         .easing('cubic-bezier(0.36,0.66,0.04,1)')
@@ -1097,9 +1096,9 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
                 cachedFooterEl.style.removeProperty('height');
                 cachedFooterEl.style.removeProperty('top');
                 cachedFooterEl.style.removeProperty('left');
-                page === null || page === void 0 ? void 0 : page.style.removeProperty('padding-bottom');
+                page?.style.removeProperty('padding-bottom');
                 // Move to page
-                page === null || page === void 0 ? void 0 : page.appendChild(cachedFooterEl);
+                page?.appendChild(cachedFooterEl);
             });
         }
         else {
@@ -1143,7 +1142,7 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
                 // when the footer is positioned absolutely. This has to be done before we
                 // make the footer absolutely positioned or we may accidentally cause the
                 // sheet to scroll.
-                page === null || page === void 0 ? void 0 : page.style.setProperty('padding-bottom', `${footerHeights}px`);
+                page?.style.setProperty('padding-bottom', `${footerHeights}px`);
                 // Apply positioning styles to keep footer at bottom
                 cachedFooterEl.classList.add('modal-footer-moving');
                 // Apply our preserved styles to pin the footer
@@ -1168,7 +1167,7 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
     if (wrapperAnimation && backdropAnimation) {
         wrapperAnimation.keyframes([...SheetDefaults.WRAPPER_KEYFRAMES]);
         backdropAnimation.keyframes([...SheetDefaults.BACKDROP_KEYFRAMES]);
-        contentAnimation === null || contentAnimation === void 0 ? void 0 : contentAnimation.keyframes([...SheetDefaults.CONTENT_KEYFRAMES]);
+        contentAnimation?.keyframes([...SheetDefaults.CONTENT_KEYFRAMES]);
         animation.progressStart(true, 1 - currentBreakpoint);
         /**
          * If backdrop is not enabled, then content
@@ -1226,13 +1225,12 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
         return true;
     };
     const onStart = (detail) => {
-        var _a;
         /**
          * Firefox automatically selects the header text during drag
          * due to the focusable wrapper (tabindex="-1"). Remove any
          * selection that may have occurred.
          */
-        (_a = window.getSelection()) === null || _a === void 0 ? void 0 : _a.removeAllRanges();
+        window.getSelection()?.removeAllRanges();
         /**
          * If canDismiss is anything other than `true`
          * then users should be able to swipe down
@@ -1496,7 +1494,7 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
                         helpers.raf(() => {
                             wrapperAnimation.keyframes([...SheetDefaults.WRAPPER_KEYFRAMES]);
                             backdropAnimation.keyframes([...SheetDefaults.BACKDROP_KEYFRAMES]);
-                            contentAnimation === null || contentAnimation === void 0 ? void 0 : contentAnimation.keyframes([...SheetDefaults.CONTENT_KEYFRAMES]);
+                            contentAnimation?.keyframes([...SheetDefaults.CONTENT_KEYFRAMES]);
                             animation.progressStart(true, 1 - snapToBreakpoint);
                             currentBreakpoint = snapToBreakpoint;
                             onBreakpointChange(currentBreakpoint);
@@ -1695,8 +1693,8 @@ const getRootSafeAreaTop = () => {
     if (cachedRootSafeAreaTop !== null) {
         return cachedRootSafeAreaTop;
     }
-    const doc = index.win === null || index.win === void 0 ? void 0 : index.win.document;
-    if (!(doc === null || doc === void 0 ? void 0 : doc.body)) {
+    const doc = index.win?.document;
+    if (!doc?.body) {
         return 0;
     }
     const el = doc.createElement('div');
@@ -1799,10 +1797,9 @@ const getInitialSafeAreaConfig = (context) => {
  * @returns SafeAreaConfig based on position
  */
 const getPositionBasedSafeAreaConfig = (wrapperEl) => {
-    var _a, _b;
     const rect = wrapperEl.getBoundingClientRect();
-    const vh = (_a = index.win === null || index.win === void 0 ? void 0 : index.win.innerHeight) !== null && _a !== void 0 ? _a : 0;
-    const vw = (_b = index.win === null || index.win === void 0 ? void 0 : index.win.innerWidth) !== null && _b !== void 0 ? _b : 0;
+    const vh = index.win?.innerHeight ?? 0;
+    const vw = index.win?.innerWidth ?? 0;
     // Only apply safe-area to sides where modal overlaps with screen edge
     return {
         top: rect.top <= EDGE_THRESHOLD ? 'inherit' : '0px',
@@ -1855,195 +1852,176 @@ const Modal = class {
         this.ionDragStart = index$3.createEvent(this, "ionDragStart", 7);
         this.ionDragMove = index$3.createEvent(this, "ionDragMove", 7);
         this.ionDragEnd = index$3.createEvent(this, "ionDragEnd", 7);
-        this.lockController = lockController.createLockController();
-        this.triggerController = overlays.createTriggerController();
-        this.coreDelegate = frameworkDelegate.CoreDelegate();
-        this.isSheetModal = false;
-        this.inheritedAttributes = {};
-        this.inline = false;
-        // Whether or not modal is being dismissed via gesture
-        this.gestureAnimationDismissing = false;
-        this.presented = false;
-        /** @internal */
-        this.hasController = false;
-        /**
-         * If `true`, the keyboard will be automatically dismissed when the overlay is presented.
-         */
-        this.keyboardClose = true;
-        /**
-         * Controls whether scrolling or dragging within the sheet modal expands
-         * it to a larger breakpoint. This only takes effect when `breakpoints`
-         * and `initialBreakpoint` are set.
-         *
-         * If `true`, scrolling or dragging anywhere in the modal will first expand
-         * it to the next breakpoint. Once fully expanded, scrolling will affect the
-         * content.
-         * If `false`, scrolling will always affect the content. The modal will
-         * only expand when dragging the header or handle. The modal will close when
-         * dragging the header or handle. It can also be closed when dragging the
-         * content, but only if the content is scrolled to the top.
-         */
-        this.expandToScroll = true;
-        /**
-         * A decimal value between 0 and 1 that indicates the
-         * point after which the backdrop will begin to fade in
-         * when using a sheet modal. Prior to this point, the
-         * backdrop will be hidden and the content underneath
-         * the sheet can be interacted with. This value is exclusive
-         * meaning the backdrop will become active after the value
-         * specified.
-         */
-        this.backdropBreakpoint = 0;
-        /**
-         * The interaction behavior for the sheet modal when the handle is pressed.
-         *
-         * Defaults to `"none"`, which  means the modal will not change size or position when the handle is pressed.
-         * Set to `"cycle"` to let the modal cycle between available breakpoints when pressed.
-         *
-         * Handle behavior is unavailable when the `handle` property is set to `false` or
-         * when the `breakpoints` property is not set (using a fullscreen or card modal).
-         */
-        this.handleBehavior = 'none';
-        /**
-         * If `true`, the modal will be dismissed when the backdrop is clicked.
-         */
-        this.backdropDismiss = true;
-        /**
-         * If `true`, a backdrop will be displayed behind the modal.
-         * This property controls whether or not the backdrop
-         * darkens the screen when the modal is presented.
-         * It does not control whether or not the backdrop
-         * is active or present in the DOM.
-         */
-        this.showBackdrop = true;
-        /**
-         * If `true`, the modal will animate.
-         */
-        this.animated = true;
-        /**
-         * If `true`, the modal will open. If `false`, the modal will close.
-         * Use this if you need finer grained control over presentation, otherwise
-         * just use the modalController or the `trigger` property.
-         * Note: `isOpen` will not automatically be set back to `false` when
-         * the modal dismisses. You will need to do that in your code.
-         */
-        this.isOpen = false;
-        /**
-         * If `true`, the component passed into `ion-modal` will
-         * automatically be mounted when the modal is created. The
-         * component will remain mounted even when the modal is dismissed.
-         * However, the component will be destroyed when the modal is
-         * destroyed. This property is not reactive and should only be
-         * used when initially creating a modal.
-         *
-         * Note: This feature only applies to inline modals in JavaScript
-         * frameworks such as Angular, React, and Vue.
-         */
-        this.keepContentsMounted = false;
-        /**
-         * If `true`, focus will not be allowed to move outside of this overlay.
-         * If `false`, focus will be allowed to move outside of the overlay.
-         *
-         * In most scenarios this property should remain set to `true`. Setting
-         * this property to `false` can cause severe accessibility issues as users
-         * relying on assistive technologies may be able to move focus into
-         * a confusing state. We recommend only setting this to `false` when
-         * absolutely necessary.
-         *
-         * Developers may want to consider disabling focus trapping if this
-         * overlay presents a non-Ionic overlay from a 3rd party library.
-         * Developers would disable focus trapping on the Ionic overlay
-         * when presenting the 3rd party overlay and then re-enable
-         * focus trapping when dismissing the 3rd party overlay and moving
-         * focus back to the Ionic overlay.
-         */
-        this.focusTrap = true;
-        /**
-         * Determines whether or not a modal can dismiss
-         * when calling the `dismiss` method.
-         *
-         * If the value is `true` or the value's function returns `true`, the modal will close when trying to dismiss.
-         * If the value is `false` or the value's function returns `false`, the modal will not close when trying to dismiss.
-         *
-         * See https://ionicframework.com/docs/troubleshooting/runtime#accessing-this
-         * if you need to access `this` from within the callback.
-         */
-        this.canDismiss = true;
-        this.onHandleClick = () => {
-            const { sheetTransition, handleBehavior } = this;
-            if (handleBehavior !== 'cycle' || sheetTransition !== undefined) {
-                /**
-                 * The sheet modal should not advance to the next breakpoint
-                 * if the handle behavior is not `cycle` or if the handle
-                 * is clicked while the sheet is moving to a breakpoint.
-                 */
-                return;
-            }
-            this.moveToNextBreakpoint();
-        };
-        this.onBackdropTap = () => {
-            const { sheetTransition } = this;
-            if (sheetTransition !== undefined) {
-                /**
-                 * When the handle is double clicked at the largest breakpoint,
-                 * it will start to move to the first breakpoint. While transitioning,
-                 * the backdrop will often receive the second click. We prevent the
-                 * backdrop from dismissing the modal while moving between breakpoints.
-                 */
-                return;
-            }
-            this.dismiss(undefined, overlays.BACKDROP);
-        };
-        this.onLifecycle = (modalEvent) => {
-            const el = this.usersElement;
-            const name = LIFECYCLE_MAP[modalEvent.type];
-            if (el && name) {
-                const ev = new CustomEvent(name, {
-                    bubbles: false,
-                    cancelable: false,
-                    detail: modalEvent.detail,
-                });
-                el.dispatchEvent(ev);
-            }
-        };
-        /**
-         * When the modal receives focus directly, pass focus to the handle
-         * if it exists and is focusable, otherwise let the focus trap handle it.
-         */
-        this.onModalFocus = (ev) => {
-            var _a;
-            const { dragHandleEl, el } = this;
-            /**
-             * Shadow DOM focus is retargeted to the host, so `ev.target === el` is also
-             * true when a shadow child (the dialog wrapper present() focuses) is focused.
-             * shadowRoot's activeElement is null only when the host was focused directly,
-             * so redirect to the handle only then and leave present()'s wrapper focus intact.
-             */
-            if (ev.target === el && ((_a = el.shadowRoot) === null || _a === void 0 ? void 0 : _a.activeElement) == null && dragHandleEl && dragHandleEl.tabIndex !== -1) {
-                dragHandleEl.focus();
-            }
-        };
-        /**
-         * When the slot changes, we need to find all the modals in the slot
-         * and set the data-parent-ion-modal attribute on them so we can find them
-         * and dismiss them when we get dismissed.
-         * We need to do it this way because when a modal is opened, it's moved to
-         * the end of the body and is no longer an actual child of the modal.
-         */
-        this.onSlotChange = ({ target }) => {
-            const slot = target;
-            slot.assignedElements().forEach((el) => {
-                el.querySelectorAll('ion-modal').forEach((childModal) => {
-                    // We don't need to write to the DOM if the modal is already tagged
-                    // If this is a deeply nested modal, this effect should cascade so we don't
-                    // need to worry about another modal claiming the same child.
-                    if (childModal.getAttribute('data-parent-ion-modal') === null) {
-                        childModal.setAttribute('data-parent-ion-modal', this.el.id);
-                    }
-                });
-            });
-        };
     }
+    lockController = lockController.createLockController();
+    triggerController = overlays.createTriggerController();
+    gesture;
+    coreDelegate = frameworkDelegate.CoreDelegate();
+    sheetTransition;
+    isSheetModal = false;
+    /**
+     * The breakpoint value that has been committed for a sheet modal.
+     * This represents the modal's resting state when it is not being dragged
+     * or animating toward a new position.
+     */
+    currentBreakpoint;
+    wrapperEl;
+    backdropEl;
+    dragHandleEl;
+    sortedBreakpoints;
+    keyboardOpenCallback;
+    moveSheetToBreakpoint;
+    inheritedAttributes = {};
+    statusBarStyle;
+    inline = false;
+    workingDelegate;
+    // Reference to the user's provided modal content
+    usersElement;
+    // Whether or not modal is being dismissed via gesture
+    gestureAnimationDismissing = false;
+    // View transition properties for handling portrait/landscape switches
+    currentViewIsPortrait;
+    viewTransitionAnimation;
+    resizeTimeout;
+    // Mutation observer to watch for parent removal
+    parentRemovalObserver;
+    // Cached original parent from before modal is moved to body during presentation
+    cachedOriginalParent;
+    // Cached ion-page ancestor for child route passthrough
+    cachedPageParent;
+    lastFocus;
+    animation;
+    presented = false;
+    get el() { return index$3.getElement(this); }
+    /** @internal */
+    hasController = false;
+    /** @internal */
+    overlayIndex;
+    /** @internal */
+    delegate;
+    /**
+     * If `true`, the keyboard will be automatically dismissed when the overlay is presented.
+     */
+    keyboardClose = true;
+    /**
+     * Animation to use when the modal is presented.
+     */
+    enterAnimation;
+    /**
+     * Animation to use when the modal is dismissed.
+     */
+    leaveAnimation;
+    /**
+     * The breakpoints to use when creating a sheet modal. Each value in the
+     * array must be a decimal between 0 and 1 where 0 indicates the modal is fully
+     * closed and 1 indicates the modal is fully open. Values are relative
+     * to the height of the modal, not the height of the screen. One of the values in this
+     * array must be the value of the `initialBreakpoint` property.
+     * For example: [0, .25, .5, 1]
+     */
+    breakpoints;
+    /**
+     * Controls whether scrolling or dragging within the sheet modal expands
+     * it to a larger breakpoint. This only takes effect when `breakpoints`
+     * and `initialBreakpoint` are set.
+     *
+     * If `true`, scrolling or dragging anywhere in the modal will first expand
+     * it to the next breakpoint. Once fully expanded, scrolling will affect the
+     * content.
+     * If `false`, scrolling will always affect the content. The modal will
+     * only expand when dragging the header or handle. The modal will close when
+     * dragging the header or handle. It can also be closed when dragging the
+     * content, but only if the content is scrolled to the top.
+     */
+    expandToScroll = true;
+    /**
+     * A decimal value between 0 and 1 that indicates the
+     * initial point the modal will open at when creating a
+     * sheet modal. This value must also be listed in the
+     * `breakpoints` array.
+     */
+    initialBreakpoint;
+    /**
+     * A decimal value between 0 and 1 that indicates the
+     * point after which the backdrop will begin to fade in
+     * when using a sheet modal. Prior to this point, the
+     * backdrop will be hidden and the content underneath
+     * the sheet can be interacted with. This value is exclusive
+     * meaning the backdrop will become active after the value
+     * specified.
+     */
+    backdropBreakpoint = 0;
+    /**
+     * The horizontal line that displays at the top of a sheet modal. It is `true` by default when
+     * setting the `breakpoints` and `initialBreakpoint` properties.
+     */
+    handle;
+    /**
+     * The interaction behavior for the sheet modal when the handle is pressed.
+     *
+     * Handle behavior is unavailable when the `handle` property is set to
+     * `false` or when the `breakpoints` property is not set (using a
+     * fullscreen or card modal).
+     *
+     * Set to `"cycle"` to make the handle focusable and let the sheet modal
+     * cycle between available breakpoints when pressed. This keeps the sheet
+     * operable with assistive technology.
+     *
+     * Set to `"none"` to make the handle purely decorative when pressed and
+     * removed from the tab order.
+     *
+     * Defaults to `"cycle"`.
+     */
+    handleBehavior = 'cycle';
+    /**
+     * The component to display inside of the modal.
+     * @internal
+     */
+    component;
+    /**
+     * The data to pass to the modal component.
+     * @internal
+     */
+    componentProps;
+    /**
+     * Additional classes to apply for custom CSS. If multiple classes are
+     * provided they should be separated by spaces.
+     * @internal
+     */
+    cssClass;
+    /**
+     * If `true`, the modal will be dismissed when the backdrop is clicked.
+     */
+    backdropDismiss = true;
+    /**
+     * If `true`, a backdrop will be displayed behind the modal.
+     * This property controls whether or not the backdrop
+     * darkens the screen when the modal is presented.
+     * It does not control whether or not the backdrop
+     * is active or present in the DOM.
+     */
+    showBackdrop = true;
+    /**
+     * If `true`, the modal will animate.
+     */
+    animated = true;
+    /**
+     * The element that presented the modal. This is used for card presentation effects
+     * and for stacking multiple modals on top of each other. Only applies in iOS mode.
+     */
+    presentingElement;
+    /**
+     * Additional attributes to pass to the modal.
+     */
+    htmlAttributes;
+    /**
+     * If `true`, the modal will open. If `false`, the modal will close.
+     * Use this if you need finer grained control over presentation, otherwise
+     * just use the modalController or the `trigger` property.
+     * Note: `isOpen` will not automatically be set back to `false` when
+     * the modal dismisses. You will need to do that in your code.
+     */
+    isOpen = false;
     onIsOpenChange(newValue, oldValue) {
         if (newValue === true && oldValue === false) {
             this.present();
@@ -2052,6 +2030,11 @@ const Modal = class {
             this.dismiss();
         }
     }
+    /**
+     * An ID corresponding to the trigger element that
+     * causes the modal to open when clicked.
+     */
+    trigger;
     triggerChanged() {
         const { trigger, el, triggerController } = this;
         if (trigger) {
@@ -2084,6 +2067,108 @@ const Modal = class {
             }
         }, 50); // Debounce to avoid excessive calls during active resizing
     }
+    /**
+     * If `true`, the component passed into `ion-modal` will
+     * automatically be mounted when the modal is created. The
+     * component will remain mounted even when the modal is dismissed.
+     * However, the component will be destroyed when the modal is
+     * destroyed. This property is not reactive and should only be
+     * used when initially creating a modal.
+     *
+     * Note: This feature only applies to inline modals in JavaScript
+     * frameworks such as Angular, React, and Vue.
+     */
+    keepContentsMounted = false;
+    /**
+     * If `true`, focus will not be allowed to move outside of this overlay.
+     * If `false`, focus will be allowed to move outside of the overlay.
+     *
+     * In most scenarios this property should remain set to `true`. Setting
+     * this property to `false` can cause severe accessibility issues as users
+     * relying on assistive technologies may be able to move focus into
+     * a confusing state. We recommend only setting this to `false` when
+     * absolutely necessary.
+     *
+     * Developers may want to consider disabling focus trapping if this
+     * overlay presents a non-Ionic overlay from a 3rd party library.
+     * Developers would disable focus trapping on the Ionic overlay
+     * when presenting the 3rd party overlay and then re-enable
+     * focus trapping when dismissing the 3rd party overlay and moving
+     * focus back to the Ionic overlay.
+     */
+    focusTrap = true;
+    /**
+     * Determines whether or not a modal can dismiss
+     * when calling the `dismiss` method.
+     *
+     * If the value is `true` or the value's function returns `true`, the modal will close when trying to dismiss.
+     * If the value is `false` or the value's function returns `false`, the modal will not close when trying to dismiss.
+     *
+     * See https://ionicframework.com/docs/troubleshooting/runtime#accessing-this
+     * if you need to access `this` from within the callback.
+     */
+    canDismiss = true;
+    /**
+     * Emitted after the modal has presented.
+     */
+    didPresent;
+    /**
+     * Emitted before the modal has presented.
+     */
+    willPresent;
+    /**
+     * Emitted before the modal has dismissed.
+     */
+    willDismiss;
+    /**
+     * Emitted after the modal has dismissed.
+     */
+    didDismiss;
+    /**
+     * Emitted after the modal breakpoint has changed.
+     */
+    ionBreakpointDidChange;
+    /**
+     * Emitted after the modal has presented.
+     * Shorthand for ionModalDidPresent.
+     */
+    didPresentShorthand;
+    /**
+     * Emitted before the modal has presented.
+     * Shorthand for ionModalWillPresent.
+     */
+    willPresentShorthand;
+    /**
+     * Emitted before the modal has dismissed.
+     * Shorthand for ionModalWillDismiss.
+     */
+    willDismissShorthand;
+    /**
+     * Emitted after the modal has dismissed.
+     * Shorthand for ionModalDidDismiss.
+     */
+    didDismissShorthand;
+    /**
+     * Emitted before the modal has presented, but after the component
+     * has been mounted in the DOM.
+     * This event exists so iOS can run the entering
+     * transition properly
+     *
+     * @internal
+     */
+    ionMount;
+    /**
+     * Event that is emitted when the sheet modal or card modal gesture starts.
+     */
+    ionDragStart;
+    /**
+     * Event that is emitted when the sheet modal or card modal gesture moves.
+     */
+    ionDragMove;
+    /**
+     * Event that is emitted when the sheet modal or card modal gesture ends.
+     */
+    ionDragEnd;
     breakpointsChanged(breakpoints) {
         if (breakpoints !== undefined) {
             this.sortedBreakpoints = breakpoints.sort((a, b) => a - b);
@@ -2101,9 +2186,12 @@ const Modal = class {
         // Also called in dismiss() — intentional dual cleanup covers both
         // dismiss-then-remove and direct DOM removal without dismiss.
         this.cleanupSafeAreaOverrides();
+        // Clean up aria-hidden if removed without dismiss() being called
+        if (this.presented) {
+            overlays.cleanupRootFocusTrapAccessibility();
+        }
     }
     componentWillLoad() {
-        var _a;
         const { breakpoints, initialBreakpoint, el, htmlAttributes } = this;
         const isSheetModal = (this.isSheetModal = breakpoints !== undefined && initialBreakpoint !== undefined);
         const attributesToInherit = ['aria-label', 'role'];
@@ -2138,7 +2226,10 @@ const Modal = class {
                      * htmlAttributes wins, but that's not a pattern that we recommend.
                      * The only time you'd need htmlAttributes is when using modalController.
                      */
-                    this.inheritedAttributes = Object.assign(Object.assign({}, this.inheritedAttributes), { [attribute]: htmlAttributes[attribute] });
+                    this.inheritedAttributes = {
+                        ...this.inheritedAttributes,
+                        [attribute]: htmlAttributes[attribute],
+                    };
                     delete htmlAttributes[attribute];
                 }
             });
@@ -2149,7 +2240,7 @@ const Modal = class {
         if (breakpoints !== undefined && initialBreakpoint !== undefined && !breakpoints.includes(initialBreakpoint)) {
             index$3.printIonWarning('[ion-modal] - Your breakpoints array must include the initialBreakpoint value.');
         }
-        if (!((_a = this.htmlAttributes) === null || _a === void 0 ? void 0 : _a.id)) {
+        if (!this.htmlAttributes?.id) {
             overlays.setOverlayId(this.el);
         }
     }
@@ -2331,7 +2422,6 @@ const Modal = class {
         unlock();
     }
     initSwipeToClose() {
-        var _a;
         if (ionicGlobal.getIonMode(this) !== 'ios') {
             return;
         }
@@ -2349,7 +2439,7 @@ const Modal = class {
             index$2.printIonContentErrorMsg(el);
             return;
         }
-        const statusBarStyle = (_a = this.statusBarStyle) !== null && _a !== void 0 ? _a : Style.Default;
+        const statusBarStyle = this.statusBarStyle ?? Style.Default;
         this.gesture = createSwipeToCloseGesture(el, ani, statusBarStyle, () => this.cardOnDismiss(), () => this.onDragStart(), (detail) => this.onDragMove(detail), (detail) => this.onDragEnd(detail));
         this.gesture.enable(true);
     }
@@ -2366,7 +2456,7 @@ const Modal = class {
             expandToScroll: this.expandToScroll,
         }));
         ani.progressStart(true, 1);
-        const { gesture, moveSheetToBreakpoint } = createSheetGesture(this.el, this.backdropEl, wrapperEl, initialBreakpoint, backdropBreakpoint, ani, this.sortedBreakpoints, this.expandToScroll, () => { var _a; return (_a = this.currentBreakpoint) !== null && _a !== void 0 ? _a : 0; }, () => this.sheetOnDismiss(), (breakpoint) => {
+        const { gesture, moveSheetToBreakpoint } = createSheetGesture(this.el, this.backdropEl, wrapperEl, initialBreakpoint, backdropBreakpoint, ani, this.sortedBreakpoints, this.expandToScroll, () => this.currentBreakpoint ?? 0, () => this.sheetOnDismiss(), (breakpoint) => {
             if (this.currentBreakpoint !== breakpoint) {
                 this.currentBreakpoint = breakpoint;
                 this.ionBreakpointDidChange.emit({ breakpoint });
@@ -2391,7 +2481,6 @@ const Modal = class {
      * passthrough on child route page wrappers and nested router outlets.
      */
     setupChildRoutePassthrough() {
-        var _a;
         // Cache the page parent for cleanup
         this.cachedPageParent = this.getOriginalPageParent();
         const pageParent = this.cachedPageParent;
@@ -2399,14 +2488,11 @@ const Modal = class {
         if (!pageParent || pageParent.tagName === 'ION-APP') {
             return;
         }
-        const hasVisibleContent = Array.from(pageParent.children).some((child) => {
-            var _a;
-            return child !== this.el &&
-                !(child instanceof HTMLElement && window.getComputedStyle(child).display === 'none') &&
-                child.tagName !== 'TEMPLATE' &&
-                child.tagName !== 'SLOT' &&
-                !(child.nodeType === Node.TEXT_NODE && !((_a = child.textContent) === null || _a === void 0 ? void 0 : _a.trim()));
-        });
+        const hasVisibleContent = Array.from(pageParent.children).some((child) => child !== this.el &&
+            !(child instanceof HTMLElement && window.getComputedStyle(child).display === 'none') &&
+            child.tagName !== 'TEMPLATE' &&
+            child.tagName !== 'SLOT' &&
+            !(child.nodeType === Node.TEXT_NODE && !child.textContent?.trim()));
         if (hasVisibleContent) {
             return;
         }
@@ -2414,7 +2500,7 @@ const Modal = class {
         pageParent.classList.add('ion-page-overlay-passthrough');
         // Also make nested router outlets passthrough
         const routerOutlet = pageParent.parentElement;
-        if ((routerOutlet === null || routerOutlet === void 0 ? void 0 : routerOutlet.tagName) === 'ION-ROUTER-OUTLET' && ((_a = routerOutlet.parentElement) === null || _a === void 0 ? void 0 : _a.tagName) !== 'ION-APP') {
+        if (routerOutlet?.tagName === 'ION-ROUTER-OUTLET' && routerOutlet.parentElement?.tagName !== 'ION-APP') {
             routerOutlet.style.setProperty('pointer-events', 'none');
             routerOutlet.setAttribute('data-overlay-passthrough', 'true');
         }
@@ -2442,7 +2528,7 @@ const Modal = class {
         }
         pageParent.classList.remove('ion-page-overlay-passthrough');
         const routerOutlet = pageParent.parentElement;
-        if (routerOutlet === null || routerOutlet === void 0 ? void 0 : routerOutlet.hasAttribute('data-overlay-passthrough')) {
+        if (routerOutlet?.hasAttribute('data-overlay-passthrough')) {
             routerOutlet.style.removeProperty('pointer-events');
             routerOutlet.removeAttribute('data-overlay-passthrough');
         }
@@ -2505,7 +2591,6 @@ const Modal = class {
      * For example, `cancel` or `backdrop`.
      */
     async dismiss(data, role) {
-        var _a;
         if (this.gestureAnimationDismissing && role !== overlays.GESTURE) {
             return false;
         }
@@ -2550,7 +2635,7 @@ const Modal = class {
         }
         const dismissed = await overlays.dismiss(this, data, role, 'modalLeave', iosLeaveAnimation, mdLeaveAnimation, {
             presentingEl: presentingElement,
-            currentBreakpoint: (_a = this.currentBreakpoint) !== null && _a !== void 0 ? _a : this.initialBreakpoint,
+            currentBreakpoint: this.currentBreakpoint ?? this.initialBreakpoint,
             backdropBreakpoint: this.backdropBreakpoint,
             expandToScroll: this.expandToScroll,
         });
@@ -2643,6 +2728,59 @@ const Modal = class {
         await this.setCurrentBreakpoint(nextBreakpoint);
         return true;
     }
+    onHandleClick = () => {
+        const { sheetTransition, handleBehavior } = this;
+        if (handleBehavior !== 'cycle' || sheetTransition !== undefined) {
+            /**
+             * The sheet modal should not advance to the next breakpoint
+             * if the handle behavior is not `cycle` or if the handle
+             * is clicked while the sheet is moving to a breakpoint.
+             */
+            return;
+        }
+        this.moveToNextBreakpoint();
+    };
+    onBackdropTap = () => {
+        const { sheetTransition } = this;
+        if (sheetTransition !== undefined) {
+            /**
+             * When the handle is double clicked at the largest breakpoint,
+             * it will start to move to the first breakpoint. While transitioning,
+             * the backdrop will often receive the second click. We prevent the
+             * backdrop from dismissing the modal while moving between breakpoints.
+             */
+            return;
+        }
+        this.dismiss(undefined, overlays.BACKDROP);
+    };
+    onLifecycle = (modalEvent) => {
+        const el = this.usersElement;
+        const name = LIFECYCLE_MAP[modalEvent.type];
+        if (el && name) {
+            const ev = new CustomEvent(name, {
+                bubbles: false,
+                cancelable: false,
+                detail: modalEvent.detail,
+            });
+            el.dispatchEvent(ev);
+        }
+    };
+    /**
+     * When the modal receives focus directly, pass focus to the handle
+     * if it exists and is focusable, otherwise let the focus trap handle it.
+     */
+    onModalFocus = (ev) => {
+        const { dragHandleEl, el } = this;
+        /**
+         * Shadow DOM focus is retargeted to the host, so `ev.target === el` is also
+         * true when a shadow child (the dialog wrapper present() focuses) is focused.
+         * shadowRoot's activeElement is null only when the host was focused directly,
+         * so redirect to the handle only then and leave present()'s wrapper focus intact.
+         */
+        if (ev.target === el && el.shadowRoot?.activeElement == null && dragHandleEl && dragHandleEl.tabIndex !== -1) {
+            dragHandleEl.focus();
+        }
+    };
     initViewTransitionListener() {
         // Only enable for iOS card modals when no custom animations are provided
         if (ionicGlobal.getIonMode(this) !== 'ios' || !this.presentingElement || this.enterAnimation || this.leaveAnimation) {
@@ -2738,7 +2876,7 @@ const Modal = class {
             wrapperEl.style.transform = 'translateY(0vh)';
             wrapperEl.style.opacity = '1';
         }
-        if ((presentingElement === null || presentingElement === void 0 ? void 0 : presentingElement.tagName) === 'ION-MODAL') {
+        if (presentingElement?.tagName === 'ION-MODAL') {
             const isPortrait = window.innerWidth < 768;
             if (isPortrait) {
                 const transformOffset = !CSS.supports('width', 'max(0px, 1px)')
@@ -2752,9 +2890,29 @@ const Modal = class {
             }
         }
     }
+    /**
+     * When the slot changes, we need to find all the modals in the slot
+     * and set the data-parent-ion-modal attribute on them so we can find them
+     * and dismiss them when we get dismissed.
+     * We need to do it this way because when a modal is opened, it's moved to
+     * the end of the body and is no longer an actual child of the modal.
+     */
+    onSlotChange = ({ target }) => {
+        const slot = target;
+        slot.assignedElements().forEach((el) => {
+            el.querySelectorAll('ion-modal').forEach((childModal) => {
+                // We don't need to write to the DOM if the modal is already tagged
+                // If this is a deeply nested modal, this effect should cascade so we don't
+                // need to worry about another modal claiming the same child.
+                if (childModal.getAttribute('data-parent-ion-modal') === null) {
+                    childModal.setAttribute('data-parent-ion-modal', this.el.id);
+                }
+            });
+        });
+    };
     async dismissNestedModals() {
         const nestedModals = document.querySelectorAll(`ion-modal[data-parent-ion-modal="${this.el.id}"]`);
-        nestedModals === null || nestedModals === void 0 ? void 0 : nestedModals.forEach(async (modal) => {
+        nestedModals?.forEach(async (modal) => {
             await modal.dismiss(undefined, 'parent-dismissed');
         });
     }
@@ -2787,10 +2945,9 @@ const Modal = class {
                 if (mutation.type === 'childList' && mutation.removedNodes.length > 0) {
                     // Check if our cached original parent was removed
                     const cachedParentWasRemoved = Array.from(mutation.removedNodes).some((node) => {
-                        var _a, _b;
                         const isDirectMatch = node === this.cachedOriginalParent;
                         const isContainedMatch = this.cachedOriginalParent
-                            ? (_b = (_a = node).contains) === null || _b === void 0 ? void 0 : _b.call(_a, this.cachedOriginalParent)
+                            ? node.contains?.(this.cachedOriginalParent)
                             : false;
                         return isDirectMatch || isContainedMatch;
                     });
@@ -2812,8 +2969,7 @@ const Modal = class {
         });
     }
     cleanupParentRemovalObserver() {
-        var _a;
-        (_a = this.parentRemovalObserver) === null || _a === void 0 ? void 0 : _a.disconnect();
+        this.parentRemovalObserver?.disconnect();
         this.parentRemovalObserver = undefined;
     }
     onDragStart() {
@@ -2853,7 +3009,10 @@ const Modal = class {
      * sheets to prevent header content from getting double-offset padding).
      */
     setInitialSafeAreaOverrides() {
-        const context = Object.assign(Object.assign({}, this.getSafeAreaContext()), { hasCustomDimensions: hasCustomModalDimensions(this.el) });
+        const context = {
+            ...this.getSafeAreaContext(),
+            hasCustomDimensions: hasCustomModalDimensions(this.el),
+        };
         const safeAreaConfig = getInitialSafeAreaConfig(context);
         applySafeAreaOverrides(this.el, safeAreaConfig);
         // Set the internal offset property with the resolved root safe-area-top value
@@ -2980,11 +3139,20 @@ const Modal = class {
         const isCardModal = presentingElement !== undefined && mode === 'ios';
         const isHandleCycle = handleBehavior === 'cycle';
         const isSheetModalWithHandle = isSheetModal && showHandle;
-        return (index$3.h(index$3.Host, Object.assign({ key: 'bad33199a939bd1e289b3b3f936c676ba403224f', "no-router": true,
+        return (index$3.h(index$3.Host, { key: 'e2d5e0985b3812d6de4f7783becb5e6b50417d6f', "no-router": true,
             // Allow the modal to be navigable when the handle is focusable
-            tabIndex: isHandleCycle && isSheetModalWithHandle ? 0 : -1 }, htmlAttributes, { style: {
+            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, [overlays.FOCUS_TRAP_DISABLE_CLASS]: focusTrap === false }, theme.getClassMap(this.cssClass)), onIonBackdropTap: this.onBackdropTap, onIonModalDidPresent: this.onLifecycle, onIonModalWillPresent: this.onLifecycle, onIonModalWillDismiss: this.onLifecycle, onIonModalDidDismiss: this.onLifecycle, onFocus: this.onModalFocus }), index$3.h("ion-backdrop", { key: 'd098688a65fb2d1befb255f0e59fd4c00b401092', ref: (el) => (this.backdropEl = el), visible: this.showBackdrop, tappable: this.backdropDismiss, part: "backdrop" }), mode === 'ios' && index$3.h("div", { key: '96cd2e59a7d1c0de7c9afb8f8d366367b09fbc93', class: "modal-shadow" }), index$3.h("div", Object.assign({ key: '882ccc39ce344a2c51d6508c11c3f40b26eaf2a7',
+            }, class: {
+                [mode]: true,
+                ['modal-default']: !isCardModal && !isSheetModal,
+                [`modal-card`]: isCardModal,
+                [`modal-sheet`]: isSheetModal,
+                [`modal-no-expand-scroll`]: isSheetModal && !expandToScroll,
+                'overlay-hidden': true,
+                [overlays.FOCUS_TRAP_DISABLE_CLASS]: focusTrap === false,
+                ...theme.getClassMap(this.cssClass),
+            }, onIonBackdropTap: this.onBackdropTap, onIonModalDidPresent: this.onLifecycle, onIonModalWillPresent: this.onLifecycle, onIonModalWillDismiss: this.onLifecycle, onIonModalDidDismiss: this.onLifecycle, onFocus: this.onModalFocus }, index$3.h("ion-backdrop", { key: 'dee7fea7a218a3cf62991164304db778d9137b72', ref: (el) => (this.backdropEl = el), visible: this.showBackdrop, tappable: this.backdropDismiss, part: "backdrop" }), mode === 'ios' && index$3.h("div", { key: '770ab0d08851077d30f3f18bdc287a863d03ce77', class: "modal-shadow" }), index$3.h("div", { key: '435f22d484f67624b1eecaaebef6c20cc42f37f5',
             /*
               role and aria-modal must be used on the
               same element. They must also be set inside the
@@ -2997,11 +3165,10 @@ const Modal = class {
               without the tabindex focus() would be a no-op and screen readers
               may not properly announce the dialog and its content when it opens.
             */
-            role: "dialog" }, inheritedAttributes, { "aria-modal": "true", tabIndex: -1, class: "modal-wrapper ion-overlay-wrapper", part: "content", ref: (el) => (this.wrapperEl = el) }), showHandle && (index$3.h("button", { key: '714d9904fcc8105b21e2bb66cdc032bffd685d72', class: "modal-handle",
+            role: "dialog", ...inheritedAttributes, "aria-modal": "true", tabIndex: -1, class: "modal-wrapper ion-overlay-wrapper", part: "content", ref: (el) => (this.wrapperEl = el) }, showHandle && (index$3.h("button", { key: '85e20acddde9a5335312342e885967722d5b128d', 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) })), index$3.h("slot", { key: '79dfbeb3fe5eee7dc3a243ad880d3f63184f3ab7', 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) })), index$3.h("slot", { key: 'deb0106d335712c42a9d866648ee90c98efb5f9d', onSlotchange: this.onSlotChange }))));
     }
-    get el() { return index$3.getElement(this); }
     static get watchers() { return {
         "isOpen": [{
                 "onIsOpenChange": 0