@ui5/webcomponents 2.12.0 → 2.13.0-rc.1

package/dist/custom-elements.json

@@ -2835,7 +2835,7 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "privacy": "public",
               "inheritedFrom": {
                 "name": "DateComponentBase",
@@ -2849,7 +2849,7 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "privacy": "public",
               "inheritedFrom": {
                 "name": "DateComponentBase",
@@ -2953,7 +2953,7 @@
               }
             },
             {
-              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "name": "min-date",
               "default": "\"\"",
               "fieldName": "minDate",
@@ -2966,7 +2966,7 @@
               }
             },
             {
-              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "name": "max-date",
               "default": "\"\"",
               "fieldName": "maxDate",
@@ -3436,7 +3436,7 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "privacy": "public",
               "inheritedFrom": {
                 "name": "DateComponentBase",
@@ -3450,7 +3450,7 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "privacy": "public",
               "inheritedFrom": {
                 "name": "DateComponentBase",
@@ -3526,7 +3526,7 @@
               }
             },
             {
-              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "name": "min-date",
               "default": "\"\"",
               "fieldName": "minDate",
@@ -3539,7 +3539,7 @@
               }
             },
             {
-              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "name": "max-date",
               "default": "\"\"",
               "fieldName": "maxDate",
@@ -4974,7 +4974,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "### Overview\n\nThe `ui5-combobox` component represents a drop-down menu with a list of the available options and a text input field to narrow down the options.\n\nIt is commonly used to enable users to select an option from a predefined list.\n\n### Structure\nThe `ui5-combobox` consists of the following elements:\n\n-  Input field - displays the selected option or a custom user entry. Users can type to narrow down the list or enter their own value.\n-  Drop-down arrow - expands\\collapses the option list.\n-  Option list - the list of available options.\n\n### Keyboard Handling\n\nThe `ui5-combobox` provides advanced keyboard handling.\n\n- [F4], [Alt]+[Up], or [Alt]+[Down] - Toggles the picker.\n- [Escape] - Closes the picker, if open. If closed, cancels changes and reverts the typed in value.\n- [Enter] or [Return] - If picker is open, takes over the currently selected item and closes it.\n- [Down] - Selects the next matching item in the picker.\n- [Up] - Selects the previous matching item in the picker.\n- [Page Down] - Moves selection down by page size (10 items by default).\n- [Page Up] - Moves selection up by page size (10 items by default).\n- [Home] - If focus is in the ComboBox, moves cursor at the beginning of text. If focus is in the picker, selects the first item.\n- [End] - If focus is in the ComboBox, moves cursor at the end of text. If focus is in the picker, selects the last item.\n\n### ES6 Module Import\n\n`import \"@ui5/webcomponents/dist/ComboBox.js\";`",
+          "description": "### Overview\n\nThe `ui5-combobox` component represents a drop-down menu with a list of the available options and a text input field to narrow down the options.\n\nIt is commonly used to enable users to select an option from a predefined list.\n\n### Structure\nThe `ui5-combobox` consists of the following elements:\n\n-  Input field - displays the selected option or a custom user entry. Users can type to narrow down the list or enter their own value.\n-  Drop-down arrow - expands\\collapses the option list.\n-  Option list - the list of available options.\n\n### Keyboard Handling\n\nThe `ui5-combobox` provides advanced keyboard handling.\n\n- [F4], [Alt]+[Up], or [Alt]+[Down] - Toggles the picker.\n- [Escape] - Closes the picker, if open. If closed, cancels changes and reverts the typed in value.\n- [Enter] or [Return] - If picker is open, takes over the currently selected item and closes it.\n- [Down] - Selects the next matching item in the picker.\n- [Up] - Selects the previous matching item in the picker.\n- [Page Down] - Moves selection down by page size (10 items by default).\n- [Page Up] - Moves selection up by page size (10 items by default).\n- [Home] - If focus is in the ComboBox, moves cursor at the beginning of text. If focus is in the picker, selects the first item.\n- [End] - If focus is in the ComboBox, moves cursor at the end of text. If focus is in the picker, selects the last item.\n- [Ctrl]+[Alt]+[F8] or [Command]+[Option]+[F8] - Focuses the first link in the value state message, if available. Pressing [Tab] moves the focus to the next link in the value state message, or closes the value state message if there are no more links.\n\n### ES6 Module Import\n\n`import \"@ui5/webcomponents/dist/ComboBox.js\";`",
           "name": "ComboBox",
           "slots": [
             {
@@ -5644,7 +5644,7 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "privacy": "public"
             },
             {
@@ -5654,7 +5654,7 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "privacy": "public"
             },
             {
@@ -5704,7 +5704,7 @@
               }
             },
             {
-              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "name": "min-date",
               "default": "\"\"",
               "fieldName": "minDate",
@@ -5713,7 +5713,7 @@
               }
             },
             {
-              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "name": "max-date",
               "default": "\"\"",
               "fieldName": "maxDate",
@@ -6017,7 +6017,7 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "privacy": "public",
               "inheritedFrom": {
                 "name": "DateComponentBase",
@@ -6031,7 +6031,7 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "privacy": "public",
               "inheritedFrom": {
                 "name": "DateComponentBase",
@@ -6267,7 +6267,7 @@
               }
             },
             {
-              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "name": "min-date",
               "default": "\"\"",
               "fieldName": "minDate",
@@ -6280,7 +6280,7 @@
               }
             },
             {
-              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "name": "max-date",
               "default": "\"\"",
               "fieldName": "maxDate",
@@ -6702,7 +6702,7 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "privacy": "public",
               "inheritedFrom": {
                 "name": "DateComponentBase",
@@ -6716,7 +6716,7 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "privacy": "public",
               "inheritedFrom": {
                 "name": "DateComponentBase",
@@ -6978,7 +6978,7 @@
               }
             },
             {
-              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "name": "min-date",
               "default": "\"\"",
               "fieldName": "minDate",
@@ -6991,7 +6991,7 @@
               }
             },
             {
-              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "name": "max-date",
               "default": "\"\"",
               "fieldName": "maxDate",
@@ -7469,7 +7469,7 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "privacy": "public",
               "inheritedFrom": {
                 "name": "DateComponentBase",
@@ -7483,7 +7483,7 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "privacy": "public",
               "inheritedFrom": {
                 "name": "DateComponentBase",
@@ -7726,7 +7726,7 @@
               }
             },
             {
-              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the minimum date available for selection.\n\n**Note:** If the formatPattern property is not set, the minDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "name": "min-date",
               "default": "\"\"",
               "fieldName": "minDate",
@@ -7739,7 +7739,7 @@
               }
             },
             {
-              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (YYYY-MM-dd).",
+              "description": "Determines the maximum date available for selection.\n\n**Note:** If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (yyyy-MM-dd).",
               "name": "max-date",
               "default": "\"\"",
               "fieldName": "maxDate",
@@ -8650,7 +8650,7 @@
           "slots": [
             {
               "name": "default",
-              "description": "By default the component contains a single input field. With this slot you can pass any content that you wish to add. See the samples for more information.\n\n**Note:** If no content is provided in this slot, the component will only consist of an input field and will not be interactable using the keyboard.\nAlso it is not recommended to use any non-interactable components, as it may lead to poor accessibility experience."
+              "description": "This slot allows you to add custom content to the component, such as a button or any other interactive element to trigger the file selection dialog.\n\n**Note:** For best accessibility experience, set a `tabindex` of \"-1\" on your interactive element, or it will be set automatically.\nThis slot is intended for use cases where you want a button-only file uploader.\nIt is recommended to set the `hideInput` property to \"true\" when using this slot.\nNot setting `hideInput` may negatively impact the screen reader users."
             },
             {
               "name": "valueStateMessage",
@@ -8675,7 +8675,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "If set to \"true\", the input field of component will not be rendered. Only the default slot that is passed will be rendered.",
+              "description": "If set to \"true\", the input field of component will not be rendered. Only the default slot that is passed will be rendered.\n\n**Note:** Use this property in combination with the default slot to achieve a button-only file uploader design.",
               "privacy": "public"
             },
             {
@@ -8755,6 +8755,36 @@
               "description": "Defines the value state of the component.",
               "privacy": "public"
             },
+            {
+              "kind": "field",
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Defines whether the component is required.",
+              "privacy": "public"
+            },
+            {
+              "kind": "field",
+              "name": "accessibleName",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Defines the accessible ARIA name of the component.",
+              "default": "undefined",
+              "privacy": "public"
+            },
+            {
+              "kind": "field",
+              "name": "accessibleNameRef",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Receives id(or many ids) of the elements that label the input.",
+              "default": "undefined",
+              "privacy": "public"
+            },
             {
               "kind": "field",
               "name": "files",
@@ -8808,7 +8838,7 @@
               }
             },
             {
-              "description": "If set to \"true\", the input field of component will not be rendered. Only the default slot that is passed will be rendered.",
+              "description": "If set to \"true\", the input field of component will not be rendered. Only the default slot that is passed will be rendered.\n\n**Note:** Use this property in combination with the default slot to achieve a button-only file uploader design.",
               "name": "hide-input",
               "default": "false",
               "fieldName": "hideInput",
@@ -8879,6 +8909,33 @@
                 "text": "\"None\" | \"Positive\" | \"Negative\" | \"Critical\" | \"Information\""
               }
             },
