@ionic/core 8.8.3 → 8.8.4-dev.11775576543.172b7b99

package/dist/types/components/input/input.d.ts

@@ -2,7 +2,8 @@ import type { ComponentInterface, EventEmitter } from '../../stencil-public-runt
 import type { AutocompleteTypes, Color, TextFieldTypes } from '../../interface';
 import type { InputChangeEventDetail, InputInputEventDetail } from './input-interface';
 /**
- * @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.
  *
  * @slot label - The label text to associate with the input. Use the `labelPlacement` property to control where the label is placed relative to the input. Use this if you need to render a label with custom HTML. (EXPERIMENTAL)
  * @slot start - Content to display at the leading edge of the input. (EXPERIMENTAL)
@@ -116,7 +117,7 @@ export declare class Input implements ComponentInterface {
     errorText?: string;
     /**
      * The fill for the item. If `"solid"` the item will have a background. If
-     * `"outline"` the item will be transparent with a border. Only available in `md` mode.
+     * `"outline"` the item will be transparent with a border. Only available when the theme is `"md"`.
      */
     fill?: 'outline' | 'solid';
     /**
@@ -144,8 +145,12 @@ export declare class Input implements ComponentInterface {
      * `"floating"`: The label will appear smaller and above the input when the input is focused or it has a value. Otherwise it will appear on top of the input.
      * `"stacked"`: The label will appear smaller and above the input regardless even when the input is blurred or has no value.
      * `"fixed"`: The label has the same behavior as `"start"` except it also has a fixed width. Long text will be truncated with ellipses ("...").
+     *
+     * Defaults to "stacked" for the ionic theme, or "start" for all other themes.
+     *
+     * In the ionic theme, only the values "stacked" and "floating" are supported.
      */
-    labelPlacement: 'start' | 'end' | 'floating' | 'stacked' | 'fixed';
+    labelPlacement?: 'start' | 'end' | 'floating' | 'stacked' | 'fixed';
     /**
      * The maximum value, which must not be less than its minimum (min attribute) value.
      */
