@ionic/core 8.8.20-dev.11787158518.168a2fea → 8.8.20-dev.11789504012.1a675914

package/dist/collection/components/back-button/back-button.ios.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
@@ -55,50 +61,50 @@
  */
 :host {
   /**
-    * @prop --background: Background of the button
-    * @prop --background-focused: Background of the button when focused with the tab key
-    * @prop --background-focused-opacity: Opacity of the button background when focused with the tab key
-    * @prop --background-hover: Background of the button on hover
-    * @prop --background-hover-opacity: Opacity of the background on hover
-    *
-    * @prop --color: Text color of the button
-    * @prop --color-focused: Text color of the button when focused with the tab key
-    * @prop --color-hover: Text color of the button on hover
-    *
-    * @prop --min-width: Minimum width of the button
-    * @prop --min-height: Minimum height of the button
-    *
-    * @prop --transition: Transition of the button
-    *
-    * @prop --border-radius: Border radius of the button
-    *
-    * @prop --ripple-color: Color of the button ripple effect
-    *
-    * @prop --opacity: Opacity of the button
-    *
-    * @prop --margin-top: Top margin of the button
-    * @prop --margin-end: Right margin if direction is left-to-right, and left margin if direction is right-to-left of the button
-    * @prop --margin-bottom: Bottom margin of the button
-    * @prop --margin-start: Left margin if direction is left-to-right, and right margin if direction is right-to-left of the button
-    *
-    * @prop --padding-top: Top padding of the button
-    * @prop --padding-end: Right padding if direction is left-to-right, and left padding if direction is right-to-left of the button
-    * @prop --padding-bottom: Bottom padding of the button
-    * @prop --padding-start: Left padding if direction is left-to-right, and right padding if direction is right-to-left of the button
-    *
-    * @prop --icon-margin-top: Top margin of the button icon
-    * @prop --icon-margin-end: Right margin if direction is left-to-right, and left margin if direction is right-to-left of the button icon
-    * @prop --icon-margin-bottom: Bottom margin of the button icon
-    * @prop --icon-margin-start: Left margin if direction is left-to-right, and right margin if direction is right-to-left of the button icon
-    *
-    * @prop --icon-padding-top: Top padding of the button icon
-    * @prop --icon-padding-end: Right padding if direction is left-to-right, and left padding if direction is right-to-left of the button icon
-    * @prop --icon-padding-bottom: Bottom padding of the button icon
-    * @prop --icon-padding-start: Left padding if direction is left-to-right, and right padding if direction is right-to-left of the button icon
-    *
-    * @prop --icon-font-size: Font size of the button icon
-    * @prop --icon-font-weight: Font weight of the button icon
-    */
+   * @prop --background: Background of the button
+   * @prop --background-focused: Background of the button when focused with the tab key
+   * @prop --background-focused-opacity: Opacity of the button background when focused with the tab key
+   * @prop --background-hover: Background of the button on hover
+   * @prop --background-hover-opacity: Opacity of the background on hover
+   *
+   * @prop --color: Text color of the button
+   * @prop --color-focused: Text color of the button when focused with the tab key
+   * @prop --color-hover: Text color of the button on hover
+   *
+   * @prop --min-width: Minimum width of the button
+   * @prop --min-height: Minimum height of the button
+   *
+   * @prop --transition: Transition of the button
+   *
+   * @prop --border-radius: Border radius of the button
+   *
+   * @prop --ripple-color: Color of the button ripple effect
+   *
+   * @prop --opacity: Opacity of the button
+   *
+   * @prop --margin-top: Top margin of the button
+   * @prop --margin-end: Right margin if direction is left-to-right, and left margin if direction is right-to-left of the button
+   * @prop --margin-bottom: Bottom margin of the button
+   * @prop --margin-start: Left margin if direction is left-to-right, and right margin if direction is right-to-left of the button
+   *
+   * @prop --padding-top: Top padding of the button
+   * @prop --padding-end: Right padding if direction is left-to-right, and left padding if direction is right-to-left of the button
+   * @prop --padding-bottom: Bottom padding of the button
+   * @prop --padding-start: Left padding if direction is left-to-right, and right padding if direction is right-to-left of the button
+   *
+   * @prop --icon-margin-top: Top margin of the button icon
+   * @prop --icon-margin-end: Right margin if direction is left-to-right, and left margin if direction is right-to-left of the button icon
+   * @prop --icon-margin-bottom: Bottom margin of the button icon
+   * @prop --icon-margin-start: Left margin if direction is left-to-right, and right margin if direction is right-to-left of the button icon
+   *
+   * @prop --icon-padding-top: Top padding of the button icon
+   * @prop --icon-padding-end: Right padding if direction is left-to-right, and left padding if direction is right-to-left of the button icon
+   * @prop --icon-padding-bottom: Bottom padding of the button icon
+   * @prop --icon-padding-start: Left padding if direction is left-to-right, and right padding if direction is right-to-left of the button icon
+   *
+   * @prop --icon-font-size: Font size of the button icon
+   * @prop --icon-font-weight: Font weight of the button icon
+   */
   --background: transparent;
   --color-focused: currentColor;
   --color-hover: currentColor;
@@ -169,18 +175,18 @@ ion-ripple-effect {
   padding-inline-end: var(--padding-end);
   padding-top: var(--padding-top);
   padding-bottom: var(--padding-bottom);
+  color: inherit;
   font-family: inherit;
   font-size: inherit;
   font-style: inherit;
   font-weight: inherit;
   letter-spacing: inherit;
+  text-align: inherit;
   text-decoration: inherit;
   text-indent: inherit;
   text-overflow: inherit;
   text-transform: inherit;
-  text-align: inherit;
   white-space: inherit;
-  color: inherit;
   display: block;
   position: relative;
   width: 100%;
@@ -239,8 +245,8 @@ ion-icon {
 }
 
 .button-native::after {
-  left: 0;
   right: 0;
+  left: 0;
   top: 0;
   bottom: 0;
   position: absolute;
@@ -270,6 +276,12 @@ ion-icon {
   color: var(--ion-toolbar-color, var(--color));
 }
 
+/**
+ * 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
@@ -329,7 +341,7 @@ ion-icon {
   --background-hover: transparent;
   --background-hover-opacity: 1;
   --background-focused: currentColor;
-  --background-focused-opacity: .1;
+  --background-focused-opacity: 0.1;
   --border-radius: 4px;
   --color: var(--ion-color-primary, #0054e9);
   --icon-margin-end: 1px;

package/dist/collection/components/back-button/back-button.js

@@ -6,70 +6,60 @@ import { inheritAriaAttributes } from "../../utils/helpers";
 import { createColorClasses, hostContext, openURL } from "../../utils/theme";
 import { arrowBackSharp, chevronBack } from "ionicons/icons";
 import { config } from "../../global/config";
-import { getIonMode } from "../../global/ionic-global";
+import { getIonTheme } from "../../global/ionic-global";
 /**
- * @virtualProp {"ios" | "md"} mode - The mode determines which platform styles to use.
+ * @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 native - The native HTML button element that wraps all child elements.
  * @part icon - The back button icon (uses ion-icon).
  * @part text - The back button text.
  */
 export class BackButton {
-    inheritedAttributes = {};
-    el;
-    /**
-     * The color to use from your application's color palette.
-     * Default options are: `"primary"`, `"secondary"`, `"tertiary"`, `"success"`, `"warning"`, `"danger"`, `"light"`, `"medium"`, and `"dark"`.
-     * For more information on colors, see [theming](/docs/theming/basics).
-     */
-    color;
-    /**
-     * The url to navigate back to by default when there is no history.
-     */
-    defaultHref;
-    /**
-     * If `true`, the user cannot interact with the button.
-     */
-    disabled = false;
-    /**
-     * The built-in named SVG icon name or the exact `src` of an SVG file
-     * to use for the back button.
-     */
-    icon;
-    /**
-     * The text to display in the back button.
-     */
-    text;
-    /**
-     * The type of the button.
-     */
-    type = 'button';
-    /**
-     * When using a router, it specifies the transition animation when navigating to
-     * another page.
-     */
-    routerAnimation;
+    constructor() {
+        this.inheritedAttributes = {};
+        /**
+         * If `true`, the user cannot interact with the button.
+         */
+        this.disabled = false;
+        /**
+         * The type of the button.
+         */
+        this.type = 'button';
+        this.onClick = async (ev) => {
+            const nav = this.el.closest('ion-nav');
+            ev.preventDefault();
+            if (nav && (await nav.canGoBack())) {
+                return nav.pop({ animationBuilder: this.routerAnimation, skipIfBusy: true });
+            }
+            return openURL(this.defaultHref, ev, 'back', this.routerAnimation);
+        };
+    }
     componentWillLoad() {
         this.inheritedAttributes = inheritAriaAttributes(this.el);
         if (this.defaultHref === undefined) {
             this.defaultHref = config.get('backButtonDefaultHref');
         }
     }
+    /**
+     * Get the icon to use for the back button icon.
+     * If an icon is set on the component, use that.
+     * Otherwise, use the icon set in the config.
+     * If no icon is set in the config, use the default icon.
+     */
     get backButtonIcon() {
-        const icon = this.icon;
-        if (icon != null) {
-            // icon is set on the component or by the config
-            return icon;
+        // Return the icon if it is explicitly set
+        if (this.icon != null) {
+            return this.icon;
         }
-        if (getIonMode(this) === 'ios') {
-            // default ios back button icon
-            return config.get('backButtonIcon', chevronBack);
-        }
-        // default md back button icon
-        return config.get('backButtonIcon', arrowBackSharp);
+        // Determine the theme and map to the default icon
+        const theme = getIonTheme(this);
+        const defaultIcon = theme === 'ios' ? chevronBack : arrowBackSharp;
+        // Return the configured back button icon or the default icon
+        return config.get('backButtonIcon', defaultIcon);
     }
     get backButtonText() {
-        const defaultBackButtonText = getIonMode(this) === 'ios' ? 'Back' : null;
+        const defaultBackButtonText = getIonTheme(this) === 'ios' ? 'Back' : null;
         return this.text != null ? this.text : config.get('backButtonText', defaultBackButtonText);
     }
     get hasIconOnly() {
@@ -83,21 +73,13 @@ export class BackButton {
         }
         return 'bounded';
     }
-    onClick = async (ev) => {
-        const nav = this.el.closest('ion-nav');
-        ev.preventDefault();
-        if (nav && (await nav.canGoBack())) {
-            return nav.pop({ animationBuilder: this.routerAnimation, skipIfBusy: true });
-        }
-        return openURL(this.defaultHref, ev, 'back', this.routerAnimation);
-    };
     render() {
         const { color, defaultHref, disabled, type, hasIconOnly, backButtonIcon, backButtonText, icon, inheritedAttributes, } = this;
         const showBackButton = defaultHref !== undefined;
-        const mode = getIonMode(this);
+        const theme = getIonTheme(this);
         const ariaLabel = inheritedAttributes['aria-label'] || backButtonText || 'back';
-        return (h(Host, { key: '5466624a10f1ab56f5469e6dc07080303880f2fe', onClick: this.onClick, class: createColorClasses(color, {
-                [mode]: true,
+        return (h(Host, { key: '3ca97664cddb7582c8344b79143b81a9fb7f167a', onClick: this.onClick, class: createColorClasses(color, {
+                [theme]: true,
                 button: true, // ion-buttons target .button
                 'back-button-disabled': disabled,
                 'back-button-has-icon-only': hasIconOnly,
@@ -106,20 +88,22 @@ export class BackButton {
                 'ion-activatable': true,
                 'ion-focusable': true,
                 'show-back-button': showBackButton,
-            }) }, h("button", { key: '63bc75ef0ad7cc9fb79e58217a3314b20acd73e3', type: type, disabled: disabled, class: "button-native", part: "native", "aria-label": ariaLabel }, h("span", { key: '5d3eacbd11af2245c6e1151cab446a0d96559ad8', class: "button-inner" }, backButtonIcon && (h("ion-icon", { key: '6439af0ae463764174e7d3207f02267811df666d', part: "icon", icon: backButtonIcon, "aria-hidden": "true", lazy: false, "flip-rtl": icon === undefined })), backButtonText && (h("span", { key: '8ee89fb18dfdb5b75948a8b197ff4cdbc008742f', part: "text", "aria-hidden": "true", class: "button-text" }, backButtonText))), mode === 'md' && h("ion-ripple-effect", { key: '63803a884998bc73bea5afe0b2a0a14e3fa4d6bf', type: this.rippleType }))));
+            }) }, h("button", { key: '49ec4655d6fbec75fd2b6f70973f98896d9accfe', type: type, disabled: disabled, class: "button-native", part: "native", "aria-label": ariaLabel }, h("span", { key: '8d701f9933253edab3627adf1b4dae681993e901', class: "button-inner" }, backButtonIcon && (h("ion-icon", { key: 'd5064dc4e5a327335fd45f21567fc1188cfcb635', part: "icon", icon: backButtonIcon, "aria-hidden": "true", lazy: false, "flip-rtl": icon === undefined })), backButtonText && (h("span", { key: '9c6611126bc7df058cb4c5669ec35c2456568717', part: "text", "aria-hidden": "true", class: "button-text" }, backButtonText))), theme === 'md' && h("ion-ripple-effect", { key: '2a88e395bc178ff2d1d14fcb8def5d679cb2e527', type: this.rippleType }))));
     }
     static get is() { return "ion-back-button"; }
     static get encapsulation() { return "shadow"; }
     static get originalStyleUrls() {
         return {
             "ios": ["back-button.ios.scss"],
-            "md": ["back-button.md.scss"]
+            "md": ["back-button.md.scss"],
+            "ionic": ["back-button.md.scss"]
         };
     }
     static get styleUrls() {
         return {
             "ios": ["back-button.ios.css"],
-            "md": ["back-button.md.css"]
+            "md": ["back-button.md.css"],
+            "ionic": ["back-button.md.css"]
         };
     }
     static get properties() {

package/dist/collection/components/back-button/back-button.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
@@ -55,50 +61,50 @@
  */
 :host {
   /**
-    * @prop --background: Background of the button
-    * @prop --background-focused: Background of the button when focused with the tab key
-    * @prop --background-focused-opacity: Opacity of the button background when focused with the tab key
-    * @prop --background-hover: Background of the button on hover
-    * @prop --background-hover-opacity: Opacity of the background on hover
-    *
-    * @prop --color: Text color of the button
-    * @prop --color-focused: Text color of the button when focused with the tab key
-    * @prop --color-hover: Text color of the button on hover
-    *
-    * @prop --min-width: Minimum width of the button
-    * @prop --min-height: Minimum height of the button
-    *
-    * @prop --transition: Transition of the button
-    *
-    * @prop --border-radius: Border radius of the button
-    *
-    * @prop --ripple-color: Color of the button ripple effect
-    *
-    * @prop --opacity: Opacity of the button
-    *
-    * @prop --margin-top: Top margin of the button
-    * @prop --margin-end: Right margin if direction is left-to-right, and left margin if direction is right-to-left of the button
-    * @prop --margin-bottom: Bottom margin of the button
-    * @prop --margin-start: Left margin if direction is left-to-right, and right margin if direction is right-to-left of the button
-    *
-    * @prop --padding-top: Top padding of the button
-    * @prop --padding-end: Right padding if direction is left-to-right, and left padding if direction is right-to-left of the button
-    * @prop --padding-bottom: Bottom padding of the button
-    * @prop --padding-start: Left padding if direction is left-to-right, and right padding if direction is right-to-left of the button
-    *
-    * @prop --icon-margin-top: Top margin of the button icon
-    * @prop --icon-margin-end: Right margin if direction is left-to-right, and left margin if direction is right-to-left of the button icon
-    * @prop --icon-margin-bottom: Bottom margin of the button icon
-    * @prop --icon-margin-start: Left margin if direction is left-to-right, and right margin if direction is right-to-left of the button icon
-    *
-    * @prop --icon-padding-top: Top padding of the button icon
-    * @prop --icon-padding-end: Right padding if direction is left-to-right, and left padding if direction is right-to-left of the button icon
-    * @prop --icon-padding-bottom: Bottom padding of the button icon
-    * @prop --icon-padding-start: Left padding if direction is left-to-right, and right padding if direction is right-to-left of the button icon
-    *
-    * @prop --icon-font-size: Font size of the button icon
-    * @prop --icon-font-weight: Font weight of the button icon
-    */
+   * @prop --background: Background of the button
+   * @prop --background-focused: Background of the button when focused with the tab key
+   * @prop --background-focused-opacity: Opacity of the button background when focused with the tab key
+   * @prop --background-hover: Background of the button on hover
+   * @prop --background-hover-opacity: Opacity of the background on hover
+   *
+   * @prop --color: Text color of the button
+   * @prop --color-focused: Text color of the button when focused with the tab key
+   * @prop --color-hover: Text color of the button on hover
+   *
+   * @prop --min-width: Minimum width of the button
+   * @prop --min-height: Minimum height of the button
+   *
+   * @prop --transition: Transition of the button
+   *
+   * @prop --border-radius: Border radius of the button
+   *
+   * @prop --ripple-color: Color of the button ripple effect
+   *
+   * @prop --opacity: Opacity of the button
+   *
+   * @prop --margin-top: Top margin of the button
+   * @prop --margin-end: Right margin if direction is left-to-right, and left margin if direction is right-to-left of the button
+   * @prop --margin-bottom: Bottom margin of the button
+   * @prop --margin-start: Left margin if direction is left-to-right, and right margin if direction is right-to-left of the button
+   *
+   * @prop --padding-top: Top padding of the button
+   * @prop --padding-end: Right padding if direction is left-to-right, and left padding if direction is right-to-left of the button
+   * @prop --padding-bottom: Bottom padding of the button
+   * @prop --padding-start: Left padding if direction is left-to-right, and right padding if direction is right-to-left of the button
+   *
+   * @prop --icon-margin-top: Top margin of the button icon
+   * @prop --icon-margin-end: Right margin if direction is left-to-right, and left margin if direction is right-to-left of the button icon
+   * @prop --icon-margin-bottom: Bottom margin of the button icon
+   * @prop --icon-margin-start: Left margin if direction is left-to-right, and right margin if direction is right-to-left of the button icon
+   *
+   * @prop --icon-padding-top: Top padding of the button icon
+   * @prop --icon-padding-end: Right padding if direction is left-to-right, and left padding if direction is right-to-left of the button icon
+   * @prop --icon-padding-bottom: Bottom padding of the button icon
+   * @prop --icon-padding-start: Left padding if direction is left-to-right, and right padding if direction is right-to-left of the button icon
+   *
+   * @prop --icon-font-size: Font size of the button icon
+   * @prop --icon-font-weight: Font weight of the button icon
+   */
   --background: transparent;
   --color-focused: currentColor;
   --color-hover: currentColor;
@@ -169,18 +175,18 @@ ion-ripple-effect {
   padding-inline-end: var(--padding-end);
   padding-top: var(--padding-top);
   padding-bottom: var(--padding-bottom);
+  color: inherit;
   font-family: inherit;
   font-size: inherit;
   font-style: inherit;
   font-weight: inherit;
   letter-spacing: inherit;
+  text-align: inherit;
   text-decoration: inherit;
   text-indent: inherit;
   text-overflow: inherit;
   text-transform: inherit;
-  text-align: inherit;
   white-space: inherit;
-  color: inherit;
   display: block;
   position: relative;
   width: 100%;
@@ -239,8 +245,8 @@ ion-icon {
 }
 
 .button-native::after {
-  left: 0;
   right: 0;
+  left: 0;
   top: 0;
   bottom: 0;
   position: absolute;
@@ -270,6 +276,12 @@ ion-icon {
   color: var(--ion-toolbar-color, var(--color));
 }
 
+/**
+ * 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
@@ -328,7 +340,7 @@ ion-icon {
 :host {
   --border-radius: 4px;
   --background-focused: currentColor;
-  --background-focused-opacity: .12;
+  --background-focused-opacity: 0.12;
   --background-hover: currentColor;
   --background-hover-opacity: 0.04;
   --color: currentColor;

package/dist/collection/components/backdrop/backdrop.ionic.css

@@ -0,0 +1,109 @@
+/**
+ * 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.
+ */
+/**
+ * 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 {
+  right: 0;
+  left: 0;
+  top: 0;
+  bottom: 0;
+  display: block;
+  position: absolute;
+  transform: translateZ(0);
+  contain: strict;
+  cursor: pointer;
+  opacity: 0.01;
+  touch-action: none;
+}
+
+:host(.backdrop-hide) {
+  background: transparent;
+}
+
+:host(.backdrop-no-tappable) {
+  cursor: auto;
+}
+
+:host {
+  background-color: rgba(var(--token-primitives-base-black-rgb, 17, 17, 17), 0.7);
+  z-index: 2;
+}

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

@@ -1,3 +1,53 @@
+/**
+ * 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 {
+  right: 0;
+  left: 0;
+  top: 0;
+  bottom: 0;
+  display: block;
+  position: absolute;
+  transform: translateZ(0);
+  contain: strict;
+  cursor: pointer;
+  opacity: 0.01;
+  touch-action: none;
+}
+
+:host(.backdrop-hide) {
+  background: transparent;
+}
+
+:host(.backdrop-no-tappable) {
+  cursor: auto;
+}
+
+/**
+ * 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
@@ -54,28 +104,15 @@
  * }
  */
 :host {
-  left: 0;
-  right: 0;
-  top: 0;
-  bottom: 0;
-  display: block;
-  position: absolute;
-  transform: translateZ(0);
-  contain: strict;
-  cursor: pointer;
-  opacity: 0.01;
-  touch-action: none;
   z-index: 2;
 }
 
-:host(.backdrop-hide) {
-  background: transparent;
-}
-
-:host(.backdrop-no-tappable) {
-  cursor: auto;
-}
-
+/**
+ * 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