@ionic/core 8.2.1 → 8.2.2-dev.11717796763.1aa87d5c

package/dist/collection/components/checkbox/checkbox.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
@@ -146,18 +152,18 @@
 input {
   position: absolute;
   top: 0;
-  left: 0;
   right: 0;
   bottom: 0;
+  left: 0;
   width: 100%;
   height: 100%;
   margin: 0;
   padding: 0;
   border: 0;
   outline: 0;
-  clip: rect(0 0 0 0);
   opacity: 0;
   overflow: hidden;
+  clip: rect(0 0 0 0);
   -webkit-appearance: none;
   -moz-appearance: none;
 }
@@ -335,6 +341,12 @@ input {
   pointer-events: none;
 }
 
+/**
+ * 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
@@ -390,6 +402,12 @@ input {
  *   }
  * }
  */
+/**
+ * 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
@@ -446,7 +464,7 @@ input {
  * }
  */
 :host {
-  --border-radius: calc(var(--size) * .125);
+  --border-radius: calc(var(--size) * 0.125);
   --border-width: 2px;
   --border-style: solid;
   --border-color: rgb(var(--ion-text-color-rgb, 0, 0, 0), 0.6);

package/dist/collection/components/checkbox/test/basic/checkbox.e2e.js

@@ -3,7 +3,7 @@
  */
 import { expect } from "@playwright/test";
 import { configs, test } from "../../../../utils/test/playwright/index";
-configs().forEach(({ title, screenshot, config }) => {
+configs({ modes: ['ios', 'md', 'ionic-md'] }).forEach(({ title, screenshot, config }) => {
     test.describe(title('checkbox: basic visual tests'), () => {
         test('should not have visual regressions', async ({ page }) => {
             await page.setContent(`
@@ -85,3 +85,68 @@ configs({ modes: ['ios'], directions: ['ltr'] }).forEach(({ title, config }) =>
         });
     });
 });
+configs({ modes: ['ionic-md'], directions: ['ltr'] }).forEach(({ title, screenshot, config }) => {
+    test.describe(title('checkbox: basic visual tests'), () => {
+        test('should have a small size applied correctly', async ({ page }) => {
+            await page.setContent(`
+        <div id="checkboxes">
+          <ion-checkbox size="small">Small</ion-checkbox>
+          <ion-checkbox size="small" checked="true">Small - Checked</ion-checkbox>
+        </div>
+      `, config);
+            const checkboxes = page.locator('#checkboxes');
+            await expect(checkboxes).toHaveScreenshot(screenshot(`checkbox-small`));
+        });
+        test('should have an invalid visual applied correctly', async ({ page }) => {
+            await page.setContent(`
+        <div id="checkboxes" style="padding: 8px">
+          <ion-checkbox class="ion-invalid">Invalid</ion-checkbox>
+          <ion-checkbox class="ion-invalid ion-focused">Invalid</ion-checkbox>
+        </div>
+      `, config);
+            const checkboxes = page.locator('#checkboxes');
+            await expect(checkboxes).toHaveScreenshot(screenshot(`checkbox-invalid`));
+        });
+    });
+    test.describe(title('checkbox: safe area'), () => {
+        test('should click the safe area of a small checkbox', async ({ page }) => {
+            await page.setContent(`<ion-checkbox size="small">Small</ion-checkbox>`, config);
+            const checkbox = page.locator('ion-checkbox');
+            const box = await checkbox.boundingBox();
+            if (box !== null) {
+                await page.mouse.click(box.x + box.width / 2, box.y + 47);
+            }
+            await expect(checkbox).toBeFocused();
+        });
+        test('should click the safe area of a default checkbox', async ({ page }) => {
+            await page.setContent(`<ion-checkbox>Default</ion-checkbox>`, config);
+            const checkbox = page.locator('ion-checkbox');
+            const box = await checkbox.boundingBox();
+            if (box !== null) {
+                await page.mouse.click(box.x + box.width / 2, box.y + 47);
+            }
+            await expect(checkbox).toBeFocused();
+        });
+    });
+    test.describe(title('checkbox: shapes'), () => {
+        test('should have a soft shape applied correctly', async ({ page }) => {
+            await page.setContent(`
+        <div id="checkboxes">
+          <ion-checkbox >soft</ion-checkbox>
+          <ion-checkbox shape="soft">Soft</ion-checkbox>
+        </div>
+      `, config);
+            const checkboxes = page.locator('#checkboxes');
+            await expect(checkboxes).toHaveScreenshot(screenshot(`checkbox-shape-soft`));
+        });
+        test('should have a rectangular shape applied correctly', async ({ page }) => {
+            await page.setContent(`
+        <div id="checkboxes">
+          <ion-checkbox shape="rectangular">Rectangular</ion-checkbox>
+        </div>
+      `, config);
+            const checkboxes = page.locator('#checkboxes');
+            await expect(checkboxes).toHaveScreenshot(screenshot(`checkbox-shape-rectangular`));
+        });
+    });
+});

package/dist/collection/components/checkbox/test/label/checkbox.e2e.js

@@ -11,7 +11,7 @@ import { configs, test } from "../../../../utils/test/playwright/index";
  * we set the width of the checkbox so we can
  * see the justification results.
  */
-configs().forEach(({ title, screenshot, config }) => {
+configs({ modes: ['ios', 'md', 'ionic-md'] }).forEach(({ title, screenshot, config }) => {
     test.describe(title('checkbox: label'), () => {
         test.describe('checkbox: start placement', () => {
             test('should render a start justification with label in the start position', async ({ page }) => {

package/dist/collection/components/checkbox/test/states/checkbox.e2e.js

@@ -3,7 +3,7 @@
  */
 import { expect } from "@playwright/test";
 import { configs, test } from "../../../../utils/test/playwright/index";
-configs({ directions: ['ltr'] }).forEach(({ title, screenshot, config }) => {
+configs({ modes: ['ios', 'md', 'ionic-md'], directions: ['ltr'] }).forEach(({ title, screenshot, config }) => {
     test.describe(title('checkbox: states'), () => {
         test('should render disabled checkbox correctly', async ({ page }) => {
             await page.setContent(`
@@ -33,5 +33,36 @@ configs({ directions: ['ltr'] }).forEach(({ title, screenshot, config }) => {
             const checkbox = page.locator('ion-checkbox');
             await expect(checkbox).toHaveScreenshot(screenshot(`checkbox-unchecked`));
         });
+        test('should render focus checkbox correctly', async ({ page }) => {
+            await page.setContent(`
+          <div id="checkboxes" style="padding: 8px">
+            <ion-checkbox class="ion-focused">Label</ion-checkbox>
+            <ion-checkbox class="ion-focused" checked>Label</ion-checkbox>
+          </div>
+      `, config);
+            const checkboxes = page.locator('#checkboxes');
+            await expect(checkboxes).toHaveScreenshot(screenshot(`checkbox-focused`));
+        });
+        test('should render checkbox hover correctly', async ({ page }) => {
+            await page.setContent(`
+          <div id="checkboxes">
+            <ion-checkbox>Label</ion-checkbox>
+            <ion-checkbox checked>Label</ion-checkbox>
+          </div>
+      `, config);
+            const checkboxes = page.locator('#checkboxes');
+            await checkboxes.hover();
+            await expect(checkboxes).toHaveScreenshot(screenshot(`checkbox-hover`));
+        });
+        test('should render checkbox active correctly', async ({ page }) => {
+            await page.setContent(`
+          <div id="checkboxes">
+            <ion-checkbox class="ion-activated">Label</ion-checkbox>
+            <ion-checkbox class="ion-activated" checked>Label</ion-checkbox>
+          </div>
+      `, config);
+            const checkboxes = page.locator('#checkboxes');
+            await expect(checkboxes).toHaveScreenshot(screenshot(`checkbox-active`));
+        });
     });
 });

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

@@ -0,0 +1,141 @@
+/**
+ * Convert a pixels given value into rem
+ * 
+ * @param pixels - Value in pixels to be converted (i.e. px)
+ * @param context (optional) - Baseline value
+ */
+/**
+ * This is an auto-generated file, please do not change it directly.
+ * Ionic Design System
+ */
+/**
+ * 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 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(--ionic-color-neutral-100, #f1f1f1);
+  --color: var(--ionic-color-neutral-900, #4e4e4e);
+  --focus-ring-color: var(--ionic-state-focus-1, #9ec4fd);
+  --focus-ring-width: var(--ionic-border-size-050, 2px);
+  -moz-osx-font-smoothing: grayscale;
+  -webkit-font-smoothing: antialiased;
+  -webkit-padding-start: var(--ionic-space-200, 8px);
+  padding-inline-start: var(--ionic-space-200, 8px);
+  -webkit-padding-end: var(--ionic-space-200, 8px);
+  padding-inline-end: var(--ionic-space-200, 8px);
+  padding-top: var(--ionic-space-150, 6px);
+  padding-bottom: var(--ionic-space-150, 6px);
+  border-radius: var(--border-radius);
+  display: inline-flex;
+  position: relative;
+  align-items: center;
+  justify-content: center;
+  gap: var(--ionic-space-100, 4px);
+  background: var(--background);
+  color: var(--color);
+  font-family: var(--ionic-font-family, "Inter", sans-serif);
+  font-weight: var(--ionic-font-weight-medium, 500);
+  line-height: var(--ionic-line-height-full, 100%);
+  cursor: pointer;
+  overflow: hidden;
+  box-sizing: border-box;
+  vertical-align: middle;
+}
+
+:host(.chip-outline) {
+  --background: transparent;
+  border-width: var(--ionic-border-size-025, 1px);
+  border-color: var(--ionic-color-neutral-100, #f1f1f1);
+}
+
+:host(.ion-focused) {
+  outline: var(--focus-ring-width) var(--ionic-border-style-solid, solid) var(--focus-ring-color);
+  outline-offset: var(--focus-ring-width);
+}
+
+@media (any-hover: hover) {
+  :host(:hover) {
+    --background: var(--ionic-color-neutral-200, #e7e7e7);
+  }
+}
+:host(.chip-disabled) {
+  opacity: 0.6;
+  pointer-events: none;
+}
+
+:host(.chip-soft) {
+  --border-radius: var(--ionic-border-radius-100, 4px);
+}
+
+:host(.chip-round) {
+  --border-radius: var(--ionic-border-radius-400, 16px);
+}
+
+:host(.chip-rectangular) {
+  --border-radius: var(--ionic-border-radius-0, 0px);
+}
+
+::slotted(ion-icon) {
+  font-size: var(--ionic-font-size-400, 1rem);
+}
+
+:host(.chip-small) {
+  min-height: var(--ionic-scale-600, 24px);
+  font-size: var(--ionic-font-size-300, 0.75rem);
+}
+
+:host(.chip-large) {
+  min-height: var(--ionic-scale-800, 32px);
+  font-size: var(--ionic-font-size-350, 0.875rem);
+}

package/dist/collection/components/chip/chip.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
@@ -57,10 +63,11 @@
   /**
    * @prop --background: Background of the chip
    * @prop --color: Color of the chip
+   * @prop --border-radius: Border radius of the chip
    */
   --background: rgba(var(--ion-text-color-rgb, 0, 0, 0), 0.12);
   --color: rgba(var(--ion-text-color-rgb, 0, 0, 0), 0.87);
-  border-radius: 16px;
+  border-radius: var(--border-radius);
   -moz-osx-font-smoothing: grayscale;
   -webkit-font-smoothing: antialiased;
   -webkit-margin-start: 4px;
@@ -209,4 +216,16 @@
    * We add a min font size to keep the text legible.
    */
   font-size: clamp(13px, 0.875rem, 22px);
+}
+
+:host(.chip-soft) {
+  --border-radius: 10px;
+}
+
+:host(.chip-round) {
+  --border-radius: 999px;
+}
+
+:host(.chip-rectangular) {
+  --border-radius: 0px;
 }

package/dist/collection/components/chip/chip.js

@@ -2,38 +2,73 @@
  * (C) Ionic http://ionicframework.com - MIT License
  */
 import { Host, h } from "@stencil/core";
+import { printIonWarning } from "../../utils/logging/index";
 import { createColorClasses } from "../../utils/theme";
-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.
  */
 export class Chip {
     constructor() {
         this.color = undefined;
         this.outline = false;
         this.disabled = false;
+        this.shape = undefined;
+        this.size = undefined;
+    }
+    /**
+     * Set the shape based on the theme
+     */
+    getShape() {
+        const theme = getIonTheme(this);
+        const { shape } = this;
+        if (shape === undefined) {
+            return theme === 'ionic' ? 'round' : 'soft';
+        }
+        return shape;
+    }
+    getSize() {
+        const theme = getIonTheme(this);
+        const { size } = this;
+        if (theme === 'ionic') {
+            return size !== undefined ? size : 'large';
+            // TODO(ROU-10695): remove the size !== undefined when we add support for
+            // the `ios` and `md` themes.
+        }
+        else if (size !== undefined) {
+            printIonWarning(`The "${size}" size is not supported in the ${theme} theme.`);
+        }
+        return undefined;
     }
     render() {
-        const mode = getIonMode(this);
-        return (h(Host, { key: '7dd923c1b28d1eb1efa348f66f49cec067645af9', "aria-disabled": this.disabled ? 'true' : null, class: createColorClasses(this.color, {
-                [mode]: true,
+        const theme = getIonTheme(this);
+        const size = this.getSize();
+        const shape = this.getShape();
+        return (h(Host, { key: 'aa0aeece6547531edddac10afb3be5dbd63b817a', "aria-disabled": this.disabled ? 'true' : null, class: createColorClasses(this.color, {
+                [theme]: true,
+                [`chip-${shape}`]: true,
                 'chip-outline': this.outline,
                 'chip-disabled': this.disabled,
                 'ion-activatable': true,
-            }) }, h("slot", { key: '7ede838bf109dc27a898ee2dcdeabc3f439c8e6f' }), mode === 'md' && h("ion-ripple-effect", { key: '5acb073029544e73fcc0db4cc4e661ec1df4d231' })));
+                'ion-focusable': !this.disabled,
+                [`chip-${size}`]: size !== undefined,
+            }) }, h("slot", { key: '94581c49b9e636e388fb0a84b5f390f7f2341210' }), theme === 'md' && h("ion-ripple-effect", { key: '392fc618c6e6ea56e7481725624ab5a98d4ecb54' })));
     }
     static get is() { return "ion-chip"; }
     static get encapsulation() { return "shadow"; }
     static get originalStyleUrls() {
         return {
             "ios": ["chip.ios.scss"],
-            "md": ["chip.md.scss"]
+            "md": ["chip.md.scss"],
+            "ionic": ["chip.ionic.scss"]
         };
     }
     static get styleUrls() {
         return {
             "ios": ["chip.ios.css"],
-            "md": ["chip.md.css"]
+            "md": ["chip.md.css"],
+            "ionic": ["chip.ionic.css"]
         };
     }
     static get properties() {
@@ -96,6 +131,40 @@ export class Chip {
                 "attribute": "disabled",
                 "reflect": false,
                 "defaultValue": "false"
+            },
+            "shape": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "'soft' | 'round' | 'rectangular'",
+                    "resolved": "\"rectangular\" | \"round\" | \"soft\" | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Set to `\"soft\"` for a chip with slightly rounded corners, `\"round\"` for a chip with fully\nrounded corners, or `\"rectangular\"` for a chip without rounded corners.\nDefaults to `\"round\"` for the `\"ionic\"` theme and `\"soft\"` for all other themes."
+                },
+                "attribute": "shape",
+                "reflect": false
+            },
+            "size": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "'small' | 'large'",
+                    "resolved": "\"large\" | \"small\" | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Set to `\"small\"` for a chip with less height and padding.\n\nDefaults to `\"large\"` for the ionic theme, and  undefined for all other themes."
+                },
+                "attribute": "size",
+                "reflect": false
             }
         };
     }

package/dist/collection/components/chip/chip.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
@@ -57,10 +63,11 @@
   /**
    * @prop --background: Background of the chip
    * @prop --color: Color of the chip
+   * @prop --border-radius: Border radius of the chip
    */
   --background: rgba(var(--ion-text-color-rgb, 0, 0, 0), 0.12);
   --color: rgba(var(--ion-text-color-rgb, 0, 0, 0), 0.87);
-  border-radius: 16px;
+  border-radius: var(--border-radius);
   -moz-osx-font-smoothing: grayscale;
   -webkit-font-smoothing: antialiased;
   -webkit-margin-start: 4px;
@@ -204,4 +211,16 @@
 }
 :host {
   font-size: 0.875rem;
+}
+
+:host(.chip-soft) {
+  --border-radius: 8px;
+}
+
+:host(.chip-round) {
+  --border-radius: 999px;
+}
+
+:host(.chip-rectangular) {
+  --border-radius: 0px;
 }

