@vaadin/select 25.0.0-alpha2 → 25.0.0-alpha20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/select",
-  "version": "25.0.0-alpha2",
+  "version": "25.0.0-alpha20",
   "publishConfig": {
     "access": "public"
   },
@@ -23,9 +23,6 @@
     "lit.d.ts",
     "lit.js",
     "src",
-    "!src/*-base-styles.d.ts",
-    "!src/*-base-styles.js",
-    "theme",
     "vaadin-*.d.ts",
     "vaadin-*.js",
     "web-types.json",
@@ -39,28 +36,28 @@
   ],
   "dependencies": {
     "@open-wc/dedupe-mixin": "^1.3.0",
-    "@vaadin/a11y-base": "25.0.0-alpha2",
-    "@vaadin/button": "25.0.0-alpha2",
-    "@vaadin/component-base": "25.0.0-alpha2",
-    "@vaadin/field-base": "25.0.0-alpha2",
-    "@vaadin/input-container": "25.0.0-alpha2",
-    "@vaadin/item": "25.0.0-alpha2",
-    "@vaadin/list-box": "25.0.0-alpha2",
-    "@vaadin/lit-renderer": "25.0.0-alpha2",
-    "@vaadin/overlay": "25.0.0-alpha2",
-    "@vaadin/vaadin-lumo-styles": "25.0.0-alpha2",
-    "@vaadin/vaadin-themable-mixin": "25.0.0-alpha2",
+    "@vaadin/a11y-base": "25.0.0-alpha20",
+    "@vaadin/button": "25.0.0-alpha20",
+    "@vaadin/component-base": "25.0.0-alpha20",
+    "@vaadin/field-base": "25.0.0-alpha20",
+    "@vaadin/input-container": "25.0.0-alpha20",
+    "@vaadin/item": "25.0.0-alpha20",
+    "@vaadin/list-box": "25.0.0-alpha20",
+    "@vaadin/lit-renderer": "25.0.0-alpha20",
+    "@vaadin/overlay": "25.0.0-alpha20",
+    "@vaadin/vaadin-themable-mixin": "25.0.0-alpha20",
     "lit": "^3.0.0"
   },
   "devDependencies": {
-    "@vaadin/chai-plugins": "25.0.0-alpha2",
-    "@vaadin/test-runner-commands": "25.0.0-alpha2",
+    "@vaadin/chai-plugins": "25.0.0-alpha20",
+    "@vaadin/test-runner-commands": "25.0.0-alpha20",
     "@vaadin/testing-helpers": "^2.0.0",
-    "sinon": "^18.0.0"
+    "@vaadin/vaadin-lumo-styles": "25.0.0-alpha20",
+    "sinon": "^21.0.0"
   },
   "web-types": [
     "web-types.json",
     "web-types.lit.json"
   ],
-  "gitHead": "67ffcd5355cf21ce1b5039c598525109fc4c164b"
+  "gitHead": "c948aae591a30b432f3784000d4677674cae56e0"
 }

package/src/lit/renderer-directives.d.ts

@@ -28,7 +28,7 @@ export class SelectRendererDirective extends LitRendererDirective<Select, Select
 }
 
 /**
- * A Lit directive for populating the content of the `<vaadin-select-overlay>` element.
+ * A Lit directive for populating the content of the `<vaadin-select>` element.
  *
  * The directive accepts a renderer callback returning a Lit template and assigns it to the select
  * via the `renderer` property. The renderer is called once to populate the content when assigned

package/src/lit/renderer-directives.js

@@ -32,7 +32,7 @@ export class SelectRendererDirective extends LitRendererDirective {
 }
 
 /**
- * A Lit directive for populating the content of the `<vaadin-select-overlay>` element.
+ * A Lit directive for populating the content of the `<vaadin-select>` element.
  *
  * The directive accepts a renderer callback returning a Lit template and assigns it to the select
  * via the `renderer` property. The renderer is called once to populate the content when assigned

package/src/styles/vaadin-select-base-styles.js

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright (c) 2017 - 2025 Vaadin Ltd.
+ * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
+ */
+import '@vaadin/component-base/src/styles/style-props.js';
+import { css } from 'lit';
+
+export const selectStyles = css`
+  :host {
+    position: relative;
+  }
+
+  ::slotted([slot='value']) {
+    flex: 1;
+  }
+
+  ::slotted(div[slot='overlay']) {
+    display: contents;
+  }
+
+  :host(:not([focus-ring])) [part='input-field'] {
+    outline: none;
+  }
+
+  :host([readonly]:not([focus-ring])) [part='input-field'] {
+    --vaadin-input-field-border-color: inherit;
+  }
+
+  [part='input-field'],
+  :host(:not([readonly])) ::slotted([slot='value']) {
+    cursor: var(--vaadin-clickable-cursor);
+  }
+
+  [part~='toggle-button']::before {
+    mask-image: var(--_vaadin-icon-chevron-down);
+  }
+`;

