@ionic/core 8.4.0 → 8.4.1-dev.11730807985.1b046f37

package/dist/collection/components/avatar/avatar.js

@@ -2,23 +2,111 @@
  * (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 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() {
-        return (h(Host, { key: '998217066084f966bf5d356fed85bcbd451f675a', class: getIonMode(this) }, h("slot", { key: '1a6f7c9d4dc6a875f86b5b3cda6d59cb39587f22' })));
+        const theme = getIonTheme(this);
+        const size = this.getSize();
+        const shape = this.getShape();
+        return (h(Host, { key: '5af235b9f85ad5c3c161219a65d8b53724f35fd0', class: {
+                [theme]: true,
+                [`avatar-${size}`]: size !== undefined,
+                [`avatar-${shape}`]: shape !== undefined,
+                [`avatar-image`]: this.hasImage,
+                [`avatar-icon`]: this.hasIcon,
+            } }, h("slot", { key: '7186cb46c15cd693e81638522c85e3fa8739ead1' })));
     }
     static get is() { return "ion-avatar"; }
     static get encapsulation() { return "shadow"; }
     static get originalStyleUrls() {
         return {
             "ios": ["avatar.ios.scss"],
-            "md": ["avatar.md.scss"]
+            "md": ["avatar.md.scss"],
+            "ionic": ["avatar.ionic.scss"]
         };
     }
     static get styleUrls() {
         return {
             "ios": ["avatar.ios.css"],
-            "md": ["avatar.md.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
+            }
         };
     }
+    static get elementRef() { return "el"; }
 }

package/dist/collection/components/avatar/avatar.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
@@ -70,6 +76,12 @@
   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,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

@@ -1,14 +1,16 @@
 /*!
  * (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 { 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).
@@ -40,20 +42,24 @@ export class BackButton {
         }
     }
     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 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);
     }
     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() {
@@ -70,10 +76,10 @@ export class BackButton {
     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: '30cb7e566ef5182691373de93dbe694fb8cf72ed', onClick: this.onClick, class: createColorClasses(color, {
+                [theme]: true,
                 button: true, // ion-buttons target .button
                 'back-button-disabled': disabled,
                 'back-button-has-icon-only': hasIconOnly,
@@ -82,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: 'be59bfbfec6e6591afee4beff7f0527bdd432dab', type: type, disabled: disabled, class: "button-native", part: "native", "aria-label": ariaLabel }, h("span", { key: '9118e5a082f9092307d80a53307f768461403928', class: "button-inner" }, backButtonIcon && (h("ion-icon", { key: '14193bf4f0edd1ba45f83ab664ddbe08f541997f', part: "icon", icon: backButtonIcon, "aria-hidden": "true", lazy: false, "flip-rtl": icon === undefined })), backButtonText && (h("span", { key: 'a83a8cdb8a95d67ff997c1e366a46c7ec2f7b9fc', part: "text", "aria-hidden": "true", class: "button-text" }, backButtonText))), theme === 'md' && h("ion-ripple-effect", { key: '11c5cc4b5eb3fc19db6e094d549546200ba2b90e', 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;