@ui5/webcomponents 0.0.0-97cba4b0b → 0.0.0-99b763015

package/src/ComboBox.ts

@@ -1,1229 +0,0 @@
-import UI5Element from "@ui5/webcomponents-base/dist/UI5Element.js";
-import customElement from "@ui5/webcomponents-base/dist/decorators/customElement.js";
-import property from "@ui5/webcomponents-base/dist/decorators/property.js";
-import event from "@ui5/webcomponents-base/dist/decorators/event.js";
-import slot from "@ui5/webcomponents-base/dist/decorators/slot.js";
-import litRender from "@ui5/webcomponents-base/dist/renderer/LitRenderer.js";
-import ValueState from "@ui5/webcomponents-base/dist/types/ValueState.js";
-import { isPhone, isAndroid, isSafari } from "@ui5/webcomponents-base/dist/Device.js";
-import Integer from "@ui5/webcomponents-base/dist/types/Integer.js";
-import InvisibleMessageMode from "@ui5/webcomponents-base/dist/types/InvisibleMessageMode.js";
-import { getEffectiveAriaLabelText } from "@ui5/webcomponents-base/dist/util/AriaLabelHelper.js";
-import announce from "@ui5/webcomponents-base/dist/util/InvisibleMessage.js";
-import "@ui5/webcomponents-icons/dist/slim-arrow-down.js";
-import "@ui5/webcomponents-icons/dist/decline.js";
-import "@ui5/webcomponents-icons/dist/not-editable.js";
-import "@ui5/webcomponents-icons/dist/error.js";
-import "@ui5/webcomponents-icons/dist/alert.js";
-import "@ui5/webcomponents-icons/dist/sys-enter-2.js";
-import "@ui5/webcomponents-icons/dist/information.js";
-import type I18nBundle from "@ui5/webcomponents-base/dist/i18nBundle.js";
-import { getI18nBundle } from "@ui5/webcomponents-base/dist/i18nBundle.js";
-import { getFeature } from "@ui5/webcomponents-base/dist/FeaturesRegistry.js";
-import {
-	isBackSpace,
-	isDelete,
-	isShow,
-	isUp,
-	isDown,
-	isEnter,
-	isEscape,
-	isTabNext,
-	isTabPrevious,
-	isPageUp,
-	isPageDown,
-	isHome,
-	isEnd,
-} from "@ui5/webcomponents-base/dist/Keys.js";
-import * as Filters from "./Filters.js";
-
-import {
-	VALUE_STATE_SUCCESS,
-	VALUE_STATE_ERROR,
-	VALUE_STATE_WARNING,
-	VALUE_STATE_INFORMATION,
-	VALUE_STATE_TYPE_SUCCESS,
-	VALUE_STATE_TYPE_INFORMATION,
-	VALUE_STATE_TYPE_ERROR,
-	VALUE_STATE_TYPE_WARNING,
-	INPUT_SUGGESTIONS_TITLE,
-	SELECT_OPTIONS,
-	LIST_ITEM_POSITION,
-	LIST_ITEM_GROUP_HEADER,
-} from "./generated/i18n/i18n-defaults.js";
-
-// Templates
-import ComboBoxTemplate from "./generated/templates/ComboBoxTemplate.lit.js";
-import ComboBoxPopoverTemplate from "./generated/templates/ComboBoxPopoverTemplate.lit.js";
-
-// Styles
-import ComboBoxCss from "./generated/themes/ComboBox.css.js";
-import ComboBoxPopoverCss from "./generated/themes/ComboBoxPopover.css.js";
-import ResponsivePopoverCommonCss from "./generated/themes/ResponsivePopoverCommon.css.js";
-import ValueStateMessageCss from "./generated/themes/ValueStateMessage.css.js";
-import SuggestionsCss from "./generated/themes/Suggestions.css.js";
-
-import ComboBoxItem from "./ComboBoxItem.js";
-import Icon from "./Icon.js";
-import Popover from "./Popover.js";
-import ResponsivePopover from "./ResponsivePopover.js";
-import List from "./List.js";
-import type { ClickEventDetail } from "./List.js";
-import BusyIndicator from "./BusyIndicator.js";
-import Button from "./Button.js";
-import StandardListItem from "./StandardListItem.js";
-import ComboBoxGroupItem from "./ComboBoxGroupItem.js";
-import GroupHeaderListItem from "./GroupHeaderListItem.js";
-import ComboBoxFilter from "./types/ComboBoxFilter.js";
-import type FormSupportT from "./features/InputElementsFormSupport.js";
-import PopoverHorizontalAlign from "./types/PopoverHorizontalAlign.js";
-
-const SKIP_ITEMS_SIZE = 10;
-
-type ValueStateAnnouncement = Record<Exclude<ValueState, ValueState.None>, string>;
-type ValueStateTypeAnnouncement = Record<Exclude<ValueState, ValueState.None>, string>;
-
-type ComboBoxListItem = StandardListItem & {
-	mappedItem: ComboBoxItem
-};
-
-enum ValueStateIconMapping {
-	Error = "error",
-	Warning = "alert",
-	Success = "sys-enter-2",
-	Information = "information",
-}
-
-type ComboBoxSelectionChangeEventDetail = {
-	item: ComboBoxItem,
-};
-
-interface IComboBoxItem extends UI5Element {
-	text: string,
-	focused: boolean,
-	isGroupItem: boolean,
-	selected?: boolean,
-	additionalText?: string,
-}
-
-/**
- * @class
- *
- * <h3 class="comment-api-title">Overview</h3>
- *
- * The <code>ui5-combobox</code> component represents a drop-down menu with a list of the available options and a text input field to narrow down the options.
- *
- * It is commonly used to enable users to select an option from a predefined list.
- *
- * <h3>Structure</h3>
- * The <code>ui5-combobox</code> consists of the following elements:
- *
- * <ul>
- * <li> Input field - displays the selected option or a custom user entry. Users can type to narrow down the list or enter their own value.</li>
- * <li> Drop-down arrow - expands\collapses the option list.</li>
- * <li> Option list - the list of available options.</li>
- * </ul>
- *
- * <h3>Keyboard Handling</h3>
- *
- * The <code>ui5-combobox</code> provides advanced keyboard handling.
- * <br>
- *
- * <ul>
- * <li>[F4], [ALT]+[UP], or [ALT]+[DOWN] - Toggles the picker.</li>
- * <li>[ESC] - Closes the picker, if open. If closed, cancels changes and reverts the typed in value.</li>
- * <li>[ENTER] or [RETURN] - If picker is open, takes over the currently selected item and closes it.</li>
- * <li>[DOWN] - Selects the next matching item in the picker.</li>
- * <li>[UP] - Selects the previous matching item in the picker.</li>
- * <li>[PAGEDOWN] - Moves selection down by page size (10 items by default).</li>
- * <li>[PAGEUP] - Moves selection up by page size (10 items by default). </li>
- * <li>[HOME] - If focus is in the ComboBox, moves cursor at the beginning of text. If focus is in the picker, selects the first item.</li>
- * <li>[END] - If focus is in the ComboBox, moves cursor at the end of text. If focus is in the picker, selects the last item.</li>
- * </ul>
- *
- *
- * <h3>ES6 Module Import</h3>
- *
- * <code>import "@ui5/webcomponents/dist/ComboBox";</code>
- *
- *
- * @constructor
- * @author SAP SE
- * @alias sap.ui.webc.main.ComboBox
- * @extends sap.ui.webc.base.UI5Element
- * @tagname ui5-combobox
- * @appenddocs sap.ui.webc.main.ComboBoxItem sap.ui.webc.main.ComboBoxGroupItem
- * @public
- * @since 1.0.0-rc.6
- */
-@customElement({
-	tag: "ui5-combobox",
-	languageAware: true,
-	renderer: litRender,
-	styles: ComboBoxCss,
-	staticAreaStyles: [
-		ResponsivePopoverCommonCss,
-		ValueStateMessageCss,
-		ComboBoxPopoverCss,
-		SuggestionsCss,
-	],
-	template: ComboBoxTemplate,
-	staticAreaTemplate: ComboBoxPopoverTemplate,
-	dependencies: [
-		ComboBoxItem,
-		Icon,
-		ResponsivePopover,
-		List,
-		BusyIndicator,
-		Button,
-		StandardListItem,
-		GroupHeaderListItem,
-		Popover,
-		ComboBoxGroupItem,
-	],
-})
-/**
- * Fired when the input operation has finished by pressing Enter, focusout or an item is selected.
- *
- * @event sap.ui.webc.main.ComboBox#change
- * @public
- */
-@event("change")
-
-/**
- * Fired when typing in input.
- * <br><br>
- * <b>Note:</b> filterValue property is updated, input is changed.
- * @event sap.ui.webc.main.ComboBox#input
- * @public
- */
-@event("input")
-/**
- * Fired when selection is changed by user interaction
- *
- * @event sap.ui.webc.main.ComboBox#selection-change
- * @param {sap.ui.webc.main.IComboBoxItem} item item to be selected.
- * @public
- */
-@event("selection-change", {
-	detail: {
-		item: { type: HTMLElement },
-	},
-})
-
-class ComboBox extends UI5Element {
-	/**
-	 * Defines the value of the component.
-	 *
-	 * @type {string}
-	 * @name sap.ui.webc.main.ComboBox.prototype.value
-	 * @defaultvalue ""
-	 * @formEvents change input
-	 * @formProperty
-	 * @public
-	 */
-	@property()
-	value!: string;
-
-	/**
-	 * Defines the "live" value of the component.
-	 * <br><br>
-	 * <b>Note:</b> If we have an item e.g. "Bulgaria", "B" is typed, "ulgaria" is typed ahead, value will be "Bulgaria", filterValue will be "B".
-	 *
-	 * <br><br>
-	 * <b>Note:</b> Initially the filter value is synced with value.
-	 *
-	 * @type {string}
-	 * @defaultvalue ""
-	 * @private
-	 */
-	@property()
-	filterValue!: string;
-
-	/**
-	 * 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.ComboBox.prototype.placeholder
-	 * @defaultvalue ""
-	 * @public
-	 */
-	@property()
-	placeholder!: string;
-
-	/**
-	 * 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.ComboBox.prototype.disabled
-	 * @defaultvalue false
-	 * @public
-	 */
-	@property({ type: Boolean })
-	disabled!: boolean;
-
-	/**
-	 * Defines the value state of the component.
-	 * <br><br>
-	 * Available options are:
-	 * <ul>
-	 * <li><code>None</code></li>
-	 * <li><code>Error</code></li>
-	 * <li><code>Warning</code></li>
-	 * <li><code>Success</code></li>
-	 * <li><code>Information</code></li>
-	 * </ul>
-	 *
-	 * @type {sap.ui.webc.base.types.ValueState}
-	 * @name sap.ui.webc.main.ComboBox.prototype.valueState
-	 * @defaultvalue "None"
-	 * @public
-	 */
-	@property({ type: ValueState, defaultValue: ValueState.None })
-	valueState!: ValueState;
-
-	/**
-	 * 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.ComboBox.prototype.readonly
-	 * @defaultvalue false
-	 * @public
-	 */
-	@property({ type: Boolean })
-	readonly!: boolean;
-
-	/**
-	 * Defines whether the component is required.
-	 *
-	 * @type {boolean}
-	 * @name sap.ui.webc.main.ComboBox.prototype.required
-	 * @defaultvalue false
-	 * @public
-	 */
-	@property({ type: Boolean })
-	required!: boolean;
-
-	/**
-	 * Indicates whether a loading indicator should be shown in the picker.
-	 *
-	 * @type {boolean}
-	 * @name sap.ui.webc.main.ComboBox.prototype.loading
-	 * @defaultvalue false
-	 * @public
-	 */
-	@property({ type: Boolean })
-	loading!: boolean;
-
-	/**
-	 * Defines the filter type of the component.
-	 * Available options are: <code>StartsWithPerTerm</code>, <code>StartsWith</code>, <code>Contains</code> and <code>None</code>.
-	 *
-	 * @type {string}
-	 * @name sap.ui.webc.main.ComboBox.prototype.filter
-	 * @defaultvalue "StartsWithPerTerm"
-	 * @public
-	 */
-	@property({ type: ComboBoxFilter, defaultValue: ComboBoxFilter.StartsWithPerTerm })
-	filter!: ComboBoxFilter;
-
-	/**
-	 * Indicates whether the input is focssed
-	 * @private
-	 */
-	@property({ type: Boolean })
-	focused!: boolean;
-
-	/**
-	 * Indicates whether the visual focus is on the value state header
-	 * @private
-	 */
-	@property({ type: Boolean })
-	_isValueStateFocused!: boolean;
-
-	/**
-	 * Defines the accessible ARIA name of the component.
-	 *
-	 * @type {string}
-	 * @name sap.ui.webc.main.ComboBox.prototype.accessibleName
-	 * @defaultvalue: ""
-	 * @public
-	 * @since 1.0.0-rc.15
-	 */
-	@property()
-	accessibleName!: string;
-
-	/**
-	 * Receives id(or many ids) of the elements that label the component
-	 * @type {string}
-	 * @name sap.ui.webc.main.ComboBox.prototype.accessibleNameRef
-	 * @defaultvalue ""
-	 * @public
-	 * @since 1.0.0-rc.15
-	 */
-	@property()
-	accessibleNameRef!: string;
-
-	@property({ type: Boolean, noAttribute: true })
-	_iconPressed!: boolean;
-
-	@property({ type: Object, noAttribute: true, multiple: true })
-	_filteredItems!: Array<IComboBoxItem>;
-
-	@property({ validator: Integer, noAttribute: true })
-	_listWidth!: number;
-
-	/**
-	 * Defines the component items.
-	 *
-	 * @type {sap.ui.webc.main.IComboBoxItem[]}
-	 * @name sap.ui.webc.main.ComboBox.prototype.default
-	 * @slot items
-	 * @public
-	 */
-	@slot({ type: HTMLElement, "default": true, invalidateOnChildChange: true })
-	items!: Array<IComboBoxItem>;
-
-	/**
-	 * Defines the value state message that will be displayed as pop up under the component.
-	 * <br><br>
-	 *
-	 * <b>Note:</b> If not specified, a default text (in the respective language) will be displayed.
-	 * <br>
-	 * <b>Note:</b> The <code>valueStateMessage</code> would be displayed,
-	 * when the <code>ui5-combobox</code> is in <code>Information</code>, <code>Warning</code> or <code>Error</code> value state.
-	 * @type {HTMLElement[]}
-	 * @name sap.ui.webc.main.ComboBox.prototype.valueStateMessage
-	 * @since 1.0.0-rc.9
-	 * @slot
-	 * @public
-	 */
-	@slot()
-	valueStateMessage!: Array<HTMLElement>;
-
-	/**
-	 * Defines the icon to be displayed in the input field.
-	 *
-	 * @type {sap.ui.webc.main.IIcon[]}
-	 * @name sap.ui.webc.main.ComboBox.prototype.icon
-	 * @slot
-	 * @public
-	 * @since 1.0.0-rc.9
-	 */
-	@slot()
-	icon!: Array<Icon>;
-
-	_initialRendering: boolean;
-	_itemFocused: boolean;
-	// used only for Safari fix (check onAfterRendering)
-	_autocomplete: boolean;
-	_isKeyNavigation: boolean;
-	_selectionPerformed: boolean;
-	_lastValue: string;
-	_selectedItemText: string;
-	_userTypedValue: string;
-	responsivePopover?: ResponsivePopover;
-	valueStatePopover?: Popover;
-	FormSupport?: typeof FormSupportT;
-	static i18nBundle: I18nBundle;
-
-	constructor() {
-		super();
-
-		this._filteredItems = [];
-		this._initialRendering = true;
-		this._itemFocused = false;
-		this._autocomplete = false;
-		this._isKeyNavigation = false;
-		this._lastValue = "";
-		this._selectionPerformed = false;
-		this._selectedItemText = "";
-		this._userTypedValue = "";
-	}
-
-	onBeforeRendering() {
-		const popover: Popover | undefined = this.valueStatePopover;
-
-		this.FormSupport = getFeature<typeof FormSupportT>("FormSupport");
-
-		if (this._initialRendering || this.filter === "None") {
-			this._filteredItems = this.items;
-		}
-
-		if (!this._initialRendering && document.activeElement === this && !this._filteredItems.length) {
-			popover?.close();
-		}
-
-		this._selectMatchingItem();
-		this._initialRendering = false;
-
-		const slottedIconsCount = this.icon.length || 0;
-		const arrowDownIconsCount = this.readonly ? 0 : 1;
-		this.style.setProperty("--_ui5-input-icons-count", `${slottedIconsCount + arrowDownIconsCount}`);
-	}
-
-	async onAfterRendering() {
-		const picker: ResponsivePopover = await this._getPicker();
-
-		if (isPhone() && picker.opened) {
-			// Set initial focus to the native input
-			this.inner.focus();
-		}
-
-		if ((await this.shouldClosePopover()) && !isPhone()) {
-			picker.close(false, false, true);
-			this._clearFocus();
-			this._itemFocused = false;
-		}
-
-		this.toggleValueStatePopover(this.shouldOpenValueStateMessagePopover);
-		this.storeResponsivePopoverWidth();
-
-		// Safari is quite slow and does not preserve text highlighting on control rerendering.
-		// That's why we need to restore it "manually".
-		if (isSafari() && this._autocomplete && this.filterValue !== this.value) {
-			this.inner.setSelectionRange(
-				(this._isKeyNavigation ? 0 : this.filterValue.length),
-				this.value.length,
-			);
-		}
-	}
-
-	async shouldClosePopover(): Promise<boolean> {
-		const popover: ResponsivePopover = await this._getPicker();
-
-		return popover.opened && !this.focused && !this._itemFocused && !this._isValueStateFocused;
-	}
-
-	_focusin(e: FocusEvent) {
-		this.focused = true;
-		this._lastValue = this.value;
-		this._autocomplete = false;
-
-		!isPhone() && (e.target as HTMLInputElement).setSelectionRange(0, this.value.length);
-	}
-
-	_focusout(e: FocusEvent) {
-		const toBeFocused = e.relatedTarget as HTMLElement;
-		const focusedOutToValueStateMessage = toBeFocused?.shadowRoot?.querySelector(".ui5-valuestatemessage-root");
-
-		this._fireChangeEvent();
-
-		if (focusedOutToValueStateMessage) {
-			e.stopImmediatePropagation();
-			return;
-		}
-
-		if (!(this.shadowRoot!.contains(toBeFocused)) && (this.staticAreaItem !== e.relatedTarget)) {
-			this.focused = false;
-			!isPhone() && this._closeRespPopover(e);
-		}
-	}
-
-	_afterOpenPopover() {
-		this._iconPressed = true;
-	}
-
-	_afterClosePopover() {
-		this._iconPressed = false;
-		this._filteredItems = this.items;
-
-		// close device's keyboard and prevent further typing
-		if (isPhone()) {
-			this.blur();
-		}
-
-		if (this._selectionPerformed) {
-			this._lastValue = this.value;
-			this._selectionPerformed = false;
-		}
-	}
-
-	async _toggleRespPopover() {
-		const picker: ResponsivePopover = await this._getPicker();
-
-		if (picker.opened) {
-			this._closeRespPopover();
-		} else {
-			this._openRespPopover();
-		}
-	}
-
-	async storeResponsivePopoverWidth() {
-		if (this.open && !this._listWidth) {
-			this._listWidth = (await this._getPicker()).offsetWidth;
-		}
-	}
-
-	toggleValueStatePopover(open: boolean) {
-		if (open) {
-			this.openValueStatePopover();
-		} else {
-			this.closeValueStatePopover();
-		}
-	}
-
-	async openValueStatePopover() {
-		(await this._getValueStatePopover())?.showAt(this);
-	}
-
-	async closeValueStatePopover() {
-		(await this._getValueStatePopover())?.close();
-	}
-
-	async _getValueStatePopover() {
-		const staticAreaItem = await this.getStaticAreaItemDomRef();
-		const popover: Popover = staticAreaItem!.querySelector<Popover>(".ui5-valuestatemessage-popover")!;
-
-		// backward compatibility
-		// rework all methods to work with async getters
-		this.valueStatePopover = popover;
-
-		return popover;
-	}
-
-	_resetFilter() {
-		this._userTypedValue = "";
-		this.inner.setSelectionRange(0, this.value.length);
-		this._filteredItems = this._filterItems("");
-		this._selectMatchingItem();
-	}
-
-	_arrowClick() {
-		this.inner.focus();
-		this._resetFilter();
-
-		if (isPhone() && this.value && !this._lastValue) {
-			this._lastValue = this.value;
-		}
-
-		this._toggleRespPopover();
-	}
-
-	_input(e: InputEvent) {
-		const { value } = e.target as HTMLInputElement;
-		const shouldAutocomplete = this.shouldAutocomplete(e);
-
-		if (e.target === this.inner) {
-			// stop the native event, as the semantic "input" would be fired.
-			e.stopImmediatePropagation();
-			this.focused = true;
-			this._isValueStateFocused = false;
-		}
-
-		this._filteredItems = this._filterItems(value);
-
-		this.value = value;
-		this.filterValue = value;
-
-		this._clearFocus();
-
-		// autocomplete
-		if (shouldAutocomplete && !isAndroid()) {
-			const item = this._getFirstMatchingItem(value);
-			item && this._applyAtomicValueAndSelection(item, value, true);
-
-			if (value !== "" && (item && !item.selected && !item.isGroupItem)) {
-				this.fireEvent<ComboBoxSelectionChangeEventDetail>("selection-change", {
-					item,
-				});
-			}
-		}
-
-		this.fireEvent("input");
-
-		if (isPhone()) {
-			return;
-		}
-
-		if (!this._filteredItems.length || value === "") {
-			this._closeRespPopover();
-		} else {
-			this._openRespPopover();
-		}
-	}
-	shouldAutocomplete(e: InputEvent): boolean {
-		const eventType = e.inputType;
-		const allowedEventTypes = [
-			"deleteWordBackward",
-			"deleteWordForward",
-			"deleteSoftLineBackward",
-			"deleteSoftLineForward",
-			"deleteEntireSoftLine",
-			"deleteHardLineBackward",
-			"deleteHardLineForward",
-			"deleteByDrag",
-			"deleteByCut",
-			"deleteContent",
-			"deleteContentBackward",
-			"deleteContentForward",
-			"historyUndo",
-		];
-
-		return !allowedEventTypes.includes(eventType);
-	}
-
-	_startsWithMatchingItems(str: string): Array<IComboBoxItem> {
-		return Filters.StartsWith(str, this._filteredItems, "text");
-	}
-
-	_clearFocus() {
-		this._filteredItems.map(item => {
-			item.focused = false;
-
-			return item;
-		});
-	}
-
-	handleNavKeyPress(e: KeyboardEvent) {
-		if (this.focused && (isHome(e) || isEnd(e)) && this.value) {
-			return;
-		}
-
-		const isOpen = this.open;
-		const currentItem = this._filteredItems.find(item => {
-			return isOpen ? item.focused : item.selected;
-		});
-
-		const indexOfItem = currentItem ? this._filteredItems.indexOf(currentItem) : -1;
-
-		e.preventDefault();
-
-		if (this.focused && isOpen && (isUp(e) || isPageUp(e) || isPageDown(e))) {
-			return;
-		}
-
-		if (this._filteredItems.length - 1 === indexOfItem && isDown(e)) {
-			return;
-		}
-
-		this._isKeyNavigation = true;
-
-		if (
-			e.key === "ArrowDown"
-			|| e.key === "ArrowUp"
-			|| e.key === "PageUp"
-			|| e.key === "PageDown"
-			|| e.key === "Home"
-			|| e.key === "End"
-		) {
-			this[`_handle${e.key}`](e, indexOfItem);
-		}
-	}
-
-	_handleItemNavigation(e: KeyboardEvent, indexOfItem: number, isForward: boolean) {
-		const isOpen = this.open;
-		const currentItem = this._filteredItems[indexOfItem];
-		const nextItem = isForward ? this._filteredItems[indexOfItem + 1] : this._filteredItems[indexOfItem - 1];
-		const isGroupItem = currentItem && currentItem.isGroupItem;
-
-		if ((!isOpen) && ((isGroupItem && !nextItem) || (!isGroupItem && !currentItem))) {
-			return;
-		}
-
-		this._clearFocus();
-
-		if (isOpen) {
-			this._itemFocused = true;
-			this.value = isGroupItem ? "" : currentItem.text;
-			this.focused = false;
-			currentItem.focused = true;
-		} else {
-			this.focused = true;
-			this.value = isGroupItem ? nextItem.text : currentItem.text;
-			currentItem.focused = false;
-		}
-
-		this._isValueStateFocused = false;
-
-		this._announceSelectedItem(indexOfItem);
-
-		if (isGroupItem && isOpen) {
-			return;
-		}
-
-		// autocomplete
-		const item = this._getFirstMatchingItem(this.value);
-		item && this._applyAtomicValueAndSelection(item, (this.open ? this._userTypedValue : ""), true);
-
-		if ((item && !item.selected)) {
-			this.fireEvent<ComboBoxSelectionChangeEventDetail>("selection-change", {
-				item,
-			});
-		}
-
-		this.fireEvent("input");
-		this._fireChangeEvent();
-	}
-
-	_handleArrowDown(e: KeyboardEvent, indexOfItem: number) {
-		const isOpen = this.open;
-
-		if (this.focused && indexOfItem === -1 && this.hasValueStateText && isOpen) {
-			this._isValueStateFocused = true;
-			this.focused = false;
-			return;
-		}
-
-		indexOfItem = !isOpen && this.hasValueState && indexOfItem === -1 ? 0 : indexOfItem;
-
-		this._handleItemNavigation(e, ++indexOfItem, true /* isForward */);
-	}
-
-	_handleArrowUp(e: KeyboardEvent, indexOfItem: number) {
-		const isOpen = this.open;
-
-		if (indexOfItem === 0 && !this.hasValueStateText) {
-			this._clearFocus();
-			this.focused = true;
-			this._itemFocused = false;
-			return;
-		}
-
-		if (indexOfItem === 0 && this.hasValueStateText && isOpen) {
-			this._clearFocus();
-			this._itemFocused = false;
-			this._isValueStateFocused = true;
-			this._filteredItems[0].selected = false;
-			return;
-		}
-
-		if (this._isValueStateFocused) {
-			this.focused = true;
-			this._isValueStateFocused = false;
-			return;
-		}
-
-		indexOfItem = !isOpen && this.hasValueState && indexOfItem === -1 ? 0 : indexOfItem;
-		this._handleItemNavigation(e, --indexOfItem, false /* isForward */);
-	}
-
-	_handlePageUp(e: KeyboardEvent, indexOfItem: number) {
-		const isProposedIndexValid = indexOfItem - SKIP_ITEMS_SIZE > -1;
-		indexOfItem = isProposedIndexValid ? indexOfItem - SKIP_ITEMS_SIZE : 0;
-		const shouldMoveForward = this._filteredItems[indexOfItem].isGroupItem && !this.open;
-
-		if (!isProposedIndexValid && this.hasValueStateText && this.open) {
-			this._clearFocus();
-			this._itemFocused = false;
-			this._isValueStateFocused = true;
-			return;
-		}
-
-		this._handleItemNavigation(e, indexOfItem, shouldMoveForward);
-	}
-
-	_handlePageDown(e: KeyboardEvent, indexOfItem: number) {
-		const itemsLength = this._filteredItems.length;
-		const isProposedIndexValid = indexOfItem + SKIP_ITEMS_SIZE < itemsLength;
-
-		indexOfItem = isProposedIndexValid ? indexOfItem + SKIP_ITEMS_SIZE : itemsLength - 1;
-		const shouldMoveForward = this._filteredItems[indexOfItem].isGroupItem && !this.open;
-
-		this._handleItemNavigation(e, indexOfItem, shouldMoveForward);
-	}
-
-	_handleHome(e: KeyboardEvent) {
-		const shouldMoveForward = this._filteredItems[0].isGroupItem && !this.open;
-
-		if (this.hasValueStateText && this.open) {
-			this._clearFocus();
-			this._itemFocused = false;
-			this._isValueStateFocused = true;
-			return;
-		}
-
-		this._handleItemNavigation(e, 0, shouldMoveForward);
-	}
-
-	_handleEnd(e: KeyboardEvent) {
-		this._handleItemNavigation(e, this._filteredItems.length - 1, true /* isForward */);
-	}
-
-	_keyup() {
-		this._userTypedValue = this.value.substring(0, this.inner.selectionStart || 0);
-	}
-
-	_keydown(e: KeyboardEvent) {
-		const isNavKey = isDown(e) || isUp(e) || isPageUp(e) || isPageDown(e) || isHome(e) || isEnd(e);
-		const picker = this.responsivePopover;
-
-		this._autocomplete = !(isBackSpace(e) || isDelete(e));
-		this._isKeyNavigation = false;
-
-		if (isNavKey && !this.readonly && this._filteredItems.length) {
-			this.handleNavKeyPress(e);
-		}
-
-		if (isEnter(e)) {
-			this._fireChangeEvent();
-
-			if (picker?.opened) {
-				this._closeRespPopover();
-				this.focused = true;
-			} else if (this.FormSupport) {
-				this.FormSupport.triggerFormSubmit(this);
-			}
-		}
-
-		if (isEscape(e)) {
-			this.focused = true;
-			this.value = !this.open ? this._lastValue : this.value;
-			this._isValueStateFocused = false;
-		}
-
-		if ((isTabNext(e) || isTabPrevious(e)) && this.open) {
-			this._closeRespPopover();
-		}
-
-		if (isShow(e) && !this.readonly && !this.disabled) {
-			e.preventDefault();
-
-			this._resetFilter();
-			this._toggleRespPopover();
-
-			const selectedItem = this._filteredItems.find(item => {
-				return item.selected;
-			});
-
-			if (selectedItem && this.open) {
-				this._itemFocused = true;
-				selectedItem.focused = true;
-				this.focused = false;
-			} else if (this.open && this._filteredItems.length) {
-				// If no item is selected, select the first one on "Show" (F4, Alt+Up/Down)
-				this._handleItemNavigation(e, 0, true /* isForward */);
-			} else {
-				this.focused = true;
-			}
-		}
-	}
-
-	_click() {
-		if (isPhone() && !this.readonly) {
-			this._openRespPopover();
-		}
-	}
-
-	_closeRespPopover(e?: Event) {
-		const picker = this.responsivePopover;
-
-		if (e && (e.target as HTMLElement).classList.contains("ui5-responsive-popover-close-btn") && this._selectedItemText) {
-			this.value = this._selectedItemText;
-			this.filterValue = this._selectedItemText;
-		}
-
-		if (e && (e.target as HTMLElement).classList.contains("ui5-responsive-popover-close-btn")) {
-			this.value = this._lastValue || "";
-			this.filterValue = this._lastValue || "";
-		}
-
-		if (isPhone()) {
-			this._fireChangeEvent();
-		}
-
-		this._isValueStateFocused = false;
-		this._clearFocus();
-
-		picker?.close();
-	}
-
-	async _openRespPopover() {
-		(await this._getPicker()).showAt(this);
-	}
-
-	_filterItems(str: string) {
-		const itemsToFilter = this.items.filter(item => !item.isGroupItem);
-		const filteredItems = (Filters[this.filter] || Filters.StartsWithPerTerm)(str, itemsToFilter, "text");
-
-		// Return the filtered items and their group items
-		return this.items.filter((item, idx, allItems) => ComboBox._groupItemFilter(item, ++idx, allItems, filteredItems) || filteredItems.indexOf(item) !== -1);
-	}
-
-	/**
-	 * Returns true if the group header should be shown (if there is a filtered suggestion item for this group item)
-	 *
-	 * @private
-	 */
-	static _groupItemFilter(item: IComboBoxItem, idx: number, allItems: Array<IComboBoxItem>, filteredItems: Array<IComboBoxItem>) {
-		if (item.isGroupItem) {
-			let groupHasFilteredItems;
-
-			while (allItems[idx] && !allItems[idx].isGroupItem && !groupHasFilteredItems) {
-				groupHasFilteredItems = filteredItems.indexOf(allItems[idx]) !== -1;
-				idx++;
-			}
-
-			return groupHasFilteredItems;
-		}
-	}
-
-	_getFirstMatchingItem(current: string): ComboBoxItem | undefined {
-		const currentlyFocusedItem = this.items.find(item => item.focused === true);
-
-		if (currentlyFocusedItem?.isGroupItem) {
-			this.value = this.filterValue;
-			return;
-		}
-
-		const matchingItems: Array<ComboBoxItem> = (this._startsWithMatchingItems(current).filter(item => !item.isGroupItem) as Array<ComboBoxItem>);
-
-		if (matchingItems.length) {
-			return matchingItems[0];
-		}
-	}
-
-	_applyAtomicValueAndSelection(item: ComboBoxItem, filterValue: string, highlightValue: boolean) {
-		const value = (item && item.text) || "";
-
-		this.inner.value = value;
-		if (highlightValue) {
-			this.inner.setSelectionRange(filterValue.length, value.length);
-		}
-		this.value = value;
-	}
-
-	_selectMatchingItem() {
-		const currentlyFocusedItem = this.items.find(item => item.focused);
-		const shouldSelectionBeCleared = currentlyFocusedItem && currentlyFocusedItem.isGroupItem;
-
-		this._filteredItems = this._filteredItems.map(item => {
-			item.selected = !item.isGroupItem && (item.text === this.value) && !shouldSelectionBeCleared;
-			return item;
-		});
-	}
-
-	_fireChangeEvent() {
-		if (this.value !== this._lastValue) {
-			this.fireEvent("change");
-			this._lastValue = this.value;
-		}
-	}
-
-	_inputChange(e: Event) {
-		e.preventDefault();
-	}
-
-	_itemMousedown(e: MouseEvent) {
-		e.preventDefault();
-	}
-
-	_selectItem(e: CustomEvent<ClickEventDetail>) {
-		const listItem = e.detail.item as ComboBoxListItem;
-
-		this._selectedItemText = listItem.mappedItem.text;
-		this._selectionPerformed = true;
-
-		const sameItemSelected = this.value === this._selectedItemText;
-		const sameSelectionPerformed = this.value.toLowerCase() === this.filterValue.toLowerCase();
-
-		if (sameItemSelected && sameSelectionPerformed) {
-			this._fireChangeEvent(); // Click on an already typed, but not memoized value shouold also trigger the change event
-			return this._closeRespPopover();
-		}
-
-		this.value = this._selectedItemText;
-
-		if (!listItem.mappedItem.selected) {
-			this.fireEvent<ComboBoxSelectionChangeEventDetail>("selection-change", {
-				item: listItem.mappedItem,
-			});
-		}
-
-		this._filteredItems.map(item => {
-			item.selected = (item === listItem.mappedItem && !item.isGroupItem);
-			return item;
-		});
-
-		this._fireChangeEvent();
-		this._closeRespPopover();
-
-		// reset selection
-		this.inner.setSelectionRange(this.value.length, this.value.length);
-	}
-
-	_onItemFocus() {
-		this._itemFocused = true;
-	}
-
-	_announceSelectedItem(indexOfItem: number) {
-		const currentItem = this._filteredItems[indexOfItem];
-		const currentItemAdditionalText = currentItem.additionalText || "";
-		const isGroupItem = currentItem?.isGroupItem;
-		const itemPositionText = ComboBox.i18nBundle.getText(LIST_ITEM_POSITION, indexOfItem + 1, this._filteredItems.length);
-		const groupHeaderText = ComboBox.i18nBundle.getText(LIST_ITEM_GROUP_HEADER);
-
-		if (isGroupItem) {
-			announce(`${groupHeaderText} ${currentItem.text} ${itemPositionText}`, InvisibleMessageMode.Polite);
-		} else {
-			announce(`${currentItemAdditionalText} ${itemPositionText}`.trim(), InvisibleMessageMode.Polite);
-		}
-	}
-
-	get _headerTitleText() {
-		return ComboBox.i18nBundle.getText(INPUT_SUGGESTIONS_TITLE);
-	}
-
-	get _iconAccessibleNameText() {
-		return ComboBox.i18nBundle.getText(SELECT_OPTIONS);
-	}
-
-	get inner(): HTMLInputElement {
-		return isPhone() ? this.responsivePopover!.querySelector(".ui5-input-inner-phone")! : this.shadowRoot!.querySelector("[inner-input]")!;
-	}
-
-	async _getPicker() {
-		const staticAreaItem = await this.getStaticAreaItemDomRef();
-		const picker = staticAreaItem!.querySelector<ResponsivePopover>("[ui5-responsive-popover]")!;
-
-		// backward compatibility
-		// rework all methods to work with async getters
-		this.responsivePopover = picker;
-
-		return picker;
-	}
-
-	get hasValueState(): boolean {
-		return this.valueState !== ValueState.None;
-	}
-
-	get hasValueStateText(): boolean {
-		return this.hasValueState && this.valueState !== ValueState.Success;
-	}
-
-	get ariaValueStateHiddenText(): string {
-		if (!this.hasValueState) {
-			return "";
-		}
-
-		let text = "";
-
-		if (this.valueState !== ValueState.None) {
-			text = this.valueStateTypeMappings[this.valueState];
-		}
-
-		if (this.shouldDisplayDefaultValueStateMessage) {
-			return `${text} ${this.valueStateDefaultText || ""}`;
-		}
-
-		return `${text}`.concat(" ", this.valueStateMessageText.map(el => el.textContent).join(" "));
-	}
-
-	get valueStateDefaultText(): string | undefined {
-		if (this.valueState === ValueState.None) {
-			return;
-		}
-
-		return this.valueStateTextMappings[this.valueState];
-	}
-
-	get valueStateMessageText(): Array<Node> {
-		return this.getSlottedNodes("valueStateMessage").map(el => el.cloneNode(true));
-	}
-
-	get valueStateTextMappings(): ValueStateAnnouncement {
-		return {
-			[ValueState.Success]: ComboBox.i18nBundle.getText(VALUE_STATE_SUCCESS),
-			[ValueState.Error]: ComboBox.i18nBundle.getText(VALUE_STATE_ERROR),
-			[ValueState.Warning]: ComboBox.i18nBundle.getText(VALUE_STATE_WARNING),
-			[ValueState.Information]: ComboBox.i18nBundle.getText(VALUE_STATE_INFORMATION),
-		};
-	}
-
-	get valueStateTypeMappings(): ValueStateTypeAnnouncement {
-		return {
-			[ValueState.Success]: ComboBox.i18nBundle.getText(VALUE_STATE_TYPE_SUCCESS),
-			[ValueState.Information]: ComboBox.i18nBundle.getText(VALUE_STATE_TYPE_INFORMATION),
-			[ValueState.Error]: ComboBox.i18nBundle.getText(VALUE_STATE_TYPE_ERROR),
-			[ValueState.Warning]: ComboBox.i18nBundle.getText(VALUE_STATE_TYPE_WARNING),
-		};
-	}
-
-	get shouldOpenValueStateMessagePopover(): boolean {
-		return this.focused && !this.readonly && this.hasValueStateText && !this._iconPressed
-			&& !this.open && !this._isPhone;
-	}
-
-	get shouldDisplayDefaultValueStateMessage(): boolean {
-		return !this.valueStateMessage.length && this.hasValueStateText;
-	}
-
-	get _valueStatePopoverHorizontalAlign(): PopoverHorizontalAlign {
-		return this.effectiveDir !== "rtl" ? PopoverHorizontalAlign.Left : PopoverHorizontalAlign.Right;
-	}
-
-	/**
-	 * This method is relevant for sap_horizon theme only
-	 */
-	get _valueStateMessageIcon(): string {
-		return this.valueState !== ValueState.None ? ValueStateIconMapping[this.valueState] : "";
-	}
-
-	get open(): boolean {
-		return this?.responsivePopover?.opened || false;
-	}
-
-	get _isPhone(): boolean {
-		return isPhone();
-	}
-
-	get itemTabIndex() {
-		return undefined;
-	}
-
-	get ariaLabelText(): string | undefined {
-		return getEffectiveAriaLabelText(this);
-	}
-
-	static async onDefine() {
-		ComboBox.i18nBundle = await getI18nBundle("@ui5/webcomponents");
-	}
-
-	get styles() {
-		const remSizeInPx = parseInt(getComputedStyle(document.documentElement).fontSize);
-		return {
-			popoverHeader: {
-				"width": `${this.offsetWidth}px`,
-			},
-			suggestionPopoverHeader: {
-				"display": this._listWidth === 0 ? "none" : "inline-block",
-				"width": `${this._listWidth || ""}px`,
-			},
-			suggestionsPopover: {
-				"min-width": `${this.offsetWidth || 0}px`,
-				"max-width": (this.offsetWidth / remSizeInPx) > 40 ? `${this.offsetWidth}px` : "40rem",
-			},
-		};
-	}
-
-	get classes() {
-		return {
-			popover: {
-				"ui5-suggestions-popover": !this._isPhone,
-				"ui5-suggestions-popover-with-value-state-header": !this._isPhone && this.hasValueStateText,
-			},
-			popoverValueState: {
-				"ui5-valuestatemessage-header": true,
-				"ui5-valuestatemessage-root": true,
-				"ui5-valuestatemessage--success": this.valueState === ValueState.Success,
-				"ui5-valuestatemessage--error": this.valueState === ValueState.Error,
-				"ui5-valuestatemessage--warning": this.valueState === ValueState.Warning,
-				"ui5-valuestatemessage--information": this.valueState === ValueState.Information,
-			},
-		};
-	}
-}
-
-ComboBox.define();
-
-export default ComboBox;
-
-export type {
-	ComboBoxSelectionChangeEventDetail,
-	IComboBoxItem,
-};