@vaadin/menu-bar 23.2.2 → 23.3.0-alpha2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/menu-bar",
-  "version": "23.2.2",
+  "version": "23.3.0-alpha2",
   "publishConfig": {
     "access": "public"
   },
@@ -37,16 +37,16 @@
   "dependencies": {
     "@open-wc/dedupe-mixin": "^1.3.0",
     "@polymer/polymer": "^3.0.0",
-    "@vaadin/button": "~23.2.2",
-    "@vaadin/component-base": "~23.2.2",
-    "@vaadin/context-menu": "~23.2.2",
-    "@vaadin/vaadin-lumo-styles": "~23.2.2",
-    "@vaadin/vaadin-material-styles": "~23.2.2",
-    "@vaadin/vaadin-themable-mixin": "~23.2.2"
+    "@vaadin/button": "23.3.0-alpha2",
+    "@vaadin/component-base": "23.3.0-alpha2",
+    "@vaadin/context-menu": "23.3.0-alpha2",
+    "@vaadin/vaadin-lumo-styles": "23.3.0-alpha2",
+    "@vaadin/vaadin-material-styles": "23.3.0-alpha2",
+    "@vaadin/vaadin-themable-mixin": "23.3.0-alpha2"
   },
   "devDependencies": {
     "@esm-bundle/chai": "^4.3.4",
-    "@vaadin/icon": "~23.2.2",
+    "@vaadin/icon": "23.3.0-alpha2",
     "@vaadin/testing-helpers": "^0.3.2",
     "sinon": "^13.0.2"
   },
@@ -54,5 +54,5 @@
     "web-types.json",
     "web-types.lit.json"
   ],
-  "gitHead": "a98818979098f4542ce557a58858fb6dad910a25"
+  "gitHead": "ae61027c62ffa7f7d70cfc50e43f333addfc74b6"
 }

package/src/vaadin-menu-bar-interactions-mixin.d.ts

@@ -4,10 +4,17 @@
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
 import type { Constructor } from '@open-wc/dedupe-mixin';
