@ui5/webcomponents 0.0.0-d9b978d1d → 0.0.0-da0d3eb88

package/dist/Input.d.ts

@@ -3,6 +3,7 @@ import type { ClassMap } from "@ui5/webcomponents-base/dist/types.js";
 import type { ResizeObserverCallback } from "@ui5/webcomponents-base/dist/delegate/ResizeHandler.js";
 import ValueState from "@ui5/webcomponents-base/dist/types/ValueState.js";
 import type I18nBundle from "@ui5/webcomponents-base/dist/i18nBundle.js";
+import type { IFormInputElement } from "@ui5/webcomponents-base/dist/features/InputElementsFormSupport.js";
 import "@ui5/webcomponents-icons/dist/decline.js";
 import "@ui5/webcomponents-icons/dist/not-editable.js";
 import "@ui5/webcomponents-icons/dist/error.js";
@@ -12,13 +13,28 @@ import "@ui5/webcomponents-icons/dist/information.js";
 import type SuggestionItem from "./SuggestionItem.js";
 import type { InputSuggestion, SuggestionComponent } from "./features/InputSuggestions.js";
 import type InputSuggestions from "./features/InputSuggestions.js";
-import type FormSupportT from "./features/InputElementsFormSupport.js";
-import type { IFormElement } from "./features/InputElementsFormSupport.js";
 import type SuggestionListItem from "./SuggestionListItem.js";
 import type { PopupScrollEventDetail } from "./Popup.js";
 import InputType from "./types/InputType.js";
 import Popover from "./Popover.js";
