@pod-os/elements 0.7.0 → 0.7.1-2196a40.0

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

@@ -1,83 +1,516 @@
-import { r as registerInstance, c as createEvent, w as writeTask, h, H as Host, a as getElement } from './index-e4deec27.js';
-import { g as getIonMode, c as config } from './ionic-global-2e28f7c7.js';
-import { a as attachComponent, d as detachComponent } from './framework-delegate-9cd8048f.js';
-import { B as BACKDROP, a as prepareOverlay, p as present, c as activeAnimations, d as dismiss, e as eventMethod } from './overlays-fc9a0625.js';
-import { g as getClassMap } from './theme-d21826a7.js';
-import { d as deepReady } from './index-8a463a85.js';
-import { c as createAnimation } from './animation-fe6ed422.js';
-import { g as getTimeGivenProgression } from './cubic-bezier-108b8579.js';
-import { createGesture } from './index-3a1bd803.js';
-import { c as clamp } from './helpers-44e3bd9f.js';
-import './hardware-back-button-bb4c578a.js';
-import './gesture-controller-8f35af24.js';
+import { r as registerInstance, d as createEvent, w as writeTask, h, H as Host, c as getElement } from './index-cb938ffb.js';
+import { g as getIonMode, c as config } from './ionic-global-6cd57191.js';
+import { a as findClosestIonContent, i as isIonContent, d as disableContentScrollY, r as resetContentScrollY, f as findIonContent, p as printIonContentErrorMsg } from './index-ebf7f059.js';
+import { C as CoreDelegate, a as attachComponent, d as detachComponent } from './framework-delegate-7e2b767b.js';
+import { g as getElementRoot, b as clamp, r as raf, a as inheritAttributes } from './helpers-aeff219b.js';
+import { KEYBOARD_DID_OPEN } from './keyboard-413afe04.js';
+import { p as printIonWarning } from './index-1f3d8582.js';
+import { w as win } from './index-0dbaca1a.js';
+import { B as BACKDROP, p as prepareOverlay, a as present, b as activeAnimations, d as dismiss, e as eventMethod } from './overlays-0c7f05e1.js';
+import { g as getClassMap } from './theme-7cf2cab0.js';
+import { d as deepReady } from './index-6048aed6.js';
+import { c as createAnimation } from './animation-801a007a.js';
+import { g as getTimeGivenProgression } from './cubic-bezier-538b6253.js';
+import { createGesture } from './index-d39eb62b.js';
+import './hardware-back-button-242191a7.js';
+import './gesture-controller-c466ff14.js';
 
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+var Style;
+(function (Style) {
+  Style["Dark"] = "DARK";
+  Style["Light"] = "LIGHT";
+  Style["Default"] = "DEFAULT";
+})(Style || (Style = {}));
+const StatusBar = {
+  getEngine() {
+    var _a;
+    return ((_a = win === null || win === void 0 ? void 0 : win.Capacitor) === null || _a === void 0 ? void 0 : _a.isPluginAvailable('StatusBar')) && (win === null || win === void 0 ? void 0 : win.Capacitor.Plugins.StatusBar);
+  },
+  supportsDefaultStatusBarStyle() {
+    var _a;
+    /**
+     * The 'DEFAULT' status bar style was added
+     * to the @capacitor/status-bar plugin in Capacitor 3.
+     * PluginHeaders is only supported in Capacitor 3+,
+     * so we can use this to detect Capacitor 3.
+     */
+    return !!((_a = win === null || win === void 0 ? void 0 : win.Capacitor) === null || _a === void 0 ? void 0 : _a.PluginHeaders);
+  },
+  setStyle(options) {
+    const engine = this.getEngine();
+    if (!engine) {
+      return;
+    }
+    engine.setStyle(options);
+  },
+  getStyle: async function () {
+    const engine = this.getEngine();
+    if (!engine) {
+      return Style.Default;
+    }
+    const { style } = await engine.getInfo();
+    return style;
+  },
+};
+
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+/**
+ * Use y = mx + b to
+ * figure out the backdrop value
+ * at a particular x coordinate. This
+ * is useful when the backdrop does
+ * not begin to fade in until after
+ * the 0 breakpoint.
+ */
+const getBackdropValueForSheet = (x, backdropBreakpoint) => {
+  /**
+   * We will use these points:
+   * (backdropBreakpoint, 0)
+   * (maxBreakpoint, 1)
+   * We know that at the beginning breakpoint,
+   * the backdrop will be hidden. We also
+   * know that at the maxBreakpoint, the backdrop
+   * must be fully visible. maxBreakpoint should
+   * always be 1 even if the maximum value
+   * of the breakpoints array is not 1 since
+   * the animation runs from a progress of 0
+   * to a progress of 1.
+   * m = (y2 - y1) / (x2 - x1)
+   *
+   * This is simplified from:
+   * m = (1 - 0) / (maxBreakpoint - backdropBreakpoint)
+   *
+   * If the backdropBreakpoint is 1, we return 0 as the
+   * backdrop is completely hidden.
+   *
+   */
+  if (backdropBreakpoint === 1) {
+    return 0;
+  }
+  const slope = 1 / (1 - backdropBreakpoint);
+  /**
+   * From here, compute b which is
+   * the backdrop opacity if the offset
+   * is 0. If the backdrop does not
+   * begin to fade in until after the
+   * 0 breakpoint, this b value will be
+   * negative. This is fine as we never pass
+   * b directly into the animation keyframes.
+   * b = y - mx
+   * Use a known point: (backdropBreakpoint, 0)
+   * This is simplified from:
+   * b = 0 - (backdropBreakpoint * slope)
+   */
+  const b = -(backdropBreakpoint * slope);
+  /**
+   * Finally, we can now determine the
+   * backdrop offset given an arbitrary
+   * gesture offset.
+   */
+  return x * slope + b;
+};
+/**
+ * The tablet/desktop card modal activates
+ * when the window width is >= 768.
+ * At that point, the presenting element
+ * is not transformed, so we do not need to
+ * adjust the status bar color.
+ *
+ * Note: We check supportsDefaultStatusBarStyle so that
+ * Capacitor <= 2 users do not get their status bar
+ * stuck in an inconsistent state due to a lack of
+ * support for Style.Default.
+ */
+const setCardStatusBarDark = () => {
+  if (!win || win.innerWidth >= 768 || !StatusBar.supportsDefaultStatusBarStyle()) {
+    return;
+  }
+  StatusBar.setStyle({ style: Style.Dark });
+};
+const setCardStatusBarDefault = (defaultStyle = Style.Default) => {
+  if (!win || win.innerWidth >= 768 || !StatusBar.supportsDefaultStatusBarStyle()) {
+    return;
+  }
+  StatusBar.setStyle({ style: defaultStyle });
+};
+
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+const handleCanDismiss = async (el, animation) => {
+  /**
+   * If canDismiss is not a function
+   * then we can return early. If canDismiss is `true`,
+   * then canDismissBlocksGesture is `false` as canDismiss
+   * will never interrupt the gesture. As a result,
+   * this code block is never reached. If canDismiss is `false`,
+   * then we never dismiss.
+   */
+  if (typeof el.canDismiss !== 'function') {
+    return;
+  }
+  /**
+   * Run the canDismiss callback.
+   * If the function returns `true`,
+   * then we can proceed with dismiss.
+   */
+  const shouldDismiss = await el.canDismiss();
+  if (!shouldDismiss) {
+    return;
+  }
+  /**
+   * If canDismiss resolved after the snap
+   * back animation finished, we can
+   * dismiss immediately.
+   *
+   * If canDismiss resolved before the snap
+   * back animation finished, we need to
+   * wait until the snap back animation is
+   * done before dismissing.
+   */
+  if (animation.isRunning()) {
+    animation.onFinish(() => {
+      el.dismiss(undefined, 'handler');
+    }, { oneTimeCallback: true });
+  }
+  else {
+    el.dismiss(undefined, 'handler');
+  }
+};
+/**
+ * This function lets us simulate a realistic spring-like animation
+ * when swiping down on the modal.
+ * There are two forces that we need to use to compute the spring physics:
+ *
+ * 1. Stiffness, k: This is a measure of resistance applied a spring.
+ * 2. Dampening, c: This value has the effect of reducing or preventing oscillation.
+ *
+ * Using these two values, we can calculate the Spring Force and the Dampening Force
+ * to compute the total force applied to a spring.
+ *
+ * Spring Force: This force pulls a spring back into its equilibrium position.
+ * Hooke's Law tells us that that spring force (FS) = kX.
+ * k is the stiffness of a spring, and X is the displacement of the spring from its
+ * equilibrium position. In this case, it is the amount by which the free end
+ * of a spring was displaced (stretched/pushed) from its "relaxed" position.
+ *
+ * Dampening Force: This force slows down motion. Without it, a spring would oscillate forever.
+ * The dampening force, FD, can be found via this formula: FD = -cv
+ * where c the dampening value and v is velocity.
+ *
+ * Therefore, the resulting force that is exerted on the block is:
+ * F = FS + FD = -kX - cv
+ *
+ * Newton's 2nd Law tells us that F = ma:
+ * ma = -kX - cv.
+ *
+ * For Ionic's purposes, we can assume that m = 1:
+ * a = -kX - cv
+ *
+ * Imagine a block attached to the end of a spring. At equilibrium
+ * the block is at position x = 1.
+ * Pressing on the block moves it to position x = 0;
+ * So, to calculate the displacement, we need to take the
+ * current position and subtract the previous position from it.
+ * X = x - x0 = 0 - 1 = -1.
+ *
+ * For Ionic's purposes, we are only pushing on the spring modal
+ * so we have a max position of 1.
+ * As a result, we can expand displacement to this formula:
+ * X = x - 1
+ *
+ * a = -k(x - 1) - cv
+ *
+ * We can represent the motion of something as a function of time: f(t) = x.
+ * The derivative of position gives us the velocity: f'(t)
+ * The derivative of the velocity gives us the acceleration: f''(t)
+ *
+ * We can substitute the formula above with these values:
+ *
+ * f"(t) = -k * (f(t) - 1) - c * f'(t)
+ *
+ * This is called a differential equation.
+ *
+ * We know that at t = 0, we are at x = 0 because the modal does not move: f(0) = 0
+ * This means our velocity is also zero: f'(0) = 0.
+ *
+ * We can cheat a bit and plug the formula into Wolfram Alpha.
+ * However, we need to pick stiffness and dampening values:
+ * k = 0.57
+ * c = 15
+ *
+ * I picked these as they are fairly close to native iOS's spring effect
+ * with the modal.
+ *
+ * What we plug in is this: f(0) = 0; f'(0) = 0; f''(t) = -0.57(f(t) - 1) - 15f'(t)
+ *
+ * The result is a formula that lets us calculate the acceleration
+ * for a given time t.
+ * Note: This is the approximate form of the solution. Wolfram Alpha will
+ * give you a complex differential equation too.
+ */
+const calculateSpringStep = (t) => {
+  return 0.00255275 * 2.71828 ** (-14.9619 * t) - 1.00255 * 2.71828 ** (-0.0380968 * t) + 1;
+};
+
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
 // Defaults for the card swipe animation
 const SwipeToCloseDefaults = {
   MIN_PRESENTING_SCALE: 0.93,
 };
