@ionic/core 8.7.5 → 8.7.6-dev.11758808200.14faa1a0

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

@@ -0,0 +1,87 @@
+/**
+ * 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 --margin-top: Top margin of the divider
+   * @prop --margin-bottom: Bottom margin of the divider
+   * @prop --padding-end: Right padding if direction is left-to-right, and left padding if direction is right-to-left of the divider
+   * @prop --padding-start: Left padding if direction is left-to-right, and right padding if direction is right-to-left of the divider
+   */
+  --margin-top: 0px;
+  --margin-bottom: 0px;
+  --padding-start: 0px;
+  --padding-end: 0px;
+  -webkit-padding-start: var(--padding-start);
+  padding-inline-start: var(--padding-start);
+  -webkit-padding-end: var(--padding-end);
+  padding-inline-end: var(--padding-end);
+  display: block;
+  width: 100%;
+}
+
+:host hr {
+  display: block;
+  width: 100%;
+  margin-top: var(--margin-top);
+  margin-bottom: var(--margin-bottom);
+  border: none;
+}
+
+:host hr {
+  border-top: 1px solid #e0e0e0;
+}
+
+:host(.divider-inset) {
+  --padding-start: 16px;
+  --padding-end: 16px;
+}
+
+:host(.divider-spacing-xsmall) {
+  --margin-top: 8px;
+  --margin-bottom: 8px;
+}
+
+:host(.divider-spacing-small) {
+  --margin-top: 12px;
+  --margin-bottom: 12px;
+}
+
+:host(.divider-spacing-medium) {
+  --margin-top: 16px;
+  --margin-bottom: 16px;
+}
+
+:host(.divider-spacing-large) {
+  --margin-top: 24px;
+  --margin-bottom: 24px;
+}
+
+:host(.divider-spacing-xlarge) {
+  --margin-top: 32px;
+  --margin-bottom: 32px;
+}
+
+:host(.divider-spacing-xxlarge) {
+  --margin-top: 40px;
+  --margin-bottom: 40px;
+}

package/dist/collection/components/divider/divider.js

