@vaadin/multi-select-combo-box 23.2.0 → 23.3.0-alpha1

package/README.md

@@ -2,15 +2,19 @@
 
 A web component that wraps `<vaadin-combo-box>` and allows selecting multiple items.
 
+[Documentation + Live Demo ↗](https://vaadin.com/docs/latest/components/multi-select-combo-box)
+
 ```html
-<vaadin-multi-select-combo-box id="fruit"></vaadin-multi-select-combo-box>
+<vaadin-multi-select-combo-box style="width: 300px"></vaadin-multi-select-combo-box>
 <script>
-  const comboBox = document.querySelector('#fruit');
+  const comboBox = document.querySelector('vaadin-multi-select-combo-box');
   comboBox.items = ['apple', 'banana', 'lemon', 'orange'];
-  comboBox.selectedItems = ['lemon', 'orange'];
+  comboBox.selectedItems = ['apple', 'banana'];
 </script>
 ```
 
+[<img src="https://raw.githubusercontent.com/vaadin/web-components/master/packages/multi-select-combo-box/screenshot.png" width="300" alt="Screenshot of vaadin-multi-select-combo-box">](https://vaadin.com/docs/latest/components/multi-select-combo-box)
+
 ## Installation
 
 Install the component:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/multi-select-combo-box",
-  "version": "23.2.0",
+  "version": "23.3.0-alpha1",
   "publishConfig": {
     "access": "public"
   },
@@ -19,8 +19,8 @@
   "main": "vaadin-multi-select-combo-box.js",
   "module": "vaadin-multi-select-combo-box.js",
   "files": [
-    "lit.js",
     "lit.d.ts",
+    "lit.js",
     "src",
     "theme",
     "vaadin-*.d.ts",
@@ -37,14 +37,14 @@
   ],
   "dependencies": {
     "@polymer/polymer": "^3.0.0",
-    "@vaadin/combo-box": "^23.2.0",
-    "@vaadin/component-base": "^23.2.0",
-    "@vaadin/field-base": "^23.2.0",
-    "@vaadin/input-container": "^23.2.0",
-    "@vaadin/lit-renderer": "^23.2.0",
-    "@vaadin/vaadin-lumo-styles": "^23.2.0",
-    "@vaadin/vaadin-material-styles": "^23.2.0",
-    "@vaadin/vaadin-themable-mixin": "^23.2.0"
+    "@vaadin/combo-box": "23.3.0-alpha1",
+    "@vaadin/component-base": "23.3.0-alpha1",
+    "@vaadin/field-base": "23.3.0-alpha1",
+    "@vaadin/input-container": "23.3.0-alpha1",
+    "@vaadin/lit-renderer": "23.3.0-alpha1",
+    "@vaadin/vaadin-lumo-styles": "23.3.0-alpha1",
+    "@vaadin/vaadin-material-styles": "23.3.0-alpha1",
+    "@vaadin/vaadin-themable-mixin": "23.3.0-alpha1"
   },
   "devDependencies": {
     "@esm-bundle/chai": "^4.3.4",
@@ -55,5 +55,5 @@
     "web-types.json",
     "web-types.lit.json"
   ],
-  "gitHead": "8b1f5941f26ac41ca038e75e24c8584e331bc7a8"
+  "gitHead": "beabc527d4b1274eb798ff701d406fed45cfe638"
 }

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

@@ -21,6 +21,7 @@ import type { InputConstraintsMixinClass } from '@vaadin/field-base/src/input-co
 import type { InputControlMixinClass } from '@vaadin/field-base/src/input-control-mixin.js';
 import type { InputMixinClass } from '@vaadin/field-base/src/input-mixin.js';
 import type { LabelMixinClass } from '@vaadin/field-base/src/label-mixin.js';
+import type { SlotStylesMixinClass } from '@vaadin/field-base/src/slot-styles-mixin.js';
 import type { ValidateMixinClass } from '@vaadin/field-base/src/validate-mixin.js';
 import type { ThemableMixinClass } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
 import type { ThemePropertyMixinClass } from '@vaadin/vaadin-themable-mixin/vaadin-theme-property-mixin.js';
@@ -332,6 +333,7 @@ declare class MultiSelectComboBox<TItem = ComboBoxDefaultItem> extends HTMLEleme
 
 interface MultiSelectComboBox
   extends ValidateMixinClass,
+    SlotStylesMixinClass,
     LabelMixinClass,
     KeyboardMixinClass,
     Omit<InputMixinClass, 'value'>,

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

@@ -11,6 +11,7 @@ import { announce } from '@vaadin/component-base/src/a11y-announcer.js';
 import { ElementMixin } from '@vaadin/component-base/src/element-mixin.js';
 import { ResizeMixin } from '@vaadin/component-base/src/resize-mixin.js';
 import { processTemplates } from '@vaadin/component-base/src/templates.js';
+import { TooltipController } from '@vaadin/component-base/src/tooltip-controller.js';
 import { InputControlMixin } from '@vaadin/field-base/src/input-control-mixin.js';
 import { InputController } from '@vaadin/field-base/src/input-controller.js';
 import { LabelledInputController } from '@vaadin/field-base/src/labelled-input-controller.js';
@@ -31,10 +32,6 @@ const multiSelectComboBox = css`
     align-items: center;
   }
 
-  :host([has-value]) ::slotted(input:placeholder-shown) {
-    color: transparent !important;
-  }
-
   ::slotted(input) {
     box-sizing: border-box;
     flex: 1 0 var(--input-min-width);
@@ -217,6 +214,8 @@ class MultiSelectComboBox extends ResizeMixin(InputControlMixin(ThemableMixin(El
           <slot name="error-message"></slot>
         </div>
       </div>
+
+      <slot name="tooltip"></slot>
     `;
   }
 
