@ionic/core 7.4.2-dev.11695927273.1323de22 → 7.4.2-dev.11695944163.13e7414e

package/dist/collection/components/toast/animations/ios.leave.js

@@ -11,22 +11,18 @@ export const iosLeaveAnimation = (baseEl, position) => {
   const wrapperAnimation = createAnimation();
   const root = getElementRoot(baseEl);
   const wrapperEl = root.querySelector('.toast-wrapper');
+  const bottom = `calc(-10px - var(--ion-safe-area-bottom, 0px))`;
+  const top = `calc(10px + var(--ion-safe-area-top, 0px))`;
   wrapperAnimation.addElement(wrapperEl);
-  /**
-   * For top/bottom positions, we use to() instead of fromTo() so that if
-   * the positionAnchor prop was used, we don't need to recalculate the
-   * toast and/or anchor's position and duplicate work from the enter
-   * animation.
-   */
   switch (position) {
     case 'top':
-      wrapperAnimation.to('transform', 'translateY(-100%)');
+      wrapperAnimation.fromTo('transform', `translateY(${top})`, 'translateY(-100%)');
       break;
     case 'middle':
       wrapperAnimation.fromTo('opacity', 0.99, 0);
       break;
     default:
-      wrapperAnimation.to('transform', 'translateY(100%)');
+      wrapperAnimation.fromTo('transform', `translateY(${bottom})`, 'translateY(100%)');
       break;
   }
   return baseAnimation.easing('cubic-bezier(.36,.66,.04,1)').duration(300).addAnimation(wrapperAnimation);

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

@@ -2,55 +2,17 @@
  * (C) Ionic http://ionicframework.com - MIT License
  */
 import { createAnimation } from "../../../utils/animation/animation";
-import { win } from "../../../utils/browser/index";
 import { getElementRoot } from "../../../utils/helpers";
 /**
  * MD Toast Enter Animation
  */
-export const mdEnterAnimation = (baseEl, opts) => {
+export const mdEnterAnimation = (baseEl, position) => {
   const baseAnimation = createAnimation();
   const wrapperAnimation = createAnimation();
-  const { position, positionAnchor } = opts;
   const root = getElementRoot(baseEl);
   const wrapperEl = root.querySelector('.toast-wrapper');
-  /**
-   * Start with a predefined offset from the edge the toast will be
-   * positioned relative to. By default, this will be the top edge
-   * of the screen for position="top", or the bottom edge for
-   * position="bottom".
-   */
-  let offset = 8;
-  let top, bottom;
-  /**
-   * If positionAnchor is defined, add in the distance from the target
-   * screen edge to the target anchor edge. For position="top", the
-   * bottom anchor edge is targeted. For position="bottom", the top
-   * anchor edge is targeted.
-   */
-  if (positionAnchor && win) {
-    const box = positionAnchor.getBoundingClientRect();
-    if (position === 'top') {
-      offset += box.bottom;
-    }
-    else if (position === 'bottom') {
-      /**
-       * Just box.top is the distance from the top edge of the screen
-       * to the top edge of the anchor. We want to calculate from the
-       * bottom edge of the screen instead.
-       */
-      offset += win.innerHeight - box.top;
-    }
-    /**
-     * We don't include safe area here because that should already be
-     * accounted for when checking the position of the anchor.
-     */
-    top = `${offset}px`;
-    bottom = `${offset}px`;
-  }
-  else {
-    top = `calc(${offset}px + var(--ion-safe-area-top, 0px))`;
-    bottom = `calc(${offset}px + var(--ion-safe-area-bottom, 0px))`;
-  }
+  const bottom = `calc(8px + var(--ion-safe-area-bottom, 0px))`;
+  const top = `calc(8px + var(--ion-safe-area-top, 0px))`;
   wrapperAnimation.addElement(wrapperEl);
   switch (position) {
     case 'top':

package/dist/collection/components/toast/test/a11y/toast.e2e.js

@@ -7,7 +7,7 @@ import { configs, test } from "../../../../utils/test/playwright/index";
 /**
  * This test does not check LTR vs RTL layouts
  */
-configs({ directions: ['ltr'] }).forEach(({ title, config }) => {
+configs({ directions: ['ltr'] }).forEach(({ title, screenshot, config }) => {
   test.describe(title('toast: a11y'), () => {
     test.beforeEach(async ({ page }) => {
       await page.goto(`/src/components/toast/test/a11y`, config);
@@ -45,4 +45,101 @@ configs({ directions: ['ltr'] }).forEach(({ title, config }) => {
       await expect(toastButton).toHaveAttribute('aria-label', 'close button');
     });
   });
+  test.describe(title('toast: font scaling'), () => {
+    test('should scale header text on larger font sizes', async ({ page }) => {
+      await page.setContent(`
+        <style>
+          html {
+            font-size: 310%;
+          }
+        </style>
+
+        <ion-toast is-open="true" header="Testing" message="Hello world"></ion-toast>
+      `, config);
+      const toast = page.locator('ion-toast');
+      await expect(toast).toBeVisible();
+      const toastWrapper = toast.locator('.toast-wrapper');
+      await expect(toastWrapper).toHaveScreenshot(screenshot('toast-header-scale'));
+    });
+    test('should scale message text on larger font sizes', async ({ page }) => {
+      await page.setContent(`
+        <style>
+          html {
+            font-size: 310%;
+          }
+        </style>
+
+        <ion-toast is-open="true" message="Hello world"></ion-toast>
+      `, config);
+      const toast = page.locator('ion-toast');
+      await expect(toast).toBeVisible();
+      const toastWrapper = toast.locator('.toast-wrapper');
+      await expect(toastWrapper).toHaveScreenshot(screenshot('toast-message-scale'));
+    });
+    test('should scale content icon on larger font sizes', async ({ page }) => {
+      await page.setContent(`
+        <style>
+          html {
+            font-size: 310%;
+          }
+        </style>
+
+        <ion-toast is-open="true" message="Hello world" icon="alert"></ion-toast>
+      `, config);
+      const toast = page.locator('ion-toast');
+      await expect(toast).toBeVisible();
+      const toastWrapper = toast.locator('.toast-wrapper');
+      await expect(toastWrapper).toHaveScreenshot(screenshot('toast-icon-scale'));
+    });
+    test('should scale button text on larger font sizes', async ({ page }) => {
+      await page.setContent(`
+        <style>
+          html {
+            font-size: 310%;
+          }
+        </style>
+
+        <ion-toast is-open="true" message="Hello world"></ion-toast>
+      `, config);
+      const toast = page.locator('ion-toast');
+      toast.evaluate((el) => {
+        el.buttons = [
+          {
+            text: 'Cancel',
+          },
+        ];
+      });
+      await expect(toast).toBeVisible();
+      const toastWrapper = toast.locator('.toast-wrapper');
+      await expect(toastWrapper).toHaveScreenshot(screenshot('toast-buttons-scale'));
+    });
+    test('should scale buttons and icons on larger font sizes', async ({ page }) => {
+      await page.setContent(`
+        <style>
+          html {
+            font-size: 310%;
+          }
+        </style>
+
+        <ion-toast is-open="true" message="Hello world"></ion-toast>
+      `, config);
+      const toast = page.locator('ion-toast');
+      toast.evaluate((el) => {
+        el.buttons = [
+          {
+            text: 'Cancel',
+            icon: 'close',
+          },
+        ];
+      });
+      await expect(toast).toBeVisible();
+      /**
+       * Linux incorrectly clips the screenshot when capturing the toast container
+       * with the inset styling.
+       *
+       * We capture the entire toast container (entire page) to avoid this issue.
+       */
+      await expect(toast).toHaveScreenshot(screenshot('toast-buttons-icon-scale'));
+    });
+  });
 });

package/dist/collection/components/toast/toast.ios.css

@@ -1,3 +1,36 @@
+/**
+ * Convert a font size to a dynamic font size.
+ * Fonts that participate in Dynamic Type should use
+ * dynamic font sizes.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param unit (optional) - The unit to convert to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * a maximum font size.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * a minimum font size.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * maximum and minimum font sizes.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
+ * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
 :host {
   /**
    * @prop --background: Background of the toast
@@ -160,6 +193,10 @@
   margin-inline-start: 16px;
 }
 
+.toast-content {
+  min-width: 0;
+}
+
 .toast-message {
   flex: 1;
   white-space: var(--white-space);
@@ -196,15 +233,49 @@
     cursor: pointer;
   }
 }
+/**
+ * Convert a font size to a dynamic font size.
+ * Fonts that participate in Dynamic Type should use
+ * dynamic font sizes.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param unit (optional) - The unit to convert to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * a maximum font size.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * a minimum font size.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * maximum and minimum font sizes.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
+ * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
 :host {
   --background: var(--ion-color-step-50, #f2f2f2);
   --border-radius: 14px;
   --button-color: var(--ion-color-primary, #3880ff);
   --color: var(--ion-color-step-850, #262626);
   --max-width: 700px;
+  --max-height: 478px;
   --start: 10px;
   --end: 10px;
-  font-size: 14px;
+  font-size: clamp(14px, 0.875rem, 43.4px);
 }
 
 .toast-wrapper {
@@ -263,12 +334,12 @@
   padding-inline-end: 15px;
   padding-top: 10px;
   padding-bottom: 10px;
-  height: 44px;
+  min-height: 44px;
   transition: background-color, opacity 100ms linear;
   border: 0;
   background-color: transparent;
   font-family: var(--ion-font-family);
-  font-size: 17px;
+  font-size: clamp(17px, 1.0625rem, 21.998px);
   font-weight: 500;
   overflow: hidden;
 }

package/dist/collection/components/toast/toast.js

@@ -54,7 +54,6 @@ export class Toast {
     this.message = undefined;
     this.keyboardClose = false;
     this.position = 'bottom';
-    this.positionAnchor = undefined;
     this.buttons = undefined;
     this.translucent = false;
     this.animated = true;
@@ -102,33 +101,7 @@ export class Toast {
   async present() {
     const unlock = await this.lockController.lock();
     await this.delegateController.attachViewToDom();
-    const { position, positionAnchor } = this;
-    let anchor;
-    if (position === 'middle' && positionAnchor !== undefined) {
-      printIonWarning('The positionAnchor property is ignored when using position="middle".', this.el);
-    }
-    else if (typeof positionAnchor === 'string') {
-      /**
-       * If the anchor is defined as an ID, find the element.
-       * We do this on every present so the toast doesn't need
-       * to account for the surrounding DOM changing since the
-       * last time it was presented.
-       */
-      const foundEl = document.getElementById(positionAnchor);
-      if (foundEl === null) {
-        printIonWarning(`An anchor element with an ID of ${positionAnchor} was not found in the DOM.`, this.el);
-      }
-      else {
-        anchor = foundEl;
-      }
-    }
-    else {
-      anchor = positionAnchor;
-    }
-    await present(this, 'toastEnter', iosEnterAnimation, mdEnterAnimation, {
-      position,
-      positionAnchor: anchor,
-    });
+    await present(this, 'toastEnter', iosEnterAnimation, mdEnterAnimation, this.position);
     /**
      * Content is revealed to screen readers after
      * the transition to avoid jank since this
@@ -544,34 +517,12 @@ export class Toast {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The starting position of the toast on the screen. Can be tweaked further\nusing the `positionAnchor` property."
+          "text": "The position of the toast on the screen."
         },
         "attribute": "position",
         "reflect": false,
         "defaultValue": "'bottom'"
       },
-      "positionAnchor": {
-        "type": "string",
-        "mutable": false,
-        "complexType": {
-          "original": "HTMLElement | string",
-          "resolved": "HTMLElement | string | undefined",
-          "references": {
-            "HTMLElement": {
-              "location": "global",
-              "id": "global::HTMLElement"
-            }
-          }
-        },
-        "required": false,
-        "optional": true,
-        "docs": {
-          "tags": [],
-          "text": "The element to anchor the toast's position to. Can be set as a direct reference\nor the ID of the element. With `position=\"bottom\"`, the toast will sit above the\nchosen element. With `position=\"top\"`, the toast will sit below the chosen element.\nWith `position=\"middle\"`, the value of `positionAnchor` is ignored."
-        },
-        "attribute": "position-anchor",
-        "reflect": false
-      },
       "buttons": {
         "type": "unknown",
         "mutable": false,
@@ -861,14 +812,9 @@ export class Toast {
               "location": "global",
               "id": "global::Promise"
             },
-            "HTMLElement": {
-              "location": "global",
-              "id": "global::HTMLElement"
-            },
             "ToastPresentOptions": {
-              "location": "import",
-              "path": "./toast-interface",
-              "id": "src/components/toast/toast-interface.ts::ToastPresentOptions"
+              "location": "global",
+              "id": "global::ToastPresentOptions"
             }
           },
           "return": "Promise<void>"
@@ -900,9 +846,8 @@ export class Toast {
               "id": "global::Promise"
             },
             "ToastDismissOptions": {
-              "location": "import",
-              "path": "./toast-interface",
-              "id": "src/components/toast/toast-interface.ts::ToastDismissOptions"
+              "location": "global",
+              "id": "global::ToastDismissOptions"
             }
           },
           "return": "Promise<boolean>"

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

@@ -1,3 +1,36 @@
+/**
+ * Convert a font size to a dynamic font size.
+ * Fonts that participate in Dynamic Type should use
+ * dynamic font sizes.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param unit (optional) - The unit to convert to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * a maximum font size.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * a minimum font size.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * maximum and minimum font sizes.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
+ * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
 :host {
   /**
    * @prop --background: Background of the toast
@@ -160,6 +193,10 @@
   margin-inline-start: 16px;
 }
 
+.toast-content {
+  min-width: 0;
+}
+
 .toast-message {
   flex: 1;
   white-space: var(--white-space);
@@ -196,6 +233,39 @@
     cursor: pointer;
   }
 }
+/**
+ * Convert a font size to a dynamic font size.
+ * Fonts that participate in Dynamic Type should use
+ * dynamic font sizes.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param unit (optional) - The unit to convert to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * a maximum font size.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * a minimum font size.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * maximum and minimum font sizes.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
+ * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
 :host {
   --background: var(--ion-color-step-800, #333333);
   --border-radius: 4px;
@@ -205,7 +275,7 @@
   --max-width: 700px;
   --start: 8px;
   --end: 8px;
-  font-size: 14px;
+  font-size: 0.875rem;
 }
 
 .toast-wrapper {
@@ -233,11 +303,11 @@
 .toast-header {
   margin-bottom: 2px;
   font-weight: 500;
-  line-height: 20px;
+  line-height: 1.25rem;
 }
 
 .toast-message {
-  line-height: 20px;
+  line-height: 1.25rem;
 }
 
 .toast-layout-baseline .toast-button-group-start {
@@ -272,7 +342,7 @@
   position: relative;
   background-color: transparent;
   font-family: var(--ion-font-family);
-  font-size: 14px;
+  font-size: 0.875rem;
   font-weight: 500;
   letter-spacing: 0.84px;
   text-transform: uppercase;

package/dist/collection/components/toggle/toggle.ios.css

@@ -1,3 +1,36 @@
+/**
+ * Convert a font size to a dynamic font size.
+ * Fonts that participate in Dynamic Type should use
+ * dynamic font sizes.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param unit (optional) - The unit to convert to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * a maximum font size.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * a minimum font size.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * maximum and minimum font sizes.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
+ * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
 :host {
   /**
    * @prop --track-background: Background of the toggle track
@@ -371,6 +404,72 @@ input {
   transform: translate3d(calc(var(--handle-spacing) * 2), 0, 0);
 }
 
+/**
+ * Convert a font size to a dynamic font size.
+ * Fonts that participate in Dynamic Type should use
+ * dynamic font sizes.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param unit (optional) - The unit to convert to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * a maximum font size.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * a minimum font size.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * maximum and minimum font sizes.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
+ * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size.
+ * Fonts that participate in Dynamic Type should use
+ * dynamic font sizes.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param unit (optional) - The unit to convert to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * a maximum font size.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * a minimum font size.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
+/**
+ * Convert a font size to a dynamic font size but impose
+ * maximum and minimum font sizes.
+ * @param size - The initial font size including the unit (i.e. px or pt)
+ * @param minScale - The minimum scale of the font (i.e. 0.8 for a minimum 80% scale).
+ * @param maxScale - The maximum scale of the font (i.e. 2.5 for a maximum 250% scale).
+ * @param unit (optional) - The unit to convert the initial font size to. Use this if you want to
+ * convert to a unit other than $baselineUnit.
+ */
 :host {
   --track-background: rgba(var(--ion-text-color-rgb, 0, 0, 0), 0.088);
   --track-background-checked: var(--ion-color-primary, #3880ff);