-const createSwipeToCloseGesture = (el, animation, onDismiss) => {
+const createSwipeToCloseGesture = (el, animation, statusBarStyle, onDismiss) => {
+  /**
+   * The step value at which a card modal
+   * is eligible for dismissing via gesture.
+   */
+  const DISMISS_THRESHOLD = 0.5;
   const height = el.offsetHeight;
   let isOpen = false;
+  let canDismissBlocksGesture = false;
+  let contentEl = null;
+  let scrollEl = null;
+  const canDismissMaxStep = 0.2;
+  let initialScrollY = true;
+  let lastStep = 0;
+  const getScrollY = () => {
+    if (contentEl && isIonContent(contentEl)) {
+      return contentEl.scrollY;
+      /**
+       * Custom scroll containers are intended to be
+       * used with virtual scrolling, so we assume
+       * there is scrolling in this case.
+       */
+    }
+    else {
+      return true;
+    }
+  };
   const canStart = (detail) => {
     const target = detail.event.target;
-    if (target === null ||
-      !target.closest) {
+    if (target === null || !target.closest) {
       return true;
     }
-    const contentOrFooter = target.closest('ion-content, ion-footer');
-    if (contentOrFooter === null) {
+    /**
+     * If we are swiping on the content,
+     * swiping should only be possible if
+     * the content is scrolled all the way
+     * to the top so that we do not interfere
+     * with scrolling.
+     *
+     * We cannot assume that the `ion-content`
+     * target will remain consistent between
+     * swipes. For example, when using
+     * ion-nav within a card modal it is
+     * possible to swipe, push a view, and then
+     * swipe again. The target content will not
+     * be the same between swipes.
+     */
+    contentEl = findClosestIonContent(target);
+    if (contentEl) {
+      /**
+       * The card should never swipe to close
+       * on the content with a refresher.
+       * Note: We cannot solve this by making the
+       * swipeToClose gesture have a higher priority
+       * than the refresher gesture as the iOS native
+       * refresh gesture uses a scroll listener in
+       * addition to a gesture.
+       *
+       * Note: Do not use getScrollElement here
+       * because we need this to be a synchronous
+       * operation, and getScrollElement is
+       * asynchronous.
+       */
+      if (isIonContent(contentEl)) {
+        const root = getElementRoot(contentEl);
+        scrollEl = root.querySelector('.inner-scroll');
+      }
+      else {
+        scrollEl = contentEl;
+      }
+      const hasRefresherInContent = !!contentEl.querySelector('ion-refresher');
+      return !hasRefresherInContent && scrollEl.scrollTop === 0;
+    }
+    /**
+     * Card should be swipeable on all
+     * parts of the modal except for the footer.
+     */
+    const footer = target.closest('ion-footer');
+    if (footer === null) {
       return true;
     }
-    // Target is in the content or the footer so do not start the gesture.
-    // We could be more nuanced here and allow it for content that
-    // does not need to scroll.
     return false;
   };
-  const onStart = () => {
-    animation.progressStart(true, (isOpen) ? 1 : 0);
+  const onStart = (detail) => {
+    const { deltaY } = detail;
+    /**
+     * Get the initial scrollY value so
+     * that we can correctly reset the scrollY
+     * prop when the gesture ends.
+     */
+    initialScrollY = getScrollY();
+    /**
+     * If canDismiss is anything other than `true`
+     * then users should be able to swipe down
+     * until a threshold is hit. At that point,
+     * the card modal should not proceed any further.
+     * TODO (FW-937)
+     * Remove undefined check
+     */
+    canDismissBlocksGesture = el.canDismiss !== undefined && el.canDismiss !== true;
+    /**
+     * If we are pulling down, then
+     * it is possible we are pulling on the
+     * content. We do not want scrolling to
+     * happen at the same time as the gesture.
+     */
+    if (deltaY > 0 && contentEl) {
+      disableContentScrollY(contentEl);
+    }
+    animation.progressStart(true, isOpen ? 1 : 0);
   };
   const onMove = (detail) => {
-    const step = clamp(0.0001, detail.deltaY / height, 0.9999);
-    animation.progressStep(step);
+    const { deltaY } = detail;
+    /**
+     * If we are pulling down, then
+     * it is possible we are pulling on the
+     * content. We do not want scrolling to
+     * happen at the same time as the gesture.
+     */
+    if (deltaY > 0 && contentEl) {
+      disableContentScrollY(contentEl);
+    }
+    /**
+     * If we are swiping on the content
+     * then the swipe gesture should only
+     * happen if we are pulling down.
+     *
+     * However, if we pull up and
+     * then down such that the scroll position
+     * returns to 0, we should be able to swipe
+     * the card.
+     */
+    const step = detail.deltaY / height;
+    /**
+     * Check if user is swiping down and
+     * if we have a canDismiss value that
+     * should block the gesture from
+     * proceeding,
+     */
+    const isAttemptingDismissWithCanDismiss = step >= 0 && canDismissBlocksGesture;
+    /**
+     * If we are blocking the gesture from dismissing,
+     * set the max step value so that the sheet cannot be
+     * completely hidden.
+     */
+    const maxStep = isAttemptingDismissWithCanDismiss ? canDismissMaxStep : 0.9999;
+    /**
+     * If we are blocking the gesture from
+     * dismissing, calculate the spring modifier value
+     * this will be added to the starting breakpoint
+     * value to give the gesture a spring-like feeling.
+     * Note that the starting breakpoint is always 0,
+     * so we omit adding 0 to the result.
+     */
+    const processedStep = isAttemptingDismissWithCanDismiss ? calculateSpringStep(step / maxStep) : step;
+    const clampedStep = clamp(0.0001, processedStep, maxStep);
+    animation.progressStep(clampedStep);
+    /**
+     * When swiping down half way, the status bar style
+     * should be reset to its default value.
+     *
+     * We track lastStep so that we do not fire these
+     * functions on every onMove, only when the user has
+     * crossed a certain threshold.
+     */
+    if (clampedStep >= DISMISS_THRESHOLD && lastStep < DISMISS_THRESHOLD) {
+      setCardStatusBarDefault(statusBarStyle);
+      /**
+       * However, if we swipe back up, then the
+       * status bar style should be set to have light
+       * text on a dark background.
+       */
+    }
+    else if (clampedStep < DISMISS_THRESHOLD && lastStep >= DISMISS_THRESHOLD) {
+      setCardStatusBarDark();
+    }
+    lastStep = clampedStep;
   };
   const onEnd = (detail) => {
     const velocity = detail.velocityY;
-    const step = clamp(0.0001, detail.deltaY / height, 0.9999);
+    const step = detail.deltaY / height;
+    const isAttemptingDismissWithCanDismiss = step >= 0 && canDismissBlocksGesture;
+    const maxStep = isAttemptingDismissWithCanDismiss ? canDismissMaxStep : 0.9999;
+    const processedStep = isAttemptingDismissWithCanDismiss ? calculateSpringStep(step / maxStep) : step;
+    const clampedStep = clamp(0.0001, processedStep, maxStep);
     const threshold = (detail.deltaY + velocity * 1000) / height;
-    const shouldComplete = threshold >= 0.5;
-    let newStepValue = (shouldComplete) ? -0.001 : 0.001;
+    /**
+     * If canDismiss blocks
+     * the swipe gesture, then the
+     * animation can never complete until
+     * canDismiss is checked.
+     */
+    const shouldComplete = !isAttemptingDismissWithCanDismiss && threshold >= DISMISS_THRESHOLD;
+    let newStepValue = shouldComplete ? -0.001 : 0.001;
     if (!shouldComplete) {
       animation.easing('cubic-bezier(1, 0, 0.68, 0.28)');
-      newStepValue += getTimeGivenProgression([0, 0], [1, 0], [0.68, 0.28], [1, 1], step)[0];
+      newStepValue += getTimeGivenProgression([0, 0], [1, 0], [0.68, 0.28], [1, 1], clampedStep)[0];
     }
     else {
       animation.easing('cubic-bezier(0.32, 0.72, 0, 1)');
-      newStepValue += getTimeGivenProgression([0, 0], [0.32, 0.72], [0, 1], [1, 1], step)[0];
+      newStepValue += getTimeGivenProgression([0, 0], [0.32, 0.72], [0, 1], [1, 1], clampedStep)[0];
     }
-    const duration = (shouldComplete) ? computeDuration(step * height, velocity) : computeDuration((1 - step) * height, velocity);
+    const duration = shouldComplete
+      ? computeDuration(step * height, velocity)
+      : computeDuration((1 - clampedStep) * height, velocity);
     isOpen = shouldComplete;
     gesture.enable(false);
+    if (contentEl) {
+      resetContentScrollY(contentEl, initialScrollY);
+    }
     animation
       .onFinish(() => {
       if (!shouldComplete) {
         gesture.enable(true);
       }
     })
-      .progressEnd((shouldComplete) ? 1 : 0, newStepValue, duration);
-    if (shouldComplete) {
+      .progressEnd(shouldComplete ? 1 : 0, newStepValue, duration);
+    /**
+     * If the canDismiss value blocked the gesture
+     * from proceeding, then we should ignore whatever
+     * shouldComplete is. Whether or not the modal
+     * animation should complete is now determined by
+     * canDismiss.
+     *
+     * If the user swiped >25% of the way
+     * to the max step, then we should
+     * check canDismiss. 25% was chosen
+     * to avoid accidental swipes.
+     */
+    if (isAttemptingDismissWithCanDismiss && clampedStep > maxStep / 4) {
+      handleCanDismiss(el, animation);
+    }
+    else if (shouldComplete) {
       onDismiss();
     }
   };
   const gesture = createGesture({
     el,
     gestureName: 'modalSwipeToClose',
-    gesturePriority: 40,
+    gesturePriority: 39,
     direction: 'y',
     threshold: 10,
     canStart,
     onStart,
     onMove,
-    onEnd
+    onEnd,
   });
   return gesture;
 };
@@ -85,55 +518,113 @@ const computeDuration = (remaining, velocity) => {
   return clamp(400, remaining / Math.abs(velocity * 1.1), 500);
 };
 
-/**
- * iOS Modal Enter Animation for the Card presentation style
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
  */
-const iosEnterAnimation = (baseEl, presentingEl) => {
+const createSheetEnterAnimation = (opts) => {
+  const { currentBreakpoint, backdropBreakpoint } = opts;
+  /**
+   * If the backdropBreakpoint is undefined, then the backdrop
+   * should always fade in. If the backdropBreakpoint came before the
+   * current breakpoint, then the backdrop should be fading in.
+   */
+  const shouldShowBackdrop = backdropBreakpoint === undefined || backdropBreakpoint < currentBreakpoint;
+  const initialBackdrop = shouldShowBackdrop ? `calc(var(--backdrop-opacity) * ${currentBreakpoint})` : '0';
+  const backdropAnimation = createAnimation('backdropAnimation').fromTo('opacity', 0, initialBackdrop);
+  if (shouldShowBackdrop) {
+    backdropAnimation
+      .beforeStyles({
+      'pointer-events': 'none',
+    })
+      .afterClearStyles(['pointer-events']);
+  }
+  const wrapperAnimation = createAnimation('wrapperAnimation').keyframes([
+    { offset: 0, opacity: 1, transform: 'translateY(100%)' },
+    { offset: 1, opacity: 1, transform: `translateY(${100 - currentBreakpoint * 100}%)` },
+  ]);
+  return { wrapperAnimation, backdropAnimation };
+};
+const createSheetLeaveAnimation = (opts) => {
+  const { currentBreakpoint, backdropBreakpoint } = opts;
+  /**
+   * Backdrop does not always fade in from 0 to 1 if backdropBreakpoint
+   * is defined, so we need to account for that offset by figuring out
+   * what the current backdrop value should be.
+   */
+  const backdropValue = `calc(var(--backdrop-opacity) * ${getBackdropValueForSheet(currentBreakpoint, backdropBreakpoint)})`;
+  const defaultBackdrop = [
+    { offset: 0, opacity: backdropValue },
+    { offset: 1, opacity: 0 },
+  ];
+  const customBackdrop = [
+    { offset: 0, opacity: backdropValue },
+    { offset: backdropBreakpoint, opacity: 0 },
+    { offset: 1, opacity: 0 },
+  ];
+  const backdropAnimation = createAnimation('backdropAnimation').keyframes(backdropBreakpoint !== 0 ? customBackdrop : defaultBackdrop);
+  const wrapperAnimation = createAnimation('wrapperAnimation').keyframes([
+    { offset: 0, opacity: 1, transform: `translateY(${100 - currentBreakpoint * 100}%)` },
+    { offset: 1, opacity: 1, transform: `translateY(100%)` },
+  ]);
+  return { wrapperAnimation, backdropAnimation };
+};
+
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+const createEnterAnimation$1 = () => {
   const backdropAnimation = createAnimation()
-    .addElement(baseEl.querySelector('ion-backdrop'))
     .fromTo('opacity', 0.01, 'var(--backdrop-opacity)')
     .beforeStyles({
-    'pointer-events': 'none'
+    'pointer-events': 'none',
   })
     .afterClearStyles(['pointer-events']);
-  const wrapperAnimation = createAnimation()
-    .addElement(baseEl.querySelectorAll('.modal-wrapper, .modal-shadow'))
-    .beforeStyles({ 'opacity': 1 })
-    .fromTo('transform', 'translateY(100vh)', 'translateY(0vh)');
-  const baseAnimation = createAnimation()
+  const wrapperAnimation = createAnimation().fromTo('transform', 'translateY(100vh)', 'translateY(0vh)');
+  return { backdropAnimation, wrapperAnimation };
+};
+/**
+ * iOS Modal Enter Animation for the Card presentation style
+ */
+const iosEnterAnimation = (baseEl, opts) => {
+  const { presentingEl, currentBreakpoint } = opts;
+  const root = getElementRoot(baseEl);
+  const { wrapperAnimation, backdropAnimation } = currentBreakpoint !== undefined ? createSheetEnterAnimation(opts) : createEnterAnimation$1();
+  backdropAnimation.addElement(root.querySelector('ion-backdrop'));
+  wrapperAnimation.addElement(root.querySelectorAll('.modal-wrapper, .modal-shadow')).beforeStyles({ opacity: 1 });
+  const baseAnimation = createAnimation('entering-base')
     .addElement(baseEl)
     .easing('cubic-bezier(0.32,0.72,0,1)')
     .duration(500)
     .addAnimation(wrapperAnimation);
   if (presentingEl) {
     const isMobile = window.innerWidth < 768;
-    const hasCardModal = (presentingEl.tagName === 'ION-MODAL' && presentingEl.presentingElement !== undefined);
-    const presentingAnimation = createAnimation()
-      .beforeStyles({
-      'transform': 'translateY(0)',
+    const hasCardModal = presentingEl.tagName === 'ION-MODAL' && presentingEl.presentingElement !== undefined;
+    const presentingElRoot = getElementRoot(presentingEl);
+    const presentingAnimation = createAnimation().beforeStyles({
+      transform: 'translateY(0)',
       'transform-origin': 'top center',
-      'overflow': 'hidden'
+      overflow: 'hidden',
     });
     const bodyEl = document.body;
     if (isMobile) {
       /**
        * Fallback for browsers that does not support `max()` (ex: Firefox)
        * No need to worry about statusbar padding since engines like Gecko
-       * are not used as the engine for standlone Cordova/Capacitor apps
+       * are not used as the engine for standalone Cordova/Capacitor apps
        */
-      const transformOffset = (!CSS.supports('width', 'max(0px, 1px)')) ? '30px' : 'max(30px, var(--ion-safe-area-top))';
+      const transformOffset = !CSS.supports('width', 'max(0px, 1px)') ? '30px' : 'max(30px, var(--ion-safe-area-top))';
       const modalTransform = hasCardModal ? '-10px' : transformOffset;
       const toPresentingScale = SwipeToCloseDefaults.MIN_PRESENTING_SCALE;
       const finalTransform = `translateY(${modalTransform}) scale(${toPresentingScale})`;
       presentingAnimation
         .afterStyles({
-        'transform': finalTransform
+        transform: finalTransform,
       })
         .beforeAddWrite(() => bodyEl.style.setProperty('background-color', 'black'))
         .addElement(presentingEl)
         .keyframes([
         { offset: 0, filter: 'contrast(1)', transform: 'translateY(0px) scale(1)', borderRadius: '0px' },
-        { offset: 1, filter: 'contrast(0.85)', transform: finalTransform, borderRadius: '10px 10px 0 0' }
+        { offset: 1, filter: 'contrast(0.85)', transform: finalTransform, borderRadius: '10px 10px 0 0' },
       ]);
       baseAnimation.addAnimation(presentingAnimation);
     }
@@ -143,25 +634,25 @@ const iosEnterAnimation = (baseEl, presentingEl) => {
         wrapperAnimation.fromTo('opacity', '0', '1');
       }
       else {
-        const toPresentingScale = (hasCardModal) ? SwipeToCloseDefaults.MIN_PRESENTING_SCALE : 1;
+        const toPresentingScale = hasCardModal ? SwipeToCloseDefaults.MIN_PRESENTING_SCALE : 1;
         const finalTransform = `translateY(-10px) scale(${toPresentingScale})`;
         presentingAnimation
           .afterStyles({
-          'transform': finalTransform
+          transform: finalTransform,
         })
-          .addElement(presentingEl.querySelector('.modal-wrapper'))
+          .addElement(presentingElRoot.querySelector('.modal-wrapper'))
           .keyframes([
           { offset: 0, filter: 'contrast(1)', transform: 'translateY(0) scale(1)' },
-          { offset: 1, filter: 'contrast(0.85)', transform: finalTransform }
+          { offset: 1, filter: 'contrast(0.85)', transform: finalTransform },
         ]);
         const shadowAnimation = createAnimation()
           .afterStyles({
-          'transform': finalTransform
+          transform: finalTransform,
         })
-          .addElement(presentingEl.querySelector('.modal-shadow'))
+          .addElement(presentingElRoot.querySelector('.modal-shadow'))
           .keyframes([
           { offset: 0, opacity: '1', transform: 'translateY(0) scale(1)' },
-          { offset: 1, opacity: '0', transform: finalTransform }
+          { offset: 1, opacity: '0', transform: finalTransform },
         ]);
         baseAnimation.addAnimation([presentingAnimation, shadowAnimation]);
       }
@@ -173,50 +664,55 @@ const iosEnterAnimation = (baseEl, presentingEl) => {
   return baseAnimation;
 };
 
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+const createLeaveAnimation$1 = () => {
+  const backdropAnimation = createAnimation().fromTo('opacity', 'var(--backdrop-opacity)', 0);
+  const wrapperAnimation = createAnimation().fromTo('transform', 'translateY(0vh)', 'translateY(100vh)');
+  return { backdropAnimation, wrapperAnimation };
+};
 /**
  * iOS Modal Leave Animation
  */
-const iosLeaveAnimation = (baseEl, presentingEl, duration = 500) => {
-  const backdropAnimation = createAnimation()
-    .addElement(baseEl.querySelector('ion-backdrop'))
-    .fromTo('opacity', 'var(--backdrop-opacity)', 0.0);
-  const wrapperAnimation = createAnimation()
-    .addElement(baseEl.querySelectorAll('.modal-wrapper, .modal-shadow'))
-    .beforeStyles({ 'opacity': 1 })
-    .fromTo('transform', 'translateY(0vh)', 'translateY(100vh)');
-  const baseAnimation = createAnimation()
+const iosLeaveAnimation = (baseEl, opts, duration = 500) => {
+  const { presentingEl, currentBreakpoint } = opts;
+  const root = getElementRoot(baseEl);
+  const { wrapperAnimation, backdropAnimation } = currentBreakpoint !== undefined ? createSheetLeaveAnimation(opts) : createLeaveAnimation$1();
+  backdropAnimation.addElement(root.querySelector('ion-backdrop'));
+  wrapperAnimation.addElement(root.querySelectorAll('.modal-wrapper, .modal-shadow')).beforeStyles({ opacity: 1 });
+  const baseAnimation = createAnimation('leaving-base')
     .addElement(baseEl)
     .easing('cubic-bezier(0.32,0.72,0,1)')
     .duration(duration)
     .addAnimation(wrapperAnimation);
   if (presentingEl) {
     const isMobile = window.innerWidth < 768;
-    const hasCardModal = (presentingEl.tagName === 'ION-MODAL' && presentingEl.presentingElement !== undefined);
+    const hasCardModal = presentingEl.tagName === 'ION-MODAL' && presentingEl.presentingElement !== undefined;
+    const presentingElRoot = getElementRoot(presentingEl);
     const presentingAnimation = createAnimation()
       .beforeClearStyles(['transform'])
       .afterClearStyles(['transform'])
-      .onFinish(currentStep => {
+      .onFinish((currentStep) => {
       // only reset background color if this is the last card-style modal
       if (currentStep !== 1) {
         return;
       }
       presentingEl.style.setProperty('overflow', '');
-      const numModals = Array.from(bodyEl.querySelectorAll('ion-modal')).filter(m => m.presentingElement !== undefined).length;
+      const numModals = Array.from(bodyEl.querySelectorAll('ion-modal')).filter((m) => m.presentingElement !== undefined).length;
       if (numModals <= 1) {
         bodyEl.style.setProperty('background-color', '');
       }
     });
     const bodyEl = document.body;
     if (isMobile) {
-      const transformOffset = (!CSS.supports('width', 'max(0px, 1px)')) ? '30px' : 'max(30px, var(--ion-safe-area-top))';
+      const transformOffset = !CSS.supports('width', 'max(0px, 1px)') ? '30px' : 'max(30px, var(--ion-safe-area-top))';
       const modalTransform = hasCardModal ? '-10px' : transformOffset;
       const toPresentingScale = SwipeToCloseDefaults.MIN_PRESENTING_SCALE;
       const finalTransform = `translateY(${modalTransform}) scale(${toPresentingScale})`;
-      presentingAnimation
-        .addElement(presentingEl)
-        .keyframes([
+      presentingAnimation.addElement(presentingEl).keyframes([
         { offset: 0, filter: 'contrast(0.85)', transform: finalTransform, borderRadius: '10px 10px 0 0' },
-        { offset: 1, filter: 'contrast(1)', transform: 'translateY(0px) scale(1)', borderRadius: '0px' }
+        { offset: 1, filter: 'contrast(1)', transform: 'translateY(0px) scale(1)', borderRadius: '0px' },
       ]);
       baseAnimation.addAnimation(presentingAnimation);
     }
@@ -226,25 +722,25 @@ const iosLeaveAnimation = (baseEl, presentingEl, duration = 500) => {
         wrapperAnimation.fromTo('opacity', '1', '0');
       }
       else {
-        const toPresentingScale = (hasCardModal) ? SwipeToCloseDefaults.MIN_PRESENTING_SCALE : 1;
+        const toPresentingScale = hasCardModal ? SwipeToCloseDefaults.MIN_PRESENTING_SCALE : 1;
         const finalTransform = `translateY(-10px) scale(${toPresentingScale})`;
         presentingAnimation
-          .addElement(presentingEl.querySelector('.modal-wrapper'))
+          .addElement(presentingElRoot.querySelector('.modal-wrapper'))
           .afterStyles({
-          'transform': 'translate3d(0, 0, 0)'
+          transform: 'translate3d(0, 0, 0)',
         })
           .keyframes([
           { offset: 0, filter: 'contrast(0.85)', transform: finalTransform },
-          { offset: 1, filter: 'contrast(1)', transform: 'translateY(0) scale(1)' }
+          { offset: 1, filter: 'contrast(1)', transform: 'translateY(0) scale(1)' },
         ]);
         const shadowAnimation = createAnimation()
-          .addElement(presentingEl.querySelector('.modal-shadow'))
+          .addElement(presentingElRoot.querySelector('.modal-shadow'))
           .afterStyles({
-          'transform': 'translateY(0) scale(1)'
+          transform: 'translateY(0) scale(1)',
         })
           .keyframes([
           { offset: 0, opacity: '0', transform: finalTransform },
-          { offset: 1, opacity: '1', transform: 'translateY(0) scale(1)' }
+          { offset: 1, opacity: '1', transform: 'translateY(0) scale(1)' },
         ]);
         baseAnimation.addAnimation([presentingAnimation, shadowAnimation]);
       }
@@ -256,60 +752,367 @@ const iosLeaveAnimation = (baseEl, presentingEl, duration = 500) => {
   return baseAnimation;
 };
 
-/**
- * Md Modal Enter Animation
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
  */
-const mdEnterAnimation = (baseEl) => {
-  const baseAnimation = createAnimation();
-  const backdropAnimation = createAnimation();
-  const wrapperAnimation = createAnimation();
-  backdropAnimation
-    .addElement(baseEl.querySelector('ion-backdrop'))
+const createEnterAnimation = () => {
+  const backdropAnimation = createAnimation()
     .fromTo('opacity', 0.01, 'var(--backdrop-opacity)')
     .beforeStyles({
-    'pointer-events': 'none'
+    'pointer-events': 'none',
   })
     .afterClearStyles(['pointer-events']);
-  wrapperAnimation
-    .addElement(baseEl.querySelector('.modal-wrapper'))
-    .keyframes([
+  const wrapperAnimation = createAnimation().keyframes([
     { offset: 0, opacity: 0.01, transform: 'translateY(40px)' },
-    { offset: 1, opacity: 1, transform: 'translateY(0px)' }
+    { offset: 1, opacity: 1, transform: `translateY(0px)` },
   ]);
-  return baseAnimation
+  return { backdropAnimation, wrapperAnimation };
+};
+/**
+ * Md Modal Enter Animation
+ */
+const mdEnterAnimation = (baseEl, opts) => {
+  const { currentBreakpoint } = opts;
+  const root = getElementRoot(baseEl);
+  const { wrapperAnimation, backdropAnimation } = currentBreakpoint !== undefined ? createSheetEnterAnimation(opts) : createEnterAnimation();
+  backdropAnimation.addElement(root.querySelector('ion-backdrop'));
+  wrapperAnimation.addElement(root.querySelector('.modal-wrapper'));
+  return createAnimation()
     .addElement(baseEl)
     .easing('cubic-bezier(0.36,0.66,0.04,1)')
     .duration(280)
     .addAnimation([backdropAnimation, wrapperAnimation]);
 };
 
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+const createLeaveAnimation = () => {
+  const backdropAnimation = createAnimation().fromTo('opacity', 'var(--backdrop-opacity)', 0);
+  const wrapperAnimation = createAnimation().keyframes([
+    { offset: 0, opacity: 0.99, transform: `translateY(0px)` },
+    { offset: 1, opacity: 0, transform: 'translateY(40px)' },
+  ]);
+  return { backdropAnimation, wrapperAnimation };
+};
 /**
  * Md Modal Leave Animation
  */
-const mdLeaveAnimation = (baseEl) => {
-  const baseAnimation = createAnimation();
-  const backdropAnimation = createAnimation();
-  const wrapperAnimation = createAnimation();
-  const wrapperEl = baseEl.querySelector('.modal-wrapper');
-  backdropAnimation
-    .addElement(baseEl.querySelector('ion-backdrop'))
-    .fromTo('opacity', 'var(--backdrop-opacity)', 0.0);
-  wrapperAnimation
-    .addElement(wrapperEl)
-    .keyframes([
-    { offset: 0, opacity: 0.99, transform: 'translateY(0px)' },
-    { offset: 1, opacity: 0, transform: 'translateY(40px)' }
-  ]);
-  return baseAnimation
-    .addElement(baseEl)
+const mdLeaveAnimation = (baseEl, opts) => {
+  const { currentBreakpoint } = opts;
+  const root = getElementRoot(baseEl);
+  const { wrapperAnimation, backdropAnimation } = currentBreakpoint !== undefined ? createSheetLeaveAnimation(opts) : createLeaveAnimation();
+  backdropAnimation.addElement(root.querySelector('ion-backdrop'));
+  wrapperAnimation.addElement(root.querySelector('.modal-wrapper'));
+  return createAnimation()
     .easing('cubic-bezier(0.47,0,0.745,0.715)')
     .duration(200)
     .addAnimation([backdropAnimation, wrapperAnimation]);
 };
 
-const modalIosCss = ".sc-ion-modal-ios-h{--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:flex;position:absolute;align-items:center;justify-content:center;outline:none;contain:strict}.overlay-hidden.sc-ion-modal-ios-h{display:none}.modal-wrapper.sc-ion-modal-ios,.modal-shadow.sc-ion-modal-ios{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);box-shadow:var(--box-shadow);overflow:var(--overflow);z-index:10}.modal-shadow.sc-ion-modal-ios{position:absolute;background:transparent}@media only screen and (min-width: 768px) and (min-height: 600px){.sc-ion-modal-ios-h{--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){.sc-ion-modal-ios-h{--width:600px;--height:600px}}.sc-ion-modal-ios-h:first-of-type{--backdrop-opacity:var(--ion-backdrop-opacity, 0.4)}@media only screen and (min-width: 768px) and (min-height: 600px){.sc-ion-modal-ios-h{--border-radius:10px}}.modal-wrapper.sc-ion-modal-ios{transform:translate3d(0,  100%,  0)}@media screen and (max-width: 767px){@supports (width: max(0px, 1px)){.modal-card.sc-ion-modal-ios-h{--height:calc(100% - max(30px, var(--ion-safe-area-top)) - 10px)}}@supports not (width: max(0px, 1px)){.modal-card.sc-ion-modal-ios-h{--height:calc(100% - 40px)}}.modal-card.sc-ion-modal-ios-h .modal-wrapper.sc-ion-modal-ios{border-top-left-radius:10px;border-top-right-radius:10px;border-bottom-right-radius:0;border-bottom-left-radius:0}[dir=rtl].sc-ion-modal-ios-h -no-combinator.modal-card.sc-ion-modal-ios-h .modal-wrapper.sc-ion-modal-ios,[dir=rtl] .sc-ion-modal-ios-h -no-combinator.modal-card.sc-ion-modal-ios-h .modal-wrapper.sc-ion-modal-ios,[dir=rtl].modal-card.sc-ion-modal-ios-h .modal-wrapper.sc-ion-modal-ios,[dir=rtl] .modal-card.sc-ion-modal-ios-h .modal-wrapper.sc-ion-modal-ios{border-top-left-radius:10px;border-top-right-radius:10px;border-bottom-right-radius:0;border-bottom-left-radius:0}.modal-card.sc-ion-modal-ios-h{--backdrop-opacity:0;--width:100%;align-items:flex-end}.modal-card.sc-ion-modal-ios-h .modal-shadow.sc-ion-modal-ios{display:none}.modal-card.sc-ion-modal-ios-h ion-backdrop.sc-ion-modal-ios{pointer-events:none}}@media screen and (min-width: 768px){.modal-card.sc-ion-modal-ios-h{--width:calc(100% - 120px);--height:calc(100% - (120px + var(--ion-safe-area-top) + var(--ion-safe-area-bottom)));--max-width:720px;--max-height:1000px}.modal-card.sc-ion-modal-ios-h{--backdrop-opacity:0;transition:all 0.5s ease-in-out}.modal-card.sc-ion-modal-ios-h:first-of-type{--backdrop-opacity:0.18}.modal-card.sc-ion-modal-ios-h .modal-shadow.sc-ion-modal-ios{box-shadow:0px 0px 30px 10px rgba(0, 0, 0, 0.1)}}";
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, backdropBreakpoint, animation, breakpoints = [], getCurrentBreakpoint, onDismiss, onBreakpointChange) => {
+  // Defaults for the sheet swipe animation
+  const defaultBackdrop = [
+    { offset: 0, opacity: 'var(--backdrop-opacity)' },
+    { offset: 1, opacity: 0.01 },
+  ];
+  const customBackdrop = [
+    { offset: 0, opacity: 'var(--backdrop-opacity)' },
+    { offset: 1 - backdropBreakpoint, opacity: 0 },
+    { offset: 1, opacity: 0 },
+  ];
+  const SheetDefaults = {
+    WRAPPER_KEYFRAMES: [
+      { offset: 0, transform: 'translateY(0%)' },
+      { offset: 1, transform: 'translateY(100%)' },
+    ],
+    BACKDROP_KEYFRAMES: backdropBreakpoint !== 0 ? customBackdrop : defaultBackdrop,
+  };
+  const contentEl = baseEl.querySelector('ion-content');
+  const height = wrapperEl.clientHeight;
+  let currentBreakpoint = initialBreakpoint;
+  let offset = 0;
+  let canDismissBlocksGesture = false;
+  const canDismissMaxStep = 0.95;
+  const wrapperAnimation = animation.childAnimations.find((ani) => ani.id === 'wrapperAnimation');
+  const backdropAnimation = animation.childAnimations.find((ani) => ani.id === 'backdropAnimation');
+  const maxBreakpoint = breakpoints[breakpoints.length - 1];
+  const minBreakpoint = breakpoints[0];
+  const enableBackdrop = () => {
+    baseEl.style.setProperty('pointer-events', 'auto');
+    backdropEl.style.setProperty('pointer-events', 'auto');
+    /**
+     * When the backdrop is enabled, elements such
+     * as inputs should not be focusable outside
+     * the sheet.
+     */
+    baseEl.classList.remove('ion-disable-focus-trap');
+  };
+  const disableBackdrop = () => {
+    baseEl.style.setProperty('pointer-events', 'none');
+    backdropEl.style.setProperty('pointer-events', 'none');
+    /**
+     * When the backdrop is enabled, elements such
+     * as inputs should not be focusable outside
+     * the sheet.
+     * Adding this class disables focus trapping
+     * for the sheet temporarily.
+     */
+    baseEl.classList.add('ion-disable-focus-trap');
+  };
+  /**
+   * After the entering animation completes,
+   * we need to set the animation to go from
+   * offset 0 to offset 1 so that users can
+   * swipe in any direction. We then set the
+   * animation offset to the current breakpoint
+   * so there is no flickering.
+   */
+  if (wrapperAnimation && backdropAnimation) {
+    wrapperAnimation.keyframes([...SheetDefaults.WRAPPER_KEYFRAMES]);
+    backdropAnimation.keyframes([...SheetDefaults.BACKDROP_KEYFRAMES]);
+    animation.progressStart(true, 1 - currentBreakpoint);
+    /**
+     * If backdrop is not enabled, then content
+     * behind modal should be clickable. To do this, we need
+     * to remove pointer-events from ion-modal as a whole.
+     * ion-backdrop and .modal-wrapper always have pointer-events: auto
+     * applied, so the modal content can still be interacted with.
+     */
+    const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint;
+    if (shouldEnableBackdrop) {
+      enableBackdrop();
+    }
+    else {
+      disableBackdrop();
+    }
+  }
+  if (contentEl && currentBreakpoint !== maxBreakpoint) {
+    contentEl.scrollY = false;
+  }
+  const canStart = (detail) => {
+    /**
+     * If the sheet is fully expanded and
+     * the user is swiping on the content,
+     * the gesture should not start to
+     * allow for scrolling on the content.
+     */
+    const content = detail.event.target.closest('ion-content');
+    currentBreakpoint = getCurrentBreakpoint();
+    if (currentBreakpoint === 1 && content) {
+      return false;
+    }
+    return true;
+  };
+  const onStart = () => {
+    /**
+     * If canDismiss is anything other than `true`
+     * then users should be able to swipe down
+     * until a threshold is hit. At that point,
+     * the card modal should not proceed any further.
+     *
+     * canDismiss is never fired via gesture if there is
+     * no 0 breakpoint. However, it can be fired if the user
+     * presses Esc or the hardware back button.
+     * TODO (FW-937)
+     * Remove undefined check
+     */
+    canDismissBlocksGesture = baseEl.canDismiss !== undefined && baseEl.canDismiss !== true && minBreakpoint === 0;
+    /**
+     * If swiping on the content
+     * we should disable scrolling otherwise
+     * the sheet will expand and the content will scroll.
+     */
+    if (contentEl) {
+      contentEl.scrollY = false;
+    }
+    raf(() => {
+      /**
+       * Dismisses the open keyboard when the sheet drag gesture is started.
+       * Sets the focus onto the modal element.
+       */
+      baseEl.focus();
+    });
+    animation.progressStart(true, 1 - currentBreakpoint);
+  };
+  const onMove = (detail) => {
+    /**
+     * Given the change in gesture position on the Y axis,
+     * compute where the offset of the animation should be
+     * relative to where the user dragged.
+     */
+    const initialStep = 1 - currentBreakpoint;
+    const secondToLastBreakpoint = breakpoints.length > 1 ? 1 - breakpoints[1] : undefined;
+    const step = initialStep + detail.deltaY / height;
+    const isAttemptingDismissWithCanDismiss = secondToLastBreakpoint !== undefined && step >= secondToLastBreakpoint && canDismissBlocksGesture;
+    /**
+     * If we are blocking the gesture from dismissing,
+     * set the max step value so that the sheet cannot be
+     * completely hidden.
+     */
+    const maxStep = isAttemptingDismissWithCanDismiss ? canDismissMaxStep : 0.9999;
+    /**
+     * If we are blocking the gesture from
+     * dismissing, calculate the spring modifier value
+     * this will be added to the starting breakpoint
+     * value to give the gesture a spring-like feeling.
+     * Note that when isAttemptingDismissWithCanDismiss is true,
+     * the modifier is always added to the breakpoint that
+     * appears right after the 0 breakpoint.
+     *
+     * Note that this modifier is essentially the progression
+     * between secondToLastBreakpoint and maxStep which is
+     * why we subtract secondToLastBreakpoint. This lets us get
+     * the result as a value from 0 to 1.
+     */
+    const processedStep = isAttemptingDismissWithCanDismiss && secondToLastBreakpoint !== undefined
+      ? secondToLastBreakpoint +
+        calculateSpringStep((step - secondToLastBreakpoint) / (maxStep - secondToLastBreakpoint))
+      : step;
+    offset = clamp(0.0001, processedStep, maxStep);
+    animation.progressStep(offset);
+  };
+  const onEnd = (detail) => {
+    /**
+     * When the gesture releases, we need to determine
+     * the closest breakpoint to snap to.
+     */
+    const velocity = detail.velocityY;
+    const threshold = (detail.deltaY + velocity * 350) / height;
+    const diff = currentBreakpoint - threshold;
+    const closest = breakpoints.reduce((a, b) => {
+      return Math.abs(b - diff) < Math.abs(a - diff) ? b : a;
+    });
+    moveSheetToBreakpoint({
+      breakpoint: closest,
+      breakpointOffset: offset,
+      canDismiss: canDismissBlocksGesture,
+    });
+  };
+  const moveSheetToBreakpoint = (options) => {
+    const { breakpoint, canDismiss, breakpointOffset } = options;
+    /**
+     * canDismiss should only prevent snapping
+     * when users are trying to dismiss. If canDismiss
+     * is present but the user is trying to swipe upwards,
+     * we should allow that to happen,
+     */
+    const shouldPreventDismiss = canDismiss && breakpoint === 0;
+    const snapToBreakpoint = shouldPreventDismiss ? currentBreakpoint : breakpoint;
+    const shouldRemainOpen = snapToBreakpoint !== 0;
+    currentBreakpoint = 0;
+    /**
+     * Update the animation so that it plays from
+     * the last offset to the closest snap point.
+     */
+    if (wrapperAnimation && backdropAnimation) {
+      wrapperAnimation.keyframes([
+        { offset: 0, transform: `translateY(${breakpointOffset * 100}%)` },
+        { offset: 1, transform: `translateY(${(1 - snapToBreakpoint) * 100}%)` },
+      ]);
+      backdropAnimation.keyframes([
+        {
+          offset: 0,
+          opacity: `calc(var(--backdrop-opacity) * ${getBackdropValueForSheet(1 - breakpointOffset, backdropBreakpoint)})`,
+        },
+        {
+          offset: 1,
+          opacity: `calc(var(--backdrop-opacity) * ${getBackdropValueForSheet(snapToBreakpoint, backdropBreakpoint)})`,
+        },
+      ]);
+      animation.progressStep(0);
+    }
+    /**
+     * Gesture should remain disabled until the
+     * snapping animation completes.
+     */
+    gesture.enable(false);
+    if (shouldPreventDismiss) {
+      handleCanDismiss(baseEl, animation);
+    }
+    else if (!shouldRemainOpen) {
+      onDismiss();
+    }
+    return new Promise((resolve) => {
+      animation
+        .onFinish(() => {
+        if (shouldRemainOpen) {
+          /**
+           * Once the snapping animation completes,
+           * we need to reset the animation to go
+           * from 0 to 1 so users can swipe in any direction.
+           * We then set the animation offset to the current
+           * breakpoint so that it starts at the snapped position.
+           */
+          if (wrapperAnimation && backdropAnimation) {
+            raf(() => {
+              wrapperAnimation.keyframes([...SheetDefaults.WRAPPER_KEYFRAMES]);
+              backdropAnimation.keyframes([...SheetDefaults.BACKDROP_KEYFRAMES]);
+              animation.progressStart(true, 1 - snapToBreakpoint);
+              currentBreakpoint = snapToBreakpoint;
+              onBreakpointChange(currentBreakpoint);
+              /**
+               * If the sheet is fully expanded, we can safely
+               * enable scrolling again.
+               */
+              if (contentEl && currentBreakpoint === breakpoints[breakpoints.length - 1]) {
+                contentEl.scrollY = true;
+              }
+              /**
+               * Backdrop should become enabled
+               * after the backdropBreakpoint value
+               */
+              const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint;
+              if (shouldEnableBackdrop) {
+                enableBackdrop();
+              }
+              else {
+                disableBackdrop();
+              }
+              gesture.enable(true);
+              resolve();
+            });
+          }
+          else {
+            gesture.enable(true);
+            resolve();
+          }
+        }
+        else {
+          resolve();
+        }
+        /**
+         * This must be a one time callback
+         * otherwise a new callback will
+         * be added every time onEnd runs.
+         */
+      }, { oneTimeCallback: true })
+        .progressEnd(1, 0, 500);
+    });
+  };
+  const gesture = createGesture({
+    el: wrapperEl,
+    gestureName: 'modalSheet',
+    gesturePriority: 40,
+    direction: 'y',
+    threshold: 10,
+    canStart,
+    onStart,
+    onMove,
+    onEnd,
+  });
+  return {
+    gesture,
+    moveSheetToBreakpoint,
+  };
+};
+
+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:flex;position:absolute;align-items:center;justify-content:center;outline:none;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);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;margin-left:auto;margin-right:auto;position:absolute;width:36px;height:5px;transform:translateZ(0);border:0;background:var(--ion-color-step-350, #c0c0be);cursor:pointer;z-index:11}@supports (margin-inline-start: 0) or (-webkit-margin-start: 0){.modal-handle{margin-left:unset;margin-right:unset;-webkit-margin-start:auto;margin-inline-start:auto;-webkit-margin-end:auto;margin-inline-end:auto}}.modal-handle::before{padding-left:4px;padding-right:4px;padding-top:4px;padding-bottom:4px;position:absolute;width:36px;height:5px;transform:translate(-50%, -50%);content:\"\"}@supports (margin-inline-start: 0) or (-webkit-margin-start: 0){.modal-handle::before{padding-left:unset;padding-right:unset;-webkit-padding-start:4px;padding-inline-start:4px;-webkit-padding-end:4px;padding-inline-end:4px}}: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{--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{transform:translate3d(0,  100%,  0)}@media screen and (max-width: 767px){@supports (width: 1px){:host(.modal-card){--height:calc(100% - max(30px, var(--ion-safe-area-top)) - 10px)}}@supports not (width: 1px){:host(.modal-card){--height:calc(100% - 40px)}}:host(.modal-card) .modal-wrapper{border-top-left-radius:var(--border-radius);border-top-right-radius:var(--border-radius);border-bottom-right-radius:0;border-bottom-left-radius:0}:host-context([dir=rtl]):host(.modal-card) .modal-wrapper,:host-context([dir=rtl]).modal-card .modal-wrapper{border-top-left-radius:var(--border-radius);border-top-right-radius:var(--border-radius);border-bottom-right-radius:0;border-bottom-left-radius:0}:host(.modal-card){--backdrop-opacity:0;--width:100%;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);transition:all 0.5s ease-in-out}:host(.modal-card) .modal-wrapper{box-shadow:none}:host(.modal-card) .modal-shadow{box-shadow:var(--box-shadow)}}:host(.modal-sheet) .modal-wrapper{border-top-left-radius:var(--border-radius);border-top-right-radius:var(--border-radius);border-bottom-right-radius:0;border-bottom-left-radius:0}:host-context([dir=rtl]):host(.modal-sheet) .modal-wrapper,:host-context([dir=rtl]).modal-sheet .modal-wrapper{border-top-left-radius:var(--border-radius);border-top-right-radius:var(--border-radius);border-bottom-right-radius:0;border-bottom-left-radius:0}";
 
-const modalMdCss = ".sc-ion-modal-md-h{--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:flex;position:absolute;align-items:center;justify-content:center;outline:none;contain:strict}.overlay-hidden.sc-ion-modal-md-h{display:none}.modal-wrapper.sc-ion-modal-md,.modal-shadow.sc-ion-modal-md{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);box-shadow:var(--box-shadow);overflow:var(--overflow);z-index:10}.modal-shadow.sc-ion-modal-md{position:absolute;background:transparent}@media only screen and (min-width: 768px) and (min-height: 600px){.sc-ion-modal-md-h{--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){.sc-ion-modal-md-h{--width:600px;--height:600px}}.sc-ion-modal-md-h:first-of-type{--backdrop-opacity:var(--ion-backdrop-opacity, 0.32)}@media only screen and (min-width: 768px) and (min-height: 600px){.sc-ion-modal-md-h{--border-radius:2px}.sc-ion-modal-md-h:first-of-type{--box-shadow:0 28px 48px rgba(0, 0, 0, 0.4)}}.modal-wrapper.sc-ion-modal-md{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:flex;position:absolute;align-items:center;justify-content:center;outline:none;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);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;margin-left:auto;margin-right:auto;position:absolute;width:36px;height:5px;transform:translateZ(0);border:0;background:var(--ion-color-step-350, #c0c0be);cursor:pointer;z-index:11}@supports (margin-inline-start: 0) or (-webkit-margin-start: 0){.modal-handle{margin-left:unset;margin-right:unset;-webkit-margin-start:auto;margin-inline-start:auto;-webkit-margin-end:auto;margin-inline-end:auto}}.modal-handle::before{padding-left:4px;padding-right:4px;padding-top:4px;padding-bottom:4px;position:absolute;width:36px;height:5px;transform:translate(-50%, -50%);content:\"\"}@supports (margin-inline-start: 0) or (-webkit-margin-start: 0){.modal-handle::before{padding-left:unset;padding-right:unset;-webkit-padding-start:4px;padding-inline-start:4px;-webkit-padding-end:4px;padding-inline-end:4px}}: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{--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{transform:translate3d(0,  40px,  0);opacity:0.01}";
 
 const Modal = class {
   constructor(hostRef) {
@@ -318,19 +1121,55 @@ const Modal = class {
     this.willPresent = createEvent(this, "ionModalWillPresent", 7);
     this.willDismiss = createEvent(this, "ionModalWillDismiss", 7);
     this.didDismiss = createEvent(this, "ionModalDidDismiss", 7);
+    this.ionBreakpointDidChange = createEvent(this, "ionBreakpointDidChange", 7);
+    this.didPresentShorthand = createEvent(this, "didPresent", 7);
+    this.willPresentShorthand = createEvent(this, "willPresent", 7);
+    this.willDismissShorthand = createEvent(this, "willDismiss", 7);
+    this.didDismissShorthand = createEvent(this, "didDismiss", 7);
+    this.modalIndex = modalIds++;
+    this.coreDelegate = 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;
+    /**
+     * 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;
     /**
@@ -339,16 +1178,74 @@ const Modal = class {
     this.animated = true;
     /**
      * If `true`, the modal can be swiped to dismiss. Only applies in iOS mode.
+     * @deprecated - To prevent modals from dismissing, use canDismiss instead.
      */
     this.swipeToClose = false;
+    /**
+     * 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;
+    this.configureTriggerInteraction = () => {
+      const { trigger, el, destroyTriggerInteraction } = this;
+      if (destroyTriggerInteraction) {
+        destroyTriggerInteraction();
+      }
+      const triggerEl = trigger !== undefined ? document.getElementById(trigger) : null;
+      if (!triggerEl) {
+        return;
+      }
+      const configureTriggerInteraction = (trigEl, modalEl) => {
+        const openModal = () => {
+          modalEl.present();
+        };
+        trigEl.addEventListener('click', openModal);
+        return () => {
+          trigEl.removeEventListener('click', openModal);
+        };
+      };
+      this.destroyTriggerInteraction = configureTriggerInteraction(triggerEl, el);
+    };
+    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, BACKDROP);
     };
-    this.onDismiss = (ev) => {
-      ev.stopPropagation();
-      ev.preventDefault();
-      this.dismiss();
-    };
     this.onLifecycle = (modalEvent) => {
       const el = this.usersElement;
       const name = LIFECYCLE_MAP[modalEvent.type];
@@ -356,22 +1253,124 @@ const Modal = class {
         const ev = new CustomEvent(name, {
           bubbles: false,
           cancelable: false,
-          detail: modalEvent.detail
+          detail: modalEvent.detail,
         });
         el.dispatchEvent(ev);
       }
     };
   }
-  swipeToCloseChanged(enable) {
+  onIsOpenChange(newValue, oldValue) {
+    if (newValue === true && oldValue === false) {
+      this.present();
+    }
+    else if (newValue === false && oldValue === true) {
+      this.dismiss();
+    }
+  }
+  onTriggerChange() {
+    this.configureTriggerInteraction();
+  }
+  async swipeToCloseChanged(enable) {
     if (this.gesture) {
       this.gesture.enable(enable);
     }
     else if (enable) {
-      this.initSwipeToClose();
+      await this.initSwipeToClose();
+    }
+  }
+  breakpointsChanged(breakpoints) {
+    if (breakpoints !== undefined) {
+      this.sortedBreakpoints = breakpoints.sort((a, b) => a - b);
     }
   }
   connectedCallback() {
-    prepareOverlay(this.el);
+    const { configureTriggerInteraction, el } = this;
+    prepareOverlay(el);
+    configureTriggerInteraction();
+  }
+  disconnectedCallback() {
+    const { destroyTriggerInteraction } = this;
+    if (destroyTriggerInteraction) {
+      destroyTriggerInteraction();
+    }
+  }
+  componentWillLoad() {
+    const { breakpoints, initialBreakpoint, swipeToClose, el } = this;
+    this.inheritedAttributes = inheritAttributes(el, ['aria-label', 'role']);
+    /**
+     * If user has custom ID set then we should
+     * not assign the default incrementing ID.
+     */
+    this.modalId = this.el.hasAttribute('id') ? this.el.getAttribute('id') : `ion-modal-${this.modalIndex}`;
+    const isSheetModal = (this.isSheetModal = breakpoints !== undefined && initialBreakpoint !== undefined);
+    if (isSheetModal) {
+      this.currentBreakpoint = this.initialBreakpoint;
+    }
+    if (breakpoints !== undefined && initialBreakpoint !== undefined && !breakpoints.includes(initialBreakpoint)) {
+      printIonWarning('Your breakpoints array must include the initialBreakpoint value.');
+    }
+    if (swipeToClose) {
+      printIonWarning('swipeToClose has been deprecated in favor of canDismiss.\n\nIf you want a card modal to be swipeable, set canDismiss to `true`. In the next major release of Ionic, swipeToClose will be removed, and all card modals will be swipeable by default.');
+    }
+  }
+  componentDidLoad() {
+    /**
+     * If modal was rendered with isOpen="true"
+     * then we should open modal immediately.
+     */
+    if (this.isOpen === true) {
+      raf(() => this.present());
+    }
+    this.breakpointsChanged(this.breakpoints);
+  }
+  /**
+   * Determines whether or not an overlay
+   * is being used inline or via a controller/JS
+   * and returns the correct delegate.
+   * By default, subsequent calls to getDelegate
+   * will use a cached version of the delegate.
+   * This is useful for calling dismiss after
+   * present so that the correct delegate is given.
+   */
+  getDelegate(force = false) {
+    if (this.workingDelegate && !force) {
+      return {
+        delegate: this.workingDelegate,
+        inline: this.inline,
+      };
+    }
+    /**
+     * If using overlay inline
+     * we potentially need to use the coreDelegate
+     * so that this works in vanilla JS apps.
+     * If a developer has presented this component
+     * via a controller, then we can assume
+     * the component is already in the
+     * correct place.
+     */
+    const parentEl = this.el.parentNode;
+    const inline = (this.inline = parentEl !== null && !this.hasController);
+    const delegate = (this.workingDelegate = inline ? this.delegate || this.coreDelegate : this.delegate);
+    return { inline, delegate };
+  }
+  /**
+   * Determines whether or not the
+   * modal is allowed to dismiss based
+   * on the state of the canDismiss prop.
+   */
+  async checkCanDismiss() {
+    const { canDismiss } = this;
+    /**
+     * TODO (FW-937) - Remove the following check in
+     * the next major release of Ionic.
+     */
+    if (canDismiss === undefined) {
+      return true;
+    }
+    if (typeof canDismiss === 'function') {
+      return canDismiss();
+    }
+    return canDismiss;
   }
   /**
    * Present the modal overlay after it has been created.
@@ -380,29 +1379,102 @@ const Modal = class {
     if (this.presented) {
       return;
     }
-    const container = this.el.querySelector(`.modal-wrapper`);
-    if (!container) {
-      throw new Error('container is undefined');
+    /**
+     * When using an inline modal
+     * and dismissing a modal it is possible to
+     * quickly present the modal while it is
+     * dismissing. We need to await any current
+     * transition to allow the dismiss to finish
+     * before presenting again.
+     */
+    if (this.currentTransition !== undefined) {
+      await this.currentTransition;
     }
-    const componentProps = Object.assign(Object.assign({}, this.componentProps), { modal: this.el });
-    this.usersElement = await attachComponent(this.delegate, container, this.component, ['ion-page'], componentProps);
+    /**
+     * If the modal is presented multiple times (inline modals), we
+     * need to reset the current breakpoint to the initial breakpoint.
+     */
+    this.currentBreakpoint = this.initialBreakpoint;
+    const data = Object.assign(Object.assign({}, this.componentProps), { modal: this.el });
+    const { inline, delegate } = this.getDelegate(true);
+    this.usersElement = await attachComponent(delegate, this.el, this.component, ['ion-page'], data, inline);
     await deepReady(this.usersElement);
     writeTask(() => this.el.classList.add('show-modal'));
-    await present(this, 'modalEnter', iosEnterAnimation, mdEnterAnimation, this.presentingElement);
-    if (this.swipeToClose) {
-      this.initSwipeToClose();
+    this.currentTransition = present(this, 'modalEnter', iosEnterAnimation, mdEnterAnimation, {
+      presentingEl: this.presentingElement,
+      currentBreakpoint: this.initialBreakpoint,
+      backdropBreakpoint: this.backdropBreakpoint,
+    });
+    /**
+     * TODO (FW-937) - In the next major release of Ionic, all card modals
+     * will be swipeable by default. canDismiss will be used to determine if the
+     * modal can be dismissed. This check should change to check the presence of
+     * presentingElement instead.
+     *
+     * If we did not do this check, then not using swipeToClose would mean you could
+     * not run canDismiss on swipe as there would be no swipe gesture created.
+     */
+    const hasCardModal = this.presentingElement !== undefined && (this.swipeToClose || this.canDismiss !== undefined);
+    /**
+     * We need to change the status bar at the
+     * start of the animation so that it completes
+     * by the time the card animation is done.
+     */
+    if (hasCardModal && getIonMode(this) === 'ios') {
+      // Cache the original status bar color before the modal is presented
+      this.statusBarStyle = await StatusBar.getStyle();
+      setCardStatusBarDark();
+    }
+    await this.currentTransition;
+    if (this.isSheetModal) {
+      this.initSheetGesture();
+    }
+    else if (hasCardModal) {
+      await this.initSwipeToClose();
     }
+    /* tslint:disable-next-line */
+    if (typeof window !== 'undefined') {
+      this.keyboardOpenCallback = () => {
+        if (this.gesture) {
+          /**
+           * When the native keyboard is opened and the webview
+           * is resized, the gesture implementation will become unresponsive
+           * and enter a free-scroll mode.
+           *
+           * When the keyboard is opened, we disable the gesture for
+           * a single frame and re-enable once the contents have repositioned
+           * from the keyboard placement.
+           */
+          this.gesture.enable(false);
+          raf(() => {
+            if (this.gesture) {
+              this.gesture.enable(true);
+            }
+          });
+        }
+      };
+      window.addEventListener(KEYBOARD_DID_OPEN, this.keyboardOpenCallback);
+    }
+    this.currentTransition = undefined;
   }
   initSwipeToClose() {
+    var _a;
     if (getIonMode(this) !== 'ios') {
       return;
     }
+    const { el } = this;
     // All of the elements needed for the swipe gesture
     // should be in the DOM and referenced by now, except
     // for the presenting el
     const animationBuilder = this.leaveAnimation || config.get('modalLeave', iosLeaveAnimation);
-    const ani = this.animation = animationBuilder(this.el, this.presentingElement);
-    this.gesture = createSwipeToCloseGesture(this.el, ani, () => {
+    const ani = (this.animation = animationBuilder(el, { presentingEl: this.presentingElement }));
+    const contentEl = findIonContent(el);
+    if (!contentEl) {
+      printIonContentErrorMsg(el);
+      return;
+    }
+    const statusBarStyle = (_a = this.statusBarStyle) !== null && _a !== void 0 ? _a : Style.Default;
+    this.gesture = createSwipeToCloseGesture(el, ani, statusBarStyle, () => {
       /**
        * While the gesture animation is finishing
        * it is possible for a user to tap the backdrop.
@@ -421,6 +1493,47 @@ const Modal = class {
     });
     this.gesture.enable(true);
   }
+  initSheetGesture() {
+    const { wrapperEl, initialBreakpoint, backdropBreakpoint } = this;
+    if (!wrapperEl || initialBreakpoint === undefined) {
+      return;
+    }
+    const animationBuilder = this.enterAnimation || config.get('modalEnter', iosEnterAnimation);
+    const ani = (this.animation = animationBuilder(this.el, {
+      presentingEl: this.presentingElement,
+      currentBreakpoint: initialBreakpoint,
+      backdropBreakpoint,
+    }));
+    ani.progressStart(true, 1);
+    const { gesture, moveSheetToBreakpoint } = createSheetGesture(this.el, this.backdropEl, wrapperEl, initialBreakpoint, backdropBreakpoint, ani, this.sortedBreakpoints, () => { var _a; return (_a = this.currentBreakpoint) !== null && _a !== void 0 ? _a : 0; }, () => this.sheetOnDismiss(), (breakpoint) => {
+      if (this.currentBreakpoint !== breakpoint) {
+        this.currentBreakpoint = breakpoint;
+        this.ionBreakpointDidChange.emit({ breakpoint });
+      }
+    });
+    this.gesture = gesture;
+    this.moveSheetToBreakpoint = moveSheetToBreakpoint;
+    this.gesture.enable(true);
+  }
+  sheetOnDismiss() {
+    /**
+     * While the gesture animation is finishing
+     * it is possible for a user to tap the backdrop.
+     * This would result in the dismiss animation
+     * being played again. Typically this is avoided
+     * by setting `presented = false` on the overlay
+     * component; however, we cannot do that here as
+     * that would prevent the element from being
+     * removed from the DOM.
+     */
+    this.gestureAnimationDismissing = true;
+    this.animation.onFinish(async () => {
+      this.currentBreakpoint = 0;
+      this.ionBreakpointDidChange.emit({ breakpoint: this.currentBreakpoint });
+      await this.dismiss(undefined, 'gesture');
+      this.gestureAnimationDismissing = false;
+    });
+  }
   /**
    * Dismiss the modal overlay after it has been presented.
    *
@@ -428,18 +1541,64 @@ const Modal = class {
    * @param role The role of the element that is dismissing the modal. For example, 'cancel' or 'backdrop'.
    */
   async dismiss(data, role) {
+    var _a;
     if (this.gestureAnimationDismissing && role !== 'gesture') {
       return false;
     }
+    /**
+     * If a canDismiss handler is responsible
+     * for calling the dismiss method, we should
+     * not run the canDismiss check again.
+     */
+    if (role !== 'handler' && !(await this.checkCanDismiss())) {
+      return false;
+    }
+    /**
+     * We need to start the status bar change
+     * before the animation so that the change
+     * finishes when the dismiss animation does.
+     * TODO (FW-937)
+     */
+    const hasCardModal = this.presentingElement !== undefined && (this.swipeToClose || this.canDismiss !== undefined);
+    if (hasCardModal && getIonMode(this) === 'ios') {
+      setCardStatusBarDefault(this.statusBarStyle);
+    }
+    /* tslint:disable-next-line */
+    if (typeof window !== 'undefined' && this.keyboardOpenCallback) {
+      window.removeEventListener(KEYBOARD_DID_OPEN, this.keyboardOpenCallback);
+    }
+    /**
+     * When using an inline modal
+     * and presenting a modal it is possible to
+     * quickly dismiss the modal while it is
+     * presenting. We need to await any current
+     * transition to allow the present to finish
+     * before dismissing again.
+     */
+    if (this.currentTransition !== undefined) {
+      await this.currentTransition;
+    }
     const enteringAnimation = activeAnimations.get(this) || [];
-    const dismissed = await dismiss(this, data, role, 'modalLeave', iosLeaveAnimation, mdLeaveAnimation, this.presentingElement);
+    this.currentTransition = dismiss(this, data, role, 'modalLeave', iosLeaveAnimation, mdLeaveAnimation, {
+      presentingEl: this.presentingElement,
+      currentBreakpoint: (_a = this.currentBreakpoint) !== null && _a !== void 0 ? _a : this.initialBreakpoint,
+      backdropBreakpoint: this.backdropBreakpoint,
+    });
+    const dismissed = await this.currentTransition;
     if (dismissed) {
-      await detachComponent(this.delegate, this.usersElement);
+      const { delegate } = this.getDelegate();
+      await detachComponent(delegate, this.usersElement);
+      writeTask(() => this.el.classList.remove('show-modal'));
       if (this.animation) {
         this.animation.destroy();
       }
-      enteringAnimation.forEach(ani => ani.destroy());
+      if (this.gesture) {
+        this.gesture.destroy();
+      }
+      enteringAnimation.forEach((ani) => ani.destroy());
     }
+    this.currentBreakpoint = undefined;
+    this.currentTransition = undefined;
     this.animation = undefined;
     return dismissed;
   }
@@ -455,24 +1614,95 @@ const Modal = class {
   onWillDismiss() {
     return eventMethod(this.el, 'ionModalWillDismiss');
   }
+  /**
+   * Move a sheet style modal to a specific breakpoint. The breakpoint value must
+   * be a value defined in your `breakpoints` array.
+   */
+  async setCurrentBreakpoint(breakpoint) {
+    if (!this.isSheetModal) {
+      printIonWarning('setCurrentBreakpoint is only supported on sheet modals.');
+      return;
+    }
+    if (!this.breakpoints.includes(breakpoint)) {
+      printIonWarning(`Attempted to set invalid breakpoint value ${breakpoint}. Please double check that the breakpoint value is part of your defined breakpoints.`);
+      return;
+    }
+    const { currentBreakpoint, moveSheetToBreakpoint, canDismiss, breakpoints } = this;
+    if (currentBreakpoint === breakpoint) {
+      return;
+    }
+    if (moveSheetToBreakpoint) {
+      this.sheetTransition = moveSheetToBreakpoint({
+        breakpoint,
+        breakpointOffset: 1 - currentBreakpoint,
+        canDismiss: canDismiss !== undefined && canDismiss !== true && breakpoints[0] === 0,
+      });
+      await this.sheetTransition;
+      this.sheetTransition = undefined;
+    }
+  }
+  /**
+   * Returns the current breakpoint of a sheet style modal
+   */
+  async getCurrentBreakpoint() {
+    return this.currentBreakpoint;
+  }
+  async moveToNextBreakpoint() {
+    const { breakpoints, currentBreakpoint } = this;
+    if (!breakpoints || currentBreakpoint == null) {
+      /**
+       * If the modal does not have breakpoints and/or the current
+       * breakpoint is not set, we can't move to the next breakpoint.
+       */
+      return false;
+    }
+    const allowedBreakpoints = breakpoints.filter((b) => b !== 0);
+    const currentBreakpointIndex = allowedBreakpoints.indexOf(currentBreakpoint);
+    const nextBreakpointIndex = (currentBreakpointIndex + 1) % allowedBreakpoints.length;
+    const nextBreakpoint = allowedBreakpoints[nextBreakpointIndex];
+    /**
+     * Sets the current breakpoint to the next available breakpoint.
+     * If the current breakpoint is the last breakpoint, we set the current
+     * breakpoint to the first non-zero breakpoint to avoid dismissing the sheet.
+     */
+    await this.setCurrentBreakpoint(nextBreakpoint);
+    return true;
+  }
   render() {
-    const { htmlAttributes } = this;
+    const { handle, isSheetModal, presentingElement, htmlAttributes, handleBehavior, inheritedAttributes } = this;
+    const showHandle = handle !== false && isSheetModal;
     const mode = getIonMode(this);
-    return (h(Host, Object.assign({ "no-router": true, "aria-modal": "true", tabindex: "-1" }, htmlAttributes, { style: {
+    const { modalId } = this;
+    const isCardModal = presentingElement !== undefined && mode === 'ios';
+    const isHandleCycle = handleBehavior === 'cycle';
+    return (h(Host, Object.assign({ "no-router": true, tabindex: "-1" }, htmlAttributes, { style: {
         zIndex: `${20000 + this.overlayIndex}`,
-      }, class: Object.assign({ [mode]: true, [`modal-card`]: this.presentingElement !== undefined && mode === 'ios' }, getClassMap(this.cssClass)), onIonBackdropTap: this.onBackdropTap, onIonDismiss: this.onDismiss, onIonModalDidPresent: this.onLifecycle, onIonModalWillPresent: this.onLifecycle, onIonModalWillDismiss: this.onLifecycle, onIonModalDidDismiss: this.onLifecycle }), h("ion-backdrop", { visible: this.showBackdrop, tappable: this.backdropDismiss }), mode === 'ios' && h("div", { class: "modal-shadow" }), h("div", { tabindex: "0" }), h("div", { role: "dialog", class: "modal-wrapper ion-overlay-wrapper" }), h("div", { tabindex: "0" })));
+      }, class: Object.assign({ [mode]: true, ['modal-default']: !isCardModal && !isSheetModal, [`modal-card`]: isCardModal, [`modal-sheet`]: isSheetModal, 'overlay-hidden': true }, getClassMap(this.cssClass)), id: modalId, onIonBackdropTap: this.onBackdropTap, onIonModalDidPresent: this.onLifecycle, onIonModalWillPresent: this.onLifecycle, onIonModalWillDismiss: this.onLifecycle, onIonModalDidDismiss: this.onLifecycle }), h("ion-backdrop", { ref: (el) => (this.backdropEl = el), visible: this.showBackdrop, tappable: this.backdropDismiss, part: "backdrop" }), mode === 'ios' && h("div", { class: "modal-shadow" }), h("div", Object.assign({
+      /*
+        role and aria-modal must be used on the
+        same element. They must also be set inside the
+        shadow DOM otherwise ion-button will not be highlighted
+        when using VoiceOver: https://bugs.webkit.org/show_bug.cgi?id=247134
+      */
+      role: "dialog"
+    }, inheritedAttributes, { "aria-modal": "true", class: "modal-wrapper ion-overlay-wrapper", part: "content", ref: (el) => (this.wrapperEl = el) }), showHandle && (h("button", { 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" })), h("slot", null))));
   }
   get el() { return getElement(this); }
   static get watchers() { return {
+    "isOpen": ["onIsOpenChange"],
+    "trigger": ["onTriggerChange"],
     "swipeToClose": ["swipeToCloseChanged"]
   }; }
 };
 const LIFECYCLE_MAP = {
-  'ionModalDidPresent': 'ionViewDidEnter',
-  'ionModalWillPresent': 'ionViewWillEnter',
-  'ionModalWillDismiss': 'ionViewWillLeave',
-  'ionModalDidDismiss': 'ionViewDidLeave',
+  ionModalDidPresent: 'ionViewDidEnter',
+  ionModalWillPresent: 'ionViewWillEnter',
+  ionModalWillDismiss: 'ionViewWillLeave',
+  ionModalDidDismiss: 'ionViewDidLeave',
 };
+let modalIds = 0;
 Modal.style = {
   ios: modalIosCss,
   md: modalMdCss