@ionic/core 8.3.1-dev.11725636643.11841b59 → 8.3.1-nightly.20240909

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

@@ -1,9 +1,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
@@ -80,8 +74,8 @@
   --max-height: 90%;
   -moz-osx-font-smoothing: grayscale;
   -webkit-font-smoothing: antialiased;
-  right: 0;
   left: 0;
+  right: 0;
   top: 0;
   bottom: 0;
   display: flex;
@@ -294,12 +288,6 @@ textarea.alert-input {
   resize: 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
@@ -355,12 +343,6 @@ textarea.alert-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

package/dist/collection/components/app/app.js

@@ -6,11 +6,7 @@ import { shouldUseCloseWatcher } from "../../utils/hardware-back-button";
 import { printIonWarning } from "../../utils/logging/index";
 import { isPlatform } from "../../utils/platform";
 import { config } from "../../global/config";
-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.
- */
+import { getIonMode } from "../../global/ionic-global";
 export class App {
     componentDidLoad() {
         if (Build.isBrowser) {
@@ -68,9 +64,9 @@ export class App {
         }
     }
     render() {
-        const theme = getIonTheme(this);
-        return (h(Host, { key: 'd65c8ab0ff36058e8d66849617b530b1df43dbb7', class: {
-                [theme]: true,
+        const mode = getIonMode(this);
+        return (h(Host, { key: 'a562850f242d9d45573e35efdd4bd178254677ef', class: {
+                [mode]: true,
                 'ion-page': true,
                 'force-statusbar-padding': config.getBoolean('_forceStatusbarPadding'),
             } }));

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

@@ -1,9 +1,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
@@ -76,12 +70,6 @@
   overflow: hidden;
 }
 
-/**
- * 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/avatar/avatar.js

@@ -2,111 +2,23 @@
  * (C) Ionic http://ionicframework.com - MIT License
  */
 import { Host, h } from "@stencil/core";
-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.
- */
+import { getIonMode } from "../../global/ionic-global";
 export class Avatar {
-    constructor() {
-        this.size = undefined;
-        this.shape = undefined;
-    }
-    get hasImage() {
-        return !!this.el.querySelector('ion-img') || !!this.el.querySelector('img');
-    }
-    get hasIcon() {
-        return !!this.el.querySelector('ion-icon');
-    }
-    getSize() {
-        const theme = getIonTheme(this);
-        const { size } = this;
-        // TODO(ROU-10752): Remove theme check when sizes are defined for all themes.
-        if (theme !== 'ionic') {
-            return undefined;
-        }
-        if (size === undefined) {
-            return 'medium';
-        }
-        return size;
-    }
-    getShape() {
-        const theme = getIonTheme(this);
-        const { shape } = this;
-        // TODO(ROU-10755): Remove theme check when shapes are defined for all themes.
-        if (theme !== 'ionic') {
-            return undefined;
-        }
-        if (shape === undefined) {
-            return 'round';
-        }
-        return shape;
-    }
     render() {
-        const theme = getIonTheme(this);
-        const size = this.getSize();
-        const shape = this.getShape();
-        return (h(Host, { key: '169f3e804c30f9eedc8c3cf064af9871bead2f5f', class: {
-                [theme]: true,
-                [`avatar-${size}`]: size !== undefined,
-                [`avatar-${shape}`]: shape !== undefined,
-                [`avatar-image`]: this.hasImage,
-                [`avatar-icon`]: this.hasIcon,
-            } }, h("slot", { key: '67bb5a3c1a6bd33af37141df05663f1685c84286' })));
+        return (h(Host, { key: 'dc1e3cd535e419eebe5599574fd2393ebfde8bbc', class: getIonMode(this) }, h("slot", { key: 'edb8441c063ea592b41345ea97d88ecd90cb3052' })));
     }
     static get is() { return "ion-avatar"; }
     static get encapsulation() { return "shadow"; }
     static get originalStyleUrls() {
         return {
             "ios": ["avatar.ios.scss"],
-            "md": ["avatar.md.scss"],
-            "ionic": ["avatar.ionic.scss"]
+            "md": ["avatar.md.scss"]
         };
     }
     static get styleUrls() {
         return {
             "ios": ["avatar.ios.css"],
-            "md": ["avatar.md.css"],
-            "ionic": ["avatar.ionic.css"]
-        };
-    }
-    static get properties() {
-        return {
-            "size": {
-                "type": "string",
-                "mutable": false,
-                "complexType": {
-                    "original": "'xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge'",
-                    "resolved": "\"large\" | \"medium\" | \"small\" | \"xlarge\" | \"xsmall\" | \"xxsmall\" | undefined",
-                    "references": {}
-                },
-                "required": false,
-                "optional": true,
-                "docs": {
-                    "tags": [],
-                    "text": "Set to `\"xxsmall\"` for the smallest size.\nSet to `\"xsmall\"` for a very small size.\nSet to `\"small\"` for a compact size.\nSet to `\"medium\"` for the default height and width.\nSet to `\"large\"` for a larger size.\nSet to `\"xlarge\"` for the largest dimensions.\n\nDefaults to `\"medium\"` for the `ionic` theme, undefined for all other themes."
-                },
-                "attribute": "size",
-                "reflect": 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 an avatar with slightly rounded corners,\n`\"round\"` for an avatar with fully rounded corners, or `\"rectangular\"`\nfor an avatar without rounded corners.\n\nDefaults to `\"round\"` for the `ionic` theme, undefined for all other themes."
-                },
-                "attribute": "shape",
-                "reflect": false
-            }
+            "md": ["avatar.md.css"]
         };
     }
-    static get elementRef() { return "el"; }
 }

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

@@ -1,9 +1,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
@@ -76,12 +70,6 @@
   overflow: hidden;
 }
 
-/**
- * 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/back-button/back-button.ios.css

@@ -1,9 +1,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
@@ -61,50 +55,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;
@@ -175,18 +169,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%;
@@ -245,8 +239,8 @@ ion-icon {
 }
 
 .button-native::after {
-  right: 0;
   left: 0;
+  right: 0;
   top: 0;
   bottom: 0;
   position: absolute;
@@ -276,12 +270,6 @@ 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
@@ -341,7 +329,7 @@ ion-icon {
   --background-hover: transparent;
   --background-hover-opacity: 1;
   --background-focused: currentColor;
-  --background-focused-opacity: 0.1;
+  --background-focused-opacity: .1;
   --border-radius: 4px;
   --color: var(--ion-color-primary, #0054e9);
   --icon-margin-end: 1px;

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

@@ -1,16 +1,14 @@
 /*!
  * (C) Ionic http://ionicframework.com - MIT License
  */
-import caretLeftRegular from "@phosphor-icons/core/assets/regular/caret-left.svg";
 import { Host, h } from "@stencil/core";
 import { inheritAriaAttributes } from "../../utils/helpers";
 import { createColorClasses, hostContext, openURL } from "../../utils/theme";
 import { arrowBackSharp, chevronBack } from "ionicons/icons";
 import { config } from "../../global/config";
-import { getIonTheme } from "../../global/ionic-global";
+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.
+ * @virtualProp {"ios" | "md"} mode - The mode determines which platform styles to use.
  *
  * @part native - The native HTML button element that wraps all child elements.
  * @part icon - The back button icon (uses ion-icon).
@@ -42,24 +40,20 @@ export class BackButton {
         }
     }
     get backButtonIcon() {
-        // Return the icon if it is explicitly set
-        if (this.icon != null) {
-            return this.icon;
+        const icon = this.icon;
+        if (icon != null) {
+            // icon is set on the component or by the config
+            return icon;
         }
-        // Determine the theme and map to default icons
-        const theme = getIonTheme(this);
-        const defaultIcons = {
-            ios: chevronBack,
-            ionic: caretLeftRegular,
-            md: arrowBackSharp,
-        };
-        // Get the default icon based on the theme, falling back to 'md' icon if necessary
-        const defaultIcon = defaultIcons[theme] || defaultIcons.md;
-        // Return the configured back button icon or the default icon
-        return config.get('backButtonIcon', defaultIcon);
+        if (getIonMode(this) === 'ios') {
+            // default ios back button icon
+            return config.get('backButtonIcon', chevronBack);
+        }
+        // default md back button icon
+        return config.get('backButtonIcon', arrowBackSharp);
     }
     get backButtonText() {
-        const defaultBackButtonText = getIonTheme(this) === 'ios' ? 'Back' : null;
+        const defaultBackButtonText = getIonMode(this) === 'ios' ? 'Back' : null;
         return this.text != null ? this.text : config.get('backButtonText', defaultBackButtonText);
     }
     get hasIconOnly() {
@@ -76,10 +70,10 @@ export class BackButton {
     render() {
         const { color, defaultHref, disabled, type, hasIconOnly, backButtonIcon, backButtonText, icon, inheritedAttributes, } = this;
         const showBackButton = defaultHref !== undefined;
-        const theme = getIonTheme(this);
+        const mode = getIonMode(this);
         const ariaLabel = inheritedAttributes['aria-label'] || backButtonText || 'back';
-        return (h(Host, { key: '6b3723c6070e0ff19b312ed86ee642bdefebae2e', onClick: this.onClick, class: createColorClasses(color, {
-                [theme]: true,
+        return (h(Host, { key: '8351c93a1812c94c979fb115f07a9ad7b3152188', onClick: this.onClick, class: createColorClasses(color, {
+                [mode]: true,
                 button: true, // ion-buttons target .button
                 'back-button-disabled': disabled,
                 'back-button-has-icon-only': hasIconOnly,
@@ -88,22 +82,20 @@ export class BackButton {
                 'ion-activatable': true,
                 'ion-focusable': true,
                 'show-back-button': showBackButton,
-            }) }, h("button", { key: '482b8e4d3d9485747d241f2bac1993cb2ab4aed6', type: type, disabled: disabled, class: "button-native", part: "native", "aria-label": ariaLabel }, h("span", { key: 'b5243414e42716903c86a08f2e8fa098d30cfdbe', class: "button-inner" }, backButtonIcon && (h("ion-icon", { key: 'fd6ad102d5fad6411c75005cb7bcc11c24a18bbb', part: "icon", icon: backButtonIcon, "aria-hidden": "true", lazy: false, "flip-rtl": icon === undefined })), backButtonText && (h("span", { key: '7d39ac018ee158f46b9bdf886ae7ed4b15c88ed4', part: "text", "aria-hidden": "true", class: "button-text" }, backButtonText))), theme === 'md' && h("ion-ripple-effect", { key: '12d543212f08222a4ba8f235b5c4a4be62284c01', type: this.rippleType }))));
+            }) }, h("button", { key: '991b8baa784dbfbdf8d3581cbbf6a858ac1f1e6e', type: type, disabled: disabled, class: "button-native", part: "native", "aria-label": ariaLabel }, h("span", { key: '929fcd83a4fdb00cf97ca803f234719171602a5e', class: "button-inner" }, backButtonIcon && (h("ion-icon", { key: '0c10d412ae8342d96f221e626b421c9abadac748', part: "icon", icon: backButtonIcon, "aria-hidden": "true", lazy: false, "flip-rtl": icon === undefined })), backButtonText && (h("span", { key: '96f505880a80f36ee8b8c78268b450f3629ee613', part: "text", "aria-hidden": "true", class: "button-text" }, backButtonText))), mode === 'md' && h("ion-ripple-effect", { key: '0aecf5d415c608069eb1a10043530bd0929b6383', 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"],
-            "ionic": ["back-button.md.scss"]
+            "md": ["back-button.md.scss"]
         };
     }
     static get styleUrls() {
         return {
             "ios": ["back-button.ios.css"],
-            "md": ["back-button.md.css"],
-            "ionic": ["back-button.md.css"]
+            "md": ["back-button.md.css"]
         };
     }
     static get properties() {

package/dist/collection/components/back-button/back-button.md.css

@@ -1,9 +1,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
@@ -61,50 +55,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;
@@ -175,18 +169,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%;
@@ -245,8 +239,8 @@ ion-icon {
 }
 
 .button-native::after {
-  right: 0;
   left: 0;
+  right: 0;
   top: 0;
   bottom: 0;
   position: absolute;
@@ -276,12 +270,6 @@ 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
@@ -340,7 +328,7 @@ ion-icon {
 :host {
   --border-radius: 4px;
   --background-focused: currentColor;
-  --background-focused-opacity: 0.12;
+  --background-focused-opacity: .12;
   --background-hover: currentColor;
   --background-hover-opacity: 0.04;
   --color: currentColor;