+import type { FocusMixinClass } from '@vaadin/component-base/src/focus-mixin.js';
+import type { KeyboardDirectionMixinClass } from '@vaadin/component-base/src/keyboard-direction-mixin.js';
+import type { KeyboardMixinClass } from '@vaadin/component-base/src/keyboard-mixin.js';
 
 export declare function InteractionsMixin<T extends Constructor<HTMLElement>>(
   base: T,
-): Constructor<InteractionsMixinClass> & T;
+): Constructor<FocusMixinClass> &
+  Constructor<InteractionsMixinClass> &
+  Constructor<KeyboardDirectionMixinClass> &
+  Constructor<KeyboardMixinClass> &
+  T;
 
 export declare class InteractionsMixinClass {
   /**

package/src/vaadin-menu-bar-interactions-mixin.js

@@ -3,12 +3,17 @@
  * Copyright (c) 2019 - 2022 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
+import { FocusMixin } from '@vaadin/component-base/src/focus-mixin.js';
+import { isKeyboardActive } from '@vaadin/component-base/src/focus-utils.js';
+import { KeyboardDirectionMixin } from '@vaadin/component-base/src/keyboard-direction-mixin.js';
 
 /**
  * @polymerMixin
+ * @mixes FocusMixin
+ * @mixes KeyboardDirectionMixinClass
  */
 export const InteractionsMixin = (superClass) =>
-  class InteractionsMixin extends superClass {
+  class InteractionsMixin extends KeyboardDirectionMixin(FocusMixin(superClass)) {
     static get properties() {
       return {
         /**
@@ -34,8 +39,8 @@ export const InteractionsMixin = (superClass) =>
     ready() {
       super.ready();
 
-      this.addEventListener('keydown', (e) => this._onKeydown(e));
-      this.addEventListener('focusin', (e) => this._onFocusin(e));
+      this.addEventListener('mousedown', () => this._hideTooltip());
+      this.addEventListener('mouseleave', () => this._hideTooltip());
 
       this._subMenu.addEventListener('item-selected', this.__onItemSelected.bind(this));
       this._subMenu.addEventListener('close-all-menus', this.__onEscapeClose.bind(this));
@@ -49,11 +54,80 @@ export const InteractionsMixin = (superClass) =>
       container.addEventListener('mouseover', (e) => this._onMouseOver(e));
     }
 
+    /**
+     * Override getter from `KeyboardDirectionMixin`
+     * to look for activeElement in shadow root, or
+     * use the expanded button as a fallback.
+     *
+     * @return {Element | null}
+     * @protected
+     * @override
+     */
+    get focused() {
+      return this.shadowRoot.activeElement || this._expandedButton;
+    }
+
+    /**
+     * Override getter from `KeyboardDirectionMixin`.
+     *
+     * @return {boolean}
+     * @protected
+     * @override
+     */
+    get _vertical() {
+      return false;
+    }
+
+    /**
+     * Override method inherited from `KeyboardDirectionMixin`
+     * to use the list of menu-bar buttons as items.
+     *
+     * @return {Element[]}
+     * @protected
+     * @override
+     */
+    _getItems() {
+      return this._buttons;
+    }
+
     /** @private */
     get __isRTL() {
       return this.getAttribute('dir') === 'rtl';
     }
 
+    /** @protected */
+    disconnectedCallback() {
+      super.disconnectedCallback();
+      this._hideTooltip();
+    }
+
+    /**
+     * @param {HTMLElement} button
+     * @protected
+     */
+    _showTooltip(button) {
+      // Check if there is a slotted vaadin-tooltip element.
+      const tooltip = this._tooltipController.node;
+      if (tooltip && tooltip.isConnected) {
+        // If the tooltip element doesn't have a generator assigned, use a default one
+        // that reads the `tooltip` property of an item.
+        if (tooltip.generator === undefined) {
+          tooltip.generator = ({ item }) => item && item.tooltip;
+        }
+
+        if (!this._subMenu.opened) {
+          this._tooltipController.setTarget(button);
+          this._tooltipController.setContext({ item: button.item });
+          this._tooltipController.setOpened(true);
+        }
+      }
+    }
+
+    /** @protected */
+    _hideTooltip() {
+      this._tooltipController.setOpened(false);
+    }
+
     /** @protected */
     _setExpanded(button, expanded) {
       button.toggleAttribute('expanded', expanded);
@@ -66,135 +140,135 @@ export const InteractionsMixin = (superClass) =>
       button.setAttribute('tabindex', focused ? '0' : '-1');
     }
 
-    /** @private */
-    _focusButton(button) {
-      button.focus();
-      button.setAttribute('focus-ring', '');
+    /**
+     * Override method inherited from `KeyboardDirectionMixin`
+     * to close the submenu for the previously focused button
+     * and open another one for the newly focused button.
+     *
+     * @param {Element} item
+     * @param {boolean} navigating
+     * @protected
+     * @override
+     */
+    _focusItem(item, navigating) {
+      const wasExpanded = navigating && this.focused === this._expandedButton;
+      if (wasExpanded) {
+        this._close();
+      }
+
+      super._focusItem(item, navigating);
+
       this._buttons.forEach((btn) => {
-        this._setTabindex(btn, btn === button);
+        this._setTabindex(btn, btn === item);
       });
-    }
 
-    /** @private */
-    _getButtonFromEvent(e) {
-      return Array.from(e.composedPath()).filter((el) => el.localName === 'vaadin-menu-bar-button')[0];
+      if (wasExpanded && item.item && item.item.children) {
+        this.__openSubMenu(item, true, { keepFocus: true });
+      } else if (item === this._overflow) {
+        this._hideTooltip();
+      } else {
+        this._showTooltip(item);
+      }
     }
 
     /** @private */
-    _getCurrentButton() {
-      return this.shadowRoot.activeElement || this._expandedButton;
+    _getButtonFromEvent(e) {
+      return Array.from(e.composedPath()).find((el) => el.localName === 'vaadin-menu-bar-button');
     }
 
     /**
-     * @param {!FocusEvent} event
+     * Override method inherited from `FocusMixin`
+     *
+     * @param {boolean} focused
+     * @override
      * @protected
      */
-    _onFocusin() {
-      const target = this.shadowRoot.querySelector('[part$="button"][tabindex="0"]');
-      if (target) {
-        this._buttons.forEach((btn) => {
-          this._setTabindex(btn, btn === target);
-        });
+    _setFocused(focused) {
+      if (focused) {
+        const target = this.shadowRoot.querySelector('[part$="button"][tabindex="0"]');
+        if (target) {
+          this._buttons.forEach((btn) => {
+            this._setTabindex(btn, btn === target);
+            if (btn === target && btn !== this._overflow && isKeyboardActive()) {
+              this._showTooltip(btn);
+            }
+          });
+        }
+      } else {
+        this._hideTooltip();
       }
     }
 
     /**
      * @param {!KeyboardEvent} event
-     * @protected
+     * @private
      */
-    _onKeydown(event) {
+    _onArrowDown(event) {
+      // Prevent page scroll.
+      event.preventDefault();
+
       const button = this._getButtonFromEvent(event);
-      if (button) {
-        if (event.keyCode === 40) {
-          // ArrowDown, prevent page scroll
-          event.preventDefault();
-          if (button === this._expandedButton) {
-            // Menu opened previously, focus first item
-            this._focusFirstItem();
-          } else {
-            this.__openSubMenu(button, event);
-          }
-        } else if (event.keyCode === 38) {
-          // ArrowUp, prevent page scroll
-          event.preventDefault();
-          if (button === this._expandedButton) {
-            // Menu opened previously, focus last item
-            this._focusLastItem();
-          } else {
-            this.__openSubMenu(button, event, { focusLast: true });
-          }
-        } else if (event.keyCode === 27 && button === this._expandedButton) {
-          this._close(true);
-        } else {
-          this._navigateByKey(event);
-        }
+      if (button === this._expandedButton) {
+        // Menu opened previously, focus first item
+        this._focusFirstItem();
+      } else {
+        this.__openSubMenu(button, true);
       }
     }
 
-    /** @private */
-    _navigateByKey(event) {
-      // IE names for arrows do not include the Arrow prefix
-      const key = event.key.replace(/^Arrow/, '');
-      const buttons = this._buttons;
-      const currentBtn = this._getCurrentButton();
-      const currentIdx = buttons.indexOf(currentBtn);
-      let idx;
-      let increment;
-      const dirIncrement = this.__isRTL ? -1 : 1;
-
-      switch (key) {
-        case 'Left':
-          increment = -dirIncrement;
-          idx = currentIdx - dirIncrement;
-          break;
-        case 'Right':
-          increment = dirIncrement;
-          idx = currentIdx + dirIncrement;
-          break;
-        case 'Home':
-          increment = 1;
-          idx = 0;
-          break;
-        case 'End':
-          increment = -1;
-          idx = buttons.length - 1;
-          break;
-        default:
-        // Do nothing.
-      }
+    /**
+     * @param {!KeyboardEvent} event
+     * @private
+     */
+    _onArrowUp(event) {
+      // Prevent page scroll.
+      event.preventDefault();
 
-      idx = this._getAvailableIndex(idx, increment, buttons);
-      if (idx >= 0) {
-        event.preventDefault();
-        const btn = buttons[idx];
-        const wasExpanded = currentBtn === this._expandedButton;
-        if (wasExpanded) {
-          this._close();
-        }
-        this._focusButton(btn);
-        if (wasExpanded && btn.item && btn.item.children) {
-          this.__openSubMenu(btn, event, { keepFocus: true });
-        }
+      const button = this._getButtonFromEvent(event);
+      if (button === this._expandedButton) {
+        // Menu opened previously, focus last item
+        this._focusLastItem();
+      } else {
+        this.__openSubMenu(button, true, { focusLast: true });
       }
     }
 
-    /** @private */
-    _getAvailableIndex(index, increment, buttons) {
-      const totalItems = buttons.length;
-      let idx = index;
-      for (let i = 0; typeof idx === 'number' && i < totalItems; i++, idx += increment || 1) {
-        if (idx < 0) {
-          idx = totalItems - 1;
-        } else if (idx >= totalItems) {
-          idx = 0;
-        }
+    /**
+     * Override an event listener from `KeyboardMixin`:
+     * - to close the sub-menu for expanded button,
+     * - to close a tooltip for collapsed button.
+     *
+     * @param {!KeyboardEvent} event
+     * @protected
+     * @override
+     */
+    _onEscape(event) {
+      if (event.composedPath().includes(this._expandedButton)) {
+        this._close(true);
+      }
 
-        const btn = buttons[idx];
-        if (!btn.disabled && !btn.hasAttribute('hidden')) {
-          return idx;
-        }
+      this._hideTooltip();
+    }
+
+    /**
+     * Override an event listener from `KeyboardMixin`.
+     *
+     * @param {!KeyboardEvent} event
+     * @protected
+     * @override
+     */
+    _onKeyDown(event) {
+      switch (event.key) {
+        case 'ArrowDown':
+          this._onArrowDown(event);
+          break;
+        case 'ArrowUp':
+          this._onArrowUp(event);
+          break;
+        default:
+          super._onKeyDown(event);
+          break;
       }
-      return -1;
     }
 
     /** @private */
@@ -240,19 +314,28 @@ export const InteractionsMixin = (superClass) =>
      */
     _onMouseOver(e) {
       const button = this._getButtonFromEvent(e);
-      if (button && button !== this._expandedButton) {
+      if (!button) {
+        // Hide tooltip on mouseover to disabled button
+        this._hideTooltip();
+      } else if (button !== this._expandedButton) {
         const isOpened = this._subMenu.opened;
         if (button.item.children && (this.openOnHover || isOpened)) {
-          this.__openSubMenu(button, e);
+          this.__openSubMenu(button, false);
         } else if (isOpened) {
           this._close();
         }
+
+        if (button === this._overflow || (this.openOnHover && button.item.children)) {
+          this._hideTooltip();
+        } else {
+          this._showTooltip(button);
+        }
       }
     }
 
     /** @private */
     __onContextMenuKeydown(e) {
-      const item = Array.from(e.composedPath()).filter((el) => el._item)[0];
+      const item = Array.from(e.composedPath()).find((el) => el._item);
       if (item) {
         const list = item.parentNode;
         if (e.keyCode === 38 && item === list.items[0]) {
@@ -262,11 +345,7 @@ export const InteractionsMixin = (superClass) =>
         if (e.keyCode === 37 || (e.keyCode === 39 && !item._item.children)) {
           // Prevent ArrowLeft from being handled in context-menu
           e.stopImmediatePropagation();
-          this._navigateByKey(e);
-          const button = this.shadowRoot.activeElement;
-          if (button && button.item && button.item.children) {
-            this.__openSubMenu(button, e, { keepFocus: true });
-          }
+          this._onKeyDown(e);
         }
       }
     }
@@ -281,12 +360,12 @@ export const InteractionsMixin = (superClass) =>
       e.stopPropagation();
       const button = this._getButtonFromEvent(e);
       if (button) {
-        this.__openSubMenu(button, e);
+        this.__openSubMenu(button, false);
       }
     }
 
     /** @private */
-    __openSubMenu(button, event, options = {}) {
+    __openSubMenu(button, keydown, options = {}) {
       const subMenu = this._subMenu;
       const item = button.item;
 
@@ -319,27 +398,33 @@ export const InteractionsMixin = (superClass) =>
             },
           }),
         );
+        this._hideTooltip();
 
         this._setExpanded(button, true);
       });
 
-      if (options.focusLast) {
-        this.__onceOpened(() => this._focusLastItem());
-      }
+      this.style.pointerEvents = 'auto';
 
-      if (options.keepFocus) {
-        this.__onceOpened(() => {
-          this._focusButton(this._expandedButton);
-        });
-      }
+      overlay.addEventListener(
+        'vaadin-overlay-open',
+        () => {
+          if (options.focusLast) {
+            this._focusLastItem();
+          }
 
-      this.__onceOpened(() => {
-        // Do not focus item when open not from keyboard
-        if (event.type !== 'keydown') {
-          subMenu.$.overlay.$.overlay.focus();
-        }
-        overlay._updatePosition();
-      });
+          if (options.keepFocus) {
+            this._focusItem(this._expandedButton, false);
+          }
+
+          // Do not focus item when open not from keyboard
+          if (!keydown) {
+            overlay.$.overlay.focus();
+          }
+
+          overlay._updatePosition();
+        },
+        { once: true },
+      );
     }
 
     /** @private */
@@ -357,17 +442,6 @@ export const InteractionsMixin = (superClass) =>
       }
     }
 
-    /** @private */
-    __onceOpened(cb) {
-      this.style.pointerEvents = 'auto';
-      const overlay = this._subMenu.$.overlay;
-      const listener = () => {
-        cb();
-        overlay.removeEventListener('vaadin-overlay-open', listener);
-      };
-      overlay.addEventListener('vaadin-overlay-open', listener);
-    }
-
     /** @private */
     __onItemSelected(e) {
       e.stopPropagation();
@@ -386,7 +460,7 @@ export const InteractionsMixin = (superClass) =>
       if (button && button.hasAttribute('expanded')) {
         this._setExpanded(button, false);
         if (restoreFocus) {
-          this._focusButton(button);
+          this._focusItem(button, false);
         }
         this._expandedButton = null;
       }

package/src/vaadin-menu-bar.d.ts

@@ -3,6 +3,7 @@
  * Copyright (c) 2019 - 2022 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
+import { ControllerMixin } from '@vaadin/component-base/src/controller-mixin.js';
 import { DisabledMixin } from '@vaadin/component-base/src/disabled-mixin.js';
 import { ElementMixin } from '@vaadin/component-base/src/element-mixin.js';
 import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
@@ -10,10 +11,31 @@ import { ButtonsMixin } from './vaadin-menu-bar-buttons-mixin.js';
 import { InteractionsMixin } from './vaadin-menu-bar-interactions-mixin.js';
 
 export interface MenuBarItem {
+  /**
+   * Text to be set as the menu button component's textContent.
+   */
   text?: string;
+  /**
+   * Text to be set as the menu button's tooltip.
+   * Requires a `<vaadin-tooltip slot="tooltip">` element to be added inside the `<vaadin-menu-bar>`.
+   */
+  tooltip?: string;
+  /**
+   * The component to represent the button content.
+   * Either a tagName or an element instance. Defaults to "vaadin-context-menu-item".
+   */
   component?: HTMLElement | string;
+  /**
+   * If true, the button is disabled and cannot be activated.
+   */
   disabled?: boolean;
+  /**
+   * Theme(s) to be set as the theme attribute of the button, overriding any theme set on the menu bar.
+   */
   theme?: string[] | string;
+  /**
+   * Array of submenu items.
+   */
   children?: SubMenuItem[];
 }
 
@@ -89,7 +111,9 @@ export interface MenuBarEventMap extends HTMLElementEventMap, MenuBarCustomEvent
  *
  * @fires {CustomEvent} item-selected - Fired when a submenu item or menu bar button without children is clicked.
  */
-declare class MenuBar extends ButtonsMixin(DisabledMixin(InteractionsMixin(ElementMixin(ThemableMixin(HTMLElement))))) {
+declare class MenuBar extends ButtonsMixin(
+  DisabledMixin(InteractionsMixin(ElementMixin(ThemableMixin(ControllerMixin(HTMLElement))))),
+) {
   /**
    * Defines a hierarchical structure, where root level items represent menu bar buttons,
    * and `children` property configures a submenu with items to be opened below

package/src/vaadin-menu-bar.js

@@ -6,8 +6,10 @@
 import './vaadin-menu-bar-submenu.js';
 import './vaadin-menu-bar-button.js';
 import { html, PolymerElement } from '@polymer/polymer/polymer-element.js';
+import { ControllerMixin } from '@vaadin/component-base/src/controller-mixin.js';
 import { DisabledMixin } from '@vaadin/component-base/src/disabled-mixin.js';
 import { ElementMixin } from '@vaadin/component-base/src/element-mixin.js';
+import { TooltipController } from '@vaadin/component-base/src/tooltip-controller.js';
 import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
 import { ButtonsMixin } from './vaadin-menu-bar-buttons-mixin.js';
 import { InteractionsMixin } from './vaadin-menu-bar-interactions-mixin.js';
@@ -61,13 +63,16 @@ import { InteractionsMixin } from './vaadin-menu-bar-interactions-mixin.js';
  * @fires {CustomEvent<boolean>} item-selected - Fired when a submenu item or menu bar button without children is clicked.
  *
  * @extends HTMLElement
+ * @mixes ControllerMixin
  * @mixes ButtonsMixin
  * @mixes InteractionsMixin
  * @mixes DisabledMixin
  * @mixes ElementMixin
  * @mixes ThemableMixin
  */
-class MenuBar extends ButtonsMixin(DisabledMixin(InteractionsMixin(ElementMixin(ThemableMixin(PolymerElement))))) {
+class MenuBar extends ButtonsMixin(
+  DisabledMixin(InteractionsMixin(ElementMixin(ThemableMixin(ControllerMixin(PolymerElement))))),
+) {
   static get template() {
     return html`
       <style>
@@ -109,6 +114,8 @@ class MenuBar extends ButtonsMixin(DisabledMixin(InteractionsMixin(ElementMixin(
         </vaadin-menu-bar-button>
       </div>
       <vaadin-menu-bar-submenu is-root=""></vaadin-menu-bar-submenu>
+
+      <slot name="tooltip"></slot>
     `;
   }
 
@@ -122,6 +129,8 @@ class MenuBar extends ButtonsMixin(DisabledMixin(InteractionsMixin(ElementMixin(
        * @typedef MenuBarItem
        * @type {object}
        * @property {string} text - Text to be set as the menu button component's textContent.
+       * @property {string} tooltip - Text to be set as the menu button's tooltip.
+       * Requires a `<vaadin-tooltip slot="tooltip">` element to be added inside the `<vaadin-menu-bar>`.
        * @property {union: string | object} component - The component to represent the button content.
        * Either a tagName or an element instance. Defaults to "vaadin-context-menu-item".
        * @property {boolean} disabled - If true, the button is disabled and cannot be activated.
@@ -213,6 +222,15 @@ class MenuBar extends ButtonsMixin(DisabledMixin(InteractionsMixin(ElementMixin(
     return ['_themeChanged(_theme)'];
   }
 
+  /** @protected */
+  ready() {
+    super.ready();
+
+    this._tooltipController = new TooltipController(this);
+    this._tooltipController.setManual(true);
+    this.addController(this._tooltipController);
+  }
+
   /**
    * Override method inherited from `DisabledMixin`
    * to update the `disabled` property for the buttons

package/web-types.json

@@ -1,14 +1,14 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/menu-bar",
-  "version": "23.2.2",
+  "version": "23.3.0-alpha2",
   "description-markup": "markdown",
   "contributions": {
     "html": {
       "elements": [
         {
           "name": "vaadin-menu-bar",
-          "description": "`<vaadin-menu-bar>` is a Web Component providing a set of horizontally stacked buttons offering\nthe user quick access to a consistent set of commands. Each button can toggle a submenu with\nsupport for additional levels of nested menus.\n\nTo create the menu bar, first add the component to the page:\n\n```\n<vaadin-menu-bar></vaadin-menu-bar>\n```\n\nAnd then use [`items`](https://cdn.vaadin.com/vaadin-web-components/23.2.2/#/elements/vaadin-menu-bar#property-items) property to initialize the structure:\n\n```\ndocument.querySelector('vaadin-menu-bar').items = [{text: 'File'}, {text: 'Edit'}];\n```\n\n### Styling\n\nThe following shadow DOM parts are exposed for styling:\n\nPart name         | Description\n------------------|----------------\n`container`       | The container wrapping menu bar buttons.\n`menu-bar-button` | The menu bar button.\n`overflow-button` | The \"overflow\" button appearing when menu bar width is not enough to fit all the buttons.\n\nThe following state attributes are available for styling:\n\nAttribute           | Description\n--------------------|----------------------------------\n`disabled`          | Set when the menu bar is disabled\n`has-single-button` | Set when there is only one button visible\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/custom-theme/styling-components) documentation.\n\n### Internal components\n\nIn addition to `<vaadin-menu-bar>` itself, the following internal\ncomponents are themable:\n\n- `<vaadin-menu-bar-button>` - has the same API as [`<vaadin-button>`](https://cdn.vaadin.com/vaadin-web-components/23.2.2/#/elements/vaadin-button).\n- `<vaadin-context-menu-item>` - has the same API as [`<vaadin-item>`](https://cdn.vaadin.com/vaadin-web-components/23.2.2/#/elements/vaadin-item).\n- `<vaadin-context-menu-list-box>` - has the same API as [`<vaadin-list-box>`](https://cdn.vaadin.com/vaadin-web-components/23.2.2/#/elements/vaadin-list-box).\n- `<vaadin-context-menu-overlay>` - has the same API as [`<vaadin-overlay>`](https://cdn.vaadin.com/vaadin-web-components/23.2.2/#/elements/vaadin-overlay).",
+          "description": "`<vaadin-menu-bar>` is a Web Component providing a set of horizontally stacked buttons offering\nthe user quick access to a consistent set of commands. Each button can toggle a submenu with\nsupport for additional levels of nested menus.\n\nTo create the menu bar, first add the component to the page:\n\n```\n<vaadin-menu-bar></vaadin-menu-bar>\n```\n\nAnd then use [`items`](https://cdn.vaadin.com/vaadin-web-components/23.3.0-alpha2/#/elements/vaadin-menu-bar#property-items) property to initialize the structure:\n\n```\ndocument.querySelector('vaadin-menu-bar').items = [{text: 'File'}, {text: 'Edit'}];\n```\n\n### Styling\n\nThe following shadow DOM parts are exposed for styling:\n\nPart name         | Description\n------------------|----------------\n`container`       | The container wrapping menu bar buttons.\n`menu-bar-button` | The menu bar button.\n`overflow-button` | The \"overflow\" button appearing when menu bar width is not enough to fit all the buttons.\n\nThe following state attributes are available for styling:\n\nAttribute           | Description\n--------------------|----------------------------------\n`disabled`          | Set when the menu bar is disabled\n`has-single-button` | Set when there is only one button visible\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/custom-theme/styling-components) documentation.\n\n### Internal components\n\nIn addition to `<vaadin-menu-bar>` itself, the following internal\ncomponents are themable:\n\n- `<vaadin-menu-bar-button>` - has the same API as [`<vaadin-button>`](https://cdn.vaadin.com/vaadin-web-components/23.3.0-alpha2/#/elements/vaadin-button).\n- `<vaadin-context-menu-item>` - has the same API as [`<vaadin-item>`](https://cdn.vaadin.com/vaadin-web-components/23.3.0-alpha2/#/elements/vaadin-item).\n- `<vaadin-context-menu-list-box>` - has the same API as [`<vaadin-list-box>`](https://cdn.vaadin.com/vaadin-web-components/23.3.0-alpha2/#/elements/vaadin-list-box).\n- `<vaadin-context-menu-overlay>` - has the same API as [`<vaadin-overlay>`](https://cdn.vaadin.com/vaadin-web-components/23.3.0-alpha2/#/elements/vaadin-overlay).",
           "attributes": [
             {
               "name": "open-on-hover",

package/web-types.lit.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/menu-bar",
-  "version": "23.2.2",
+  "version": "23.3.0-alpha2",
   "description-markup": "markdown",
   "framework": "lit",
   "framework-config": {
@@ -16,7 +16,7 @@
       "elements": [
         {
           "name": "vaadin-menu-bar",
-          "description": "`<vaadin-menu-bar>` is a Web Component providing a set of horizontally stacked buttons offering\nthe user quick access to a consistent set of commands. Each button can toggle a submenu with\nsupport for additional levels of nested menus.\n\nTo create the menu bar, first add the component to the page:\n\n```\n<vaadin-menu-bar></vaadin-menu-bar>\n```\n\nAnd then use [`items`](https://cdn.vaadin.com/vaadin-web-components/23.2.2/#/elements/vaadin-menu-bar#property-items) property to initialize the structure:\n\n```\ndocument.querySelector('vaadin-menu-bar').items = [{text: 'File'}, {text: 'Edit'}];\n```\n\n### Styling\n\nThe following shadow DOM parts are exposed for styling:\n\nPart name         | Description\n------------------|----------------\n`container`       | The container wrapping menu bar buttons.\n`menu-bar-button` | The menu bar button.\n`overflow-button` | The \"overflow\" button appearing when menu bar width is not enough to fit all the buttons.\n\nThe following state attributes are available for styling:\n\nAttribute           | Description\n--------------------|----------------------------------\n`disabled`          | Set when the menu bar is disabled\n`has-single-button` | Set when there is only one button visible\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/custom-theme/styling-components) documentation.\n\n### Internal components\n\nIn addition to `<vaadin-menu-bar>` itself, the following internal\ncomponents are themable:\n\n- `<vaadin-menu-bar-button>` - has the same API as [`<vaadin-button>`](https://cdn.vaadin.com/vaadin-web-components/23.2.2/#/elements/vaadin-button).\n- `<vaadin-context-menu-item>` - has the same API as [`<vaadin-item>`](https://cdn.vaadin.com/vaadin-web-components/23.2.2/#/elements/vaadin-item).\n- `<vaadin-context-menu-list-box>` - has the same API as [`<vaadin-list-box>`](https://cdn.vaadin.com/vaadin-web-components/23.2.2/#/elements/vaadin-list-box).\n- `<vaadin-context-menu-overlay>` - has the same API as [`<vaadin-overlay>`](https://cdn.vaadin.com/vaadin-web-components/23.2.2/#/elements/vaadin-overlay).",
+          "description": "`<vaadin-menu-bar>` is a Web Component providing a set of horizontally stacked buttons offering\nthe user quick access to a consistent set of commands. Each button can toggle a submenu with\nsupport for additional levels of nested menus.\n\nTo create the menu bar, first add the component to the page:\n\n```\n<vaadin-menu-bar></vaadin-menu-bar>\n```\n\nAnd then use [`items`](https://cdn.vaadin.com/vaadin-web-components/23.3.0-alpha2/#/elements/vaadin-menu-bar#property-items) property to initialize the structure:\n\n```\ndocument.querySelector('vaadin-menu-bar').items = [{text: 'File'}, {text: 'Edit'}];\n```\n\n### Styling\n\nThe following shadow DOM parts are exposed for styling:\n\nPart name         | Description\n------------------|----------------\n`container`       | The container wrapping menu bar buttons.\n`menu-bar-button` | The menu bar button.\n`overflow-button` | The \"overflow\" button appearing when menu bar width is not enough to fit all the buttons.\n\nThe following state attributes are available for styling:\n\nAttribute           | Description\n--------------------|----------------------------------\n`disabled`          | Set when the menu bar is disabled\n`has-single-button` | Set when there is only one button visible\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/custom-theme/styling-components) documentation.\n\n### Internal components\n\nIn addition to `<vaadin-menu-bar>` itself, the following internal\ncomponents are themable:\n\n- `<vaadin-menu-bar-button>` - has the same API as [`<vaadin-button>`](https://cdn.vaadin.com/vaadin-web-components/23.3.0-alpha2/#/elements/vaadin-button).\n- `<vaadin-context-menu-item>` - has the same API as [`<vaadin-item>`](https://cdn.vaadin.com/vaadin-web-components/23.3.0-alpha2/#/elements/vaadin-item).\n- `<vaadin-context-menu-list-box>` - has the same API as [`<vaadin-list-box>`](https://cdn.vaadin.com/vaadin-web-components/23.3.0-alpha2/#/elements/vaadin-list-box).\n- `<vaadin-context-menu-overlay>` - has the same API as [`<vaadin-overlay>`](https://cdn.vaadin.com/vaadin-web-components/23.3.0-alpha2/#/elements/vaadin-overlay).",
           "extension": true,
           "attributes": [
             {