@ionic/core 8.8.9-dev.11780414486.1df2bd72 → 8.8.9-dev.11780493937.17fe092d

package/dist/collection/components/input-otp/input-otp.js

@@ -2,11 +2,22 @@
  * (C) Ionic http://ionicframework.com - MIT License
  */
 import { Fragment, Host, h } from "@stencil/core";
+import { reportValidityToElementInternals } from "../../utils/forms/index";
 import { inheritAriaAttributes } from "../../utils/helpers";
 import { printIonWarning } from "../../utils/logging/index";
 import { isRTL } from "../../utils/rtl/index";
 import { createColorClasses } from "../../utils/theme";
 import { getIonMode } from "../../global/ionic-global";
+/**
+ * @virtualProp {"ios" | "md"} mode - The mode determines the platform behaviors of the component.
+ * @virtualProp {"ios" | "md" | "ionic"} theme - The theme determines the visual appearance of the component.
+ *
+ * @part group - The container element that wraps all input boxes.
+ * @part container - The wrapper element for each individual input box.
+ * @part native - The native input element.
+ * @part separator - The separator element displayed between input boxes.
+ * @part description - The container element for the description text.
+ */
 export class InputOTP {
     constructor() {
         this.inheritedAttributes = {};
@@ -362,6 +373,12 @@ export class InputOTP {
             (_b = inputRefs[nextEmptyIndex]) === null || _b === void 0 ? void 0 : _b.focus();
         };
     }
+    /**
+     * Update element internals when disabled prop changes
+     */
+    disabledChanged() {
+        this.updateElementInternals();
+    }
     /**
      * Sets focus to an input box.
      * @param index - The index of the input box to focus (0-based).
@@ -382,6 +399,7 @@ export class InputOTP {
     valueChanged() {
         this.initializeValues();
         this.updateTabIndexes();
+        this.updateElementInternals();
     }
     /**
      * Processes the separators prop into an array of numbers.
@@ -438,6 +456,7 @@ export class InputOTP {
     }
     componentDidLoad() {
         this.updateTabIndexes();
+        this.updateElementInternals();
     }
     /**
      * Get the regex pattern for allowed characters.
@@ -514,6 +533,47 @@ export class InputOTP {
             this.ionComplete.emit({ value: newValue });
         }
     }
+    /**
+     * Gets the value of the input group as a string for form submission.
+     * Returns an empty string if the value is null or undefined.
+     */
+    getValue() {
+        return this.value != null ? this.value.toString() : '';
+    }
+    /**
+     * Called when the form state is restored.
+     * Restores the component's value.
+     */
+    formStateRestoreCallback(value) {
+        this.value = value;
+    }
+    /**
+     * Called when the form is reset.
+     * Resets the component's value.
+     */
+    formResetCallback() {
+        this.value = '';
+    }
+    /**
+     * Updates the form value and reports validity state to the browser via
+     * ElementInternals. This should be called when the component loads, when
+     * the disabled prop changes, and when the value changes to ensure the form
+     * value stays in sync and validation state is updated.
+     */
+    updateElementInternals() {
+        var _a;
+        // Disabled form controls should not be included in form data
+        // Pass null to setFormValue when disabled to exclude it from form submission
+        const value = this.disabled ? null : this.getValue();
+        // ElementInternals may not be fully available in test environments
+        // so we need to check if the method exists before calling it
+        if (typeof this.internals.setFormValue === 'function') {
+            this.internals.setFormValue(value);
+        }
+        // Use the first input element for validity reporting since all inputs
+        // share the same validation state
+        reportValidityToElementInternals((_a = this.inputRefs[0]) !== null && _a !== void 0 ? _a : null, this.internals);
+    }
     /**
      * Emits an `ionChange` event.
      * This API should be called for user committed changes.
@@ -620,7 +680,7 @@ export class InputOTP {
         const tabbableIndex = this.getTabbableIndex();
         const pattern = this.getPattern();
         const hasDescription = ((_b = (_a = el.querySelector('.input-otp-description')) === null || _a === void 0 ? void 0 : _a.textContent) === null || _b === void 0 ? void 0 : _b.trim()) !== '';
-        return (h(Host, { key: '5c1386ae6b8038ec33ca94fd818c9353b1b37f75', class: createColorClasses(color, {
+        return (h(Host, { key: '7a5c5dbb7e1880bd94d4b00e579af941366b1cb2', class: createColorClasses(color, {
                 [mode]: true,
                 'has-focus': hasFocus,
                 [`input-otp-size-${size}`]: true,
@@ -628,23 +688,26 @@ export class InputOTP {
                 [`input-otp-fill-${fill}`]: true,
                 'input-otp-disabled': disabled,
                 'input-otp-readonly': readonly,
-            }) }, h("div", Object.assign({ key: '9a19129688e55095f8386826c73ef3f9744becff', role: "group", "aria-label": "One-time password input", class: "input-otp-group" }, inheritedAttributes), Array.from({ length }).map((_, index) => (h(Fragment, null, h("div", { class: "native-wrapper" }, h("input", { class: "native-input", id: `${inputId}-${index}`, "aria-label": `Input ${index + 1} of ${length}`, type: "text", autoCapitalize: autocapitalize, inputmode: inputmode, pattern: pattern, disabled: disabled, readOnly: readonly, tabIndex: index === tabbableIndex ? 0 : -1, value: inputValues[index] || '', autocomplete: "one-time-code", ref: (el) => (inputRefs[index] = el), onInput: this.onInput(index), onBlur: this.onBlur, onFocus: this.onFocus(index), onKeyDown: this.onKeyDown(index), onPaste: this.onPaste })), this.showSeparator(index) && h("div", { class: "input-otp-separator" }))))), h("div", { key: '7853819c3610c4691191f1836b947bf4ec17939d', class: {
+            }) }, h("div", Object.assign({ key: 'a4427602ea1894d53e4d0f502dbb972c93a86bff', role: "group", "aria-label": "One-time password input", class: "input-otp-group", part: "group" }, inheritedAttributes), Array.from({ length }).map((_, index) => (h(Fragment, null, h("div", { class: "native-wrapper", part: "container" }, h("input", { class: "native-input", part: "native", id: `${inputId}-${index}`, "aria-label": `Input ${index + 1} of ${length}`, type: "text", autoCapitalize: autocapitalize, inputmode: inputmode, pattern: pattern, disabled: disabled, readOnly: readonly, tabIndex: index === tabbableIndex ? 0 : -1, value: inputValues[index] || '', autocomplete: "one-time-code", ref: (el) => (inputRefs[index] = el), onInput: this.onInput(index), onBlur: this.onBlur, onFocus: this.onFocus(index), onKeyDown: this.onKeyDown(index), onPaste: this.onPaste })), this.showSeparator(index) && h("div", { class: "input-otp-separator", part: "separator" }))))), h("div", { key: '7ee9d8dfd2e52875f1bfe3e3dea0494c18c12f4a', class: {
                 'input-otp-description': true,
                 'input-otp-description-hidden': !hasDescription,
-            } }, h("slot", { key: 'f4674d47d3d3991f21a0a79321ebc323968071dc' }))));
+            }, part: "description" }, h("slot", { key: '163c374e7ae5dbdb1dc12483161e5aca919a50d5' }))));
     }
     static get is() { return "ion-input-otp"; }
-    static get encapsulation() { return "scoped"; }
+    static get encapsulation() { return "shadow"; }
+    static get formAssociated() { return true; }
     static get originalStyleUrls() {
         return {
             "ios": ["input-otp.ios.scss"],
-            "md": ["input-otp.md.scss"]
+            "md": ["input-otp.md.scss"],
+            "ionic": ["input-otp.ionic.scss"]
         };
     }
     static get styleUrls() {
         return {
             "ios": ["input-otp.ios.css"],
-            "md": ["input-otp.md.css"]
+            "md": ["input-otp.md.css"],
+            "ionic": ["input-otp.ionic.css"]
         };
     }
     static get properties() {
@@ -1061,6 +1124,9 @@ export class InputOTP {
     static get elementRef() { return "el"; }
     static get watchers() {
         return [{
+                "propName": "disabled",
+                "methodName": "disabledChanged"
+            }, {
                 "propName": "value",
                 "methodName": "valueChanged"
             }, {
@@ -1071,5 +1137,6 @@ export class InputOTP {
                 "methodName": "processSeparators"
             }];
     }
+    static get attachInternalsMemberName() { return "internals"; }
 }
 let inputIds = 0;

package/dist/collection/components/input-otp/input-otp.md.css

@@ -1,3 +1,9 @@
+/**
+ * Convert a pixels given value into rem
+ * 
+ * @param pixels - Value in pixels to be converted (i.e. px)
+ * @param context (optional) - Baseline value
+ */
 /**
  * Convert a font size to a dynamic font size.
  * Fonts that participate in Dynamic Type should use
@@ -53,6 +59,28 @@
  *   }
  * }
  */
+/**
+ * A heuristic that applies CSS to tablet
+ * viewports.
+ *
+ * Usage:
+ * @include tablet-viewport() {
+ *   :host {
+ *     background-color: green;
+ *   }
+ * }
+ */
+/**
+ * A heuristic that applies CSS to mobile
+ * viewports (i.e. phones, not tablets).
+ *
+ * Usage:
+ * @include mobile-viewport() {
+ *   :host {
+ *     background-color: blue;
+ *   }
+ * }
+ */
 :host {
   /**
    * @prop --background: Background color of the input boxes
@@ -60,6 +88,7 @@
    * @prop --border-radius: Border radius of the input boxes
    *
    * @prop --border-width: Border width of the input boxes
+   * @prop --border-style: Border style of the input boxes
    * @prop --border-color: Border color of the input boxes
    *
    * @prop --color: Text color of the input
@@ -91,19 +120,7 @@
   --margin-end: 0;
   --margin-bottom: 0;
   --margin-start: 0;
-  --padding-top: 16px;
-  --padding-end: 0;
-  --padding-bottom: 16px;
-  --padding-start: 0;
-  --color: initial;
-  --min-width: 40px;
-  --separator-width: 8px;
   --separator-height: var(--separator-width);
-  --separator-border-radius: 999px;
-  --separator-color: var(--ion-color-step-150, var(--ion-background-color-step-150, #d9d9d9));
-  --highlight-color-focused: var(--ion-color-primary, #0054e9);
-  --highlight-color-valid: var(--ion-color-success, #2dd55b);
-  --highlight-color-invalid: var(--ion-color-danger, #c5000f);
   /**
    * This is a private API that is used to switch
    * out the highlight color based on the state
@@ -113,7 +130,6 @@
   --highlight-color: var(--highlight-color-focused);
   display: block;
   position: relative;
-  font-size: 0.875rem;
 }
 
 .input-otp-group {
@@ -147,13 +163,15 @@
   min-width: inherit;
   height: var(--height);
   border-width: var(--border-width);
-  border-style: solid;
+  border-style: var(--border-style);
   border-color: var(--border-color);
   background: var(--background);
   color: var(--color);
+  font-family: inherit;
   font-size: inherit;
   text-align: center;
   appearance: none;
+  box-sizing: border-box;
 }
 
 :host(.has-focus) .native-input {
@@ -161,9 +179,6 @@
 }
 
 .input-otp-description {
-  color: var(--ion-color-step-700, var(--ion-text-color-step-300, #4d4d4d));
-  font-size: 0.75rem;
-  line-height: 1.25rem;
   text-align: center;
 }
 
@@ -179,6 +194,73 @@
   background: var(--separator-color);
 }
 
+:host(.input-otp-disabled),
+:host(.input-otp-disabled) .native-input:disabled {
+  cursor: not-allowed;
+}
+
+:host(.has-focus) .native-input:focus {
+  --border-color: var(--highlight-color);
+  outline: none;
+}
+
+:host(.ion-touched.ion-invalid) {
+  --highlight-color: var(--highlight-color-invalid);
+}
+
+/**
+ * The component highlight is only shown
+ * on focus, so we can safely set the valid
+ * color state when valid. If we
+ * set it when .has-focus is present then
+ * the highlight color would change
+ * from the valid color to the component's
+ * color during the transition after the
+ * component loses focus.
+ */
+:host(.ion-valid) {
+  --highlight-color: var(--highlight-color-valid);
+}
+
+/**
+ * If the input has a validity state, the
+ * border should reflect that as a color.
+ * The invalid state should show if the input is
+ * invalid and has already been touched.
+ * The valid state should show if the input
+ * is valid, has already been touched, and
+ * is currently focused. Do not show the valid
+ * highlight when the input is blurred.
+ */
+:host(.has-focus.ion-valid),
+:host(.ion-touched.ion-invalid) {
+  --border-color: var(--highlight-color);
+}
+
+:host {
+  --padding-top: 16px;
+  --padding-end: 0;
+  --padding-bottom: 16px;
+  --padding-start: 0;
+  --color: initial;
+  --min-width: 40px;
+  --border-style: solid;
+  --separator-width: 8px;
+  --separator-border-radius: 999px;
+  --separator-color: var(--ion-color-step-150, var(--ion-background-color-step-150, #d9d9d9));
+  --highlight-color-focused: var(--ion-color-primary, #0054e9);
+  --highlight-color-valid: var(--ion-color-success, #2dd55b);
+  --highlight-color-invalid: var(--ion-color-danger, #c5000f);
+  font-family: var(--ion-font-family, inherit);
+  font-size: 0.875rem;
+}
+
+.input-otp-description {
+  color: var(--ion-color-step-700, var(--ion-text-color-step-300, #4d4d4d));
+  font-size: 0.75rem;
+  line-height: 1.25rem;
+}
+
 :host(.input-otp-size-small) {
   --width: 40px;
   --height: 40px;
@@ -233,16 +315,6 @@
   --border-color: var(--ion-color-step-100, var(--ion-background-color-step-100, #e6e6e6));
 }
 
-:host(.input-otp-disabled),
-:host(.input-otp-disabled) .native-input:disabled {
-  cursor: not-allowed;
-}
-
-:host(.has-focus) .native-input:focus {
-  --border-color: var(--highlight-color);
-  outline: none;
-}
-
 :host(.input-otp-fill-outline.input-otp-readonly) {
   --background: var(--ion-color-step-50, var(--ion-background-color-step-50, #f2f2f2));
 }
@@ -253,39 +325,6 @@
   --background: var(--ion-color-step-100, var(--ion-background-color-step-100, #e6e6e6));
 }
 
-:host(.ion-touched.ion-invalid) {
-  --highlight-color: var(--highlight-color-invalid);
-}
-
-/**
- * The component highlight is only shown
- * on focus, so we can safely set the valid
- * color state when valid. If we
- * set it when .has-focus is present then
- * the highlight color would change
- * from the valid color to the component's
- * color during the transition after the
- * component loses focus.
- */
-:host(.ion-valid) {
-  --highlight-color: var(--highlight-color-valid);
-}
-
-/**
- * If the input has a validity state, the
- * border should reflect that as a color.
- * The invalid state should show if the input is
- * invalid and has already been touched.
- * The valid state should show if the input
- * is valid, has already been touched, and
- * is currently focused. Do not show the valid
- * highlight when the input is blurred.
- */
-:host(.has-focus.ion-valid),
-:host(.ion-touched.ion-invalid) {
-  --border-color: var(--highlight-color);
-}
-
 :host(.ion-color) {
   --highlight-color-focused: var(--ion-color-base);
 }
@@ -313,6 +352,12 @@
   border-color: rgba(var(--ion-color-base-rgb), 0.3);
 }
 
+/**
+ * Convert a pixels given value into rem
+ * 
+ * @param pixels - Value in pixels to be converted (i.e. px)
+ * @param context (optional) - Baseline value
+ */
 /**
  * Convert a font size to a dynamic font size.
  * Fonts that participate in Dynamic Type should use

package/dist/collection/components/input-password-toggle/input-password-toggle.ionic.css

@@ -0,0 +1,78 @@
+/**
+ * A heuristic that applies CSS to tablet
+ * viewports.
+ *
+ * Usage:
+ * @include tablet-viewport() {
+ *   :host {
+ *     background-color: green;
+ *   }
+ * }
+ */
+/**
+ * A heuristic that applies CSS to mobile
+ * viewports (i.e. phones, not tablets).
+ *
+ * Usage:
+ * @include mobile-viewport() {
+ *   :host {
+ *     background-color: blue;
+ *   }
+ * }
+ */
+/**
+ * Convert a pixels given value into rem
+ * 
+ * @param pixels - Value in pixels to be converted (i.e. px)
+ * @param context (optional) - Baseline value
+ */
+/**
+ * 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 ion-button {
+  --color: var(--token-primitives-neutral-800, #626262);
+  --margin-end: calc(-1 * var(--padding-end));
+  --padding-end: inherit;
+  --icon-size: var(--token-font-size-400, 1rem);
+  -webkit-margin-start: 0;
+  margin-inline-start: 0;
+  -webkit-margin-end: var(--margin-end);
+  margin-inline-end: var(--margin-end);
+  margin-top: 0;
+  margin-bottom: 0;
+  width: var(--size);
+  height: var(--size);
+}
+:host ion-button ion-icon {
+  font-size: var(--icon-size);
+}

package/dist/collection/components/input-password-toggle/input-password-toggle.js

@@ -1,11 +1,14 @@
 /*!
  * (C) Ionic http://ionicframework.com - MIT License
  */
+import eyeSlashRegular from "@phosphor-icons/core/assets/regular/eye-slash.svg";
+import eyeRegular from "@phosphor-icons/core/assets/regular/eye.svg";
 import { Host, h } from "@stencil/core";
 import { printIonWarning } from "../../utils/logging/index";
 import { createColorClasses } from "../../utils/theme";
 import { eyeOff, eye } from "ionicons/icons";
-import { getIonMode } from "../../global/ionic-global";
+import { config } from "../../global/config";
+import { getIonMode, getIonTheme } from "../../global/ionic-global";
 /**
  * @virtualProp {"ios" | "md"} mode - The mode determines which platform styles to use.
  */
@@ -53,36 +56,69 @@ export class InputPasswordToggle {
     disconnectedCallback() {
         this.inputElRef = null;
     }
+    get inputPasswordHideIcon() {
+        // Return the icon if it is explicitly set
+        if (this.hideIcon != null) {
+            return this.hideIcon;
+        }
+        // Determine the theme and map to default icons
+        const theme = getIonTheme(this);
+        const defaultIcons = {
+            ios: eyeOff,
+            ionic: eyeSlashRegular,
+            md: eyeOff,
+        };
+        // Get the default icon based on the theme, falling back to 'md' icon if necessary
+        const defaultIcon = defaultIcons[theme] || defaultIcons.md;
+        // Return the configured input password hide icon or the default icon
+        return config.get('inputPasswordHideIcon', defaultIcon);
+    }
+    get inputPasswordShowIcon() {
+        // Return the icon if it is explicitly set
+        if (this.showIcon != null) {
+            return this.showIcon;
+        }
+        // Determine the theme and map to default icons
+        const theme = getIonTheme(this);
+        const defaultIcons = {
+            ios: eye,
+            ionic: eyeRegular,
+            md: eye,
+        };
+        // Get the default icon based on the theme, falling back to 'md' icon if necessary
+        const defaultIcon = defaultIcons[theme] || defaultIcons.md;
+        // Return the configured input password show icon or the default icon
+        return config.get('inputPasswordShowIcon', defaultIcon);
+    }
     render() {
-        var _a, _b;
-        const { color, type } = this;
+        const { color, inputPasswordHideIcon, inputPasswordShowIcon, type } = this;
         const mode = getIonMode(this);
-        const showPasswordIcon = (_a = this.showIcon) !== null && _a !== void 0 ? _a : eye;
-        const hidePasswordIcon = (_b = this.hideIcon) !== null && _b !== void 0 ? _b : eyeOff;
         const isPasswordVisible = type === 'text';
-        return (h(Host, { key: '91bc55664d496fe457518bd112865dd7811d0c17', class: createColorClasses(color, {
+        return (h(Host, { key: 'c7f0805958b284005806a0cb3ed0b5cba42cecd1', class: createColorClasses(color, {
                 [mode]: true,
-            }) }, h("ion-button", { key: '6344d6838f5cdcba54c6bf4b592f036092044de0', mode: mode, color: color, fill: "clear", shape: "round", "aria-label": isPasswordVisible ? 'Hide password' : 'Show password', "aria-pressed": isPasswordVisible ? 'true' : 'false', type: "button", onPointerDown: (ev) => {
+            }) }, h("ion-button", { key: 'dee2bdeb169d1fa4943c9a8b0164b8fbb4cdfe06', mode: mode, color: color, fill: "clear", shape: "round", "aria-label": isPasswordVisible ? 'Hide password' : 'Show password', "aria-pressed": isPasswordVisible ? 'true' : 'false', type: "button", onPointerDown: (ev) => {
                 /**
                  * This prevents mobile browsers from
                  * blurring the input when the password toggle
                  * button is activated.
                  */
                 ev.preventDefault();
-            }, onClick: this.togglePasswordVisibility }, h("ion-icon", { key: 'a2bd9197c2635bf8cb155ff25ce022e7d7dc6d00', slot: "icon-only", "aria-hidden": "true", icon: isPasswordVisible ? hidePasswordIcon : showPasswordIcon }))));
+            }, onClick: this.togglePasswordVisibility }, h("ion-icon", { key: 'be752db7186a7cd6fc033c7002fcb1683d93c162', slot: "icon-only", "aria-hidden": "true", icon: isPasswordVisible ? inputPasswordHideIcon : inputPasswordShowIcon }))));
     }
     static get is() { return "ion-input-password-toggle"; }
     static get encapsulation() { return "shadow"; }
     static get originalStyleUrls() {
         return {
-            "ios": ["input-password-toggle.scss"],
-            "md": ["input-password-toggle.scss"]
+            "ios": ["input-password-toggle.native.scss"],
+            "md": ["input-password-toggle.native.scss"],
+            "ionic": ["input-password-toggle.ionic.scss"]
         };
     }
     static get styleUrls() {
         return {
-            "ios": ["input-password-toggle.css"],
-            "md": ["input-password-toggle.css"]
+            "ios": ["input-password-toggle.native.css"],
+            "md": ["input-password-toggle.native.css"],
+            "ionic": ["input-password-toggle.ionic.css"]
         };
     }
     static get properties() {

package/dist/collection/components/input-password-toggle/input-password-toggle.native.css

@@ -0,0 +1,61 @@
+/**
+ * Convert a pixels given value into rem
+ * 
+ * @param pixels - Value in pixels to be converted (i.e. px)
+ * @param context (optional) - Baseline value
+ */
+/**
+ * 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.
+ */
+/**
+ * A heuristic that applies CSS to tablet
+ * viewports.
+ *
+ * Usage:
+ * @include tablet-viewport() {
+ *   :host {
+ *     background-color: green;
+ *   }
+ * }
+ */
+/**
+ * A heuristic that applies CSS to mobile
+ * viewports (i.e. phones, not tablets).
+ *
+ * Usage:
+ * @include mobile-viewport() {
+ *   :host {
+ *     background-color: blue;
+ *   }
+ * }
+ */