package/src/{vaadin-select-overlay-core-styles.js → styles/vaadin-select-overlay-base-styles.js}

@@ -11,13 +11,15 @@ export const selectOverlayStyles = css`
     justify-content: flex-start;
   }
 
-  :host(:not([phone])) [part='overlay'] {
-    min-width: var(--vaadin-select-overlay-width, var(--vaadin-select-text-field-width));
+  [part='overlay'] {
+    min-width: var(--vaadin-select-overlay-width, var(--_vaadin-select-overlay-default-width));
   }
 
-  @media (forced-colors: active) {
-    [part='overlay'] {
-      outline: 3px solid;
-    }
+  [part='content'] {
+    padding: var(--vaadin-item-overlay-padding, 4px);
+  }
+
+  [part='backdrop'] {
+    background: transparent;
   }
 `;

package/src/styles/vaadin-select-value-button-base-styles.js

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright (c) 2017 - 2025 Vaadin Ltd.
+ * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
+ */
+import { css } from 'lit';
+
+export const valueButton = css`
+  :host {
+    min-height: 1lh;
+    outline: none;
+    overflow: hidden;
+    white-space: nowrap;
+    width: 100%;
+  }
+
+  ::slotted(*) {
+    padding: 0;
+    cursor: inherit;
+  }
+
+  .vaadin-button-container,
+  [part='label'] {
+    display: contents;
+  }
+
+  :host([placeholder]) {
+    color: var(--vaadin-input-field-placeholder-color, var(--vaadin-text-color-secondary));
+  }
+
+  :host([disabled]) {
+    pointer-events: none;
+  }
+`;

package/src/vaadin-select-base-mixin.d.ts

@@ -10,7 +10,6 @@ import type { FocusMixinClass } from '@vaadin/a11y-base/src/focus-mixin.js';
 import type { KeyboardMixinClass } from '@vaadin/a11y-base/src/keyboard-mixin.js';
 import type { TabindexMixinClass } from '@vaadin/a11y-base/src/tabindex-mixin.js';
 import type { DelegateStateMixinClass } from '@vaadin/component-base/src/delegate-state-mixin.js';
-import type { OverlayClassMixinClass } from '@vaadin/component-base/src/overlay-class-mixin.js';
 import type { FieldMixinClass } from '@vaadin/field-base/src/field-mixin.js';
 import type { LabelMixinClass } from '@vaadin/field-base/src/label-mixin.js';
 import type { ValidateMixinClass } from '@vaadin/field-base/src/validate-mixin.js';