+            {
+              "description": "Defines whether the component is required.",
+              "name": "required",
+              "default": "false",
+              "fieldName": "required",
+              "type": {
+                "text": "boolean"
+              }
+            },
+            {
+              "description": "Defines the accessible ARIA name of the component.",
+              "name": "accessible-name",
+              "default": "undefined",
+              "fieldName": "accessibleName",
+              "type": {
+                "text": "string | undefined"
+              }
+            },
+            {
+              "description": "Receives id(or many ids) of the elements that label the input.",
+              "name": "accessible-name-ref",
+              "default": "undefined",
+              "fieldName": "accessibleNameRef",
+              "type": {
+                "text": "string | undefined"
+              }
+            },
             {
               "description": "FileList of all selected files.",
               "name": "files",
@@ -9512,7 +9569,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "### Overview\n\nThe `ui5-input` component allows the user to enter and edit text or numeric values in one line.\n\nAdditionally, you can provide `suggestionItems`,\nthat are displayed in a popover right under the input.\n\nThe text field can be editable or read-only (`readonly` property),\nand it can be enabled or disabled (`disabled` property).\nTo visualize semantic states, such as \"Negative\" or \"Critical\", the `valueState` property is provided.\nWhen the user makes changes to the text, the change event is fired,\nwhich enables you to react on any text change.\n\n### Keyboard Handling\nThe `ui5-input` provides the following keyboard shortcuts:\n\n- [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.\n- [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.\n- [Down] - Focuses the next matching item in the suggestion list. Selection-change event is fired.\n- [Up] - Focuses the previous matching item in the suggestion list. Selection-change event is fired.\n- [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.\n- [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.\n- [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.\n- [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.\n\n### ES6 Module Import\n\n`import \"@ui5/webcomponents/dist/Input.js\";`",
+          "description": "### Overview\n\nThe `ui5-input` component allows the user to enter and edit text or numeric values in one line.\n\nAdditionally, you can provide `suggestionItems`,\nthat are displayed in a popover right under the input.\n\nThe text field can be editable or read-only (`readonly` property),\nand it can be enabled or disabled (`disabled` property).\nTo visualize semantic states, such as \"Negative\" or \"Critical\", the `valueState` property is provided.\nWhen the user makes changes to the text, the change event is fired,\nwhich enables you to react on any text change.\n\n### Keyboard Handling\nThe `ui5-input` provides the following keyboard shortcuts:\n\n- [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.\n- [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.\n- [Down] - Focuses the next matching item in the suggestion list. Selection-change event is fired.\n- [Up] - Focuses the previous matching item in the suggestion list. Selection-change event is fired.\n- [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.\n- [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.\n- [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.\n- [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.\n- [Ctrl]+[Alt]+[F8] or [Command]+[Option]+[F8] - Focuses the first link in the value state message, if available. Pressing [Tab] moves the focus to the next link in the value state message, or closes the value state message if there are no more links.\n\n### ES6 Module Import\n\n`import \"@ui5/webcomponents/dist/Input.js\";`",
           "name": "Input",
           "cssParts": [
             {
@@ -11696,8 +11753,8 @@
           ],
           "slots": [
             {
-              "description": "Defines the custom formatted text of the component.\n\n**Note:** For optimal text wrapping and a consistent layout, it is strongly recommended to use the `text` property.\n\nUse the `default` slot only when custom formatting with HTML elements (e.g., `<b>`, `<i>`) is required.\nBe aware that wrapping (via `wrappingType=\"Normal\"`) may not function correctly with custom HTML content in the `default` slot.\n\nIf both `text` and `default` slot are used, the `text` property takes precedence.",
-              "name": "default"
+              "name": "default",
+              "description": "Defines the custom formatted text of the component.\n\n**Note:** For optimal text wrapping and a consistent layout, it is strongly recommended to use the `text` property.\n\nUse the `default` slot only when custom formatting with HTML elements (e.g., `<b>`, `<i>`) is required.\nBe aware that wrapping (via `wrappingType=\"Normal\"`) may not function correctly with custom HTML content in the `default` slot.\n\nIf both `text` and `default` slot are used, the `text` property takes precedence."
             },
             {
               "name": "image",
@@ -13092,7 +13149,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "### Overview\n\nThe `ui5-multi-combobox` component consists of a list box with items and a text field allowing the user to either type a value directly into the text field, or choose from the list of existing items.\n\nThe drop-down list is used for selecting and filtering values, it enables users to select one or more options from a predefined list. The control provides an editable input field to filter the list, and a dropdown arrow to expand/collapse the list of available options.\nThe options in the list have checkboxes that permit multi-selection. Entered values are displayed as tokens.\n### Structure\nThe `ui5-multi-combobox` consists of the following elements:\n\n-  Tokenizer - a list of tokens with selected options.\n-  Input field - displays the selected option/s as token/s. Users can type to filter the list.\n-  Drop-down arrow - expands\\collapses the option list.\n-  Option list - the list of available options.\n\n### Keyboard Handling\n\nThe `ui5-multi-combobox` provides advanced keyboard handling.\n\n#### Picker\nIf the `ui5-multi-combobox` is focused,\nyou can open or close the drop-down by pressing [F4], [Alt] + [Up] or [Alt] + [Down] keys.\nOnce the drop-down is opened, you can use the `UP` and `DOWN` arrow keys\nto navigate through the available options and select one by pressing the `Space` or `Enter` keys.\n\n#### Tokens\n\n-  Left/Right arrow keys - moves the focus selection form the currently focused token to the previous/next one (if available).\n-  Delete -  deletes the token and focuses the previous token.\n-  Backspace -  deletes the token and focus the next token.\n\n### ES6 Module Import\n\n`import \"@ui5/webcomponents/dist/MultiComboBox.js\";`",
+          "description": "### Overview\n\nThe `ui5-multi-combobox` component consists of a list box with items and a text field allowing the user to either type a value directly into the text field, or choose from the list of existing items.\n\nThe drop-down list is used for selecting and filtering values, it enables users to select one or more options from a predefined list. The control provides an editable input field to filter the list, and a dropdown arrow to expand/collapse the list of available options.\nThe options in the list have checkboxes that permit multi-selection. Entered values are displayed as tokens.\n### Structure\nThe `ui5-multi-combobox` consists of the following elements:\n\n-  Tokenizer - a list of tokens with selected options.\n-  Input field - displays the selected option/s as token/s. Users can type to filter the list.\n-  Drop-down arrow - expands\\collapses the option list.\n-  Option list - the list of available options.\n\n### Keyboard Handling\n\nThe `ui5-multi-combobox` provides advanced keyboard handling.\n\n#### Picker\nIf the `ui5-multi-combobox` is focused,\nyou can open or close the drop-down by pressing [F4], [Alt] + [Up] or [Alt] + [Down] keys.\nOnce the drop-down is opened, you can use the `UP` and `DOWN` arrow keys\nto navigate through the available options and select one by pressing the `Space` or `Enter` keys.\n[Ctrl]+[Alt]+[F8] or [Command]+[Option]+[F8] - Focuses the first link in the value state message, if available. Pressing [Tab] moves the focus to the next link in the value state message, or closes the value state message if there are no more links.\n\n#### Tokens\n\n-  Left/Right arrow keys - moves the focus selection form the currently focused token to the previous/next one (if available).\n-  Delete -  deletes the token and focuses the previous token.\n-  Backspace -  deletes the token and focus the next token.\n\n### ES6 Module Import\n\n`import \"@ui5/webcomponents/dist/MultiComboBox.js\";`",
           "name": "MultiComboBox",
           "cssParts": [
             {

package/dist/features/InputSuggestions.d.ts

@@ -9,7 +9,6 @@ import type SuggestionItem from "../SuggestionItem.js";
 import InputSuggestionsTemplate from "./InputSuggestionsTemplate.js";
 import type { IInputSuggestionItem, IInputSuggestionItemSelectable } from "../Input.js";
 interface SuggestionComponent extends UI5Element {
-    _isValueStateFocused: boolean;
     focused: boolean;
     hasSuggestionItemSelected: boolean;
     value: string;
@@ -92,8 +91,6 @@ declare class Suggestions {
     get itemSelectionAnnounce(): string;
     hightlightInput(text: string, input: string): string;
     get _hasValueState(): boolean;
-    _focusValueState(): void;
-    _clearValueStateFocus(): void;
     _clearSelectedSuggestionAndaccInfo(): void;
 }
 export default Suggestions;

package/dist/features/InputSuggestions.js

@@ -60,39 +60,29 @@ class Suggestions {
     onPageUp(e) {
         e.preventDefault();
         const isItemIndexValid = this.selectedItemIndex - 10 > -1;
-        if (this._hasValueState && !isItemIndexValid) {
-            this._focusValueState();
-            return true;
-        }
         this._moveItemSelection(this.selectedItemIndex, isItemIndexValid ? this.selectedItemIndex -= 10 : this.selectedItemIndex = 0);
         return true;
     }
     onPageDown(e) {
         e.preventDefault();
         const items = this._getItems();
-        const lastItemIndex = items.length - 1;
-        const isItemIndexValid = this.selectedItemIndex + 10 <= lastItemIndex;
-        if (this._hasValueState && !items) {
-            this._focusValueState();
+        if (!items) {
             return true;
         }
+        const lastItemIndex = items.length - 1;
+        const isItemIndexValid = this.selectedItemIndex + 10 <= lastItemIndex;
         this._moveItemSelection(this.selectedItemIndex, isItemIndexValid ? this.selectedItemIndex += 10 : this.selectedItemIndex = lastItemIndex);
         return true;
     }
     onHome(e) {
         e.preventDefault();
-        if (this._hasValueState) {
-            this._focusValueState();
-            return true;
-        }
         this._moveItemSelection(this.selectedItemIndex, this.selectedItemIndex = 0);
         return true;
     }
     onEnd(e) {
         e.preventDefault();
         const lastItemIndex = this._getItems().length - 1;
-        if (this._hasValueState && !lastItemIndex) {
-            this._focusValueState();
+        if (!lastItemIndex) {
             return true;
         }
         this._moveItemSelection(this.selectedItemIndex, this.selectedItemIndex = lastItemIndex);
@@ -203,14 +193,6 @@ class Suggestions {
     _selectNextItem() {
         const itemsCount = this._getItems().length;
         const previousSelectedIdx = this.selectedItemIndex;
-        if (this._hasValueState && previousSelectedIdx === -1 && !this.component._isValueStateFocused) {
-            this._focusValueState();
-            return;
-        }
-        if ((previousSelectedIdx === -1 && !this._hasValueState) || this.component._isValueStateFocused) {
-            this._clearValueStateFocus();
-            this.selectedItemIndex = -1;
-        }
         if (previousSelectedIdx !== -1 && previousSelectedIdx + 1 > itemsCount - 1) {
             return;
         }
@@ -219,22 +201,6 @@ class Suggestions {
     _selectPreviousItem() {
         const items = this._getItems();
         const previousSelectedIdx = this.selectedItemIndex;
-        if (this._hasValueState && previousSelectedIdx === 0 && !this.component._isValueStateFocused) {
-            this.component.hasSuggestionItemSelected = false;
-            this.component._isValueStateFocused = true;
-            this.selectedItemIndex = 0;
-            items[0].focused = false;
-            if (items[0].hasAttribute("ui5-suggestion-item")) {
-                items[0].selected = false;
-            }
-            return;
-        }
-        if (this.component._isValueStateFocused) {
-            this.component.focused = true;
-            this.component._isValueStateFocused = false;
-            this.selectedItemIndex = 0;
-            return;
-        }
         if (previousSelectedIdx === -1 || previousSelectedIdx === null) {
             return;
         }
@@ -260,7 +226,6 @@ class Suggestions {
             return;
         }
         this.component.focused = false;
-        this._clearValueStateFocus();
         const selectedItem = this._getItems()[this.selectedItemIndex];
         this.accInfo = {
             isGroup: isGroupItem,
@@ -374,17 +339,6 @@ class Suggestions {
     get _hasValueState() {
         return this.component.hasValueStateMessage;
     }
-    _focusValueState() {
-        this.component._isValueStateFocused = true;
-        this.component.focused = false;
-        this.component.hasSuggestionItemSelected = false;
-        this.selectedItemIndex = 0;
-        this.component.value = this.component.typedInValue;
-        this._deselectItems();
-    }
-    _clearValueStateFocus() {
-        this.component._isValueStateFocused = false;
-    }
     _clearSelectedSuggestionAndaccInfo() {
         this.accInfo = undefined;
         this.selectedItemIndex = 0;