@@ -0,0 +1,94 @@
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+import { getIonTheme } from "../../global/ionic-global";
+import { Host, h } from "@stencil/core";
+export class Divider {
+    constructor() {
+        /**
+         * Set to `"xxsmall"` for the smallest spacing.
+         * Set to "xsmall" for very small spacing.
+         * Set to `"small"` for small spacing.
+         * Set to "medium" for medium spacing.
+         * Set to "large" for large spacing.
+         * Set to `"xlarge"` for the largest spacing.
+         *
+         * Defaults to `"medium"`.
+         */
+        this.spacing = 'medium';
+        /**
+         * If `true`, the divider will have horizontal margins
+         * By default, it's `false`
+         */
+        this.inset = false;
+    }
+    render() {
+        const { inset, spacing } = this;
+        const theme = getIonTheme(this);
+        return (h(Host, { key: '387f7cb3ce69a1d4aa299f988d21d731fd5775d9', class: {
+                [theme]: true,
+                [`divider-spacing-${spacing}`]: spacing !== undefined,
+                [`divider-inset`]: inset,
+            } }, h("hr", { key: 'cecfeab61e8f532a1eda36e73011f5447be63480' })));
+    }
+    static get is() { return "ion-divider"; }
+    static get encapsulation() { return "shadow"; }
+    static get originalStyleUrls() {
+        return {
+            "ios": ["divider.ios.scss"],
+            "md": ["divider.md.scss"],
+            "ionic": ["divider.ionic.scss"]
+        };
+    }
+    static get styleUrls() {
+        return {
+            "ios": ["divider.ios.css"],
+            "md": ["divider.md.css"],
+            "ionic": ["divider.ionic.css"]
+        };
+    }
+    static get properties() {
+        return {
+            "spacing": {
+                "type": "string",
+                "attribute": "spacing",
+                "mutable": false,
+                "complexType": {
+                    "original": "'xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge'",
+                    "resolved": "\"large\" | \"medium\" | \"small\" | \"xlarge\" | \"xsmall\" | \"xxlarge\" | \"xxsmall\" | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Set to `\"xxsmall\"` for the smallest spacing.\nSet to \"xsmall\" for very small spacing.\nSet to `\"small\"` for small spacing.\nSet to \"medium\" for medium spacing.\nSet to \"large\" for large spacing.\nSet to `\"xlarge\"` for the largest spacing.\n\nDefaults to `\"medium\"`."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "defaultValue": "'medium'"
+            },
+            "inset": {
+                "type": "boolean",
+                "attribute": "inset",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "If `true`, the divider will have horizontal margins\nBy default, it's `false`"
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "defaultValue": "false"
+            }
+        };
+    }
+}

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

@@ -0,0 +1,87 @@
+/**
+ * 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 --margin-top: Top margin of the divider
+   * @prop --margin-bottom: Bottom margin of the divider
+   * @prop --padding-end: Right padding if direction is left-to-right, and left padding if direction is right-to-left of the divider
+   * @prop --padding-start: Left padding if direction is left-to-right, and right padding if direction is right-to-left of the divider
+   */
+  --margin-top: 0px;
+  --margin-bottom: 0px;
+  --padding-start: 0px;
+  --padding-end: 0px;
+  -webkit-padding-start: var(--padding-start);
+  padding-inline-start: var(--padding-start);
+  -webkit-padding-end: var(--padding-end);
+  padding-inline-end: var(--padding-end);
+  display: block;
+  width: 100%;
+}
+
+:host hr {
+  display: block;
+  width: 100%;
+  margin-top: var(--margin-top);
+  margin-bottom: var(--margin-bottom);
+  border: none;
+}
+
+:host hr {
+  border-top: 1px solid #e0e0e0;
+}
+
+:host(.divider-inset) {
+  --padding-start: 16px;
+  --padding-end: 16px;
+}
+
+:host(.divider-spacing-xsmall) {
+  --margin-top: 8px;
+  --margin-bottom: 8px;
+}
+
+:host(.divider-spacing-small) {
+  --margin-top: 12px;
+  --margin-bottom: 12px;
+}
+
+:host(.divider-spacing-medium) {
+  --margin-top: 16px;
+  --margin-bottom: 16px;
+}
+
+:host(.divider-spacing-large) {
+  --margin-top: 24px;
+  --margin-bottom: 24px;
+}
+
+:host(.divider-spacing-xlarge) {
+  --margin-top: 32px;
+  --margin-bottom: 32px;
+}
+
+:host(.divider-spacing-xxlarge) {
+  --margin-top: 40px;
+  --margin-bottom: 40px;
+}

package/dist/collection/components/fab/fab.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,12 @@
  *   }
  * }
  */
+/**
+ * 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
@@ -108,6 +120,12 @@
  *   }
  * }
  */
+/**
+ * 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
@@ -163,6 +181,12 @@
  *   }
  * }
  */
+/**
+ * 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
@@ -226,8 +250,8 @@
 }
 
 :host(.fab-horizontal-center) {
-  left: 0px;
   right: 0px;
+  left: 0px;
   -webkit-margin-start: auto;
   margin-inline-start: auto;
   -webkit-margin-end: auto;

package/dist/collection/components/fab/fab.js

@@ -2,7 +2,11 @@
  * (C) Ionic http://ionicframework.com - MIT License
  */
 import { Host, h } from "@stencil/core";