package/dist/collection/components/chip/test/shape/chip.e2e.js

@@ -0,0 +1,39 @@
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+import { expect } from "@playwright/test";
+import { configs, test } from "../../../../utils/test/playwright/index";
+/**
+ * This behavior does not vary across directions
+ */
+configs({ modes: ['ionic-md', 'md', 'ios'], directions: ['ltr'] }).forEach(({ title, screenshot, config }) => {
+    test.describe(title('chip: shape'), () => {
+        test.beforeEach(async ({ page }) => {
+            await page.goto(`/src/components/chip/test/shape`, config);
+        });
+        test.describe('default', () => {
+            test('should not have visual regressions', async ({ page }) => {
+                const container = page.locator('#default');
+                await expect(container).toHaveScreenshot(screenshot(`chip-default`));
+            });
+        });
+        test.describe('soft', () => {
+            test('should not have visual regressions', async ({ page }) => {
+                const container = page.locator('#soft');
+                await expect(container).toHaveScreenshot(screenshot(`chip-soft`));
+            });
+        });
+        test.describe('round', () => {
+            test('should not have visual regressions', async ({ page }) => {
+                const container = page.locator('#round');
+                await expect(container).toHaveScreenshot(screenshot(`chip-round`));
+            });
+        });
+        test.describe('rectangular', () => {
+            test('should not have visual regressions', async ({ page }) => {
+                const container = page.locator('#rectangular');
+                await expect(container).toHaveScreenshot(screenshot(`chip-rectangular`));
+            });
+        });
+    });
+});