@@ -189,9 +194,12 @@ export declare class Input implements ComponentInterface {
      */
     required: boolean;
     /**
-     * The shape of the input. If "round" it will have an increased border radius.
+     * Set to `"soft"` for an input with slightly rounded corners, `"round"` for an input with fully
+     * rounded corners, or `"rectangular"` for an input without rounded corners.
+     * Defaults to `"round"` for the ionic theme, and `undefined` for all other themes.
+     * Only applies when the fill is set to `"solid"` or `"outline"`.
      */
-    shape?: 'round';
+    shape?: 'soft' | 'round' | 'rectangular';
     /**
      * If `true`, the element will have its spelling and grammar checked.
      */
@@ -201,6 +209,11 @@ export declare class Input implements ComponentInterface {
      * Possible values are: `"any"` or a positive floating point number.
      */
     step?: string;
+    /**
+     * The size of the input. If "large", it will have an increased height. By default the
+     * size is medium. This property only applies to the `"ionic"` theme.
+     */
+    size?: 'medium' | 'large' | 'xlarge';
     /**
      * The type of control to display. The default type is text.
      */
@@ -301,6 +314,10 @@ export declare class Input implements ComponentInterface {
     private emitInputChange;
     private shouldClearOnEdit;
     private getValue;
+    private getFill;
+    private getLabelPlacement;
+    private getSize;
+    private getShape;
     private onInput;
     private onChange;
     private onBlur;
@@ -356,5 +373,14 @@ export declare class Input implements ComponentInterface {
      * when fill="outline".
      */
     private renderLabelContainer;
+    /**
+     * Get the icon to use for the clear icon.
+     * If an icon is set on the component, use that.
+     * Otherwise, use the icon set in the config.
+     * If no icon is set in the config, use the default icon.
+     *
+     * @internal
+     */
+    get inputClearIcon(): string;
     render(): any;
 }

package/dist/types/components/input-otp/input-otp.d.ts

@@ -1,6 +1,16 @@
 import type { ComponentInterface, EventEmitter } from '../../stencil-public-runtime';
 import type { Color } from '../../interface';
 import type { InputOtpChangeEventDetail, InputOtpCompleteEventDetail, InputOtpInputEventDetail } from './input-otp-interface';
+/**
+ * @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 group - The container element that wraps all input boxes.
+ * @part container - The wrapper element for each individual input box.
+ * @part native - The native input element.
+ * @part separator - The separator element displayed between input boxes.
+ * @part description - The container element for the description text.
+ */
 export declare class InputOTP implements ComponentInterface {
     private inheritedAttributes;
     private inputRefs;
@@ -19,6 +29,7 @@ export declare class InputOTP implements ComponentInterface {
      */
     private isKeyboardNavigation;
     el: HTMLIonInputOtpElement;
+    internals: ElementInternals;
     private inputValues;
     hasFocus: boolean;
     private previousInputValues;
@@ -37,6 +48,10 @@ export declare class InputOTP implements ComponentInterface {
      * If `true`, the user cannot interact with the input.
      */
     disabled: boolean;
+    /**
+     * Update element internals when disabled prop changes
+     */
+    protected disabledChanged(): void;
     /**
      * The fill for the input boxes. If `"solid"` the input boxes will have a background. If
      * `"outline"` the input boxes will be transparent with a border.
@@ -180,6 +195,28 @@ export declare class InputOTP implements ComponentInterface {
      * If all of the input boxes are filled, it emits an `ionComplete` event.
      */
     private updateValue;
+    /**
+     * Gets the value of the input group as a string for form submission.
+     * Returns an empty string if the value is null or undefined.
+     */
+    private getValue;
+    /**
+     * Called when the form state is restored.
+     * Restores the component's value.
+     */
+    formStateRestoreCallback(value: string): void;
+    /**
+     * Called when the form is reset.
+     * Resets the component's value.
+     */
+    formResetCallback(): void;
+    /**
+     * Updates the form value and reports validity state to the browser via
+     * ElementInternals. This should be called when the component loads, when
+     * the disabled prop changes, and when the value changes to ensure the form
+     * value stays in sync and validation state is updated.
+     */
+    private updateElementInternals;
     /**
      * Emits an `ionChange` event.
      * This API should be called for user committed changes.

package/dist/types/components/input-password-toggle/input-password-toggle.d.ts

@@ -33,5 +33,7 @@ export declare class InputPasswordToggle implements ComponentInterface {
     connectedCallback(): void;
     disconnectedCallback(): void;
     private togglePasswordVisibility;
+    get inputPasswordHideIcon(): any;
+    get inputPasswordShowIcon(): any;
     render(): any;
 }

package/dist/types/components/item/item.d.ts

@@ -3,7 +3,8 @@ import type { AnchorInterface, ButtonInterface } from "../../utils/element-inter
 import type { AnimationBuilder, Color, StyleEventDetail } from '../../interface';
 import type { RouterDirection } from '../router/utils/interface';
 /**
- * @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.
  *
  * @slot - Content is placed between the named slots if provided without a slot.
  * @slot start - Content is placed to the left of the item text in LTR, and to the right in RTL.
@@ -33,14 +34,14 @@ export declare class Item implements ComponentInterface, AnchorInterface, Button
      */
     button: boolean;
     /**
-     * If `true`, a detail arrow will appear on the item. Defaults to `false` unless the `mode`
-     * is `ios` and an `href` or `button` property is present.
+     * If `true`, a detail arrow will appear on the item. Defaults to `false` unless the `theme`
+     * is `"ios"` and an `href` or `button` property is present.
      */
     detail?: boolean;
     /**
      * The icon to use when `detail` is set to `true`.
      */
-    detailIcon: string;
+    detailIcon?: string;
     /**
      * If `true`, the user cannot interact with the item.
      */
@@ -102,5 +103,11 @@ export declare class Item implements ComponentInterface, AnchorInterface, Button
     private isFocusable;
     private hasStartEl;
     private getFirstInteractive;
+    get itemDetailIcon(): any;
+    /**
+     * The icon should be flipped when the app is RTL and
+     * the icon is a variation of chevron.
+     */
+    get shouldFlipIcon(): boolean;
     render(): any;
 }

package/dist/types/components/item-divider/item-divider.d.ts

@@ -1,7 +1,8 @@
 import type { ComponentInterface } from '../../stencil-public-runtime';
 import type { Color } from '../../interface';
 /**
- * @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.
  *
  * @slot - Content is placed between the named slots if provided without a slot.
  * @slot start - Content is placed to the left of the divider text in LTR, and to the right in RTL.

package/dist/types/components/item-group/item-group.d.ts

@@ -1,4 +1,8 @@
 import type { ComponentInterface } from '../../stencil-public-runtime';
+/**
+ * @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 declare class ItemGroup implements ComponentInterface {
     render(): any;
 }

package/dist/types/components/item-option/item-option.d.ts

@@ -2,7 +2,8 @@ import type { ComponentInterface } from '../../stencil-public-runtime';
 import type { AnchorInterface, ButtonInterface } from "../../utils/element-interface";
 import type { Color } from '../../interface';
 /**
- * @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.
  *
  * @slot - Content is placed between the named slots if provided without a slot.
  * @slot start - Content is placed to the left of the option text in LTR, and to the right in RTL.
@@ -43,6 +44,13 @@ export declare class ItemOption implements ComponentInterface, AnchorInterface,
      * If this property is set, an anchor tag will be rendered.
      */
     href: string | undefined;
+    /**
+     * Set to `"bold"` for an option with vibrant, bold colors or to `"subtle"` for
+     * an option with muted, subtle colors.
+     *
+     * Only applies to the `ionic` theme.
+     */
+    hue?: 'bold' | 'subtle';
     /**
      * Specifies the relationship of the target object to the link object.
      * The value is a space-separated list of [link types](https://developer.mozilla.org/en-US/docs/Web/HTML/Link_types).
@@ -58,6 +66,15 @@ export declare class ItemOption implements ComponentInterface, AnchorInterface,
      * The type of the button.
      */
     type: 'submit' | 'reset' | 'button';
+    /**
+     * Set to `"rectangular"` for non-rounded corners.
+     * Set to `"soft"` for slightly rounded corners.
+     * Set to `"round"` for fully rounded corners.
+     *
+     * Defaults to `"round"` for the `ionic` theme, undefined for all other themes.
+     */
+    shape?: 'soft' | 'round' | 'rectangular';
     private onClick;
+    private getShape;
     render(): any;
 }

package/dist/types/components/item-options/item-options.d.ts

@@ -1,5 +1,9 @@
 import type { ComponentInterface, EventEmitter } from '../../stencil-public-runtime';
 import type { Side } from '../menu/menu-interface';
+/**
+ * @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 declare class ItemOptions implements ComponentInterface {
     el: HTMLElement;
     /**

package/dist/types/components/item-sliding/item-sliding.d.ts

@@ -8,6 +8,10 @@ declare const enum SlidingState {
     SwipeEnd = 32,
     SwipeStart = 64
 }
+/**
+ * @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 declare class ItemSliding implements ComponentInterface {
     private item;
     private openAmount;

package/dist/types/components/label/label.d.ts

@@ -1,7 +1,8 @@
 import type { ComponentInterface, EventEmitter } from '../../stencil-public-runtime';
 import type { Color, StyleEventDetail } from '../../interface';
 /**
- * @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 declare class Label implements ComponentInterface {
     private inRange;

package/dist/types/components/list/list.d.ts

@@ -1,6 +1,7 @@
 import type { ComponentInterface } from '../../stencil-public-runtime';
 /**
- * @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 declare class List implements ComponentInterface {
     el: HTMLElement;
@@ -12,6 +13,18 @@ export declare class List implements ComponentInterface {
      * If `true`, the list will have margin around it and rounded corners.
      */
     inset: boolean;
+    /**
+     * Set to `"soft"` for slightly rounded corners,
+     * `"round"` for fully rounded corners,
+     * or `"rectangular"` for no rounded corners.
+     *
+     * Defaults to `"round"` for the `ionic` theme
+     * when inset is `true`
+     * defaults to `"rectangular"` for the `ionic`
+     * theme when inset is `false`,
+     * undefined for all other themes.
+     */
+    shape?: 'soft' | 'round' | 'rectangular';
     /**
      * If `ion-item-sliding` are used inside the list, this method closes
      * any open sliding item.
@@ -19,5 +32,6 @@ export declare class List implements ComponentInterface {
      * Returns `true` if an actual `ion-item-sliding` is closed.
      */
     closeSlidingItems(): Promise<boolean>;
+    private getShape;
     render(): any;
 }

package/dist/types/components/list-header/list-header.d.ts

@@ -1,7 +1,8 @@
 import type { ComponentInterface } from '../../stencil-public-runtime';
 import type { Color } from '../../interface';
 /**
- * @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 inner - The inner wrapper element that arranges the list header content.
  */

package/dist/types/components/loading/loading-interface.d.ts

@@ -1,21 +1,16 @@
-import type { AnimationBuilder, Mode } from '../../interface';
+import type { OverlayOptions } from "../../utils/overlays-interface";
 import type { IonicSafeString } from '../../utils/sanitization';
 import type { SpinnerTypes } from '../spinner/spinner-configs';
-export interface LoadingOptions {
+export interface LoadingOptions extends OverlayOptions {
     spinner?: SpinnerTypes | null;
     message?: string | IonicSafeString;
     cssClass?: string | string[];
     showBackdrop?: boolean;
     duration?: number;
     translucent?: boolean;
-    animated?: boolean;
     backdropDismiss?: boolean;
-    mode?: Mode;
     keyboardClose?: boolean;
-    id?: string;
     htmlAttributes?: {
         [key: string]: any;
     };
-    enterAnimation?: AnimationBuilder;
-    leaveAnimation?: AnimationBuilder;
 }

package/dist/types/components/loading/loading.d.ts

@@ -4,7 +4,8 @@ import type { OverlayEventDetail } from '../../utils/overlays-interface';
 import type { IonicSafeString } from '../../utils/sanitization';
 import type { SpinnerTypes } from '../spinner/spinner-configs';
 /**
- * @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 declare class Loading implements ComponentInterface, OverlayInterface {
     private readonly delegateController;
@@ -65,7 +66,7 @@ export declare class Loading implements ComponentInterface, OverlayInterface {
     spinner?: SpinnerTypes | null;
     /**
      * If `true`, the loading indicator 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).
      */
     translucent: boolean;

package/dist/types/components/menu/menu.d.ts

@@ -1,6 +1,9 @@
 import type { ComponentInterface, EventEmitter } from '../../stencil-public-runtime';
 import type { MenuChangeEventDetail, MenuCloseEventDetail, MenuI, MenuType, Side } from './menu-interface';
 /**
+ * @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 container - The container for the menu content.
  * @part backdrop - The backdrop that appears over the main content when the menu is open.
  */

package/dist/types/components/menu-button/menu-button.d.ts

@@ -2,7 +2,8 @@ import type { ComponentInterface } from '../../stencil-public-runtime';
 import type { ButtonInterface } from "../../utils/element-interface";
 import type { Color } from '../../interface';
 /**
- * @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 menu button icon (uses ion-icon).
@@ -36,6 +37,7 @@ export declare class MenuButton implements ComponentInterface, ButtonInterface {
     componentWillLoad(): void;
     componentDidLoad(): void;
     visibilityChanged(): Promise<void>;
+    get menuIcon(): any;
     private onClick;
     render(): any;
 }

package/dist/types/components/menu-toggle/menu-toggle.d.ts

@@ -1,5 +1,8 @@
 import type { ComponentInterface } from '../../stencil-public-runtime';
 /**
+ * @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.
+ *
  * @slot - Content is placed inside the toggle to act as the click target.
  */
 export declare class MenuToggle implements ComponentInterface {

package/dist/types/components/modal/gestures/sheet.d.ts

@@ -29,7 +29,7 @@ export interface MoveSheetToBreakpointOptions {
      */
     animated: boolean;
 }
-export declare const createSheetGesture: (baseEl: HTMLIonModalElement, backdropEl: HTMLIonBackdropElement, wrapperEl: HTMLElement, initialBreakpoint: number, backdropBreakpoint: number, animation: Animation, breakpoints: number[] | undefined, expandToScroll: boolean, getCurrentBreakpoint: () => number, onDismiss: () => void, onBreakpointChange: (breakpoint: number) => void, onDragStart: () => void, onDragMove: (detail: ModalDragEventDetail) => void, onDragEnd: (detail: ModalDragEventDetail) => void) => {
+export declare const createSheetGesture: (baseEl: HTMLIonModalElement, backdropEl: HTMLIonBackdropElement, wrapperEl: HTMLElement, initialBreakpoint: number, backdropBreakpoint: number, animation: Animation, breakpoints: number[] | undefined, expandToScroll: boolean, getCurrentBreakpoint: () => number, onDismiss: () => void, onBreakpointChange: (breakpoint: number) => void, staticBackdropOpacity: boolean, onDragStart: () => void, onDragMove: (detail: ModalDragEventDetail) => void, onDragEnd: (detail: ModalDragEventDetail) => void) => {
     gesture: import("@utils/gesture").Gesture;
     moveSheetToBreakpoint: (options: MoveSheetToBreakpointOptions) => Promise<void>;
 };

package/dist/types/components/modal/modal-interface.d.ts

@@ -1,5 +1,6 @@
-import type { AnimationBuilder, ComponentProps, ComponentRef, FrameworkDelegate, Mode } from '../../interface';
-export interface ModalOptions<T extends ComponentRef = ComponentRef> {
+import type { OverlayOptions } from "../../utils/overlays-interface";
+import type { ComponentProps, ComponentRef, FrameworkDelegate } from '../../interface';
+export interface ModalOptions<T extends ComponentRef = ComponentRef> extends OverlayOptions {
     component: T;
     componentProps?: ComponentProps<T>;
     presentingElement?: HTMLElement;
@@ -7,17 +8,12 @@ export interface ModalOptions<T extends ComponentRef = ComponentRef> {
     backdropDismiss?: boolean;
     cssClass?: string | string[];
     delegate?: FrameworkDelegate;
-    animated?: boolean;
     canDismiss?: boolean | ((data?: any, role?: string) => Promise<boolean>);
     focusTrap?: boolean;
-    mode?: Mode;
     keyboardClose?: boolean;
-    id?: string;
     htmlAttributes?: {
         [key: string]: any;
     };
-    enterAnimation?: AnimationBuilder;
-    leaveAnimation?: AnimationBuilder;
     breakpoints?: number[];
     initialBreakpoint?: number;
     backdropBreakpoint?: number;
@@ -30,6 +26,7 @@ export interface ModalAnimationOptions {
     currentBreakpoint?: number;
     backdropBreakpoint?: number;
     expandToScroll: boolean;
+    staticBackdropOpacity?: boolean;
 }
 export interface ModalBreakpointChangeEventDetail {
     breakpoint: number;

package/dist/types/components/modal/modal.d.ts

@@ -3,7 +3,8 @@ import type { Animation, AnimationBuilder, ComponentProps, ComponentRef, Framewo
 import type { OverlayEventDetail } from '../../utils/overlays-interface';
 import type { ModalBreakpointChangeEventDetail, ModalHandleBehavior, ModalDragEventDetail } from './modal-interface';
 /**
- * @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.
  *
  * @slot - Content is placed inside of the `.modal-content` element.
  *
@@ -219,6 +220,14 @@ export declare class Modal implements ComponentInterface, OverlayInterface {
      * if you need to access `this` from within the callback.
      */
     canDismiss: boolean | ((data?: any, role?: string) => Promise<boolean>);
+    /**
+     * Set to `"soft"` for a modal with slightly rounded corners,
+     * `"round"` for a modal with fully rounded corners, or `"rectangular"`
+     * for a modal without rounded corners.
+     *
+     * Defaults to `"round"` for the `ionic` theme, undefined for all other themes.
+     */
+    shape?: 'soft' | 'round' | 'rectangular';
     /**
      * Emitted after the modal has presented.
      */
@@ -353,6 +362,7 @@ export declare class Modal implements ComponentInterface, OverlayInterface {
      */
     getCurrentBreakpoint(): Promise<number | undefined>;
     private moveToNextBreakpoint;
+    private getShape;
     private onHandleClick;
     private onBackdropTap;
     private onLifecycle;

package/dist/types/components/nav/nav-interface.d.ts

@@ -1,4 +1,4 @@
-import type { AnimationBuilder, ComponentProps, ComponentRef, FrameworkDelegate, Mode } from '../../interface';
+import type { AnimationBuilder, ComponentProps, ComponentRef, FrameworkDelegate, Mode, Theme } from '../../interface';
 import type { ViewController } from './view-controller';
 export type NavDirection = 'back' | 'forward';
 export type NavComponent = ComponentRef | ViewController;
@@ -26,7 +26,15 @@ export interface RouterOutletOptions {
     showGoBack?: boolean;
     direction?: NavDirection;
     deepWait?: boolean;
+    /**
+     * To change the default appearance of the component, use the `theme` option.
+     * Mode is used to change the platform behavior of the component.
+     */
     mode?: Mode;
+    /**
+     * The theme determines the visual appearance of the component.
+     */
+    theme?: Theme;
     keyboardClose?: boolean;
     skipIfBusy?: boolean;
     progressAnimation?: boolean;

package/dist/types/components/nav/nav.d.ts

@@ -3,6 +3,10 @@ import type { AnimationBuilder, ComponentProps, FrameworkDelegate } from '../../
 import type { NavOutlet, RouteID, RouteWrite, RouterDirection } from '../router/utils/interface';
 import type { NavComponent, NavComponentWithProps, NavOptions, TransitionDoneFn } from './nav-interface';
 import type { ViewController } from './view-controller';
+/**
+ * @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 declare class Nav implements NavOutlet {
     private transInstr;
     private sbAni?;
@@ -26,7 +30,7 @@ export declare class Nav implements NavOutlet {
      */
     animated: boolean;
     /**
-     * By default `ion-nav` animates transition between pages based in the mode (ios or material design).
+     * By default `ion-nav` animates transition between pages based on the mode ("ios" or "md").
      * However, this property allows to create custom transition using `AnimationBuilder` functions.
      */
     animation?: AnimationBuilder;

package/dist/types/components/nav-link/nav-link.d.ts

@@ -2,6 +2,10 @@ import type { ComponentInterface } from '../../stencil-public-runtime';
 import type { AnimationBuilder, ComponentProps } from '../../interface';
 import type { NavComponent } from '../nav/nav-interface';
 import type { RouterDirection } from '../router/utils/interface';
+/**
+ * @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 declare class NavLink implements ComponentInterface {
     el: HTMLElement;
     /**

package/dist/types/components/note/note.d.ts

@@ -1,7 +1,8 @@
 import type { ComponentInterface } from '../../stencil-public-runtime';
 import type { Color } from '../../interface';
 /**
- * @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 declare class Note implements ComponentInterface {
     /**

package/dist/types/components/picker/picker.d.ts

@@ -1,7 +1,8 @@
 import type { ComponentInterface, EventEmitter } from '../../stencil-public-runtime';
 import type { PickerChangeEventDetail } from './picker-interfaces';
 /**
- * @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 declare class Picker implements ComponentInterface {
     private inputEl?;

package/dist/types/components/picker-column/picker-column.d.ts

@@ -2,7 +2,8 @@ import type { ComponentInterface, EventEmitter } from '../../stencil-public-runt
 import type { Color } from '../../interface';
 import type { PickerColumnChangeEventDetail, PickerColumnValue } from './picker-column-interfaces';
 /**
- * @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.
  *
  * @slot prefix - Content to show on the left side of the picker options.
  * @slot suffix - Content to show on the right side of the picker options.

package/dist/types/components/picker-column-option/picker-column-option.d.ts

@@ -1,5 +1,9 @@
 import type { ComponentInterface } from '../../stencil-public-runtime';
 import type { Color } from '../../interface';
+/**
+ * @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 declare class PickerColumnOption implements ComponentInterface {
     /**
      * We keep track of the parent picker column

package/dist/types/components/picker-legacy/picker.d.ts

@@ -3,7 +3,8 @@ import type { AnimationBuilder, OverlayInterface, FrameworkDelegate } from '../.
 import type { OverlayEventDetail } from '../../utils/overlays-interface';
 import type { PickerButton, PickerColumn } from './picker-interface';
 /**
- * @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 declare class Picker implements ComponentInterface, OverlayInterface {
     private readonly delegateController;