@vaadin/multi-select-combo-box 25.3.0-dev.3a3c2d7d2a → 25.3.0

package/custom-elements.json

@@ -26,6 +26,20 @@
           "description": "",
           "name": "MultiSelectComboBoxMixin",
           "members": [
+            {
+              "kind": "field",
+              "name": "accessibleDescriptionRef",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "A space-separated list of IDs referencing the elements that\ndescribe the component for screen reader users. The referenced\nelements are announced in addition to the helper text and\nthe error message.",
+              "attribute": "accessible-description-ref",
+              "inheritedFrom": {
+                "name": "FieldMixin",
+                "package": "@vaadin/field-base/src/field-mixin.js"
+              }
+            },
             {
               "kind": "field",
               "name": "accessibleName",
@@ -33,7 +47,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "String used to label the component to screen reader users.",
+              "description": "String used to label the component for screen reader users.",
               "attribute": "accessible-name",
               "inheritedFrom": {
                 "name": "FieldMixin",
@@ -47,7 +61,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Id of the element used as label of the component to screen reader users.",
+              "description": "A space-separated list of IDs referencing the elements that\nlabel the component for screen reader users.",
               "attribute": "accessible-name-ref",
               "inheritedFrom": {
                 "name": "FieldMixin",
@@ -170,7 +184,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Set to true to display the clear icon which clears the input.\n\nIt is up to the component to choose where to place the clear icon:\nin the Shadow DOM or in the light DOM. In any way, a reference to\nthe clear icon element should be provided via the `clearElement` getter.",
+              "description": "Set to true to display the clear icon which clears the input.\nThis also enables clearing the input when pressing Esc key.",
               "attribute": "clear-button-visible",
               "inheritedFrom": {
                 "name": "ClearButtonMixin",
@@ -334,8 +348,12 @@
               "type": {
                 "text": "string"
               },
-              "description": "Path for the id of the item, used to detect whether the item is selected.",
-              "attribute": "item-id-path"
+              "description": "Path for the id of the item. If `items` is an array of objects,\nthe `itemIdPath` is used to compare and identify the same item\nin the selection and in `filteredItems` (items given by the\n`dataProvider` callback).",
+              "attribute": "item-id-path",
+              "inheritedFrom": {
+                "name": "ComboBoxItemsMixin",
+                "package": "@vaadin/combo-box/src/vaadin-combo-box-items-mixin.js"
+              }
             },
             {
               "kind": "field",
@@ -492,6 +510,20 @@
                 "package": "@vaadin/combo-box/src/vaadin-combo-box-data-provider-mixin.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "partialMatchMode",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Controls which item is automatically set to be selected, for\nexample on Enter, when the typed filter only partially matches\nits label. The item that will be selected is highlighted in the\ndropdown while typing:\n\n- `none` (default): an item is automatically set to be selected only when the filter matches its label exactly.\n- `first-match`: the first item in the filtered results is automatically set to be selected.\n- `only-match`: the item is automatically set to be selected when filtering narrows the results to a single item.\n\nIn general, an exact match is always set to be selected and takes\nprecedence over partial matches, regardless of the mode.\n\nA partial match is only applied while the dropdown is open. For\nexample, when auto-open is disabled with `autoOpenDisabled`, typing\ndoes not highlight a match or set it to be selected until the\ndropdown is opened.\n\nThis feature cannot be used together with custom values, because a\npartial match is also a valid custom value. A partial match is not\napplied when custom values are allowed with `allowCustomValue`.",
+              "attribute": "partial-match-mode",
+              "inheritedFrom": {
+                "name": "ComboBoxItemsMixin",
+                "package": "@vaadin/combo-box/src/vaadin-combo-box-items-mixin.js"
+              }
+            },
             {
               "kind": "field",
               "name": "placeholder",
@@ -533,7 +565,11 @@
             {
               "kind": "method",
               "name": "requestContentUpdate",
-              "description": "Requests an update for the content of items.\nWhile performing the update, it invokes the renderer (passed in the `renderer` property) once an item.\n\nIt is not guaranteed that the update happens immediately (synchronously) after it is requested."
+              "description": "Requests an update for the content of items.\nWhile performing the update, it invokes the renderer (passed in the `renderer` property) once an item.\n\nIt is not guaranteed that the update happens immediately (synchronously) after it is requested.",
+              "inheritedFrom": {
+                "name": "ComboBoxItemsMixin",
+                "package": "@vaadin/combo-box/src/vaadin-combo-box-items-mixin.js"
+              }
             },
             {
               "kind": "field",
@@ -655,12 +691,24 @@
             }
           ],
           "attributes": [
+            {
+              "name": "accessible-description-ref",
+              "type": {
+                "text": "string"
+              },
+              "description": "A space-separated list of IDs referencing the elements that\ndescribe the component for screen reader users. The referenced\nelements are announced in addition to the helper text and\nthe error message.",
+              "fieldName": "accessibleDescriptionRef",
+              "inheritedFrom": {
+                "name": "FieldMixin",
+                "package": "@vaadin/field-base/src/field-mixin.js"
+              }
+            },
             {
               "name": "accessible-name",
               "type": {
                 "text": "string"
               },
-              "description": "String used to label the component to screen reader users.",
+              "description": "String used to label the component for screen reader users.",
               "fieldName": "accessibleName",
               "inheritedFrom": {
                 "name": "FieldMixin",
@@ -672,7 +720,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Id of the element used as label of the component to screen reader users.",
+              "description": "A space-separated list of IDs referencing the elements that\nlabel the component for screen reader users.",
               "fieldName": "accessibleNameRef",
               "inheritedFrom": {
                 "name": "FieldMixin",
@@ -756,7 +804,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Set to true to display the clear icon which clears the input.\n\nIt is up to the component to choose where to place the clear icon:\nin the Shadow DOM or in the light DOM. In any way, a reference to\nthe clear icon element should be provided via the `clearElement` getter.",
+              "description": "Set to true to display the clear icon which clears the input.\nThis also enables clearing the input when pressing Esc key.",
               "fieldName": "clearButtonVisible",
               "inheritedFrom": {
                 "name": "ClearButtonMixin",
@@ -860,8 +908,12 @@
               "type": {
                 "text": "string"
               },
-              "description": "Path for the id of the item, used to detect whether the item is selected.",
-              "fieldName": "itemIdPath"
+              "description": "Path for the id of the item. If `items` is an array of objects,\nthe `itemIdPath` is used to compare and identify the same item\nin the selection and in `filteredItems` (items given by the\n`dataProvider` callback).",
+              "fieldName": "itemIdPath",
+              "inheritedFrom": {
+                "name": "ComboBoxItemsMixin",
+                "package": "@vaadin/combo-box/src/vaadin-combo-box-items-mixin.js"
+              }
             },
             {
               "name": "item-label-path",
@@ -963,6 +1015,18 @@
                 "package": "@vaadin/combo-box/src/vaadin-combo-box-data-provider-mixin.js"
               }
             },
+            {
+              "name": "partial-match-mode",
+              "type": {
+                "text": "string"
+              },
+              "description": "Controls which item is automatically set to be selected, for\nexample on Enter, when the typed filter only partially matches\nits label. The item that will be selected is highlighted in the\ndropdown while typing:\n\n- `none` (default): an item is automatically set to be selected only when the filter matches its label exactly.\n- `first-match`: the first item in the filtered results is automatically set to be selected.\n- `only-match`: the item is automatically set to be selected when filtering narrows the results to a single item.\n\nIn general, an exact match is always set to be selected and takes\nprecedence over partial matches, regardless of the mode.\n\nA partial match is only applied while the dropdown is open. For\nexample, when auto-open is disabled with `autoOpenDisabled`, typing\ndoes not highlight a match or set it to be selected until the\ndropdown is opened.\n\nThis feature cannot be used together with custom values, because a\npartial match is also a valid custom value. A partial match is not\napplied when custom values are allowed with `allowCustomValue`.",
+              "fieldName": "partialMatchMode",
+              "inheritedFrom": {
+                "name": "ComboBoxItemsMixin",
+                "package": "@vaadin/combo-box/src/vaadin-combo-box-items-mixin.js"
+              }
+            },
             {
               "name": "placeholder",
               "type": {
@@ -1110,9 +1174,23 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<vaadin-multi-select-combo-box>` is a web component that wraps `<vaadin-combo-box>` and extends\nits functionality to allow selecting multiple items, in addition to basic features.\n\n```html\n<vaadin-multi-select-combo-box id=\"comboBox\"></vaadin-multi-select-combo-box>\n```\n\n```js\nconst comboBox = document.querySelector('#comboBox');\ncomboBox.items = ['apple', 'banana', 'lemon', 'orange'];\ncomboBox.selectedItems = ['lemon', 'orange'];\n```\n\n### Styling\n\nThe following shadow DOM parts are available for styling:\n\nPart name              | Description\n-----------------------|----------------\n`chips`                | The element that wraps slotted chips for selected items\n`label`                | The label element\n`input-field`          | The element that wraps prefix, value and suffix\n`field-button`         | Set on both clear and toggle buttons\n`clear-button`         | The clear button\n`error-message`        | The error message element\n`helper-text`          | The helper text element wrapper\n`required-indicator`   | The `required` state indicator element\n`toggle-button`        | The toggle button\n`overlay`              | The overlay container\n`content`              | The overlay content\n`loader`               | The loading indicator shown while loading items\n\nThe following state attributes are available for styling:\n\nAttribute              | Description\n-----------------------|-----------------\n`disabled`             | Set to a disabled element\n`has-value`            | Set when the element has a value\n`has-label`            | Set when the element has a label\n`has-helper`           | Set when the element has helper text or slot\n`has-error-message`    | Set when the element has an error message\n`has-tooltip`          | Set when the element has a slotted tooltip\n`invalid`              | Set when the element is invalid\n`focused`              | Set when the element is focused\n`focus-ring`           | Set when the element is keyboard focused\n`loading`              | Set when loading items from the data provider\n`opened`               | Set when the dropdown is open\n`readonly`             | Set to a readonly element\n\nThe following custom CSS properties are available for styling:\n\nCustom property                                      | Description                | Default\n-----------------------------------------------------|----------------------------|--------\n`--vaadin-field-default-width`                       | Default width of the field | `12em`\n`--vaadin-multi-select-combo-box-overlay-width`      | Width of the overlay       | `auto`\n`--vaadin-multi-select-combo-box-overlay-max-height` | Max height of the overlay  | `65vh`\n`--vaadin-multi-select-combo-box-input-min-width`    | Min width of the input     | `4em`\n\n### Internal components\n\nIn addition to `<vaadin-multi-select-combo-box>` itself, the following internal\ncomponents are themable:\n\n- `<vaadin-multi-select-combo-box-chip>`\n- `<vaadin-multi-select-combo-box-item>` - has the same API as `<vaadin-item>`.\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.",
+          "description": "`<vaadin-multi-select-combo-box>` is a web component that wraps `<vaadin-combo-box>` and extends\nits functionality to allow selecting multiple items, in addition to basic features.\n\n```html\n<vaadin-multi-select-combo-box id=\"comboBox\"></vaadin-multi-select-combo-box>\n```\n\n```js\nconst comboBox = document.querySelector('#comboBox');\ncomboBox.items = ['apple', 'banana', 'lemon', 'orange'];\ncomboBox.selectedItems = ['lemon', 'orange'];\n```\n\n### Styling\n\nThe following shadow DOM parts are available for styling:\n\nPart name              | Description\n-----------------------|----------------\n`chips`                | The element that wraps slotted chips for selected items\n`label`                | The label element\n`input-field`          | The element that wraps prefix, value and suffix\n`field-button`         | Set on both clear and toggle buttons\n`clear-button`         | The clear button\n`error-message`        | The error message element\n`helper-text`          | The helper text element wrapper\n`required-indicator`   | The `required` state indicator element\n`toggle-button`        | The toggle button\n`overlay`              | The overlay container\n`content`              | The overlay content\n`loader`               | The loading indicator shown while loading items\n\nThe following state attributes are available for styling:\n\nAttribute              | Description\n-----------------------|-----------------\n`disabled`             | Set to a disabled element\n`has-value`            | Set when the element has a value\n`has-label`            | Set when the element has a label\n`has-helper`           | Set when the element has helper text or slot\n`has-error-message`    | Set when the element has an error message\n`has-tooltip`          | Set when the element has a slotted tooltip\n`invalid`              | Set when the element is invalid\n`focused`              | Set when the element is focused\n`focus-ring`           | Set when the element is keyboard focused\n`loading`              | Set when loading items from the data provider\n`opened`               | Set when the dropdown is open\n`readonly`             | Set to a readonly element\n\nThe following custom CSS properties are available for styling:\n\nCustom CSS property                                     |\n:-------------------------------------------------------|\n| `--vaadin-chip-background`                            |\n| `--vaadin-chip-border-color`                          |\n| `--vaadin-chip-border-radius`                         |\n| `--vaadin-chip-border-width`                          |\n| `--vaadin-chip-font-size`                             |\n| `--vaadin-chip-font-weight`                           |\n| `--vaadin-chip-gap`                                   |\n| `--vaadin-chip-height`                                |\n| `--vaadin-chip-padding`                               |\n| `--vaadin-chip-remove-button-text-color`              |\n| `--vaadin-chip-text-color`                            |\n| `--vaadin-field-default-width`                        |\n| `--vaadin-input-field-background`                     |\n| `--vaadin-input-field-border-color`                   |\n| `--vaadin-input-field-border-radius`                  |\n| `--vaadin-input-field-border-width`                   |\n| `--vaadin-input-field-bottom-end-radius`              |\n| `--vaadin-input-field-bottom-start-radius`            |\n| `--vaadin-input-field-button-text-color`              |\n| `--vaadin-input-field-container-gap`                  |\n| `--vaadin-input-field-disabled-background`            |\n| `--vaadin-input-field-disabled-text-color`            |\n| `--vaadin-input-field-error-color`                    |\n| `--vaadin-input-field-error-font-size`                |\n| `--vaadin-input-field-error-font-weight`              |\n| `--vaadin-input-field-error-line-height`              |\n| `--vaadin-input-field-gap`                            |\n| `--vaadin-input-field-helper-color`                   |\n| `--vaadin-input-field-helper-font-size`               |\n| `--vaadin-input-field-helper-font-weight`             |\n| `--vaadin-input-field-helper-line-height`             |\n| `--vaadin-input-field-label-color`                    |\n| `--vaadin-input-field-label-font-size`                |\n| `--vaadin-input-field-label-font-weight`              |\n| `--vaadin-input-field-label-line-height`              |\n| `--vaadin-input-field-padding`                        |\n| `--vaadin-input-field-placeholder-color`              |\n| `--vaadin-input-field-required-indicator`             |\n| `--vaadin-input-field-required-indicator-color`       |\n| `--vaadin-input-field-top-end-radius`                 |\n| `--vaadin-input-field-top-start-radius`               |\n| `--vaadin-input-field-value-color`                    |\n| `--vaadin-input-field-value-font-size`                |\n| `--vaadin-input-field-value-font-weight`              |\n| `--vaadin-input-field-value-line-height`              |\n| `--vaadin-item-overlay-padding`                       |\n| `--vaadin-multi-select-combo-box-chip-min-width`      |\n| `--vaadin-multi-select-combo-box-chips-gap`           |\n| `--vaadin-multi-select-combo-box-input-min-width`     |\n| `--vaadin-multi-select-combo-box-overlay-max-height`  |\n| `--vaadin-multi-select-combo-box-overlay-width`       |\n\n### Internal components\n\nIn addition to `<vaadin-multi-select-combo-box>` itself, the following internal\ncomponents are themable:\n\n- `<vaadin-multi-select-combo-box-chip>`\n- `<vaadin-multi-select-combo-box-item>` - has the same API as `<vaadin-item>`.\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.",
           "name": "MultiSelectComboBox",
           "members": [
+            {
+              "kind": "field",
+              "name": "accessibleDescriptionRef",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "A space-separated list of IDs referencing the elements that\ndescribe the component for screen reader users. The referenced\nelements are announced in addition to the helper text and\nthe error message.",
+              "attribute": "accessible-description-ref",
+              "inheritedFrom": {
+                "name": "FieldMixin",
+                "package": "@vaadin/field-base/src/field-mixin.js"
+              }
+            },
             {
               "kind": "field",
               "name": "accessibleName",
@@ -1120,7 +1198,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "String used to label the component to screen reader users.",
+              "description": "String used to label the component for screen reader users.",
               "attribute": "accessible-name",
               "inheritedFrom": {
                 "name": "FieldMixin",
@@ -1134,7 +1212,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Id of the element used as label of the component to screen reader users.",
+              "description": "A space-separated list of IDs referencing the elements that\nlabel the component for screen reader users.",
               "attribute": "accessible-name-ref",
               "inheritedFrom": {
                 "name": "FieldMixin",
@@ -1269,7 +1347,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Set to true to display the clear icon which clears the input.\n\nIt is up to the component to choose where to place the clear icon:\nin the Shadow DOM or in the light DOM. In any way, a reference to\nthe clear icon element should be provided via the `clearElement` getter.",
+              "description": "Set to true to display the clear icon which clears the input.\nThis also enables clearing the input when pressing Esc key.",
               "attribute": "clear-button-visible",
               "inheritedFrom": {
                 "name": "ClearButtonMixin",
@@ -1441,11 +1519,11 @@
               "type": {
                 "text": "string"
               },
-              "description": "Path for the id of the item, used to detect whether the item is selected.",
+              "description": "Path for the id of the item. If `items` is an array of objects,\nthe `itemIdPath` is used to compare and identify the same item\nin the selection and in `filteredItems` (items given by the\n`dataProvider` callback).",
               "attribute": "item-id-path",
               "inheritedFrom": {
-                "name": "MultiSelectComboBoxMixin",
-                "module": "src/vaadin-multi-select-combo-box-mixin.js"
+                "name": "ComboBoxItemsMixin",
+                "package": "@vaadin/combo-box/src/vaadin-combo-box-items-mixin.js"
               }
             },
             {
@@ -1611,6 +1689,20 @@
                 "package": "@vaadin/combo-box/src/vaadin-combo-box-data-provider-mixin.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "partialMatchMode",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Controls which item is automatically set to be selected, for\nexample on Enter, when the typed filter only partially matches\nits label. The item that will be selected is highlighted in the\ndropdown while typing:\n\n- `none` (default): an item is automatically set to be selected only when the filter matches its label exactly.\n- `first-match`: the first item in the filtered results is automatically set to be selected.\n- `only-match`: the item is automatically set to be selected when filtering narrows the results to a single item.\n\nIn general, an exact match is always set to be selected and takes\nprecedence over partial matches, regardless of the mode.\n\nA partial match is only applied while the dropdown is open. For\nexample, when auto-open is disabled with `autoOpenDisabled`, typing\ndoes not highlight a match or set it to be selected until the\ndropdown is opened.\n\nThis feature cannot be used together with custom values, because a\npartial match is also a valid custom value. A partial match is not\napplied when custom values are allowed with `allowCustomValue`.",
+              "attribute": "partial-match-mode",
+              "inheritedFrom": {
+                "name": "ComboBoxItemsMixin",
+                "package": "@vaadin/combo-box/src/vaadin-combo-box-items-mixin.js"
+              }
+            },
             {
               "kind": "field",
               "name": "placeholder",
@@ -1658,8 +1750,8 @@
               "name": "requestContentUpdate",
               "description": "Requests an update for the content of items.\nWhile performing the update, it invokes the renderer (passed in the `renderer` property) once an item.\n\nIt is not guaranteed that the update happens immediately (synchronously) after it is requested.",
               "inheritedFrom": {
-                "name": "MultiSelectComboBoxMixin",
-                "module": "src/vaadin-multi-select-combo-box-mixin.js"
+                "name": "ComboBoxItemsMixin",
+                "package": "@vaadin/combo-box/src/vaadin-combo-box-items-mixin.js"
               }
             },
             {
@@ -1806,41 +1898,25 @@
               "name": "validated"
             }
           ],
-          "mixins": [
-            {
-              "name": "MultiSelectComboBoxMixin",
-              "module": "src/vaadin-multi-select-combo-box-mixin.js"
-            },
-            {
-              "name": "ThemableMixin",
-              "package": "@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js"
-            },
-            {
-              "name": "ElementMixin",
-              "package": "@vaadin/component-base/src/element-mixin.js"
-            },
+          "attributes": [
             {
-              "name": "PolylitMixin",
-              "package": "@vaadin/component-base/src/polylit-mixin.js"
+              "name": "accessible-description-ref",
+              "type": {
+                "text": "string"
+              },
+              "description": "A space-separated list of IDs referencing the elements that\ndescribe the component for screen reader users. The referenced\nelements are announced in addition to the helper text and\nthe error message.",
+              "fieldName": "accessibleDescriptionRef",
+              "inheritedFrom": {
+                "name": "FieldMixin",
+                "package": "@vaadin/field-base/src/field-mixin.js"
+              }
             },
-            {
-              "name": "LumoInjectionMixin",
-              "package": "@vaadin/vaadin-themable-mixin/lumo-injection-mixin.js"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "vaadin-multi-select-combo-box",
-          "customElement": true,
-          "attributes": [
             {
               "name": "accessible-name",
               "type": {
                 "text": "string"
               },
-              "description": "String used to label the component to screen reader users.",
+              "description": "String used to label the component for screen reader users.",
               "fieldName": "accessibleName",
               "inheritedFrom": {
                 "name": "FieldMixin",
@@ -1852,7 +1928,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Id of the element used as label of the component to screen reader users.",
+              "description": "A space-separated list of IDs referencing the elements that\nlabel the component for screen reader users.",
               "fieldName": "accessibleNameRef",
               "inheritedFrom": {
                 "name": "FieldMixin",
@@ -1948,7 +2024,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Set to true to display the clear icon which clears the input.\n\nIt is up to the component to choose where to place the clear icon:\nin the Shadow DOM or in the light DOM. In any way, a reference to\nthe clear icon element should be provided via the `clearElement` getter.",
+              "description": "Set to true to display the clear icon which clears the input.\nThis also enables clearing the input when pressing Esc key.",
               "fieldName": "clearButtonVisible",
               "inheritedFrom": {
                 "name": "ClearButtonMixin",
@@ -2056,11 +2132,11 @@
               "type": {
                 "text": "string"
               },
-              "description": "Path for the id of the item, used to detect whether the item is selected.",
+              "description": "Path for the id of the item. If `items` is an array of objects,\nthe `itemIdPath` is used to compare and identify the same item\nin the selection and in `filteredItems` (items given by the\n`dataProvider` callback).",
               "fieldName": "itemIdPath",
               "inheritedFrom": {
-                "name": "MultiSelectComboBoxMixin",
-                "module": "src/vaadin-multi-select-combo-box-mixin.js"
+                "name": "ComboBoxItemsMixin",
+                "package": "@vaadin/combo-box/src/vaadin-combo-box-items-mixin.js"
               }
             },
             {
@@ -2171,6 +2247,18 @@
                 "package": "@vaadin/combo-box/src/vaadin-combo-box-data-provider-mixin.js"
               }
             },
+            {
+              "name": "partial-match-mode",
+              "type": {
+                "text": "string"
+              },
+              "description": "Controls which item is automatically set to be selected, for\nexample on Enter, when the typed filter only partially matches\nits label. The item that will be selected is highlighted in the\ndropdown while typing:\n\n- `none` (default): an item is automatically set to be selected only when the filter matches its label exactly.\n- `first-match`: the first item in the filtered results is automatically set to be selected.\n- `only-match`: the item is automatically set to be selected when filtering narrows the results to a single item.\n\nIn general, an exact match is always set to be selected and takes\nprecedence over partial matches, regardless of the mode.\n\nA partial match is only applied while the dropdown is open. For\nexample, when auto-open is disabled with `autoOpenDisabled`, typing\ndoes not highlight a match or set it to be selected until the\ndropdown is opened.\n\nThis feature cannot be used together with custom values, because a\npartial match is also a valid custom value. A partial match is not\napplied when custom values are allowed with `allowCustomValue`.",
+              "fieldName": "partialMatchMode",
+              "inheritedFrom": {
+                "name": "ComboBoxItemsMixin",
+                "package": "@vaadin/combo-box/src/vaadin-combo-box-items-mixin.js"
+              }
+            },
             {
               "name": "placeholder",
               "type": {
@@ -2255,6 +2343,13 @@
                 "package": "@vaadin/combo-box/src/vaadin-combo-box-data-provider-mixin.js"
               }
             },
+            {
+              "type": {
+                "text": "string"
+              },
+              "description": "The theme variants to apply to the component.",
+              "name": "theme"
+            },
             {
               "name": "title",
               "type": {
@@ -2267,7 +2362,35 @@
                 "package": "@vaadin/field-base/src/input-control-mixin.js"
               }
             }
-          ]
+          ],
+          "mixins": [
+            {
+              "name": "MultiSelectComboBoxMixin",
+              "module": "src/vaadin-multi-select-combo-box-mixin.js"
+            },
+            {
+              "name": "ThemableMixin",
+              "package": "@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js"
+            },
+            {
+              "name": "ElementMixin",
+              "package": "@vaadin/component-base/src/element-mixin.js"
+            },
+            {
+              "name": "PolylitMixin",
+              "package": "@vaadin/component-base/src/polylit-mixin.js"
+            },
+            {
+              "name": "LumoInjectionMixin",
+              "package": "@vaadin/vaadin-themable-mixin/lumo-injection-mixin.js"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "vaadin-multi-select-combo-box",
+          "customElement": true
         }
       ],
       "exports": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/multi-select-combo-box",
-  "version": "25.3.0-dev.3a3c2d7d2a",
+  "version": "25.3.0",
   "publishConfig": {
     "access": "public"
   },
@@ -37,23 +37,23 @@
   ],
   "dependencies": {
     "@open-wc/dedupe-mixin": "^1.3.0",
-    "@vaadin/a11y-base": "25.3.0-dev.3a3c2d7d2a",
-    "@vaadin/combo-box": "25.3.0-dev.3a3c2d7d2a",
-    "@vaadin/component-base": "25.3.0-dev.3a3c2d7d2a",
-    "@vaadin/field-base": "25.3.0-dev.3a3c2d7d2a",
-    "@vaadin/input-container": "25.3.0-dev.3a3c2d7d2a",
-    "@vaadin/item": "25.3.0-dev.3a3c2d7d2a",
-    "@vaadin/lit-renderer": "25.3.0-dev.3a3c2d7d2a",
-    "@vaadin/overlay": "25.3.0-dev.3a3c2d7d2a",
-    "@vaadin/vaadin-themable-mixin": "25.3.0-dev.3a3c2d7d2a",
+    "@vaadin/a11y-base": "~25.3.0",
+    "@vaadin/combo-box": "~25.3.0",
+    "@vaadin/component-base": "~25.3.0",
+    "@vaadin/field-base": "~25.3.0",
+    "@vaadin/input-container": "~25.3.0",
+    "@vaadin/item": "~25.3.0",
+    "@vaadin/lit-renderer": "~25.3.0",
+    "@vaadin/overlay": "~25.3.0",
+    "@vaadin/vaadin-themable-mixin": "~25.3.0",
     "lit": "^3.0.0"
   },
   "devDependencies": {
-    "@vaadin/aura": "25.3.0-dev.3a3c2d7d2a",
-    "@vaadin/chai-plugins": "25.3.0-dev.3a3c2d7d2a",
-    "@vaadin/test-runner-commands": "25.3.0-dev.3a3c2d7d2a",
+    "@vaadin/aura": "~25.3.0",
+    "@vaadin/chai-plugins": "~25.3.0",
+    "@vaadin/test-runner-commands": "~25.3.0",
     "@vaadin/testing-helpers": "^2.0.0",
-    "@vaadin/vaadin-lumo-styles": "25.3.0-dev.3a3c2d7d2a",
+    "@vaadin/vaadin-lumo-styles": "~25.3.0",
     "sinon": "^22.0.0"
   },
   "customElements": "custom-elements.json",
@@ -61,5 +61,5 @@
     "web-types.json",
     "web-types.lit.json"
   ],
-  "gitHead": "ac506ca7800c23e05da55863c56bcedf12812d37"
+  "gitHead": "4133747243c03bf544f6e82cc2ec9f295aaccd65"
 }

package/src/vaadin-multi-select-combo-box-chip.js

@@ -24,6 +24,7 @@ import { multiSelectComboBoxChipStyles } from './styles/vaadin-multi-select-comb
  *
  * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  *
+ * @attr {string} theme - The theme variants to apply to the component.
  * @customElement vaadin-multi-select-combo-box-chip
  * @extends HTMLElement
  * @private

package/src/vaadin-multi-select-combo-box-item.js

@@ -34,10 +34,11 @@ import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mix
  *
  * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  *
+ * @attr {string} theme - The theme variants to apply to the component.
  * @customElement vaadin-multi-select-combo-box-item
  * @private
  */
-export class MultiSelectComboBoxItem extends ComboBoxItemMixin(
+class MultiSelectComboBoxItem extends ComboBoxItemMixin(
   ThemableMixin(DirMixin(PolylitMixin(LumoInjectionMixin(LitElement)))),
 ) {
   static get is() {
@@ -60,3 +61,5 @@ export class MultiSelectComboBoxItem extends ComboBoxItemMixin(
 }
 
 defineCustomElement(MultiSelectComboBoxItem);
+
+export { MultiSelectComboBoxItem };

package/src/vaadin-multi-select-combo-box-mixin.d.ts

@@ -100,12 +100,6 @@ export declare class MultiSelectComboBoxMixinClass<TItem> {
    */
   itemClassNameGenerator: (item: TItem) => string;
 
-  /**
-   * Path for the id of the item, used to detect whether the item is selected.
-   * @attr {string} item-id-path
-   */
-  itemIdPath: string;
-
   /**
    * The object used to localize this component. To change the default
    * localization, replace this with an object that provides all properties, or
@@ -177,12 +171,4 @@ export declare class MultiSelectComboBoxMixinClass<TItem> {
    * Clears the selected items.
    */
   clear(): void;
-
-  /**
-   * Requests an update for the content of items.
-   * While performing the update, it invokes the renderer (passed in the `renderer` property) once an item.
-   *
-   * It is not guaranteed that the update happens immediately (synchronously) after it is requested.
-   */
-  requestContentUpdate(): void;
 }