From 6e477b743e41b2b37627c8208901704f599b762a Mon Sep 17 00:00:00 2001
From: Liam DeBeasi <liamdebeasi@users.noreply.github.com>
Date: Fri, 22 Mar 2024 09:13:15 -0400
Subject: [PATCH 1/2] refactor(searchbar): autocapitalize defaults to off
 (#29107)

BREAKING CHANGE: The `autocapitalize` property on Searchbar now defaults to `'off'`.
---
 BREAKING.md                                 |  5 +++++
 core/api.txt                                |  2 +-
 core/src/components.d.ts                    |  2 +-
 core/src/components/searchbar/searchbar.tsx | 17 +----------------
 4 files changed, 8 insertions(+), 18 deletions(-)

diff --git a/BREAKING.md b/BREAKING.md
index 7b9eb8dc67..bf44f563dc 100644
--- a/BREAKING.md
+++ b/BREAKING.md
@@ -30,6 +30,7 @@ This is a comprehensive list of the breaking changes introduced in the major ver
   - [Progress bar](#version-8x-progress-bar)
   - [Radio](#version-8x-radio)
   - [Range](#version-8x-range)
+  - [Searchbar](#version-8x-searchbar)
   - [Select](#version-8x-select)
   - [Textarea](#version-8x-textarea)
   - [Toggle](#version-8x-toggle)
@@ -264,6 +265,10 @@ For more information on styling toast buttons, refer to the [Toast Theming docum
 
 - The `legacy` property and support for the legacy syntax, which involved placing an `ion-range` inside of an `ion-item` with an `ion-label`, have been removed. Ionic will also no longer attempt to automatically associate form controls with sibling `<label>` elements as these label elements are now used inside the form control. Developers should provide a label (either visible text or `aria-label`) directly to the form control. For more information on migrating from the legacy range syntax, refer to the [Range documentation](https://ionicframework.com/docs/api/range#migrating-from-legacy-range-syntax).
 
+<h4 id="version-8x-searchbar">Searchbar</h4>
+
+- The `autocapitalize` property now defaults to `'off'`.
+
 <h4 id="version-8x-select">Select</h4>
 
 - The `legacy` property and support for the legacy syntax, which involved placing an `ion-select` inside of an `ion-item` with an `ion-label`, have been removed. Ionic will also no longer attempt to automatically associate form controls with sibling `<label>` elements as these label elements are now used inside the form control. Developers should provide a label (either visible text or `aria-label`) directly to the form control. For more information on migrating from the legacy select syntax, refer to the [Select documentation](https://ionicframework.com/docs/api/select#migrating-from-legacy-select-syntax).
diff --git a/core/api.txt b/core/api.txt
index b6b11321b6..4c25d93691 100644
--- a/core/api.txt
+++ b/core/api.txt
@@ -1166,7 +1166,7 @@ ion-row,shadow
 
 ion-searchbar,scoped
 ion-searchbar,prop,animated,boolean,false,false,false
-ion-searchbar,prop,autocapitalize,string,undefined,true,false
+ion-searchbar,prop,autocapitalize,string,'off',false,false
 ion-searchbar,prop,autocomplete,"name" | "email" | "tel" | "url" | "on" | "off" | "honorific-prefix" | "given-name" | "additional-name" | "family-name" | "honorific-suffix" | "nickname" | "username" | "new-password" | "current-password" | "one-time-code" | "organization-title" | "organization" | "street-address" | "address-line1" | "address-line2" | "address-line3" | "address-level4" | "address-level3" | "address-level2" | "address-level1" | "country" | "country-name" | "postal-code" | "cc-name" | "cc-given-name" | "cc-additional-name" | "cc-family-name" | "cc-number" | "cc-exp" | "cc-exp-month" | "cc-exp-year" | "cc-csc" | "cc-type" | "transaction-currency" | "transaction-amount" | "language" | "bday" | "bday-day" | "bday-month" | "bday-year" | "sex" | "tel-country-code" | "tel-national" | "tel-area-code" | "tel-local" | "tel-extension" | "impp" | "photo",'off',false,false
 ion-searchbar,prop,autocorrect,"off" | "on",'off',false,false
 ion-searchbar,prop,cancelButtonIcon,string,config.get('backButtonIcon', arrowBackSharp) as string,false,false
diff --git a/core/src/components.d.ts b/core/src/components.d.ts
index 7de5e38e49..2726c41739 100644
--- a/core/src/components.d.ts
+++ b/core/src/components.d.ts
@@ -7213,7 +7213,7 @@ declare namespace LocalJSX {
         /**
           * Indicates whether and how the text value should be automatically capitalized as it is entered/edited by the user. Available options: `"off"`, `"none"`, `"on"`, `"sentences"`, `"words"`, `"characters"`.
          */
-        "autocapitalize": string;
+        "autocapitalize"?: string;
         /**
           * Set the input's autocomplete property.
          */
diff --git a/core/src/components/searchbar/searchbar.tsx b/core/src/components/searchbar/searchbar.tsx
index cf48cf4a04..d218bcaaa6 100644
--- a/core/src/components/searchbar/searchbar.tsx
+++ b/core/src/components/searchbar/searchbar.tsx
@@ -78,26 +78,11 @@ export class Searchbar implements ComponentInterface {
    */
   @Prop() animated = false;
 
-  /**
-   * Prior to the addition of this property
-   * autocapitalize was enabled by default on iOS
-   * and disabled by default on Android
-   * for Searchbar. The autocapitalize type on HTMLElement
-   * requires that it be a string and never undefined.
-   * However, setting it to a string value would be a breaking change
-   * in behavior, so we use "!" to tell TypeScript that this property
-   * is always defined so we can rely on the browser defaults. Browsers
-   * will automatically set a default value if the developer does not set one.
-   *
-   * In the future, this property will default to "off" to align with
-   * Input and Textarea, and the "!" will not be needed.
-   */
-
   /**
    * Indicates whether and how the text value should be automatically capitalized as it is entered/edited by the user.
    * Available options: `"off"`, `"none"`, `"on"`, `"sentences"`, `"words"`, `"characters"`.
    */
-  @Prop() autocapitalize!: string;
+  @Prop() autocapitalize: string = 'off';
 
   /**
    * Set the input's autocomplete property.

From 6c500fd6b2e2553c11fcddc9d86ac9a29f76e172 Mon Sep 17 00:00:00 2001
From: Liam DeBeasi <liamdebeasi@users.noreply.github.com>
Date: Mon, 25 Mar 2024 13:22:06 -0400
Subject: [PATCH 2/2] feat(input): add input-password-toggle component (#29175)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Issue number: Internal

---------

<!-- Please do not submit updates to dependencies unless it fixes an
issue. -->

<!-- Please try to limit your pull request to one type (bugfix, feature,
etc). Submit multiple pull requests if needed. -->

## What is the current behavior?
<!-- Please describe the current behavior that you are modifying. -->

When given a password input it is hard to know what users are typing as
the contents of the input are obscured. As a result, it is a common
pattern to have a button that lets users temporarily toggle the
visibility of the password so they can correct any mistakes. Ionic
currently has the infrastructure for developers to implement this on
their own, but this use case is so common that the team thinks it is
worth having this functionality built-in to Ionic.

## What is the new behavior?
<!-- Please describe the behavior or changes that are being added by
this PR. -->

- Introduces the `ion-input-password-toggle` component. This component
is a button that toggles the visibility of the text in the input it is
slotted into.

## Does this introduce a breaking change?

- [ ] Yes
- [x] No

<!--
  If this introduces a breaking change:
1. Describe the impact and migration path for existing applications
below.
  2. Update the BREAKING.md file with the breaking change.
3. Add "BREAKING CHANGE: [...]" to the commit description when merging.
See
https://github.com/ionic-team/ionic-framework/blob/main/.github/CONTRIBUTING.md#footer
for more information.
-->


## Other information

<!-- Any other information that is important to this PR such as
screenshots of how the component looks before and after the change. -->


⚠️ Give co-author credit to
https://github.com/ionic-team/ionic-framework/pull/29141 on merge.

Docs PR: https://github.com/ionic-team/ionic-docs/pull/3541

Note: We did not do the approach listed in the other PR due to
https://github.com/ionic-team/ionic-framework/pull/29141#discussion_r1523631811.

---------

Co-authored-by: OS-giulianasilva <OS-giulianasilva@users.noreply.github.com>
---
 core/api.txt                                  |  10 +-
 core/src/components.d.ts                      |  47 ++++++
 ...lert-scale-ios-ltr-Mobile-Chrome-linux.png | Bin 17550 -> 17541 bytes
 .../input-password-toggle.scss                |   0
 .../input-password-toggle.tsx                 | 152 ++++++++++++++++++
 .../test/a11y/input-password-toggle.e2e.ts    |  23 +++
 .../test/basic/index.html                     |  76 +++++++++
 .../test/basic/input-password-toggle.e2e.ts   |  50 ++++++
 ...ord-toggle-ios-ltr-Mobile-Chrome-linux.png | Bin 0 -> 719 bytes
 ...rd-toggle-ios-ltr-Mobile-Firefox-linux.png | Bin 0 -> 748 bytes
 ...ord-toggle-ios-ltr-Mobile-Safari-linux.png | Bin 0 -> 624 bytes
 .../test/input-password-toggle.spec.tsx       | 115 +++++++++++++
 core/src/components/input/input.scss          |   9 ++
 core/src/components/input/input.tsx           |  26 ++-
 .../angular/src/directives/proxies-list.ts    |   1 +
 packages/angular/src/directives/proxies.ts    |  22 +++
 .../standalone/src/directives/proxies.ts      |  25 +++
 packages/react/src/components/proxies.ts      |   2 +
 packages/vue/src/proxies.ts                   |   9 ++
 19 files changed, 563 insertions(+), 4 deletions(-)
 create mode 100644 core/src/components/input-password-toggle/input-password-toggle.scss
 create mode 100644 core/src/components/input-password-toggle/input-password-toggle.tsx
 create mode 100644 core/src/components/input-password-toggle/test/a11y/input-password-toggle.e2e.ts
 create mode 100644 core/src/components/input-password-toggle/test/basic/index.html
 create mode 100644 core/src/components/input-password-toggle/test/basic/input-password-toggle.e2e.ts
 create mode 100644 core/src/components/input-password-toggle/test/basic/input-password-toggle.e2e.ts-snapshots/input-password-toggle-ios-ltr-Mobile-Chrome-linux.png
 create mode 100644 core/src/components/input-password-toggle/test/basic/input-password-toggle.e2e.ts-snapshots/input-password-toggle-ios-ltr-Mobile-Firefox-linux.png
 create mode 100644 core/src/components/input-password-toggle/test/basic/input-password-toggle.e2e.ts-snapshots/input-password-toggle-ios-ltr-Mobile-Safari-linux.png
 create mode 100644 core/src/components/input-password-toggle/test/input-password-toggle.spec.tsx

diff --git a/core/api.txt b/core/api.txt
index 4c25d93691..f4fe3f9290 100644
--- a/core/api.txt
+++ b/core/api.txt
@@ -558,7 +558,7 @@ ion-input,prop,color,"danger" | "dark" | "light" | "medium" | "primary" | "secon
 ion-input,prop,counter,boolean,false,false,false
 ion-input,prop,counterFormatter,((inputLength: number, maxLength: number) => string) | undefined,undefined,false,false
 ion-input,prop,debounce,number | undefined,undefined,false,false
-ion-input,prop,disabled,boolean,false,false,false
+ion-input,prop,disabled,boolean,false,false,true
 ion-input,prop,enterkeyhint,"done" | "enter" | "go" | "next" | "previous" | "search" | "send" | undefined,undefined,false,false
 ion-input,prop,errorText,string | undefined,undefined,false,false
 ion-input,prop,fill,"outline" | "solid" | undefined,undefined,false,false
@@ -575,7 +575,7 @@ ion-input,prop,multiple,boolean | undefined,undefined,false,false
 ion-input,prop,name,string,this.inputId,false,false
 ion-input,prop,pattern,string | undefined,undefined,false,false
 ion-input,prop,placeholder,string | undefined,undefined,false,false
-ion-input,prop,readonly,boolean,false,false,false
+ion-input,prop,readonly,boolean,false,false,true
 ion-input,prop,required,boolean,false,false,false
 ion-input,prop,shape,"round" | undefined,undefined,false,false
 ion-input,prop,spellcheck,boolean,false,false,false
@@ -607,6 +607,12 @@ ion-input,css-prop,--placeholder-font-style
 ion-input,css-prop,--placeholder-font-weight
 ion-input,css-prop,--placeholder-opacity
 
+ion-input-password-toggle,shadow
+ion-input-password-toggle,prop,color,"danger" | "dark" | "light" | "medium" | "primary" | "secondary" | "success" | "tertiary" | "warning" | string & Record<never, never> | undefined,undefined,false,true
+ion-input-password-toggle,prop,hideIcon,string | undefined,undefined,false,false
+ion-input-password-toggle,prop,mode,"ios" | "md",undefined,false,false
+ion-input-password-toggle,prop,showIcon,string | undefined,undefined,false,false
+
 ion-item,shadow
 ion-item,prop,button,boolean,false,false,false
 ion-item,prop,color,"danger" | "dark" | "light" | "medium" | "primary" | "secondary" | "success" | "tertiary" | "warning" | string & Record<never, never> | undefined,undefined,false,true
diff --git a/core/src/components.d.ts b/core/src/components.d.ts
index 2726c41739..4b85721b49 100644
--- a/core/src/components.d.ts
+++ b/core/src/components.d.ts
@@ -1287,6 +1287,25 @@ export namespace Components {
          */
         "value"?: string | number | null;
     }
+    interface IonInputPasswordToggle {
+        /**
+          * The color to use from your application's color palette. Default options are: `"primary"`, `"secondary"`, `"tertiary"`, `"success"`, `"warning"`, `"danger"`, `"light"`, `"medium"`, and `"dark"`. For more information on colors, see [theming](/docs/theming/basics).
+         */
+        "color"?: Color;
+        /**
+          * The icon that can be used to represent hiding a password. If not set, the "eyeOff" Ionicon will be used.
+         */
+        "hideIcon"?: string;
+        /**
+          * The mode determines which platform styles to use.
+         */
+        "mode"?: "ios" | "md";
+        /**
+          * The icon that can be used to represent showing a password. If not set, the "eye" Ionicon will be used.
+         */
+        "showIcon"?: string;
+        "type": TextFieldTypes;
+    }
     interface IonItem {
         /**
           * If `true`, a button tag will be rendered and the item will be tappable.
@@ -3811,6 +3830,12 @@ declare global {
         prototype: HTMLIonInputElement;
         new (): HTMLIonInputElement;
     };
+    interface HTMLIonInputPasswordToggleElement extends Components.IonInputPasswordToggle, HTMLStencilElement {
+    }
+    var HTMLIonInputPasswordToggleElement: {
+        prototype: HTMLIonInputPasswordToggleElement;
+        new (): HTMLIonInputPasswordToggleElement;
+    };
     interface HTMLIonItemElement extends Components.IonItem, HTMLStencilElement {
     }
     var HTMLIonItemElement: {
@@ -4635,6 +4660,7 @@ declare global {
         "ion-infinite-scroll": HTMLIonInfiniteScrollElement;
         "ion-infinite-scroll-content": HTMLIonInfiniteScrollContentElement;
         "ion-input": HTMLIonInputElement;
+        "ion-input-password-toggle": HTMLIonInputPasswordToggleElement;
         "ion-item": HTMLIonItemElement;
         "ion-item-divider": HTMLIonItemDividerElement;
         "ion-item-group": HTMLIonItemGroupElement;
@@ -5993,6 +6019,25 @@ declare namespace LocalJSX {
          */
         "value"?: string | number | null;
     }
+    interface IonInputPasswordToggle {
+        /**
+          * The color to use from your application's color palette. Default options are: `"primary"`, `"secondary"`, `"tertiary"`, `"success"`, `"warning"`, `"danger"`, `"light"`, `"medium"`, and `"dark"`. For more information on colors, see [theming](/docs/theming/basics).
+         */
+        "color"?: Color;
+        /**
+          * The icon that can be used to represent hiding a password. If not set, the "eyeOff" Ionicon will be used.
+         */
+        "hideIcon"?: string;
+        /**
+          * The mode determines which platform styles to use.
+         */
+        "mode"?: "ios" | "md";
+        /**
+          * The icon that can be used to represent showing a password. If not set, the "eye" Ionicon will be used.
+         */
+        "showIcon"?: string;
+        "type"?: TextFieldTypes;
+    }
     interface IonItem {
         /**
           * If `true`, a button tag will be rendered and the item will be tappable.
@@ -8040,6 +8085,7 @@ declare namespace LocalJSX {
         "ion-infinite-scroll": IonInfiniteScroll;
         "ion-infinite-scroll-content": IonInfiniteScrollContent;
         "ion-input": IonInput;
+        "ion-input-password-toggle": IonInputPasswordToggle;
         "ion-item": IonItem;
         "ion-item-divider": IonItemDivider;
         "ion-item-group": IonItemGroup;
@@ -8138,6 +8184,7 @@ declare module "@stencil/core" {
             "ion-infinite-scroll": LocalJSX.IonInfiniteScroll & JSXBase.HTMLAttributes<HTMLIonInfiniteScrollElement>;
             "ion-infinite-scroll-content": LocalJSX.IonInfiniteScrollContent & JSXBase.HTMLAttributes<HTMLIonInfiniteScrollContentElement>;
             "ion-input": LocalJSX.IonInput & JSXBase.HTMLAttributes<HTMLIonInputElement>;
+            "ion-input-password-toggle": LocalJSX.IonInputPasswordToggle & JSXBase.HTMLAttributes<HTMLIonInputPasswordToggleElement>;
             "ion-item": LocalJSX.IonItem & JSXBase.HTMLAttributes<HTMLIonItemElement>;
             "ion-item-divider": LocalJSX.IonItemDivider & JSXBase.HTMLAttributes<HTMLIonItemDividerElement>;
             "ion-item-group": LocalJSX.IonItemGroup & JSXBase.HTMLAttributes<HTMLIonItemGroupElement>;
diff --git a/core/src/components/alert/test/a11y/alert.e2e.ts-snapshots/alert-scale-ios-ltr-Mobile-Chrome-linux.png b/core/src/components/alert/test/a11y/alert.e2e.ts-snapshots/alert-scale-ios-ltr-Mobile-Chrome-linux.png
index d838af9af88f964d8d720d8922b0d549f3498d9e..88c0d8e8f60d79d25228a0f457585ed5325c0867 100644
GIT binary patch
delta 13540
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
T`wdN`|J6{_d4N%Q`uhI?_UYVq

delta 13520
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
P@NcNAXe$>hK6?2-9=^ch

diff --git a/core/src/components/input-password-toggle/input-password-toggle.scss b/core/src/components/input-password-toggle/input-password-toggle.scss
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/core/src/components/input-password-toggle/input-password-toggle.tsx b/core/src/components/input-password-toggle/input-password-toggle.tsx
new file mode 100644
index 0000000000..a783cfc9af
--- /dev/null
+++ b/core/src/components/input-password-toggle/input-password-toggle.tsx
@@ -0,0 +1,152 @@
+import type { ComponentInterface } from '@stencil/core';
+import { Component, Element, Host, Prop, h, Watch } from '@stencil/core';
+import { printIonWarning } from '@utils/logging';
+import { createColorClasses } from '@utils/theme';
+import { eyeOff, eye } from 'ionicons/icons';
+
+import { getIonMode } from '../../global/ionic-global';
+import type { Color, TextFieldTypes } from '../../interface';
+
+/**
+ * @virtualProp {"ios" | "md"} mode - The mode determines which platform styles to use.
+ */
+@Component({
+  tag: 'ion-input-password-toggle',
+  /**
+   * Empty CSS files are required in order for the mode to be inherited to the
+   * inner ion-button. Otherwise, the setMode callback provided to Stencil will not get called
+   * and we will default to MD mode.
+   */
+  styleUrls: {
+    ios: 'input-password-toggle.scss',
+    md: 'input-password-toggle.scss',
+  },
+  shadow: true,
+})
+export class InputPasswordToggle implements ComponentInterface {
+  private inputElRef!: HTMLIonInputElement | null;
+
+  @Element() el!: HTMLIonInputElement;
+
+  /**
+   * The color to use from your application's color palette.
+   * Default options are: `"primary"`, `"secondary"`, `"tertiary"`, `"success"`, `"warning"`, `"danger"`, `"light"`, `"medium"`, and `"dark"`.
+   * For more information on colors, see [theming](/docs/theming/basics).
+   */
+  @Prop({ reflect: true }) color?: Color;
+
+  /**
+   * The icon that can be used to represent showing a password. If not set, the "eye" Ionicon will be used.
+   */
+  @Prop() showIcon?: string;
+
+  /**
+   * The icon that can be used to represent hiding a password. If not set, the "eyeOff" Ionicon will be used.
+   */
+  @Prop() hideIcon?: string;
+
+  /**
+   * @internal
+   */
+  @Prop({ mutable: true }) type: TextFieldTypes = 'password';
+
+  /**
+   * Whenever the input type changes we need to re-run validation to ensure the password
+   * toggle is being used with the correct input type. If the application changes the type
+   * outside of this component we also need to re-render so the correct icon is shown.
+   */
+  @Watch('type')
+  onTypeChange(newValue: TextFieldTypes) {
+    if (newValue !== 'text' && newValue !== 'password') {
+      printIonWarning(
+        `ion-input-password-toggle only supports inputs of type "text" or "password". Input of type "${newValue}" is not compatible.`,
+        this.el
+      );
+
+      return;
+    }
+  }
+
+  connectedCallback() {
+    const { el } = this;
+
+    const inputElRef = (this.inputElRef = el.closest('ion-input'));
+
+    if (!inputElRef) {
+      printIonWarning(
+        'No ancestor ion-input found for ion-input-password-toggle. This component must be slotted inside of an ion-input.',
+        el
+      );
+
+      return;
+    }
+
+    /**
+     * Important: Set the type in connectedCallback because the default value
+     * of this.type may not always be accurate. Usually inputs have the "password" type
+     * but it is possible to have the input to initially have the "text" type. In that scenario
+     * the wrong icon will show briefly before switching to the correct icon. Setting the
+     * type here allows us to avoid that flicker.
+     */
+    this.type = inputElRef.type;
+  }
+
+  disconnectedCallback() {
+    this.inputElRef = null;
+  }
+
+  private togglePasswordVisibility = () => {
+    const { inputElRef } = this;
+
+    if (!inputElRef) {
+      return;
+    }
+
+    inputElRef.type = inputElRef.type === 'text' ? 'password' : 'text';
+  };
+
+  render() {
+    const { color, type } = this;
+
+    const mode = getIonMode(this);
+
+    const showPasswordIcon = this.showIcon ?? eye;
+    const hidePasswordIcon = this.hideIcon ?? eyeOff;
+
+    const isPasswordVisible = type === 'text';
+
+    return (
+      <Host
+        class={createColorClasses(color, {
+          [mode]: true,
+        })}
+      >
+        <ion-button
+          mode={mode}
+          color={color}
+          fill="clear"
+          shape="round"
+          aria-checked={isPasswordVisible ? 'true' : 'false'}
+          aria-label="show password"
+          role="switch"
+          type="button"
+          onPointerDown={(ev) => {
+            /**
+             * This prevents mobile browsers from
+             * blurring the input when the password toggle
+             * button is activated.
+             */
+            ev.preventDefault();
+          }}
+          onClick={this.togglePasswordVisibility}
+        >
+          <ion-icon
+            slot="icon-only"
+            aria-hidden="true"
+            icon={isPasswordVisible ? hidePasswordIcon : showPasswordIcon}
+          ></ion-icon>
+        </ion-button>
+      </Host>
+    );
+  }
+}
diff --git a/core/src/components/input-password-toggle/test/a11y/input-password-toggle.e2e.ts b/core/src/components/input-password-toggle/test/a11y/input-password-toggle.e2e.ts
new file mode 100644
index 0000000000..76b9f3d283
--- /dev/null
+++ b/core/src/components/input-password-toggle/test/a11y/input-password-toggle.e2e.ts
@@ -0,0 +1,23 @@
+import AxeBuilder from '@axe-core/playwright';
+import { expect } from '@playwright/test';
+import { configs, test } from '@utils/test/playwright';
+
+configs({ directions: ['ltr'] }).forEach(({ title, config }) => {
+  test.describe(title('input password toggle: a11y'), () => {
+    test('should not have accessibility violations', async ({ page }) => {
+      await page.setContent(
+        `
+          <main>
+            <ion-input label="input" type="password">
+              <ion-input-password-toggle slot="end"></ion-input-password-toggle>
+            </ion-input>
+          </main>
+        `,
+        config
+      );
+
+      const results = await new AxeBuilder({ page }).analyze();
+      expect(results.violations).toEqual([]);
+    });
+  });
+});
diff --git a/core/src/components/input-password-toggle/test/basic/index.html b/core/src/components/input-password-toggle/test/basic/index.html
new file mode 100644
index 0000000000..e4232be7fc
--- /dev/null
+++ b/core/src/components/input-password-toggle/test/basic/index.html
@@ -0,0 +1,76 @@
+<!DOCTYPE html>
+<html lang="en" dir="ltr">
+  <head>
+    <meta charset="UTF-8" />
+    <title>Input - Toggle Password</title>
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no"
+    />
+    <link href="../../../../../css/ionic.bundle.css" rel="stylesheet" />
+    <link href="../../../../../scripts/testing/styles.css" rel="stylesheet" />
+    <script src="../../../../../scripts/testing/scripts.js"></script>
+    <script nomodule src="../../../../../dist/ionic/ionic.js"></script>
+    <script type="module" src="../../../../../dist/ionic/ionic.esm.js"></script>
+    <style>
+      .grid {
+        display: grid;
+        grid-template-columns: repeat(5, minmax(250px, 1fr));
+        grid-row-gap: 20px;
+        grid-column-gap: 20px;
+      }
+      h2 {
+        font-size: 12px;
+        font-weight: normal;
+
+        color: #6f7378;
+
+        margin-top: 10px;
+      }
+      @media screen and (max-width: 800px) {
+        .grid {
+          grid-template-columns: 1fr;
+          padding: 0;
+        }
+      }
+    </style>
+  </head>
+
+  <body>
+    <ion-app>
+      <ion-header>
+        <ion-toolbar>
+          <ion-title>Input - Basic</ion-title>
+        </ion-toolbar>
+      </ion-header>
+
+      <ion-content id="content" class="ion-padding">
+        <div class="grid">
+          <div class="grid-item">
+            <h2>Default</h2>
+            <ion-input type="password" value="supersecurepassword" label="Password">
+              <ion-input-password-toggle slot="end"></ion-input-password-toggle>
+            </ion-input>
+          </div>
+          <div class="grid-item">
+            <h2>Custom Icon</h2>
+            <ion-input type="password" value="supersecurepassword" label="Password">
+              <ion-input-password-toggle show-icon="trash" slot="end"></ion-input-password-toggle>
+            </ion-input>
+          </div>
+          <div class="grid-item">
+            <h2>Custom Mode/Color</h2>
+            <ion-input type="password" value="supersecurepassword" label="Password">
+              <ion-input-password-toggle
+                color="danger"
+                mode="ios"
+                show-icon="trash"
+                slot="end"
+              ></ion-input-password-toggle>
+            </ion-input>
+          </div>
+        </div>
+      </ion-content>
+    </ion-app>
+  </body>
+</html>
diff --git a/core/src/components/input-password-toggle/test/basic/input-password-toggle.e2e.ts b/core/src/components/input-password-toggle/test/basic/input-password-toggle.e2e.ts
new file mode 100644
index 0000000000..637c9ac3c4
--- /dev/null
+++ b/core/src/components/input-password-toggle/test/basic/input-password-toggle.e2e.ts
@@ -0,0 +1,50 @@
+import { expect } from '@playwright/test';
+import { configs, test } from '@utils/test/playwright';
+
+configs({ modes: ['ios'], directions: ['ltr'] }).forEach(({ title, screenshot, config }) => {
+  test.describe(title('input password toggle: states'), () => {
+    test('should be hidden when inside of a readonly input', async ({ page }) => {
+      await page.setContent(
+        `
+          <ion-input label="input" type="password" readonly="true">
+            <ion-input-password-toggle slot="end"></ion-input-password-toggle>
+          </ion-input>
+        `,
+        config
+      );
+
+      const inputPasswordToggle = page.locator('ion-input-password-toggle');
+      await expect(inputPasswordToggle).toBeHidden();
+    });
+    test('should be hidden when inside of a disabled input', async ({ page }) => {
+      await page.setContent(
+        `
+          <ion-input label="input" type="password" disabled="true">
+            <ion-input-password-toggle slot="end"></ion-input-password-toggle>
+          </ion-input>
+        `,
+        config
+      );
+
+      const inputPasswordToggle = page.locator('ion-input-password-toggle');
+      await expect(inputPasswordToggle).toBeHidden();
+    });
+  });
+
+  test.describe(title('input password toggle: rendering'), () => {
+    test('should not have visual regressions', async ({ page }) => {
+      await page.setContent(
+        `
+          <ion-input label="input" type="password">
+            <ion-input-password-toggle slot="end"></ion-input-password-toggle>
+          </ion-input>
+        `,
+        config
+      );
+
+      const inputPasswordToggle = page.locator('ion-input-password-toggle');
+
+      await expect(inputPasswordToggle).toHaveScreenshot(screenshot('input-password-toggle'));
+    });
+  });
+});
diff --git a/core/src/components/input-password-toggle/test/basic/input-password-toggle.e2e.ts-snapshots/input-password-toggle-ios-ltr-Mobile-Chrome-linux.png b/core/src/components/input-password-toggle/test/basic/input-password-toggle.e2e.ts-snapshots/input-password-toggle-ios-ltr-Mobile-Chrome-linux.png
new file mode 100644
index 0000000000000000000000000000000000000000..4861e066bab0ad5898ac4cfcadfc5f77518ef563
GIT binary patch
literal 719
zcmV;=0x<oFP)<h;3K|Lk000e1NJLTq001cf001or1^@s6Gx0*;00001b5ch_0Itp)
z=>Px%iAh93R9J=WmP<%fQ5b-~d*{(Sv}w$oB1NU5MV1v&K?}_uphjRsv<WM0QD6y$
zVJ_NawyBl0N{SX`CAzQ{1=1pWXc0vafnsGwjjyqsnujy@wlJr;nlO(e7Tj<7pUXKP
z|9}4bA4yeJm46(0t_5O2mlTCADGFUu6uP7+bV*U@lA_QhMPU@Rk)pu;S3y1whWR?G
z5LP6%=9ws5WkOCe6;iT~UR8yrjsUecy}Ta?gA~08IT<o1itSXESTPvpK+@}j@`i7;
zbOolEqm>0V<eF%yc94}Ge_9ik{NPq7t@rTub2t(^w$n<*HY>|qM*4=sG<5{1YxPFf
zGo3PRH49jq8{aKUNOELMWmAoZ9(O1bJH6XRRjHk;4}Em@gvie}aHz;i+w%a&uZ=~%
zbJ`@jE-YmElGrmEx1^##;aLxl-i>SGy$$I!w)?1S{Sk>(6j`}^Bo*`i0ZsW=xQukx
zJ8`B?xf3%G_XWB0G%!sN6*ALgnxFYK;kz$`jE5%598I@7#Fchm%xA_exn-q^#f~X$
zDnZ|{!rsjmO?cOOGe!gSdlXIFW`g2%^JY&nGhL>w#xc>sQQUs)r?SLGRf&zIX$B4!
zSU9uCPE&_}TBkRkbdr}H`~N86?!NaT$i7RX{QO<{6pKV{nVka#7F-UQ;W3q4PyC!~
z@iO@R&k>DB=X1EoGV{hFB>}p+LzJHPFyxKeLWR{?Cf<A+*JRLchSusdcI3xD<dU8^
zUq%#8UH5Y1FJ+ySF576~VtER=uEgeJ(vp+(4=Fr&9i-PCMv^9Ma~8>LUt=aaBe~%%
zOma5)FP>_;q$qSrQRtGQ&?QBoONv656ooD+ieDzG;5<H+*uDS&002ovPDHLkV1jcP
BMe+au

literal 0
HcmV?d00001

diff --git a/core/src/components/input-password-toggle/test/basic/input-password-toggle.e2e.ts-snapshots/input-password-toggle-ios-ltr-Mobile-Firefox-linux.png b/core/src/components/input-password-toggle/test/basic/input-password-toggle.e2e.ts-snapshots/input-password-toggle-ios-ltr-Mobile-Firefox-linux.png
new file mode 100644
index 0000000000000000000000000000000000000000..d8fd77a74468225c027a3d07e7d387ae97b1686a
GIT binary patch
literal 748
zcmV<I0u%j-P)<h;3K|Lk000e1NJLTq001cf001or1^@s6Gx0*;0008BNkl<ZSV!%a
zO=uHA7>3_XQj;`hBS|WFi9d}Xf>a2(D2lX*UMeU?sN$tcQ5p{-=t0q1Dp&=jYC+L}
zqEd(jMNtqGF%=K3E$yM|B}#50+n*%OUlS8&YTDhj6f@}@6lP8#nf>O;Gw(M$Qh^No
z<3kdVoOVc<<RlWpq%g_L0IxbClfon~1H9^pObU~%2J(3z{3DNu@(aV?v)H`03btwq
zo^=N3bgb1D&R<d{>2*2qHjRg&G(w-J0janEy+)JItDQO=-fl+Q0Sol{%3&*p9E%sQ
z@9HE%U$W}z+B^O%F!|Nx)T8&54PLjQBGQT=2g5luT%15OrBXF|j5zPJpw4B$a3qHt
zFOzumAw36WGfTL4Ove5#MrKfENF`RldcT564dAv7Rd{xK1=@lMj6||<)#!1v*@|;L
zQ|Nx3QlUt8`>)vHtz|RH1UXK&xSkjsA*SXAkvY(5$Afn%+|mFY+G;}A5i6X{3Yn@J
zr$)owPB^TZJp9Ei6J+nl41Cw4r6tMw(>*KE&_02_uWCMJ0;2?K;2@CkG*PG-XZKpr
zanMrswlhI0(E{8jl#(n`N&T1Y=z5jJ<32TmjUE$e78%B-pK8|=EDAr^>41Ax`DYUo
zB>n53NYi-FjF&9jy334?rseS8jpO-H20Jzyalh4yYcG<x^fXaoEO^oeA7k?{L(&xk
zZ_+q=J5~bf-(5X(9?B+ZCV}lw5(@zDw8&`LX)1f0XD3z!Ngp049z$_Wms4sA8B382
zYWl)Tz6%_enGG%(k`@>v$I*r06nW!h{(#LJG=F<YHmTuSh78WHQ?W^HA^P?i`j*4{
zQSxdmj=D7l)NfkGbkr=C11^xvA!B?%Kr#wjbh<DpO!6|otB%N|Fv-gRuR0==!Xz&P
eyz2ZHnfwjC;C6}4Z9h){0000<MNUMnLSTYG_fBB|

literal 0
HcmV?d00001

diff --git a/core/src/components/input-password-toggle/test/basic/input-password-toggle.e2e.ts-snapshots/input-password-toggle-ios-ltr-Mobile-Safari-linux.png b/core/src/components/input-password-toggle/test/basic/input-password-toggle.e2e.ts-snapshots/input-password-toggle-ios-ltr-Mobile-Safari-linux.png
new file mode 100644
index 0000000000000000000000000000000000000000..ef43adce9eb4b887967e125db316766d75d78cee
GIT binary patch
literal 624
zcmV-$0+0QPP)<h;3K|Lk000e1NJLTq001cf001or0ssI2ypz?p00006VoOIv0RI60
z0RN!9r;`8x0wqaAK~z|UWBmXBKf?e4rh&3})b3HcN9`W9d(`exyN9^lEaYjs^WyJ?
z2Y=pu`Nz-2s4K^!Db2#jNMpPI{$p5t=tuA7Z&x1uK^9jOW6pHv%=P5tU?sr`jKsHF
z?!EjQJ?YblTfcEBP!?xiU&gO1N34H{jqh{!{#aDKhg<Ap%zn00=*KeAtNlU=4jd4{
zyD$G*RlnbO`X@E*e)j&Kf7gfCpZ>uuUQ^7s=EM)jh7Z$rexH!Yo8`_4k^1uEe`xQ=
z!`E?!4Kg4c=3jsQx2=7D{yrjt&vgl{KK`S9{Wl0V+LmKNB9B<|8@Nf5f=p*Rg`@-t
zc#N>Wcbxx)Y%wDvgQg7gfvX6g?Yr_zgqKM|0AbYg_y3k3`9aWR!gkwfu_F86|9^&i
zFaH`TArh2{GV7=B|6hLi2N&VxWb`#*r-I$0d`xRg_}N$xnWuZ>x7J9WXj=|RK_(w#
z_UWm-J)6G$g9SJvBg4EbJ~c^Zf+iE2$Ce%Wku>e|&)-nRS?-*T;oKs;OrO60@7eUN
zef`%ze;F7U7?_zD`r>)>yf}$5lZ5<z{MPTF?vF2!!d6m{>E(xia32eBGcGUS_b^~1
z(m)dIW?*1=`}tqnx^Hv$egF6kMHdeTW2_xVZ3wp{p|nlD-4O8o*Z;%Ue_wj|=k4cz
zLcC1cGAwpltUMef7wF{JO)W4|>+ey!N9`W9d(`exyGQM&6aWC1zt}xCruAL`0000<
KMNUMnLSTaXf<DXu

literal 0
HcmV?d00001

diff --git a/core/src/components/input-password-toggle/test/input-password-toggle.spec.tsx b/core/src/components/input-password-toggle/test/input-password-toggle.spec.tsx
new file mode 100644
index 0000000000..9e771598e2
--- /dev/null
+++ b/core/src/components/input-password-toggle/test/input-password-toggle.spec.tsx
@@ -0,0 +1,115 @@
+import { h } from '@stencil/core';
+import { newSpecPage } from '@stencil/core/testing';
+
+import { Input } from '../../input/input';
+import { InputPasswordToggle } from '../input-password-toggle';
+import { Button } from '../../button/button';
+import { initialize } from '../../../global/ionic-global';
+
+describe('input password toggle', () => {
+  it('should toggle input type when clicked', async () => {
+    const page = await newSpecPage({
+      components: [Input, InputPasswordToggle, Button],
+      template: () => (
+        <ion-input type="password">
+          <ion-input-password-toggle slot="end"></ion-input-password-toggle>
+        </ion-input>
+      ),
+    });
+
+    const inputPasswordToggle = page.body.querySelector('ion-input-password-toggle')!;
+    const button = inputPasswordToggle.shadowRoot!.querySelector('ion-button')!;
+    const input = page.body.querySelector('ion-input')!;
+
+    expect(input.type).toBe('password');
+
+    button.click();
+    await page.waitForChanges();
+
+    expect(input.type).toBe('text');
+
+    button.click();
+    await page.waitForChanges();
+
+    expect(input.type).toBe('password');
+  });
+
+  it('should render custom icons', async () => {
+    const page = await newSpecPage({
+      components: [Input, InputPasswordToggle, Button],
+      template: () => (
+        <ion-input type="password">
+          <ion-input-password-toggle showIcon="show" hideIcon="hide" slot="end"></ion-input-password-toggle>
+        </ion-input>
+      ),
+    });
+
+    const inputPasswordToggle = page.body.querySelector('ion-input-password-toggle')!;
+    const button = inputPasswordToggle.shadowRoot!.querySelector('ion-button')!;
+    const icon = inputPasswordToggle.shadowRoot!.querySelector('ion-icon')!;
+
+    // Grab the attribute to test since we are not actually passing in a valid SVG
+    expect(icon.getAttribute('icon')).toBe('show');
+
+    button.click();
+    await page.waitForChanges();
+
+    expect(icon.getAttribute('icon')).toBe('hide');
+  });
+
+  it('changing the type on the input should update the icon used in password toggle', async () => {
+    const page = await newSpecPage({
+      components: [Input, InputPasswordToggle, Button],
+      template: () => (
+        <ion-input type="password">
+          <ion-input-password-toggle showIcon="show" hideIcon="hide" slot="end"></ion-input-password-toggle>
+        </ion-input>
+      ),
+    });
+
+    const inputPasswordToggle = page.body.querySelector('ion-input-password-toggle')!;
+    const input = page.body.querySelector('ion-input')!;
+    const icon = inputPasswordToggle.shadowRoot!.querySelector('ion-icon')!;
+
+    // Grab the attribute to test since we are not actually passing in a valid SVG
+    expect(icon.getAttribute('icon')).toBe('show');
+
+    input.type = 'text';
+    await page.waitForChanges();
+
+    expect(icon.getAttribute('icon')).toBe('hide');
+
+    input.type = 'password';
+    await page.waitForChanges();
+
+    expect(icon.getAttribute('icon')).toBe('show');
+  });
+
+  it('should inherit the mode and color to internal ionic components', async () => {
+    /**
+     * This initialize script tells Stencil how to determine the mode on components.
+     * This is required for any getIonMode internal logic to function properly in spec tests.
+     */
+    initialize();
+
+    const page = await newSpecPage({
+      components: [Input, InputPasswordToggle, Button],
+      template: () => (
+        <ion-input type="password" color="primary">
+          <ion-input-password-toggle slot="end" mode="ios" color="danger"></ion-input-password-toggle>
+        </ion-input>
+      ),
+    });
+
+    const inputPasswordToggle = page.body.querySelector('ion-input-password-toggle')!;
+    const button = inputPasswordToggle.shadowRoot!.querySelector('ion-button')!;
+
+    await page.waitForChanges();
+
+    // mode is a virtual prop so we need to access it as an attribute
+    expect(button.getAttribute('mode')).toBe('ios');
+
+    // color is an actual prop so we can access the element property
+    expect(button.color).toBe('danger');
+  });
+});
diff --git a/core/src/components/input/input.scss b/core/src/components/input/input.scss
index af3ad3c467..80ebc9896a 100644
--- a/core/src/components/input/input.scss
+++ b/core/src/components/input/input.scss
@@ -605,3 +605,12 @@
   margin-inline-start: $form-control-label-margin;
   margin-inline-end: 0;
 }
+
+/**
+ * The input password toggle component should be hidden when the input is readonly/disabled
+ * because it is not possible to edit a password.
+ */
+:host([disabled]) ::slotted(ion-input-password-toggle),
+:host([readonly]) ::slotted(ion-input-password-toggle) {
+  display: none;
+}
diff --git a/core/src/components/input/input.tsx b/core/src/components/input/input.tsx
index eeaf63beae..15727fe0e0 100644
--- a/core/src/components/input/input.tsx
+++ b/core/src/components/input/input.tsx
@@ -130,7 +130,7 @@ export class Input implements ComponentInterface {
   /**
    * If `true`, the user cannot interact with the input.
    */
-  @Prop() disabled = false;
+  @Prop({ reflect: true }) disabled = false;
 
   /**
    * A hint to the browser for which enter key to display.
@@ -226,7 +226,7 @@ export class Input implements ComponentInterface {
   /**
    * If `true`, the user cannot modify the value.
    */
-  @Prop() readonly = false;
+  @Prop({ reflect: true }) readonly = false;
 
   /**
    * If `true`, the user must fill in a value before submitting a form.
@@ -254,6 +254,20 @@ export class Input implements ComponentInterface {
    */
   @Prop() type: TextFieldTypes = 'text';
 
+  /**
+   * Whenever the type on the input changes we need
+   * to update the internal type prop on the password
+   * toggle so that that correct icon is shown.
+   */
+  @Watch('type')
+  onTypeChange() {
+    const passwordToggle = this.el.querySelector('ion-input-password-toggle');
+
+    if (passwordToggle) {
+      passwordToggle.type = this.type;
+    }
+  }
+
   /**
    * The value of the input.
    */
@@ -344,6 +358,14 @@ export class Input implements ComponentInterface {
 
   componentDidLoad() {
     this.originalIonInput = this.ionInput;
+
+    /**
+     * Set the type on the password toggle in the event that this input's
+     * type was set async and does not match the default type for the password toggle.
+     * This can happen when the type is bound using a JS framework binding syntax
+     * such as [type] in Angular.
+     */
+    this.onTypeChange();
   }
 
   componentDidRender() {
diff --git a/packages/angular/src/directives/proxies-list.ts b/packages/angular/src/directives/proxies-list.ts
index 172c4ec49d..8a0d9eb03e 100644
--- a/packages/angular/src/directives/proxies-list.ts
+++ b/packages/angular/src/directives/proxies-list.ts
@@ -36,6 +36,7 @@ export const DIRECTIVES = [
   d.IonInfiniteScroll,
   d.IonInfiniteScrollContent,
   d.IonInput,
+  d.IonInputPasswordToggle,
   d.IonItem,
   d.IonItemDivider,
   d.IonItemGroup,
diff --git a/packages/angular/src/directives/proxies.ts b/packages/angular/src/directives/proxies.ts
index d7eaecc6d8..8253b0876f 100644
--- a/packages/angular/src/directives/proxies.ts
+++ b/packages/angular/src/directives/proxies.ts
@@ -1014,6 +1014,28 @@ where the user's interaction is typing.
 }
 
 
+@ProxyCmp({
+  inputs: ['color', 'hideIcon', 'mode', 'showIcon']
+})
+@Component({
+  selector: 'ion-input-password-toggle',
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  template: '<ng-content></ng-content>',
+  // eslint-disable-next-line @angular-eslint/no-inputs-metadata-property
+  inputs: ['color', 'hideIcon', 'mode', 'showIcon'],
+})
+export class IonInputPasswordToggle {
+  protected el: HTMLElement;
+  constructor(c: ChangeDetectorRef, r: ElementRef, protected z: NgZone) {
+    c.detach();
+    this.el = r.nativeElement;
+  }
+}
+
+
+export declare interface IonInputPasswordToggle extends Components.IonInputPasswordToggle {}
+
+
 @ProxyCmp({
   inputs: ['button', 'color', 'detail', 'detailIcon', 'disabled', 'download', 'href', 'lines', 'mode', 'rel', 'routerAnimation', 'routerDirection', 'target', 'type']
 })
diff --git a/packages/angular/standalone/src/directives/proxies.ts b/packages/angular/standalone/src/directives/proxies.ts
index a677f50007..c319aa5527 100644
--- a/packages/angular/standalone/src/directives/proxies.ts
+++ b/packages/angular/standalone/src/directives/proxies.ts
@@ -36,6 +36,7 @@ import { defineCustomElement as defineIonHeader } from '@ionic/core/components/i
 import { defineCustomElement as defineIonImg } from '@ionic/core/components/ion-img.js';
 import { defineCustomElement as defineIonInfiniteScroll } from '@ionic/core/components/ion-infinite-scroll.js';
 import { defineCustomElement as defineIonInfiniteScrollContent } from '@ionic/core/components/ion-infinite-scroll-content.js';
+import { defineCustomElement as defineIonInputPasswordToggle } from '@ionic/core/components/ion-input-password-toggle.js';
 import { defineCustomElement as defineIonItem } from '@ionic/core/components/ion-item.js';
 import { defineCustomElement as defineIonItemDivider } from '@ionic/core/components/ion-item-divider.js';
 import { defineCustomElement as defineIonItemGroup } from '@ionic/core/components/ion-item-group.js';
@@ -976,6 +977,30 @@ export class IonInfiniteScrollContent {
 export declare interface IonInfiniteScrollContent extends Components.IonInfiniteScrollContent {}
 
 
+@ProxyCmp({
+  defineCustomElementFn: defineIonInputPasswordToggle,
+  inputs: ['color', 'hideIcon', 'mode', 'showIcon']
+})
+@Component({
+  selector: 'ion-input-password-toggle',
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  template: '<ng-content></ng-content>',
+  // eslint-disable-next-line @angular-eslint/no-inputs-metadata-property
+  inputs: ['color', 'hideIcon', 'mode', 'showIcon'],
+  standalone: true
+})
+export class IonInputPasswordToggle {
+  protected el: HTMLElement;
+  constructor(c: ChangeDetectorRef, r: ElementRef, protected z: NgZone) {
+    c.detach();
+    this.el = r.nativeElement;
+  }
+}
+
+
+export declare interface IonInputPasswordToggle extends Components.IonInputPasswordToggle {}
+
+
 @ProxyCmp({
   defineCustomElementFn: defineIonItem,
   inputs: ['button', 'color', 'detail', 'detailIcon', 'disabled', 'download', 'href', 'lines', 'mode', 'rel', 'routerAnimation', 'routerDirection', 'target', 'type']
diff --git a/packages/react/src/components/proxies.ts b/packages/react/src/components/proxies.ts
index 54e5d4f605..05800f3877 100644
--- a/packages/react/src/components/proxies.ts
+++ b/packages/react/src/components/proxies.ts
@@ -31,6 +31,7 @@ import { defineCustomElement as defineIonImg } from '@ionic/core/components/ion-
 import { defineCustomElement as defineIonInfiniteScroll } from '@ionic/core/components/ion-infinite-scroll.js';
 import { defineCustomElement as defineIonInfiniteScrollContent } from '@ionic/core/components/ion-infinite-scroll-content.js';
 import { defineCustomElement as defineIonInput } from '@ionic/core/components/ion-input.js';
+import { defineCustomElement as defineIonInputPasswordToggle } from '@ionic/core/components/ion-input-password-toggle.js';
 import { defineCustomElement as defineIonItemDivider } from '@ionic/core/components/ion-item-divider.js';
 import { defineCustomElement as defineIonItemGroup } from '@ionic/core/components/ion-item-group.js';
 import { defineCustomElement as defineIonItemOptions } from '@ionic/core/components/ion-item-options.js';
@@ -99,6 +100,7 @@ export const IonImg = /*@__PURE__*/createReactComponent<JSX.IonImg, HTMLIonImgEl
 export const IonInfiniteScroll = /*@__PURE__*/createReactComponent<JSX.IonInfiniteScroll, HTMLIonInfiniteScrollElement>('ion-infinite-scroll', undefined, undefined, defineIonInfiniteScroll);
 export const IonInfiniteScrollContent = /*@__PURE__*/createReactComponent<JSX.IonInfiniteScrollContent, HTMLIonInfiniteScrollContentElement>('ion-infinite-scroll-content', undefined, undefined, defineIonInfiniteScrollContent);
 export const IonInput = /*@__PURE__*/createReactComponent<JSX.IonInput, HTMLIonInputElement>('ion-input', undefined, undefined, defineIonInput);
+export const IonInputPasswordToggle = /*@__PURE__*/createReactComponent<JSX.IonInputPasswordToggle, HTMLIonInputPasswordToggleElement>('ion-input-password-toggle', undefined, undefined, defineIonInputPasswordToggle);
 export const IonItemDivider = /*@__PURE__*/createReactComponent<JSX.IonItemDivider, HTMLIonItemDividerElement>('ion-item-divider', undefined, undefined, defineIonItemDivider);
 export const IonItemGroup = /*@__PURE__*/createReactComponent<JSX.IonItemGroup, HTMLIonItemGroupElement>('ion-item-group', undefined, undefined, defineIonItemGroup);
 export const IonItemOptions = /*@__PURE__*/createReactComponent<JSX.IonItemOptions, HTMLIonItemOptionsElement>('ion-item-options', undefined, undefined, defineIonItemOptions);
diff --git a/packages/vue/src/proxies.ts b/packages/vue/src/proxies.ts
index eab6fe4a36..30d640d44f 100644
--- a/packages/vue/src/proxies.ts
+++ b/packages/vue/src/proxies.ts
@@ -35,6 +35,7 @@ import { defineCustomElement as defineIonImg } from '@ionic/core/components/ion-
 import { defineCustomElement as defineIonInfiniteScroll } from '@ionic/core/components/ion-infinite-scroll.js';
 import { defineCustomElement as defineIonInfiniteScrollContent } from '@ionic/core/components/ion-infinite-scroll-content.js';
 import { defineCustomElement as defineIonInput } from '@ionic/core/components/ion-input.js';
+import { defineCustomElement as defineIonInputPasswordToggle } from '@ionic/core/components/ion-input-password-toggle.js';
 import { defineCustomElement as defineIonItem } from '@ionic/core/components/ion-item.js';
 import { defineCustomElement as defineIonItemDivider } from '@ionic/core/components/ion-item-divider.js';
 import { defineCustomElement as defineIonItemGroup } from '@ionic/core/components/ion-item-group.js';
@@ -436,6 +437,14 @@ export const IonInput = /*@__PURE__*/ defineContainer<JSX.IonInput, JSX.IonInput
 'value', 'ion-input');
 
 
+export const IonInputPasswordToggle = /*@__PURE__*/ defineContainer<JSX.IonInputPasswordToggle>('ion-input-password-toggle', defineIonInputPasswordToggle, [
+  'color',
+  'showIcon',
+  'hideIcon',
+  'type'
+]);
+
+
 export const IonItem = /*@__PURE__*/ defineContainer<JSX.IonItem>('ion-item', defineIonItem, [
   'color',
   'button',