@@ -473,6 +472,19 @@ class MultiSelectComboBox extends ResizeMixin(InputControlMixin(ThemableMixin(El
     return ['_selectedItemsChanged(selectedItems, selectedItems.*)'];
   }
 
+  /** @protected */
+  get slotStyles() {
+    const tag = this.localName;
+    return [
+      ...super.slotStyles,
+      `
+        ${tag}[has-value] input::placeholder {
+          color: transparent !important;
+        }
+      `,
+    ];
+  }
+
   /**
    * Used by `InputControlMixin` as a reference to the clear button element.
    * @protected
@@ -501,6 +513,10 @@ class MultiSelectComboBox extends ResizeMixin(InputControlMixin(ThemableMixin(El
     );
     this.addController(new LabelledInputController(this.inputElement, this._labelController));
 
+    this._tooltipController = new TooltipController(this);
+    this.addController(this._tooltipController);
+    this._tooltipController.setShouldShow((target) => !target.opened);
+
     this._inputField = this.shadowRoot.querySelector('[part="input-field"]');
     this.__updateChips();
 

package/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/multi-select-combo-box",
-  "version": "23.2.0",
+  "version": "23.3.0-alpha1",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -652,6 +652,14 @@
               {
                 "name": "filter-changed",
                 "description": "Fired when the `filter` property changes."
+              },
+              {
+                "name": "invalid-changed",
+                "description": "Fired when the `invalid` property changes."
+              },
+              {
+                "name": "selectedItems-changed",
+                "description": "Fired when the `selectedItems` property changes."
               }
             ]
           }

package/web-types.lit.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/multi-select-combo-box",
-  "version": "23.2.0",
+  "version": "23.3.0-alpha1",
   "description-markup": "markdown",
   "framework": "lit",
   "framework-config": {
@@ -270,6 +270,20 @@
               "value": {
                 "kind": "expression"
               }
+            },
+            {
+              "name": "@invalid-changed",
+              "description": "Fired when the `invalid` property changes.",
+              "value": {
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "@selectedItems-changed",
+              "description": "Fired when the `selectedItems` property changes.",
+              "value": {
+                "kind": "expression"
+              }
             }
           ]
         }