From c76de0cc37e04350dc81b87caca6078359555d87 Mon Sep 17 00:00:00 2001
From: Sean Perkins <sean@ionic.io>
Date: Tue, 13 Sep 2022 15:16:20 -0400
Subject: [PATCH] chore(input): build output (#25933)

---
 angular/src/directives/proxies.ts | 21 ++++++++++++++++++---
 core/api.txt                      |  2 +-
 2 files changed, 19 insertions(+), 4 deletions(-)

diff --git a/angular/src/directives/proxies.ts b/angular/src/directives/proxies.ts
index 02dfff016e..c30a4d98fd 100644
--- a/angular/src/directives/proxies.ts
+++ b/angular/src/directives/proxies.ts
@@ -814,14 +814,29 @@ export class IonInfiniteScrollContent {
   }
 }
 
+import type { InputInputEventDetail as IInputInputInputEventDetail } from '@ionic/core';
 import type { InputChangeEventDetail as IInputInputChangeEventDetail } from '@ionic/core';
 export declare interface IonInput extends Components.IonInput {
   /**
-   * Emitted when a keyboard input occurred. 
+   * The `ionInput` event fires when the `value` of an `<ion-input>` element
+has been changed.
+
+For elements that accept text input (`type=text`, `type=tel`, etc.), the interface
+is [`InputEvent`](https://developer.mozilla.org/en-US/docs/Web/API/InputEvent); for others,
+the interface is [`Event`](https://developer.mozilla.org/en-US/docs/Web/API/Event). 
    */
-  ionInput: EventEmitter<CustomEvent<InputEvent>>;
+  ionInput: EventEmitter<CustomEvent<IInputInputInputEventDetail>>;
   /**
-   * Emitted when the value has changed. 
+   * The `ionChange` event is fired for `<ion-input>` elements when the user
+modifies the element's value. Unlike the `ionInput` event, the `ionChange`
+event is not necessarily fired for each alteration to an element's value.
+
+Depending on the way the users interacts with the element, the `ionChange`
+event fires at a different moment:
+- When the user commits the change explicitly (e.g. by selecting a date
+from a date picker for `<ion-input type="date">`, etc.).
+- When the element loses focus after its value has changed: for elements
+where the user's interaction is typing. 
    */
   ionChange: EventEmitter<CustomEvent<IInputInputChangeEventDetail>>;
   /**
diff --git a/core/api.txt b/core/api.txt
index 853dd159f1..63eb7e4050 100644
--- a/core/api.txt
+++ b/core/api.txt
@@ -550,7 +550,7 @@ ion-input,method,setFocus,setFocus() => Promise<void>
 ion-input,event,ionBlur,FocusEvent,true
 ion-input,event,ionChange,InputChangeEventDetail,true
 ion-input,event,ionFocus,FocusEvent,true
-ion-input,event,ionInput,InputEvent,true
+ion-input,event,ionInput,Event | InputEvent,true
 ion-input,css-prop,--background
 ion-input,css-prop,--color
 ion-input,css-prop,--padding-bottom