@@ -25,7 +24,6 @@ export declare function SelectBaseMixin<T extends Constructor<HTMLElement>>(
   Constructor<FocusMixinClass> &
   Constructor<KeyboardMixinClass> &
   Constructor<LabelMixinClass> &
-  Constructor<OverlayClassMixinClass> &
   Constructor<SelectBaseMixinClass> &
   Constructor<TabindexMixinClass> &
   Constructor<ValidateMixinClass> &
@@ -64,8 +62,7 @@ export declare class SelectBaseMixinClass {
    * Custom function for rendering the content of the `<vaadin-select>`.
    * Receives two arguments:
    *
-   * - `root` The `<vaadin-select-overlay>` internal container
-   *   DOM element. Append your content to it.
+   * - `root` The internal container DOM element. Append your content to it.
    * - `select` The reference to the `<vaadin-select>` element.
    */
   renderer: SelectRenderer | undefined;

package/src/vaadin-select-base-mixin.js

@@ -8,7 +8,6 @@ import { DelegateFocusMixin } from '@vaadin/a11y-base/src/delegate-focus-mixin.j
 import { KeyboardMixin } from '@vaadin/a11y-base/src/keyboard-mixin.js';
 import { DelegateStateMixin } from '@vaadin/component-base/src/delegate-state-mixin.js';
 import { MediaQueryController } from '@vaadin/component-base/src/media-query-controller.js';
-import { OverlayClassMixin } from '@vaadin/component-base/src/overlay-class-mixin.js';
 import { TooltipController } from '@vaadin/component-base/src/tooltip-controller.js';
 import { generateUniqueId } from '@vaadin/component-base/src/unique-id-utils.js';
 import { FieldMixin } from '@vaadin/field-base/src/field-mixin.js';
@@ -21,12 +20,9 @@ import { ButtonController } from './button-controller.js';
  * @mixes DelegateStateMixin
  * @mixes FieldMixin
  * @mixes KeyboardMixin
- * @mixes OverlayClassMixin
  */
 export const SelectBaseMixin = (superClass) =>
-  class SelectBaseMixin extends OverlayClassMixin(
-    DelegateFocusMixin(DelegateStateMixin(KeyboardMixin(FieldMixin(superClass)))),
-  ) {
+  class SelectBaseMixin extends DelegateFocusMixin(DelegateStateMixin(KeyboardMixin(FieldMixin(superClass)))) {
     static get properties() {
       return {
         /**
@@ -63,6 +59,7 @@ export const SelectBaseMixin = (superClass) =>
           type: Boolean,
           value: false,
           notify: true,
+          observer: '_openedChanged',
           reflectToAttribute: true,
           sync: true,
         },
@@ -71,8 +68,7 @@ export const SelectBaseMixin = (superClass) =>
          * Custom function for rendering the content of the `<vaadin-select>`.
          * Receives two arguments:
          *
-         * - `root` The `<vaadin-select-overlay>` internal container
-         *   DOM element. Append your content to it.
+         * - `root` The internal container DOM element. Append your content to it.
          * - `select` The reference to the `<vaadin-select>` element.
          * @type {!SelectRenderer | undefined}
          */
@@ -160,11 +156,7 @@ export const SelectBaseMixin = (superClass) =>
     }
 
     static get observers() {
-      return [
-        '_updateAriaExpanded(opened, focusElement)',
-        '_updateSelectedItem(value, _items, placeholder)',
-        '_openedChanged(opened, _overlayElement)',
-      ];
+      return ['_updateAriaExpanded(opened, focusElement)', '_updateSelectedItem(value, _items, placeholder)'];
     }
 
     constructor() {
@@ -207,6 +199,15 @@ export const SelectBaseMixin = (superClass) =>
       this.addController(this._tooltipController);
     }
 
+    /** @protected */
+    updated(props) {
+      super.updated(props);
+
+      if (props.has('_phone')) {
+        this.toggleAttribute('phone', this._phone);
+      }
+    }
+
     /**
      * Requests an update for the content of the select.
      * While performing the update, it invokes the renderer passed in the `renderer` property.
@@ -219,10 +220,6 @@ export const SelectBaseMixin = (superClass) =>
       }
 
       this._overlayElement.requestContentUpdate();
-
-      if (this._menuElement && this._menuElement.items) {
-        this._updateSelectedItem(this.value, this._menuElement.items);
-      }
     }
 
     /**
@@ -283,6 +280,12 @@ export const SelectBaseMixin = (superClass) =>
         // Store the menu element reference
         this.__lastMenuElement = menuElement;
       }
+
+      // When the renderer was re-assigned so that menu element is preserved
+      // but its items have changed, make sure selected property is updated.
+      if (this._menuElement && this._menuElement.items) {
+        this._updateSelectedItem(this.value, this._menuElement.items);
+      }
     }
 
     /** @private */
@@ -326,6 +329,12 @@ export const SelectBaseMixin = (superClass) =>
       // Prevent mousedown event to avoid blur and preserve focused state
       // while opening, and to restore focus-ring attribute on closing.
       event.preventDefault();
+
+      // Clicking the `vaadin-input-container` focuses the value button
+      // but clicking the toggle button does not, so we handle it here.
+      if (!this.opened) {
+        this.focusElement.focus();
+      }
     }
 
     /**
@@ -358,17 +367,21 @@ export const SelectBaseMixin = (superClass) =>
      * @protected
      */
     _onKeyDownInside(e) {
-      if (/^(Tab)$/u.test(e.key)) {
+      if (e.key === 'Tab') {
+        // Temporarily set tabindex to prevent moving focus
+        // to the value button element on item Shift + Tab
+        this.focusElement.setAttribute('tabindex', '-1');
+        this._overlayElement.restoreFocusOnClose = false;
         this.opened = false;
+        setTimeout(() => {
+          this.focusElement.setAttribute('tabindex', '0');
+          this._overlayElement.restoreFocusOnClose = true;
+        });
       }
     }
 
     /** @private */
-    _openedChanged(opened, overlayElement) {
-      if (!overlayElement) {
-        return;
-      }
-
+    _openedChanged(opened, oldOpened) {
       if (opened) {
         if (this.disabled || this.readonly) {
           // Disallow programmatic opening when disabled or readonly
@@ -379,8 +392,6 @@ export const SelectBaseMixin = (superClass) =>
         // Avoid multiple announcements when a value gets selected from the dropdown
         this._updateAriaLive(false);
 
-        overlayElement.style.setProperty('--vaadin-select-text-field-width', `${this._inputContainer.offsetWidth}px`);
-
         // Preserve focus-ring to restore it later
         const hasFocusRing = this.hasAttribute('focus-ring');
         this._openedWithFocusRing = hasFocusRing;
@@ -389,7 +400,7 @@ export const SelectBaseMixin = (superClass) =>
         if (hasFocusRing) {
           this.removeAttribute('focus-ring');
         }
-      } else if (this.__oldOpened) {
+      } else if (oldOpened) {
         if (this._openedWithFocusRing) {
           this.setAttribute('focus-ring', '');
         }
@@ -401,8 +412,6 @@ export const SelectBaseMixin = (superClass) =>
           this._requestValidation();
         }
       }
-
-      this.__oldOpened = opened;
     }
 
     /** @private */
@@ -590,8 +599,8 @@ export const SelectBaseMixin = (superClass) =>
      * @protected
      * @override
      */
-    _shouldRemoveFocus() {
-      return !this.opened;
+    _shouldRemoveFocus(event) {
+      return !this.contains(event.relatedTarget);
     }
 
     /**
@@ -644,13 +653,7 @@ export const SelectBaseMixin = (superClass) =>
     }
 
     /** @private */
-    async __dispatchChange() {
-      // Wait for the update complete to guarantee that value-changed is fired
-      // before validated and change events when using the Lit version of the component.
-      if (this.updateComplete) {
-        await this.updateComplete;
-      }
-
+    __dispatchChange() {
       this._requestValidation();
       this.dispatchEvent(new CustomEvent('change', { bubbles: true }));
       this.__dispatchChangePending = false;

package/src/vaadin-select-item.js

@@ -7,8 +7,9 @@ import { html, LitElement } from 'lit';
 import { defineCustomElement } from '@vaadin/component-base/src/define.js';
 import { DirMixin } from '@vaadin/component-base/src/dir-mixin.js';
 import { PolylitMixin } from '@vaadin/component-base/src/polylit-mixin.js';
-import { itemStyles } from '@vaadin/item/src/vaadin-item-core-styles.js';
+import { itemStyles } from '@vaadin/item/src/styles/vaadin-item-base-styles.js';
 import { ItemMixin } from '@vaadin/item/src/vaadin-item-mixin.js';
+import { LumoInjectionMixin } from '@vaadin/vaadin-themable-mixin/lumo-injection-mixin.js';
 import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
 
 /**
@@ -21,7 +22,7 @@ import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mix
  * @mixes ThemableMixin
  * @protected
  */
-class SelectItem extends ItemMixin(ThemableMixin(DirMixin(PolylitMixin(LitElement)))) {
+class SelectItem extends ItemMixin(ThemableMixin(DirMixin(PolylitMixin(LumoInjectionMixin(LitElement))))) {
   static get is() {
     return 'vaadin-select-item';
   }

package/src/vaadin-select-list-box.js

@@ -8,7 +8,8 @@ import { ListMixin } from '@vaadin/a11y-base/src/list-mixin.js';
 import { defineCustomElement } from '@vaadin/component-base/src/define.js';
 import { DirMixin } from '@vaadin/component-base/src/dir-mixin.js';
 import { PolylitMixin } from '@vaadin/component-base/src/polylit-mixin.js';
-import { listBoxStyles } from '@vaadin/list-box/src/vaadin-list-box-core-styles.js';
+import { listBoxStyles } from '@vaadin/list-box/src/styles/vaadin-list-box-base-styles.js';
+import { LumoInjectionMixin } from '@vaadin/vaadin-themable-mixin/lumo-injection-mixin.js';
 import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
 
 /**
@@ -21,7 +22,7 @@ import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mix
  * @mixes ThemableMixin
  * @protected
  */
-class SelectListBox extends ListMixin(ThemableMixin(DirMixin(PolylitMixin(LitElement)))) {
+class SelectListBox extends ListMixin(ThemableMixin(DirMixin(PolylitMixin(LumoInjectionMixin(LitElement))))) {
   static get is() {
     return 'vaadin-select-list-box';
   }

package/src/vaadin-select-overlay-mixin.js

@@ -16,7 +16,7 @@ import { PositionMixin } from '@vaadin/overlay/src/vaadin-overlay-position-mixin
 export const SelectOverlayMixin = (superClass) =>
   class SelectOverlayMixin extends PositionMixin(OverlayMixin(DirMixin(superClass))) {
     static get observers() {
-      return ['_updateOverlayWidth(opened, owner)'];
+      return ['_updateOverlayWidth(opened, positionTarget)'];
     }
 
     /** @protected */
@@ -26,6 +26,21 @@ export const SelectOverlayMixin = (superClass) =>
       this.restoreFocusOnClose = true;
     }
 
+    /**
+     * @override
+     * @protected
+     */
+    get _contentRoot() {
+      if (!this.__savedRoot) {
+        const root = document.createElement('div');
+        root.setAttribute('slot', 'overlay');
+        this.owner.appendChild(root);
+        this.__savedRoot = root;
+      }
+
+      return this.__savedRoot;
+    }
+
     /**
      * Override method inherited from `Overlay` to always close on outside click,
      * in order to avoid problem when using inside of the modeless dialog.
@@ -38,22 +53,26 @@ export const SelectOverlayMixin = (superClass) =>
       return true;
     }
 
+    /**
+     * @protected
+     * @override
+     */
+    _mouseDownListener(event) {
+      super._mouseDownListener(event);
+
+      // Prevent global mousedown event to avoid losing focus on outside click
+      event.preventDefault();
+    }
+
     /** @protected */
     _getMenuElement() {
-      return Array.from(this.children).find((el) => el.localName !== 'style');
+      return Array.from(this._contentRoot.children).find((el) => el.localName !== 'style');
     }
 
     /** @private */
-    _updateOverlayWidth(opened, owner) {
-      if (opened && owner) {
-        const widthProperty = '--vaadin-select-overlay-width';
-        const customWidth = getComputedStyle(owner).getPropertyValue(widthProperty);
-
-        if (customWidth === '') {
-          this.style.removeProperty(widthProperty);
-        } else {
-          this.style.setProperty(widthProperty, customWidth);
-        }
+    _updateOverlayWidth(opened, positionTarget) {
+      if (opened && positionTarget) {
+        this.style.setProperty('--_vaadin-select-overlay-default-width', `${positionTarget.offsetWidth}px`);
       }
     }
 

package/src/vaadin-select-overlay.js

@@ -6,9 +6,10 @@
 import { html, LitElement } from 'lit';
 import { defineCustomElement } from '@vaadin/component-base/src/define.js';
 import { PolylitMixin } from '@vaadin/component-base/src/polylit-mixin.js';
-import { overlayStyles } from '@vaadin/overlay/src/vaadin-overlay-styles.js';
+import { overlayStyles } from '@vaadin/overlay/src/styles/vaadin-overlay-base-styles.js';
+import { LumoInjectionMixin } from '@vaadin/vaadin-themable-mixin/lumo-injection-mixin.js';
 import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
-import { selectOverlayStyles } from './vaadin-select-overlay-core-styles.js';
+import { selectOverlayStyles } from './styles/vaadin-select-overlay-base-styles.js';
 import { SelectOverlayMixin } from './vaadin-select-overlay-mixin.js';
 
 /**
@@ -20,7 +21,7 @@ import { SelectOverlayMixin } from './vaadin-select-overlay-mixin.js';
  * @mixes ThemableMixin
  * @private
  */
-export class SelectOverlay extends SelectOverlayMixin(ThemableMixin(PolylitMixin(LitElement))) {
+export class SelectOverlay extends SelectOverlayMixin(ThemableMixin(PolylitMixin(LumoInjectionMixin(LitElement)))) {
   static get is() {
     return 'vaadin-select-overlay';
   }
@@ -33,7 +34,7 @@ export class SelectOverlay extends SelectOverlayMixin(ThemableMixin(PolylitMixin
   render() {
     return html`
       <div id="backdrop" part="backdrop" ?hidden="${!this.withBackdrop}"></div>
-      <div part="overlay" id="overlay" tabindex="0">
+      <div part="overlay" id="overlay">
         <div part="content" id="content">
           <slot></slot>
         </div>

package/src/vaadin-select-value-button.js

@@ -7,8 +7,9 @@ import { html, LitElement } from 'lit';
 import { ButtonMixin } from '@vaadin/button/src/vaadin-button-mixin.js';
 import { defineCustomElement } from '@vaadin/component-base/src/define.js';
 import { PolylitMixin } from '@vaadin/component-base/src/polylit-mixin.js';
+import { LumoInjectionMixin } from '@vaadin/vaadin-themable-mixin/lumo-injection-mixin.js';
 import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
-import { valueButton } from './vaadin-select-value-button-core-styles.js';
+import { valueButton } from './styles/vaadin-select-value-button-base-styles.js';
 
 /**
  * An element used internally by `<vaadin-select>`. Not intended to be used separately.
@@ -19,7 +20,7 @@ import { valueButton } from './vaadin-select-value-button-core-styles.js';
  * @mixes ThemableMixin
  * @protected
  */
-class SelectValueButton extends ButtonMixin(ThemableMixin(PolylitMixin(LitElement))) {
+class SelectValueButton extends ButtonMixin(ThemableMixin(PolylitMixin(LumoInjectionMixin(LitElement)))) {
   static get is() {
     return 'vaadin-select-value-button';
   }

package/src/vaadin-select.d.ts

@@ -26,8 +26,7 @@ export type SelectChangeEvent = Event & {
  * Function for rendering the content of the `<vaadin-select>`.
  * Receives two arguments:
  *
- * - `root` The `<vaadin-select-overlay>` internal container
- *   DOM element. Append your content to it.
+ * - `root` The internal container DOM element. Append your content to it.
  * - `select` The reference to the `<vaadin-select>` element.
  */
 export type SelectRenderer = (root: HTMLElement, select: Select) => void;
@@ -126,43 +125,50 @@ export interface SelectEventMap extends HTMLElementEventMap, SelectCustomEventMa
  *
  * The following custom properties are available for styling:
  *
- * Custom property                    | Description                  | Target element          | Default
- * -----------------------------------|------------------------------|----------------------------------
- * `--vaadin-field-default-width`     | Default width of the field   | :host                   | `12em`
- * `--vaadin-select-text-field-width` | Effective width of the field | `vaadin-select-overlay` |
- * `--vaadin-select-overlay-width`    | Width of the overlay         | `vaadin-select-overlay` |
- *
- * `<vaadin-select>` provides mostly the same set of shadow DOM parts and state attributes as `<vaadin-text-field>`.
- * See [`<vaadin-text-field>`](#/elements/vaadin-text-field) for the styling documentation.
- *
- *
- * In addition to `<vaadin-text-field>` parts, the following parts are available for theming:
- *
- * Part name       | Description
- * ----------------|----------------
- * `toggle-button` | The toggle button
- *
- * In addition to `<vaadin-text-field>` state attributes, the following state attributes are available for theming:
- *
- * Attribute | Description                 | Part name
- * ----------|-----------------------------|-----------
- * `opened`  | Set when the select is open | :host
- *
- * There are two exceptions in terms of styling compared to `<vaadin-text-field>`:
- * - the `clear-button` shadow DOM part does not exist in `<vaadin-select>`.
- * - the `input-prevented` state attribute is not supported by `<vaadin-select>`.
+ * Custom property                  | Description                 | Default
+ * ---------------------------------|-----------------------------|--------
+ * `--vaadin-field-default-width`   | Default width of the field  | `12em`
+ * `--vaadin-select-overlay-width`  | Width of the overlay        |
+ *
+ * The following shadow DOM parts are available for styling:
+ *
+ * Part name            | Description
+ * ---------------------|----------------
+ * `label`              | The label element
+ * `input-field`        | The element that wraps prefix, value and toggle button
+ * `field-button`       | Set on the toggle button
+ * `error-message`      | The error message element
+ * `helper-text`        | The helper text element wrapper
+ * `required-indicator` | The `required` state indicator element
+ * `toggle-button`      | The toggle button
+ * `backdrop`           | Backdrop of the overlay
+ * `overlay`            | The overlay container
+ * `content`            | The overlay content
+ *
+ * The following state attributes are available for styling:
+ *
+ * Attribute            | Description
+ * ---------------------|---------------------------------
+ * `disabled`           | Set when the element is disabled
+ * `has-value`          | Set when the element has a value
+ * `has-label`          | Set when the element has a label
+ * `has-helper`         | Set when the element has helper text or slot
+ * `has-error-message`  | Set when the element has an error message
+ * `invalid`            | Set when the element is invalid
+ * `focused`            | Set when the element is focused
+ * `focus-ring`         | Set when the element is keyboard focused
+ * `readonly`           | Set when the element is readonly
+ * `opened`             | Set when the overlay is opened
+ * `phone`              | Set when the overlay is shown in phone mode
  *
  * ### Internal components
  *
  * In addition to `<vaadin-select>` itself, the following internal
  * components are themable:
  *
- * - `<vaadin-select-overlay>` - has the same API as [`<vaadin-overlay>`](#/elements/vaadin-overlay).
  * - `<vaadin-select-value-button>` - has the same API as [`<vaadin-button>`](#/elements/vaadin-button).
- * - [`<vaadin-input-container>`](#/elements/vaadin-input-container) - an internal element wrapping the button.
- *
- * Note: the `theme` attribute value set on `<vaadin-select>` is
- * propagated to the internal components listed above.
+ * - `<vaadin-select-list-box>` - has the same API as [`<vaadin-list-box>`](#/elements/vaadin-list-box).
+ * - `<vaadin-select-item>` - has the same API as [`<vaadin-item>`](#/elements/vaadin-item).
  *
  * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  *