-import Icon from "./Icon.js";
+import type { IIcon } from "./Icon.js";
+import type ListItemType from "./types/ListItemType.js";
+import PopoverHorizontalAlign from "./types/PopoverHorizontalAlign.js";
+import type { ListItemClickEventDetail, ListSelectionChangeEventDetail } from "./List.js";
+/**
+ * Interface for components that represent a suggestion item, usable in `ui5-input`
+ * @public
+ */
+interface IInputSuggestionItem extends UI5Element {
+    text: string;
+    groupItem: boolean;
+    description?: string;
+    image?: string;
+    icon?: string;
+    additionalText?: string;
+    additionalTextState?: `${ValueState}`;
+    type?: `${ListItemType}`;
+}
 type NativeInputAttributes = {
     min?: number;
     max?: number;
@@ -40,14 +56,11 @@ declare enum INPUT_ACTIONS {
     ACTION_USER_INPUT = "input"
 }
 type InputEventDetail = {
-    inputType?: string;
-};
-type InputSuggestionItemSelectEventDetail = {
-    item: SuggestionItem;
+    inputType: string;
 };
-type InputSuggestionItemPreviewEventDetail = {
-    item: SuggestionItem;
-    targetRef: SuggestionListItem;
+type InputSelectionChangeEventDetail = {
+    item: IInputSuggestionItem | null;
+    targetRef: SuggestionListItem | null;
 };
 type InputSuggestionScrollEventDetail = {
     scrollTop: number;
@@ -55,74 +68,60 @@ type InputSuggestionScrollEventDetail = {
 };
 /**
  * @class
- * <h3 class="comment-api-title">Overview</h3>
+ * ### Overview
  *
- * The <code>ui5-input</code> component allows the user to enter and edit text or numeric values in one line.
- * <br>
- * Additionally, you can provide <code>suggestionItems</code>,
+ * The `ui5-input` component allows the user to enter and edit text or numeric values in one line.
+ *
+ * Additionally, you can provide `suggestionItems`,
  * that are displayed in a popover right under the input.
- * <br><br>
- * The text field can be editable or read-only (<code>readonly</code> property),
- * and it can be enabled or disabled (<code>disabled</code> property).
- * To visualize semantic states, such as "error" or "warning", the <code>valueState</code> property is provided.
+ *
+ * The text field can be editable or read-only (`readonly` property),
+ * and it can be enabled or disabled (`disabled` property).
+ * To visualize semantic states, such as "error" or "warning", the `valueState` property is provided.
  * When the user makes changes to the text, the change event is fired,
  * which enables you to react on any text change.
- * <br><br>
- * <b>Note:</b> If you are using the <code>ui5-input</code> as a single npm module,
- * don't forget to import the <code>InputSuggestions</code> module from
+ *
+ * **Note:** If you are using the `ui5-input` as a single npm module,
+ * don't forget to import the `InputSuggestions` module from
  * "@ui5/webcomponents/dist/features/InputSuggestions.js"
  * to enable the suggestions functionality.
  *
- * <h3>Keyboard Handling</h3>
- * The <code>ui5-input</code> provides the following keyboard shortcuts:
- * <br>
+ * ### Keyboard Handling
+ * The `ui5-input` provides the following keyboard shortcuts:
  *
- * <ul>
- * <li>[ESC] - Closes the suggestion list, if open. If closed or not enabled, cancels changes and reverts to the value which the Input field had when it got the focus.</li>
- * <li>[ENTER] or [RETURN] - If suggestion list is open takes over the current matching item and closes it. If value state or group header is focused, does nothing.</li>
- * <li>[DOWN] - Focuses the next matching item in the suggestion list.</li>
- * <li>[UP] - Focuses the previous matching item in the suggestion list.</li>
- * <li>[HOME] - If focus is in the text input, moves caret before the first character. If focus is in the list, highlights the first item and updates the input accordingly.</li>
- * <li>[END] - If focus is in the text input, moves caret after the last character. If focus is in the list, highlights the last item and updates the input accordingly.</li>
- * <li>[PAGEUP] - If focus is in the list, moves highlight up by page size (10 items by default). If focus is in the input, does nothing.</li>
- * <li>[PAGEDOWN] - If focus is in the list, moves highlight down by page size (10 items by default). If focus is in the input, does nothing.</li>
- * </ul>
+ * - [Escape] - Closes the suggestion list, if open. If closed or not enabled, cancels changes and reverts to the value which the Input field had when it got the focus.
+ * - [Enter] or [Return] - If suggestion list is open takes over the current matching item and closes it. If value state or group header is focused, does nothing.
+ * - [Down] - Focuses the next matching item in the suggestion list. Selection-change event is fired.
+ * - [Up] - Focuses the previous matching item in the suggestion list. Selection-change event is fired.
+ * - [Home] - If focus is in the text input, moves caret before the first character. If focus is in the list, highlights the first item and updates the input accordingly.
+ * - [End] - If focus is in the text input, moves caret after the last character. If focus is in the list, highlights the last item and updates the input accordingly.
+ * - [Page Up] - If focus is in the list, moves highlight up by page size (10 items by default). If focus is in the input, does nothing.
+ * - [Page Down] - If focus is in the list, moves highlight down by page size (10 items by default). If focus is in the input, does nothing.
  *
- * <h3>ES6 Module Import</h3>
+ * ### ES6 Module Import
  *
- * <code>import "@ui5/webcomponents/dist/Input.js";</code>
- * <br>
- * <code>import "@ui5/webcomponents/dist/features/InputSuggestions.js";</code> (optional - for input suggestions support)
+ * `import "@ui5/webcomponents/dist/Input.js";`
  *
+ * `import "@ui5/webcomponents/dist/features/InputSuggestions.js";` (optional - for input suggestions support)
  * @constructor
- * @author SAP SE
- * @alias sap.ui.webc.main.Input
- * @extends sap.ui.webc.base.UI5Element
- * @tagname ui5-input
- * @appenddocs sap.ui.webc.main.SuggestionItem sap.ui.webc.main.SuggestionGroupItem
- * @implements sap.ui.webc.main.IInput
+ * @extends UI5Element
  * @public
  */
-declare class Input extends UI5Element implements SuggestionComponent, IFormElement {
+declare class Input extends UI5Element implements SuggestionComponent, IFormInputElement {
     /**
      * Defines whether the component is in disabled state.
-     * <br><br>
-     * <b>Note:</b> A disabled component is completely noninteractive.
      *
-     * @type {boolean}
-     * @name sap.ui.webc.main.Input.prototype.disabled
-     * @defaultvalue false
+     * **Note:** A disabled component is completely noninteractive.
+     * @default false
      * @public
      */
     disabled: boolean;
     /**
      * Defines if characters within the suggestions are to be highlighted
      * in case the input value matches parts of the suggestions text.
-     * <br><br>
-     * <b>Note:</b> takes effect when <code>showSuggestions</code> is set to <code>true</code>
      *
-     * @type {boolean}
-     * @defaultvalue false
+     * **Note:** takes effect when `showSuggestions` is set to `true`
+     * @default false
      * @private
      * @since 1.0.0-rc.8
      */
@@ -130,69 +129,51 @@ declare class Input extends UI5Element implements SuggestionComponent, IFormElem
     /**
      * Defines a short hint intended to aid the user with data entry when the
      * component has no value.
-     * @type {string}
-     * @name sap.ui.webc.main.Input.prototype.placeholder
-     * @defaultvalue ""
+     * @default ""
      * @public
      */
     placeholder: string;
     /**
      * Defines whether the component is read-only.
-     * <br><br>
-     * <b>Note:</b> A read-only component is not editable,
-     * but still provides visual feedback upon user interaction.
      *
-     * @type {boolean}
-     * @name sap.ui.webc.main.Input.prototype.readonly
-     * @defaultvalue false
+     * **Note:** A read-only component is not editable,
+     * but still provides visual feedback upon user interaction.
+     * @default false
      * @public
      */
     readonly: boolean;
     /**
      * Defines whether the component is required.
-     *
-     * @type {boolean}
-     * @name sap.ui.webc.main.Input.prototype.required
-     * @defaultvalue false
+     * @default false
      * @public
      * @since 1.0.0-rc.3
      */
     required: boolean;
     /**
      * Defines whether the value will be autcompleted to match an item
-     *
-     * @type {boolean}
-     * @name sap.ui.webc.main.Input.prototype.noTypeahead
-     * @defaultvalue false
+     * @default false
      * @public
      * @since 1.4.0
      */
     noTypeahead: boolean;
     /**
      * Defines the HTML type of the component.
-     * <br><br>
-     * <b>Notes:</b>
-     * <ul>
-     * <li>The particular effect of this property differs depending on the browser
-     * and the current language settings, especially for type <code>Number</code>.</li>
-     * <li>The property is mostly intended to be used with touch devices
-     * that use different soft keyboard layouts depending on the given input type.</li>
-     * </ul>
      *
-     * @type {sap.ui.webc.main.types.InputType}
-     * @name sap.ui.webc.main.Input.prototype.type
-     * @defaultvalue "Text"
+     * **Notes:**
+     *
+     * - The particular effect of this property differs depending on the browser
+     * and the current language settings, especially for type `Number`.
+     * - The property is mostly intended to be used with touch devices
+     * that use different soft keyboard layouts depending on the given input type.
+     * @default "Text"
      * @public
      */
     type: `${InputType}`;
     /**
      * Defines the value of the component.
-     * <br><br>
-     * <b>Note:</b> The property is updated upon typing.
      *
-     * @type {string}
-     * @name sap.ui.webc.main.Input.prototype.value
-     * @defaultvalue ""
+     * **Note:** The property is updated upon typing.
+     * @default ""
      * @formEvents change input
      * @formProperty
      * @public
@@ -200,106 +181,79 @@ declare class Input extends UI5Element implements SuggestionComponent, IFormElem
     value: string;
     /**
      * Defines the inner stored value of the component.
-     * <br><br>
-     * <b>Note:</b> The property is updated upon typing. In some special cases the old value is kept (e.g. deleting the value after the dot in a float)
      *
-     * @type {string}
-     * @defaultvalue ""
+     * **Note:** The property is updated upon typing. In some special cases the old value is kept (e.g. deleting the value after the dot in a float)
+     * @default ""
      * @private
      */
     _innerValue: string;
     /**
      * Defines the value state of the component.
-     *
-     * @type {sap.ui.webc.base.types.ValueState}
-     * @name sap.ui.webc.main.Input.prototype.valueState
-     * @defaultvalue "None"
+     * @default "None"
      * @public
      */
     valueState: `${ValueState}`;
     /**
-     * Determines the name with which the component will be submitted in an HTML form.
-     *
-     * <br><br>
-     * <b>Important:</b> For the <code>name</code> property to have effect, you must add the following import to your project:
-     * <code>import "@ui5/webcomponents/dist/features/InputElementsFormSupport.js";</code>
+     * Determines the name by which the component will be identified upon submission in an HTML form.
      *
-     * <br><br>
-     * <b>Note:</b> When set, a native <code>input</code> HTML element
-     * will be created inside the component so that it can be submitted as
-     * part of an HTML form. Do not use this property unless you need to submit a form.
-     *
-     * @type {string}
-     * @name sap.ui.webc.main.Input.prototype.name
-     * @defaultvalue ""
+     * **Note:** This property is only applicable within the context of an HTML Form element.
+     * @default ""
      * @public
      */
     name: string;
     /**
      * Defines whether the component should show suggestions, if such are present.
-     * <br><br>
-     * <b>Note:</b> You need to import the <code>InputSuggestions</code> module
-     * from <code>"@ui5/webcomponents/dist/features/InputSuggestions.js"</code> to enable this functionality.
-     * @type {boolean}
-     * @name sap.ui.webc.main.Input.prototype.showSuggestions
-     * @defaultvalue false
+     *
+     * **Note:** You need to import the `InputSuggestions` module
+     * from `"@ui5/webcomponents/dist/features/InputSuggestions.js"` to enable this functionality.
+     * @default false
      * @public
      */
     showSuggestions: boolean;
     /**
      * Sets the maximum number of characters available in the input field.
-     * <br><br>
-     * <b>Note:</b> This property is not compatible with the ui5-input type InputType.Number. If the ui5-input type is set to Number, the maxlength value is ignored.
-     * @type {sap.ui.webc.base.types.Integer}
-     * @name sap.ui.webc.main.Input.prototype.maxlength
+     *
+     * **Note:** This property is not compatible with the ui5-input type InputType.Number. If the ui5-input type is set to Number, the maxlength value is ignored.
+     * @default undefined
      * @since 1.0.0-rc.5
      * @public
      */
     maxlength?: number;
     /**
      * Defines the accessible ARIA name of the component.
-     *
-     * @type {string}
-     * @name sap.ui.webc.main.Input.prototype.accessibleName
+     * @default ""
      * @public
      * @since 1.0.0-rc.15
      */
     accessibleName: string;
     /**
      * Receives id(or many ids) of the elements that label the input.
-     *
-     * @type {string}
-     * @name sap.ui.webc.main.Input.prototype.accessibleNameRef
-     * @defaultvalue ""
+     * @default ""
      * @public
      * @since 1.0.0-rc.15
      */
     accessibleNameRef: string;
     /**
      * Defines whether the clear icon of the input will be shown.
-     *
-     * @type {boolean}
-     * @name sap.ui.webc.main.Input.prototype.showClearIcon
-     * @defaultvalue false
+     * @default false
      * @public
      * @since 1.2.0
      */
     showClearIcon: boolean;
     /**
      * Defines whether the clear icon is visible.
-     *
-     * @type {boolean}
-     * @defaultvalue false
+     * @default false
      * @private
      * @since 1.2.0
      */
-    effectiveShowClearIcon: boolean;
+    _effectiveShowClearIcon: boolean;
     /**
      * @private
      */
     focused: boolean;
     openOnMobile: boolean;
     open: boolean;
+    valueStateOpen: boolean;
     /**
      * Determines whether to manually show the suggestions popover
      * @private
@@ -314,7 +268,6 @@ declare class Input extends UI5Element implements SuggestionComponent, IFormElem
     _nativeInputAttributes: NativeInputAttributes;
     _inputWidth?: number;
     _listWidth?: number;
-    _isPopoverOpen: boolean;
     _inputIconFocused: boolean;
     /**
      * Constantly updated value of texts collected from the associated labels
@@ -328,78 +281,43 @@ declare class Input extends UI5Element implements SuggestionComponent, IFormElem
     _accessibleLabelsRefTexts?: string;
     /**
      * Defines the suggestion items.
-     * <br><br>
-     * Example:
-     * <br><br>
-     * &lt;ui5-input show-suggestions><br>
-     * &nbsp;&nbsp;&nbsp;&nbsp;&lt;ui5-suggestion-item text="Item #1">&lt;/ui5-suggestion-item><br>
-     * &nbsp;&nbsp;&nbsp;&nbsp;&lt;ui5-suggestion-item text="Item #2">&lt;/ui5-suggestion-item><br>
-     * &lt;/ui5-input>
-     * <br>
-     * <ui5-input show-suggestions>
-     * <ui5-suggestion-group-item text="Group #1"></ui5-suggestion-group-item>
-     * <ui5-suggestion-item text="Item #1"></ui5-suggestion-item>
-     * <ui5-suggestion-item text="Item #2"></ui5-suggestion-item>
-     * <ui5-suggestion-group-item text="Group #2"></ui5-suggestion-group-item>
-     * <ui5-suggestion-item text="Item #3"></ui5-suggestion-item>
-     * <ui5-suggestion-item text="Item #4"></ui5-suggestion-item>
-     * </ui5-input>
-     * <br><br>
-     * <b>Note:</b> The suggestions would be displayed only if the <code>showSuggestions</code>
-     * property is set to <code>true</code>.
-     * <br><br>
-     * <b>Note:</b> The <code>&lt;ui5-suggestion-item&gt;</code> and <code>&lt;ui5-suggestion-group-item&gt;</code> are recommended to be used as suggestion items.
-     * <br><br>
-     * <b>Note:</b> Importing the Input Suggestions Support feature:
-     * <br>
-     * <code>import "@ui5/webcomponents/dist/features/InputSuggestions.js";</code>
-     * <br>
-     * automatically imports the <code>&lt;ui5-suggestion-item></code> and <code>&lt;ui5-suggestion-group-item></code> for your convenience.
      *
-     * @type {sap.ui.webc.main.IInputSuggestionItem[]}
-     * @name sap.ui.webc.main.Input.prototype.default
-     * @slot suggestionItems
+     * **Note:** The suggestions would be displayed only if the `showSuggestions`
+     * property is set to `true`.
+     *
+     * **Note:** The `<ui5-suggestion-item>` and `<ui5-suggestion-group-item>` are recommended to be used as suggestion items.
+     *
+     * **Note:** Importing the Input Suggestions Support feature:
+     *
+     * `import "@ui5/webcomponents/dist/features/InputSuggestions.js";`
+     *
+     * automatically imports the `<ui5-suggestion-item>` and `<ui5-suggestion-group-item>` for your convenience.
      * @public
      */
-    suggestionItems: Array<SuggestionItem>;
+    suggestionItems: Array<IInputSuggestionItem>;
     /**
      * Defines the icon to be displayed in the component.
-     *
-     * @type {sap.ui.webc.main.IIcon[]}
-     * @name sap.ui.webc.main.Input.prototype.icon
-     * @slot
      * @public
      */
-    icon: Array<Icon>;
-    /**
-     * The slot is used for native <code>input</code> HTML element to enable form submit,
-     * when <code>name</code> property is set.
-     * @type {HTMLElement[]}
-     * @private
-     */
-    formSupport: Array<HTMLElement>;
+    icon: Array<IIcon>;
     /**
      * Defines the value state message that will be displayed as pop up under the component.
-     * <br><br>
+     * The value state message slot should contain only one root element.
+     *
+     * **Note:** If not specified, a default text (in the respective language) will be displayed.
      *
-     * <b>Note:</b> If not specified, a default text (in the respective language) will be displayed.
-     * <br><br>
-     * <b>Note:</b> The <code>valueStateMessage</code> would be displayed,
-     * when the component is in <code>Information</code>, <code>Warning</code> or <code>Error</code> value state.
-     * <br><br>
-     * <b>Note:</b> If the component has <code>suggestionItems</code>,
-     * the <code>valueStateMessage</code> would be displayed as part of the same popover, if used on desktop, or dialog - on phone.
-     * @type {HTMLElement[]}
-     * @name sap.ui.webc.main.Input.prototype.valueStateMessage
+     * **Note:** The `valueStateMessage` would be displayed,
+     * when the component is in `Information`, `Warning` or `Error` value state.
+     *
+     * **Note:** If the component has `suggestionItems`,
+     * the `valueStateMessage` would be displayed as part of the same popover, if used on desktop, or dialog - on phone.
      * @since 1.0.0-rc.6
-     * @slot
      * @public
      */
     valueStateMessage: Array<HTMLElement>;
     hasSuggestionItemSelected: boolean;
     valueBeforeItemSelection: string;
-    valueBeforeItemPreview: string;
-    suggestionSelectionCancelled: boolean;
+    valueBeforeSelectionStart: string;
     previousValue: string;
     firstRendering: boolean;
     typedInValue: string;
@@ -412,18 +330,21 @@ declare class Input extends UI5Element implements SuggestionComponent, IFormElem
     _keyDown?: boolean;
     _isKeyNavigation?: boolean;
     Suggestions?: InputSuggestions;
-    FormSupport?: typeof FormSupportT;
     _selectedText?: string;
     _clearIconClicked?: boolean;
     _focusedAfterClear: boolean;
     _performTextSelection?: boolean;
-    _previewItem?: SuggestionListItem;
+    _isLatestValueFromSuggestions: boolean;
     static i18nBundle: I18nBundle;
+    get formValidityMessage(): string;
+    get formValidity(): ValidityStateFlags;
+    formElementAnchor(): Promise<HTMLElement | undefined>;
+    get formFormattedValue(): FormData | string | null;
     constructor();
     onEnterDOM(): void;
     onExitDOM(): void;
     onBeforeRendering(): void;
-    onAfterRendering(): Promise<void>;
+    onAfterRendering(): void;
     _onkeydown(e: KeyboardEvent): void;
     _onkeyup(e: KeyboardEvent): void;
     _handleUp(e: KeyboardEvent): void;
@@ -436,10 +357,10 @@ declare class Input extends UI5Element implements SuggestionComponent, IFormElem
     _handleHome(e: KeyboardEvent): void;
     _handleEnd(e: KeyboardEvent): void;
     _handleEscape(): void;
-    _onfocusin(e: FocusEvent): Promise<void>;
+    _onfocusin(e: FocusEvent): void;
     /**
      * Called on "focusin" of the native input HTML Element.
-     * <b>Note:</b> implemented in MultiInput, but used in the Input template.
+     * **Note:** implemented in MultiInput, but used in the Input template.
      */
     innerFocusIn(): void | undefined;
     _onfocusout(e: FocusEvent): void;
@@ -450,50 +371,40 @@ declare class Input extends UI5Element implements SuggestionComponent, IFormElem
     _iconMouseDown(): void;
     _scroll(e: CustomEvent<PopupScrollEventDetail>): void;
     _handleInput(e: InputEvent | CustomEvent<InputEventDetail>): void;
-    _startsWithMatchingItems(str: string): Array<SuggestionItem>;
-    _getFirstMatchingItem(current: string): SuggestionItem | undefined;
-    _handleTypeAhead(item: SuggestionItem): void;
+    _startsWithMatchingItems(str: string): Array<IInputSuggestionItem>;
+    _getFirstMatchingItem(current: string): IInputSuggestionItem | undefined;
+    _handleTypeAhead(item: IInputSuggestionItem): void;
     _handleResize(): void;
     _updateAssociatedLabelsTexts(): void;
-    _closeRespPopover(): void;
-    _afterOpenPopover(): Promise<void>;
-    _afterClosePopover(): void;
-    /**
-     * Checks if the value state popover is open.
-     * @returns {boolean} true if the value state popover is open, false otherwise
-     */
-    isValueStateOpened(): boolean;
-    openPopover(): Promise<void>;
-    closePopover(): Promise<void>;
-    _getPopover(): Promise<Popover>;
+    _closePicker(): void;
+    _afterOpenPicker(): void;
+    _afterClosePicker(): void;
+    _handleSuggestionItemPress(e: CustomEvent<ListItemClickEventDetail>): void;
+    _handleSelectionChange(e: CustomEvent<ListSelectionChangeEventDetail>): void;
+    _handleItemMouseOver(e: MouseEvent): void;
+    _handleItemMouseOut(e: MouseEvent): void;
+    _handlePickerAfterOpen(): void;
+    _handlePickerAfterClose(): void;
+    openValueStatePopover(): void;
+    closeValueStatePopover(): void;
+    _handleValueStatePopoverAfterClose(): void;
+    _getValueStatePopover(): Popover;
     /**
      * Manually opens the suggestions popover, assuming suggestions are enabled. Items must be preloaded for it to open.
      * @public
-     * @method
-     * @name sap.ui.webc.main.Input#openPicker
-     * @return {void}
      * @since 1.3.0
      */
     openPicker(): void;
     enableSuggestions(): void;
-    selectSuggestion(item: SuggestionItem, keyboardUsed: boolean): void;
-    previewSuggestion(item: SuggestionListItem): void;
-    /**
-     * Updates the input value on item preview.
-     * @param {Object} item The item that is on preview
-     */
-    updateValueOnPreview(item: SuggestionListItem): void;
+    acceptSuggestion(item: IInputSuggestionItem, keyboardUsed: boolean): void;
     /**
-     * The suggestion item on preview.
-     * @type {sap.ui.webc.main.IInputSuggestionItem | null}
-     * @name sap.ui.webc.main.Input.prototype.previewItem
-     * @readonly
-     * @public
+     * Updates the input value on item select.
+     * @param item The item that is on select
      */
-    get previewItem(): SuggestionItem | null;
-    fireEventByAction(action: INPUT_ACTIONS, e: InputEvent): Promise<void>;
-    getInputValue(): Promise<string>;
-    getInputDOMRef(): Promise<HTMLInputElement | Input | null>;
+    updateValueOnSelect(item: SuggestionListItem): void;
+    fireEventByAction(action: INPUT_ACTIONS, e: InputEvent): void;
+    getInputValue(): string;
+    getInputDOMRef(): HTMLInputElement | Input | null;
     getInputDOMRefSync(): HTMLInputElement | null;
     /**
      * Returns a reference to the native input element
@@ -501,41 +412,40 @@ declare class Input extends UI5Element implements SuggestionComponent, IFormElem
      */
     get nativeInput(): HTMLInputElement | null;
     get nativeInputWidth(): number;
-    getLabelableElementId(): string;
-    getSuggestionByListItem(item: SuggestionListItem): SuggestionItem;
+    getSuggestionByListItem(item: SuggestionListItem): IInputSuggestionItem;
     /**
      * Returns if the suggestions popover is scrollable.
-     * The method returns <code>Promise</code> that resolves to true,
+     * The method returns `Promise` that resolves to true,
      * if the popup is scrollable and false otherwise.
-     * @returns {Promise}
      */
-    isSuggestionsScrollable(): Promise<boolean>;
-    getInputId(): string;
+    isSuggestionsScrollable(): boolean | Promise<boolean>;
     onItemMouseOver(e: MouseEvent): void;
     onItemMouseOut(e: MouseEvent): void;
     onItemMouseDown(e: MouseEvent): void;
-    onItemSelected(item: SuggestionItem, keyboardUsed: boolean): void;
-    onItemPreviewed(item: SuggestionListItem): void;
+    onItemSelected(suggestionItem: SuggestionItem, listItem: SuggestionListItem | null, keyboardUsed: boolean): void;
+    onItemSelect(item: SuggestionListItem): void;
     get valueStateTypeMappings(): {
-        Success: string;
+        Positive: string;
         Information: string;
-        Error: string;
-        Warning: string;
+        Negative: string;
+        Critical: string;
     };
     valueStateTextMappings(): {
-        Success: string;
+        Positive: string;
         Information: string;
-        Error: string;
-        Warning: string;
+        Negative: string;
+        Critical: string;
     };
     announceSelectedItem(): void;
+    fireSelectionChange(item: IInputSuggestionItem | null, targetRef: SuggestionListItem | null, isValueFromSuggestions: boolean): void;
+    fireResetSelectionChange(): void;
     get _readonly(): boolean;
     get _headerTitleText(): string;
     get clearIconAccessibleName(): string;
     get inputType(): string;
     get isTypeNumber(): boolean;
-    get suggestionsTextId(): string;
-    get valueStateTextId(): string;
+    get suggestionsTextId(): "" | "suggestionsText";
+    get valueStateTextId(): "" | "valueStateDesc";
     get accInfo(): {
         input: {
             ariaRoledescription: string | undefined;
@@ -576,7 +486,6 @@ declare class Input extends UI5Element implements SuggestionComponent, IFormElem
         };
     };
     get suggestionSeparators(): string;
-    get valueStateMessageText(): Node[];
     get shouldDisplayOnlyValueStateMessage(): boolean;
     get shouldDisplayDefaultValueStateMessage(): boolean;
     get hasValueState(): boolean;
@@ -596,7 +505,7 @@ declare class Input extends UI5Element implements SuggestionComponent, IFormElem
      * This method is relevant for sap_horizon theme only
      */
     get _valueStateInputIcon(): string;
-    get _valueStatePopoverHorizontalAlign(): "Left" | "Right";
+    get _valueStatePopoverHorizontalAlign(): `${PopoverHorizontalAlign}`;
     /**
      * This method is relevant for sap_horizon theme only
      */
@@ -609,15 +518,14 @@ declare class Input extends UI5Element implements SuggestionComponent, IFormElem
     /**
      * Sets the caret to a certain position inside the native input
      * @protected
-     * @param pos
      */
     setCaretPosition(pos: number | null): void;
     /**
      * Removes the fractional part of floating-point number.
-     * @param {string} value the numeric value of Input of type "Number"
+     * @param value the numeric value of Input of type "Number"
      */
     removeFractionalPart(value: string): string;
     static onDefine(): Promise<void>;
 }
 export default Input;
-export type { InputSuggestionScrollEventDetail, InputSuggestionItemSelectEventDetail, InputSuggestionItemPreviewEventDetail, };
+export type { IInputSuggestionItem, InputSuggestionScrollEventDetail, InputSelectionChangeEventDetail, InputEventDetail, };