-import { getIonMode } from "../../global/ionic-global";
+import { getIonTheme } 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.
+ */
 export class Fab {
     constructor() {
         /**
@@ -53,13 +57,13 @@ export class Fab {
     }
     render() {
         const { horizontal, vertical, edge } = this;
-        const mode = getIonMode(this);
-        return (h(Host, { key: '8a310806d0e748d7ebb0ed3d9a2652038e0f2960', class: {
-                [mode]: true,
+        const theme = getIonTheme(this);
+        return (h(Host, { key: '8b758c5283382f1bddd051f5a575d4952b001c50', class: {
+                [theme]: true,
                 [`fab-horizontal-${horizontal}`]: horizontal !== undefined,
                 [`fab-vertical-${vertical}`]: vertical !== undefined,
                 'fab-edge': edge,
-            } }, h("slot", { key: '9394ef6d6e5b0410fa6ba212171f687fb178ce2d' })));
+            } }, h("slot", { key: '45ce20f308b3de9c09d625d45b3f3dc7b4ee8652' })));
     }
     static get is() { return "ion-fab"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/fab-button/fab-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
@@ -90,7 +96,7 @@
   --color-focused: var(--color);
   --color-hover: var(--color);
   --background-hover: var(--ion-color-primary-contrast, #fff);
-  --background-hover-opacity: .08;
+  --background-hover-opacity: 0.08;
   --transition: background-color, opacity 100ms linear;
   --ripple-color: currentColor;
   --border-radius: 50%;
@@ -124,18 +130,18 @@
   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%;
@@ -163,8 +169,8 @@
 }
 
 .button-native::after {
-  left: 0;
   right: 0;
+  left: 0;
   top: 0;
   bottom: 0;
   position: absolute;
@@ -173,8 +179,8 @@
 }
 
 .button-inner {
-  left: 0;
   right: 0;
+  left: 0;
   top: 0;
   display: flex;
   position: absolute;
@@ -241,8 +247,8 @@
   margin-inline-end: auto;
   margin-top: 0;
   margin-bottom: 0;
-  left: 0;
   right: 0;
+  left: 0;
   top: 0;
   position: absolute;
   height: 100%;
@@ -278,6 +284,12 @@ ion-ripple-effect {
   color: var(--ion-color-contrast);
 }
 
+/**
+ * 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/fab-button/fab-button.js

@@ -1,13 +1,16 @@
 /*!
  * (C) Ionic http://ionicframework.com - MIT License
  */
+import xRegular from "@phosphor-icons/core/assets/regular/x.svg";
 import { Host, h } from "@stencil/core";
 import { inheritAriaAttributes } from "../../utils/helpers";
 import { createColorClasses, hostContext, openURL } from "../../utils/theme";
 import { close } from "ionicons/icons";
-import { getIonMode } from "../../global/ionic-global";
+import { config } from "../../global/config";
+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 or anchor element that wraps all child elements.
  * @part close-icon - The close icon that is displayed when a fab list opens (uses ion-icon).
@@ -35,7 +38,7 @@ export class FabButton {
         this.show = false;
         /**
          * If `true`, the fab button will be translucent.
-         * Only applies when the mode is `"ios"` and the device supports
+         * Only applies when the theme is `"ios"` and the device supports
          * [`backdrop-filter`](https://developer.mozilla.org/en-US/docs/Web/CSS/backdrop-filter#Browser_compatibility).
          */
         this.translucent = false;
@@ -43,12 +46,6 @@ export class FabButton {
          * The type of the button.
          */
         this.type = 'button';
-        /**
-         * The icon name to use for the close icon. This will appear when the fab button
-         * is pressed. Only applies if it is the main button inside of a fab containing a
-         * fab list.
-         */
-        this.closeIcon = close;
         this.onFocus = () => {
             this.ionFocus.emit();
         };
@@ -69,10 +66,27 @@ export class FabButton {
     componentWillLoad() {
         this.inheritedAttributes = inheritAriaAttributes(this.el);
     }
+    get fabButtonCloseIcon() {
+        // Return the icon if it is explicitly set
+        if (this.closeIcon != null) {
+            return this.closeIcon;
+        }
+        // Determine the theme and map to default icons
+        const theme = getIonTheme(this);
+        const defaultIcons = {
+            ios: close,
+            ionic: xRegular,
+            md: close,
+        };
+        // Get the default icon based on the theme, falling back to 'md' icon if necessary
+        const defaultIcon = defaultIcons[theme] || defaultIcons.md;
+        // Return the configured fab button close icon or the default icon
+        return config.get('fabButtonCloseIcon', defaultIcon);
+    }
     render() {
-        const { el, disabled, color, href, activated, show, translucent, size, inheritedAttributes } = this;
+        const { el, disabled, fabButtonCloseIcon, color, href, activated, show, translucent, size, inheritedAttributes } = this;
         const inList = hostContext('ion-fab-list', el);
-        const mode = getIonMode(this);
+        const theme = getIonTheme(this);
         const TagType = href === undefined ? 'button' : 'a';
         const attrs = TagType === 'button'
             ? { type: this.type }
@@ -82,8 +96,8 @@ export class FabButton {
                 rel: this.rel,
                 target: this.target,
             };
-        return (h(Host, { key: '4eee204d20b0e2ffed49a88f6cb3e04b6697965c', onClick: this.onClick, "aria-disabled": disabled ? 'true' : null, class: createColorClasses(color, {
-                [mode]: true,
+        return (h(Host, { key: 'ffc552ad3b542e0f79e319fa86b063c3289e1a23', onClick: this.onClick, "aria-disabled": disabled ? 'true' : null, class: createColorClasses(color, {
+                [theme]: true,
                 'fab-button-in-list': inList,
                 'fab-button-translucent-in-list': inList && translucent,
                 'fab-button-close-active': activated,
@@ -93,20 +107,22 @@ export class FabButton {
                 'ion-activatable': true,
                 'ion-focusable': true,
                 [`fab-button-${size}`]: size !== undefined,
-            }) }, h(TagType, Object.assign({ key: '914561622c0c6bd41453e828a7d8a39f924875ac' }, attrs, { class: "button-native", part: "native", disabled: disabled, onFocus: this.onFocus, onBlur: this.onBlur, onClick: (ev) => openURL(href, ev, this.routerDirection, this.routerAnimation) }, inheritedAttributes), h("ion-icon", { key: '2c8090742a64c62a79243667027a195cca9d5912', "aria-hidden": "true", icon: this.closeIcon, part: "close-icon", class: "close-icon", lazy: false }), h("span", { key: 'c3e55291e4c4d306d34a4b95dd2e727e87bdf39c', class: "button-inner" }, h("slot", { key: 'f8e57f71d8f8878d9746cfece82f57f19ef9e988' })), mode === 'md' && h("ion-ripple-effect", { key: 'a5e94fa0bb9836072300617245ed0c1b4887bac6' }))));
+            }) }, h(TagType, Object.assign({ key: 'acf0c99822630499b171f0873924cfe10ef41547' }, attrs, { class: "button-native", part: "native", disabled: disabled, onFocus: this.onFocus, onBlur: this.onBlur, onClick: (ev) => openURL(href, ev, this.routerDirection, this.routerAnimation) }, inheritedAttributes), h("ion-icon", { key: '236a7340cf8213a69325716cb3b813abb627b40a', "aria-hidden": "true", icon: fabButtonCloseIcon, part: "close-icon", class: "close-icon", lazy: false }), h("span", { key: '908a53794c801a64c8cdae9b08ae75deb93a5b22', class: "button-inner" }, h("slot", { key: '41bf30e091cfcf90dcf3975a4b05a30c987e8aae' })), theme === 'md' && h("ion-ripple-effect", { key: 'b665e44a357138ef30454e267a2214356dc0fe3b' }))));
     }
     static get is() { return "ion-fab-button"; }
     static get encapsulation() { return "shadow"; }
     static get originalStyleUrls() {
         return {
             "ios": ["fab-button.ios.scss"],
-            "md": ["fab-button.md.scss"]
+            "md": ["fab-button.md.scss"],
+            "ionic": ["fab-button.md.scss"]
         };
     }
     static get styleUrls() {
         return {
             "ios": ["fab-button.ios.css"],
-            "md": ["fab-button.md.css"]
+            "md": ["fab-button.md.css"],
+            "ionic": ["fab-button.md.css"]
         };
     }
     static get properties() {
@@ -335,7 +351,7 @@ export class FabButton {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "If `true`, the fab button will be translucent.\nOnly applies when the mode is `\"ios\"` and the device supports\n[`backdrop-filter`](https://developer.mozilla.org/en-US/docs/Web/CSS/backdrop-filter#Browser_compatibility)."
+                    "text": "If `true`, the fab button will be translucent.\nOnly applies when the theme is `\"ios\"` and the device supports\n[`backdrop-filter`](https://developer.mozilla.org/en-US/docs/Web/CSS/backdrop-filter#Browser_compatibility)."
                 },
                 "getter": false,
                 "setter": false,
@@ -387,19 +403,18 @@ export class FabButton {
                 "mutable": false,
                 "complexType": {
                     "original": "string",
-                    "resolved": "string",
+                    "resolved": "string | undefined",
                     "references": {}
                 },
                 "required": false,
-                "optional": false,
+                "optional": true,
                 "docs": {
                     "tags": [],
                     "text": "The icon name to use for the close icon. This will appear when the fab button\nis pressed. Only applies if it is the main button inside of a fab containing a\nfab list."
                 },
                 "getter": false,
                 "setter": false,
-                "reflect": false,
-                "defaultValue": "close"
+                "reflect": false
             }
         };
     }

package/dist/collection/components/fab-button/fab-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
@@ -90,7 +96,7 @@
   --color-focused: var(--color);
   --color-hover: var(--color);
   --background-hover: var(--ion-color-primary-contrast, #fff);
-  --background-hover-opacity: .08;
+  --background-hover-opacity: 0.08;
   --transition: background-color, opacity 100ms linear;
   --ripple-color: currentColor;
   --border-radius: 50%;
@@ -124,18 +130,18 @@
   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%;
@@ -163,8 +169,8 @@
 }
 
 .button-native::after {
-  left: 0;
   right: 0;
+  left: 0;
   top: 0;
   bottom: 0;
   position: absolute;
@@ -173,8 +179,8 @@
 }
 
 .button-inner {
-  left: 0;
   right: 0;
+  left: 0;
   top: 0;
   display: flex;
   position: absolute;
@@ -241,8 +247,8 @@
   margin-inline-end: auto;
   margin-top: 0;
   margin-bottom: 0;
-  left: 0;
   right: 0;
+  left: 0;
   top: 0;
   position: absolute;
   height: 100%;
@@ -278,6 +284,12 @@ ion-ripple-effect {
   color: var(--ion-color-contrast);
 }
 
+/**
+ * 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
@@ -339,8 +351,8 @@ ion-ripple-effect {
   --background-focused: currentColor;
   --background-hover: currentColor;
   --background-activated-opacity: 0;
-  --background-focused-opacity: .24;
-  --background-hover-opacity: .08;
+  --background-focused-opacity: 0.24;
+  --background-hover-opacity: 0.08;
   --color: var(--ion-color-primary-contrast, #fff);
   --box-shadow: 0 3px 5px -1px rgba(0, 0, 0, 0.2), 0 6px 10px 0 rgba(0, 0, 0, 0.14), 0 1px 18px 0 rgba(0, 0, 0, 0.12);
   --transition: box-shadow 280ms cubic-bezier(0.4, 0, 0.2, 1), background-color 280ms cubic-bezier(0.4, 0, 0.2, 1), color 280ms cubic-bezier(0.4, 0, 0.2, 1), opacity 15ms linear 30ms, transform 270ms cubic-bezier(0, 0, 0.2, 1) 0ms;

package/dist/collection/components/fab-list/fab-list.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,12 @@
  *   }
  * }
  */
+/**
+ * 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