package/dist/collection/components/chip/test/size/chip.e2e.js

@@ -0,0 +1,26 @@
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+import { expect } from "@playwright/test";
+import { configs, test } from "../../../../utils/test/playwright/index";
+/**
+ * This behavior does not vary across modes/directions.
+ */
+configs({ modes: ['ionic-md'], directions: ['ltr'] }).forEach(({ title, screenshot, config }) => {
+    test.describe(title('chip: size'), () => {
+        test('should render small chip', async ({ page }) => {
+            await page.setContent(`<ion-chip size="small">
+          <ion-label>Small</ion-label>
+        </ion-chip>`, config);
+            const chip = page.locator('ion-chip');
+            await expect(chip).toHaveScreenshot(screenshot(`chip-size-small`));
+        });
+        test('should render large chip', async ({ page }) => {
+            await page.setContent(`<ion-chip size="large">
+          <ion-label>Large</ion-label>
+        </ion-chip>`, config);
+            const chip = page.locator('ion-chip');
+            await expect(chip).toHaveScreenshot(screenshot(`chip-size-large`));
+        });
+    });
+});

package/dist/collection/components/chip/test/states/chip.e2e.js

@@ -33,3 +33,19 @@ configs({ modes: ['ios'], directions: ['ltr'] }).forEach(({ title, screenshot, c
         });
     });
 });
+configs({ modes: ['ionic-md'], directions: ['ltr'] }).forEach(({ title, screenshot, config }) => {
+    /**
+     * This behavior only applies to Ionic Theme.
+     */
+    test.describe(title('chip: focus state'), () => {
+        test('should render focus state', async ({ page }) => {
+            await page.setContent(`<div id="container" class="ion-padding">
+          <ion-chip class="ion-focused">
+            <ion-label>Focused</ion-label>
+          </ion-chip>
+        </div>`, config);
+            const chip = page.locator('#container');
+            await expect(chip).toHaveScreenshot(screenshot(`chip-focused`));
+        });
+    });
+});

package/dist/collection/components/col/col.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