@vaadin/tooltip 24.8.4 → 25.0.0-alpha10

package/README.md

@@ -27,29 +27,6 @@ Once installed, import the component in your application:
 import '@vaadin/tooltip';
 ```
 
-## Themes
-
-Vaadin components come with two built-in [themes](https://vaadin.com/docs/latest/styling), Lumo and Material.
-The [main entrypoint](https://github.com/vaadin/web-components/blob/main/packages/tooltip/vaadin-tooltip.js) of the package uses the Lumo theme.
-
-To use the Material theme, import the component from the `theme/material` folder:
-
-```js
-import '@vaadin/tooltip/theme/material/vaadin-tooltip.js';
-```
-
-You can also import the Lumo version of the component explicitly:
-
-```js
-import '@vaadin/tooltip/theme/lumo/vaadin-tooltip.js';
-```
-
-Finally, you can import the un-themed component from the `src` folder to get a minimal starting point:
-
-```js
-import '@vaadin/tooltip/src/vaadin-tooltip.js';
-```
-
 ## Contributing
 
 Read the [contributing guide](https://vaadin.com/docs/latest/contributing) to learn about our development process, how to propose bugfixes and improvements, and how to test your changes to Vaadin components.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/tooltip",
-  "version": "24.8.4",
+  "version": "25.0.0-alpha10",
   "publishConfig": {
     "access": "public"
   },
@@ -21,6 +21,8 @@
   "type": "module",
   "files": [
     "src",
+    "!src/styles/*-base-styles.d.ts",
+    "!src/styles/*-base-styles.js",
     "theme",
     "vaadin-*.d.ts",
     "vaadin-*.js",
@@ -35,25 +37,23 @@
   ],
   "dependencies": {
     "@open-wc/dedupe-mixin": "^1.3.0",
-    "@polymer/polymer": "^3.0.0",
-    "@vaadin/a11y-base": "~24.8.4",
-    "@vaadin/component-base": "~24.8.4",
-    "@vaadin/overlay": "~24.8.4",
-    "@vaadin/popover": "~24.8.4",
-    "@vaadin/vaadin-lumo-styles": "~24.8.4",
-    "@vaadin/vaadin-material-styles": "~24.8.4",
-    "@vaadin/vaadin-themable-mixin": "~24.8.4",
+    "@vaadin/a11y-base": "25.0.0-alpha10",
+    "@vaadin/component-base": "25.0.0-alpha10",
+    "@vaadin/overlay": "25.0.0-alpha10",
+    "@vaadin/popover": "25.0.0-alpha10",
+    "@vaadin/vaadin-lumo-styles": "25.0.0-alpha10",
+    "@vaadin/vaadin-themable-mixin": "25.0.0-alpha10",
     "lit": "^3.0.0"
   },
   "devDependencies": {
-    "@vaadin/chai-plugins": "~24.8.4",
-    "@vaadin/test-runner-commands": "~24.8.4",
-    "@vaadin/testing-helpers": "^1.1.0",
+    "@vaadin/chai-plugins": "25.0.0-alpha10",
+    "@vaadin/test-runner-commands": "25.0.0-alpha10",
+    "@vaadin/testing-helpers": "^2.0.0",
     "sinon": "^18.0.0"
   },
   "web-types": [
     "web-types.json",
     "web-types.lit.json"
   ],
-  "gitHead": "849e54e967563080a685965e2dced02060b3ab23"
+  "gitHead": "6cc6c94079e805fa5b2f0af4dbf3b2a7485e57d0"
 }

package/src/styles/vaadin-tooltip-overlay-base-styles.js

@@ -0,0 +1,58 @@
+/**
+ * @license
+ * Copyright (c) 2022 - 2025 Vaadin Ltd.
+ * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
+ */
+import '@vaadin/component-base/src/style-props.js';
+import { css } from 'lit';
+
+export const tooltipOverlayStyles = css`
+  :host {
+    --_vaadin-tooltip-default-offset: 4px;
+  }
+
+  [part='overlay'] {
+    max-width: var(--vaadin-tooltip-max-width, 40ch);
+    padding: var(--vaadin-tooltip-padding, var(--vaadin-padding-container));
+    border-radius: var(--vaadin-tooltip-border-radius, var(--vaadin-radius-m));
+    background: var(--vaadin-tooltip-background, var(--vaadin-background-color));
+    color: var(--vaadin-tooltip-color, inherit);
+    font-size: var(--vaadin-tooltip-font-size, 0.9em);
+    font-weight: var(--vaadin-tooltip-font-weight, inherit);
+    line-height: var(--vaadin-tooltip-line-height, inherit);
+    border: 0;
+    box-shadow:
+      0 0 0 var(--vaadin-tooltip-border-width, 1px) var(--vaadin-tooltip-border-color, var(--vaadin-border-color)),
+      var(--vaadin-tooltip-box-shadow, 0 3px 8px -1px rgba(0, 0, 0, 0.2));
+  }
+
+  [part='content'] {
+    white-space: pre-wrap;
+  }
+
+  :host([position^='top'][top-aligned]) [part='overlay'],
+  :host([position^='bottom'][top-aligned]) [part='overlay'] {
+    margin-top: var(--vaadin-tooltip-offset-top, var(--_vaadin-tooltip-default-offset));
+  }
+
+  :host([position^='top'][bottom-aligned]) [part='overlay'],
+  :host([position^='bottom'][bottom-aligned]) [part='overlay'] {
+    margin-bottom: var(--vaadin-tooltip-offset-bottom, var(--_vaadin-tooltip-default-offset));
+  }
+
+  :host([position^='start'][start-aligned]) [part='overlay'],
+  :host([position^='end'][start-aligned]) [part='overlay'] {
+    margin-inline-start: var(--vaadin-tooltip-offset-start, var(--_vaadin-tooltip-default-offset));
+  }
+
+  :host([position^='start'][end-aligned]) [part='overlay'],
+  :host([position^='end'][end-aligned]) [part='overlay'] {
+    margin-inline-end: var(--vaadin-tooltip-offset-end, var(--_vaadin-tooltip-default-offset));
+  }
+
+  @media (forced-colors: active) {
+    [part='overlay'] {
+      border: 1px dashed;
+    }
+  }
+`;

package/src/styles/vaadin-tooltip-overlay-core-styles.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright (c) 2022 - 2025 Vaadin Ltd.
+ * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
+ */
+import type { CSSResult } from 'lit';
+
+export const tooltipOverlayStyles: CSSResult;

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

@@ -3,9 +3,13 @@
  * Copyright (c) 2022 - 2025 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
-import { css } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
+import { css } from 'lit';
 
 export const tooltipOverlayStyles = css`
+  :host {
+    --_vaadin-tooltip-default-offset: 0;
+  }
+
   [part='overlay'] {
     max-width: 40ch;
   }
@@ -16,22 +20,22 @@ export const tooltipOverlayStyles = css`
 
   :host([position^='top'][top-aligned]) [part='overlay'],
   :host([position^='bottom'][top-aligned]) [part='overlay'] {
-    margin-top: var(--vaadin-tooltip-offset-top, 0);
+    margin-top: var(--vaadin-tooltip-offset-top, var(--_vaadin-tooltip-default-offset));
   }
 
   :host([position^='top'][bottom-aligned]) [part='overlay'],
   :host([position^='bottom'][bottom-aligned]) [part='overlay'] {
-    margin-bottom: var(--vaadin-tooltip-offset-bottom, 0);
+    margin-bottom: var(--vaadin-tooltip-offset-bottom, var(--_vaadin-tooltip-default-offset));
   }
 
   :host([position^='start'][start-aligned]) [part='overlay'],
   :host([position^='end'][start-aligned]) [part='overlay'] {
-    margin-inline-start: var(--vaadin-tooltip-offset-start, 0);
+    margin-inline-start: var(--vaadin-tooltip-offset-start, var(--_vaadin-tooltip-default-offset));
   }
 
   :host([position^='start'][end-aligned]) [part='overlay'],
   :host([position^='end'][end-aligned]) [part='overlay'] {
-    margin-inline-end: var(--vaadin-tooltip-offset-end, 0);
+    margin-inline-end: var(--vaadin-tooltip-offset-end, var(--_vaadin-tooltip-default-offset));
   }
 
   @media (forced-colors: active) {

package/src/vaadin-tooltip-mixin.js

@@ -330,7 +330,6 @@ export const TooltipMixin = (superClass) =>
          */
         text: {
           type: String,
-          observer: '__textChanged',
         },
 
         /**
@@ -366,26 +365,9 @@ export const TooltipMixin = (superClass) =>
           type: Boolean,
           sync: true,
         },
-
-        /** @private */
-        _srLabel: {
-          type: Object,
-        },
-
-        /** @private */
-        _overlayContent: {
-          type: String,
-        },
       };
     }
 
-    static get observers() {
-      return [
-        '__generatorChanged(_overlayElement, generator, context)',
-        '__updateSrLabelText(_srLabel, _overlayContent)',
-      ];
-    }
-
     /**
      * Sets the default focus delay to be used by all tooltip instances,
      * except for those that have focus delay configured using property.
@@ -420,7 +402,6 @@ export const TooltipMixin = (superClass) =>
       super();
 
       this._uniqueId = `vaadin-tooltip-${generateUniqueId()}`;
-      this._renderer = this.__tooltipRenderer.bind(this);
 
       this.__onFocusin = this.__onFocusin.bind(this);
       this.__onFocusout = this.__onFocusout.bind(this);
@@ -467,19 +448,24 @@ export const TooltipMixin = (superClass) =>
 
       this._overlayElement = this.$.overlay;
 
-      this._srLabelController = new SlotController(this, 'sr-label', 'div', {
+      this.__contentController = new SlotController(this, 'overlay', 'div', {
         initializer: (element) => {
           element.id = this._uniqueId;
           element.setAttribute('role', 'tooltip');
-          this._srLabel = element;
+          this.__contentNode = element;
         },
       });
-      this.addController(this._srLabelController);
+      this.addController(this.__contentController);
     }
 
-    /** @private */
-    __computeOpened(manual, opened, autoOpened, connected) {
-      return connected && (manual ? opened : autoOpened);
+    /** @protected */
+    updated(props) {
+      super.updated(props);
+
+      if (props.has('text') || props.has('generator') || props.has('context')) {
+        this.__updateContent();
+        this.$.overlay.toggleAttribute('hidden', this.__contentNode.textContent.trim() === '');
+      }
     }
 
     /** @private */
@@ -688,18 +674,8 @@ export const TooltipMixin = (superClass) =>
     }
 
     /** @private */
-    __textChanged(text, oldText) {
-      if (this._overlayElement && (text || oldText)) {
-        this._overlayElement.requestContentUpdate();
-      }
-    }
-
-    /** @private */
-    __tooltipRenderer(root) {
-      root.textContent = typeof this.generator === 'function' ? this.generator(this.context) : this.text;
-
-      // Update the sr-only label text content
-      this._overlayContent = root.textContent;
+    __updateContent() {
+      this.__contentNode.textContent = typeof this.generator === 'function' ? this.generator(this.context) : this.text;
     }
 
     /** @private */
@@ -723,23 +699,4 @@ export const TooltipMixin = (superClass) =>
         });
       }
     }
-
-    /** @private */
-    __generatorChanged(overlayElement, generator, context) {
-      if (overlayElement) {
-        if (generator !== this.__oldTextGenerator || context !== this.__oldContext) {
-          overlayElement.requestContentUpdate();
-        }
-
-        this.__oldTextGenerator = generator;
-        this.__oldContext = context;
-      }
-    }
-
-    /** @private */
-    __updateSrLabelText(srLabel, textContent) {
-      if (srLabel) {
-        srLabel.textContent = textContent;
-      }
-    }
   };

package/src/vaadin-tooltip-overlay.js

@@ -3,17 +3,15 @@
  * Copyright (c) 2022 - 2025 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
-import { html, PolymerElement } from '@polymer/polymer/polymer-element.js';
+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 { overlayStyles } from '@vaadin/overlay/src/vaadin-overlay-styles.js';
+import { PolylitMixin } from '@vaadin/component-base/src/polylit-mixin.js';
+import { overlayStyles } from '@vaadin/overlay/src/styles/vaadin-overlay-core-styles.js';
 import { PopoverOverlayMixin } from '@vaadin/popover/src/vaadin-popover-overlay-mixin.js';
-import { registerStyles, ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
-import { tooltipOverlayStyles } from './vaadin-tooltip-overlay-styles.js';
-
-registerStyles('vaadin-tooltip-overlay', [overlayStyles, tooltipOverlayStyles], {
-  moduleId: 'vaadin-tooltip-overlay-styles',
-});
+import { LumoInjectionMixin } from '@vaadin/vaadin-themable-mixin/lumo-injection-mixin.js';
+import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
+import { tooltipOverlayStyles } from './styles/vaadin-tooltip-overlay-core-styles.js';
 
 /**
  * An element used internally by `<vaadin-tooltip>`. Not intended to be used separately.
@@ -25,34 +23,25 @@ registerStyles('vaadin-tooltip-overlay', [overlayStyles, tooltipOverlayStyles],
  * @mixes PopoverOverlayMixin
  * @private
  */
-class TooltipOverlay extends PopoverOverlayMixin(DirMixin(ThemableMixin(PolymerElement))) {
+class TooltipOverlay extends PopoverOverlayMixin(
+  DirMixin(ThemableMixin(PolylitMixin(LumoInjectionMixin(LitElement)))),
+) {
   static get is() {
     return 'vaadin-tooltip-overlay';
   }
 
-  static get template() {
+  static get styles() {
+    return [overlayStyles, tooltipOverlayStyles];
+  }
+
+  /** @protected */
+  render() {
     return html`
-      <div id="backdrop" part="backdrop" hidden></div>
       <div part="overlay" id="overlay">
         <div part="content" id="content"><slot></slot></div>
       </div>
     `;
   }
-
-  /**
-   * Tag name prefix used by custom properties.
-   * @protected
-   * @return {string}
-   */
-  get _tagNamePrefix() {
-    return 'vaadin-tooltip';
-  }
-
-  requestContentUpdate() {
-    super.requestContentUpdate();
-
-    this.toggleAttribute('hidden', this.textContent.trim() === '');
-  }
 }
 
 defineCustomElement(TooltipOverlay);

package/src/vaadin-tooltip.d.ts

@@ -3,7 +3,6 @@
  * Copyright (c) 2022 - 2025 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 { ElementMixin } from '@vaadin/component-base/src/element-mixin.js';
 import { ThemePropertyMixin } from '@vaadin/vaadin-themable-mixin/vaadin-theme-property-mixin.js';
 import { TooltipMixin } from './vaadin-tooltip-mixin.js';
@@ -20,11 +19,12 @@ export { TooltipPosition } from './vaadin-tooltip-mixin.js';
  *
  * ### Styling
  *
- * `<vaadin-tooltip>` uses `<vaadin-tooltip-overlay>` internal
- * themable component as the actual visible overlay.
+ * The following shadow DOM parts are available for styling:
  *
- * See [`<vaadin-overlay>`](#/elements/vaadin-overlay) documentation
- * for `<vaadin-tooltip-overlay>` parts.
+ * Part name   | Description
+ * ----------- | ---------------
+ * `overlay`   | The overlay element
+ * `content`   | The overlay content element
  *
  * The following state attributes are available for styling:
  *
@@ -48,7 +48,7 @@ export { TooltipPosition } from './vaadin-tooltip-mixin.js';
  *
  * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
  */
-declare class Tooltip extends TooltipMixin(ThemePropertyMixin(ControllerMixin(ElementMixin(HTMLElement)))) {
+declare class Tooltip extends TooltipMixin(ThemePropertyMixin(ElementMixin(HTMLElement))) {
   /**
    * Sets the default focus delay to be used by all tooltip instances,
    * except for those that have focus delay configured using property.

package/src/vaadin-tooltip.js

@@ -4,10 +4,11 @@
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
 import './vaadin-tooltip-overlay.js';
-import { html, PolymerElement } from '@polymer/polymer/polymer-element.js';
-import { ControllerMixin } from '@vaadin/component-base/src/controller-mixin.js';
+import { css, html, LitElement } from 'lit';
+import { ifDefined } from 'lit/directives/if-defined.js';
 import { defineCustomElement } from '@vaadin/component-base/src/define.js';
 import { ElementMixin } from '@vaadin/component-base/src/element-mixin.js';
+import { PolylitMixin } from '@vaadin/component-base/src/polylit-mixin.js';
 import { ThemePropertyMixin } from '@vaadin/vaadin-themable-mixin/vaadin-theme-property-mixin.js';
 import { TooltipMixin } from './vaadin-tooltip-mixin.js';
 
@@ -21,11 +22,12 @@ import { TooltipMixin } from './vaadin-tooltip-mixin.js';
  *
  * ### Styling
  *
- * `<vaadin-tooltip>` uses `<vaadin-tooltip-overlay>` internal
- * themable component as the actual visible overlay.
+ * The following shadow DOM parts are available for styling:
  *
- * See [`<vaadin-overlay>`](#/elements/vaadin-overlay) documentation
- * for `<vaadin-tooltip-overlay>` parts.
+ * Part name   | Description
+ * ----------- | ---------------
+ * `overlay`   | The overlay element
+ * `content`   | The overlay content element
  *
  * The following state attributes are available for styling:
  *
@@ -51,54 +53,47 @@ import { TooltipMixin } from './vaadin-tooltip-mixin.js';
  *
  * @customElement
  * @extends HTMLElement
- * @mixes ControllerMixin
  * @mixes ElementMixin
  * @mixes ThemePropertyMixin
  * @mixes TooltipMixin
  */
-class Tooltip extends TooltipMixin(ThemePropertyMixin(ElementMixin(ControllerMixin(PolymerElement)))) {
+class Tooltip extends TooltipMixin(ThemePropertyMixin(ElementMixin(PolylitMixin(LitElement)))) {
   static get is() {
     return 'vaadin-tooltip';
   }
 
-  static get template() {
+  static get styles() {
+    return css`
+      :host {
+        display: contents;
+      }
+    `;
+  }
+
+  /** @protected */
+  render() {
+    const effectivePosition = this.__effectivePosition;
+
     return html`
-      <style>
-        :host {
-          display: none;
-        }
-      </style>
       <vaadin-tooltip-overlay
         id="overlay"
-        owner="[[__overlayOwner]]"
-        renderer="[[_renderer]]"
-        theme$="[[_theme]]"
-        opened="[[__computeOpened(manual, opened, _autoOpened, _isConnected)]]"
-        position-target="[[target]]"
-        position="[[__effectivePosition]]"
-        no-horizontal-overlap$="[[__computeNoHorizontalOverlap(__effectivePosition)]]"
-        no-vertical-overlap$="[[__computeNoVerticalOverlap(__effectivePosition)]]"
-        horizontal-align="[[__computeHorizontalAlign(__effectivePosition)]]"
-        vertical-align="[[__computeVerticalAlign(__effectivePosition)]]"
-        on-mouseenter="__onOverlayMouseEnter"
-        on-mouseleave="__onOverlayMouseLeave"
+        .owner="${this}"
+        theme="${ifDefined(this._theme)}"
+        .opened="${this._isConnected && (this.manual ? this.opened : this._autoOpened)}"
+        .positionTarget="${this.target}"
+        .position="${effectivePosition}"
+        ?no-horizontal-overlap="${this.__computeNoHorizontalOverlap(effectivePosition)}"
+        ?no-vertical-overlap="${this.__computeNoVerticalOverlap(effectivePosition)}"
+        .horizontalAlign="${this.__computeHorizontalAlign(effectivePosition)}"
+        .verticalAlign="${this.__computeVerticalAlign(effectivePosition)}"
+        @mouseenter="${this.__onOverlayMouseEnter}"
+        @mouseleave="${this.__onOverlayMouseLeave}"
         modeless
+        exportparts="overlay, content"
+        ><slot name="overlay"></slot
       ></vaadin-tooltip-overlay>
-
-      <slot name="sr-label"></slot>
     `;
   }
-
-  static get properties() {
-    return {
-      /** @private */
-      __overlayOwner: {
-        value() {
-          return this;
-        },
-      },
-    };
-  }
 }
 
 defineCustomElement(Tooltip);

package/theme/lumo/vaadin-tooltip-styles.js

@@ -6,10 +6,7 @@ import { css, registerStyles } from '@vaadin/vaadin-themable-mixin/vaadin-themab
 
 const tooltipOverlay = css`
   :host {
-    --vaadin-tooltip-offset-top: var(--lumo-space-xs);
-    --vaadin-tooltip-offset-bottom: var(--lumo-space-xs);
-    --vaadin-tooltip-offset-start: var(--lumo-space-xs);
-    --vaadin-tooltip-offset-end: var(--lumo-space-xs);
+    --_vaadin-tooltip-default-offset: var(--lumo-space-xs);
   }
 
   [part='overlay'] {

package/web-types.json

@@ -1,14 +1,14 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/tooltip",
-  "version": "24.8.4",
+  "version": "25.0.0-alpha10",
   "description-markup": "markdown",
   "contributions": {
     "html": {
       "elements": [
         {
           "name": "vaadin-tooltip",
-          "description": "`<vaadin-tooltip>` is a Web Component for creating tooltips.\n\n```html\n<button id=\"confirm\">Confirm</button>\n<vaadin-tooltip text=\"Click to save changes\" for=\"confirm\"></vaadin-tooltip>\n```\n\n### Styling\n\n`<vaadin-tooltip>` uses `<vaadin-tooltip-overlay>` internal\nthemable component as the actual visible overlay.\n\nSee [`<vaadin-overlay>`](https://cdn.vaadin.com/vaadin-web-components/24.8.4/#/elements/vaadin-overlay) documentation\nfor `<vaadin-tooltip-overlay>` parts.\n\nThe following state attributes are available for styling:\n\nAttribute        | Description\n-----------------|----------------------------------------\n`position`       | Reflects the `position` property value.\n\nNote: the `theme` attribute value set on `<vaadin-tooltip>` is\npropagated to the internal `<vaadin-tooltip-overlay>` component.\n\n### Custom CSS Properties\n\nThe following custom CSS properties are available on the `<vaadin-tooltip>` element:\n\nCustom CSS property              | Description\n---------------------------------|-------------\n`--vaadin-tooltip-offset-top`    | Used as an offset when the tooltip is aligned vertically below the target\n`--vaadin-tooltip-offset-bottom` | Used as an offset when the tooltip is aligned vertically above the target\n`--vaadin-tooltip-offset-start`  | Used as an offset when the tooltip is aligned horizontally after the target\n`--vaadin-tooltip-offset-end`    | Used as an offset when the tooltip is aligned horizontally before the target\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.",
+          "description": "`<vaadin-tooltip>` is a Web Component for creating tooltips.\n\n```html\n<button id=\"confirm\">Confirm</button>\n<vaadin-tooltip text=\"Click to save changes\" for=\"confirm\"></vaadin-tooltip>\n```\n\n### Styling\n\nThe following shadow DOM parts are available for styling:\n\nPart name   | Description\n----------- | ---------------\n`overlay`   | The overlay element\n`content`   | The overlay content element\n\nThe following state attributes are available for styling:\n\nAttribute        | Description\n-----------------|----------------------------------------\n`position`       | Reflects the `position` property value.\n\nNote: the `theme` attribute value set on `<vaadin-tooltip>` is\npropagated to the internal `<vaadin-tooltip-overlay>` component.\n\n### Custom CSS Properties\n\nThe following custom CSS properties are available on the `<vaadin-tooltip>` element:\n\nCustom CSS property              | Description\n---------------------------------|-------------\n`--vaadin-tooltip-offset-top`    | Used as an offset when the tooltip is aligned vertically below the target\n`--vaadin-tooltip-offset-bottom` | Used as an offset when the tooltip is aligned vertically above the target\n`--vaadin-tooltip-offset-start`  | Used as an offset when the tooltip is aligned horizontally after the target\n`--vaadin-tooltip-offset-end`    | Used as an offset when the tooltip is aligned horizontally before the target\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.",
           "attributes": [
             {
               "name": "overlay-class",

package/web-types.lit.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/tooltip",
-  "version": "24.8.4",
+  "version": "25.0.0-alpha10",
   "description-markup": "markdown",
   "framework": "lit",
   "framework-config": {
@@ -16,7 +16,7 @@
       "elements": [
         {
           "name": "vaadin-tooltip",
-          "description": "`<vaadin-tooltip>` is a Web Component for creating tooltips.\n\n```html\n<button id=\"confirm\">Confirm</button>\n<vaadin-tooltip text=\"Click to save changes\" for=\"confirm\"></vaadin-tooltip>\n```\n\n### Styling\n\n`<vaadin-tooltip>` uses `<vaadin-tooltip-overlay>` internal\nthemable component as the actual visible overlay.\n\nSee [`<vaadin-overlay>`](https://cdn.vaadin.com/vaadin-web-components/24.8.4/#/elements/vaadin-overlay) documentation\nfor `<vaadin-tooltip-overlay>` parts.\n\nThe following state attributes are available for styling:\n\nAttribute        | Description\n-----------------|----------------------------------------\n`position`       | Reflects the `position` property value.\n\nNote: the `theme` attribute value set on `<vaadin-tooltip>` is\npropagated to the internal `<vaadin-tooltip-overlay>` component.\n\n### Custom CSS Properties\n\nThe following custom CSS properties are available on the `<vaadin-tooltip>` element:\n\nCustom CSS property              | Description\n---------------------------------|-------------\n`--vaadin-tooltip-offset-top`    | Used as an offset when the tooltip is aligned vertically below the target\n`--vaadin-tooltip-offset-bottom` | Used as an offset when the tooltip is aligned vertically above the target\n`--vaadin-tooltip-offset-start`  | Used as an offset when the tooltip is aligned horizontally after the target\n`--vaadin-tooltip-offset-end`    | Used as an offset when the tooltip is aligned horizontally before the target\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.",
+          "description": "`<vaadin-tooltip>` is a Web Component for creating tooltips.\n\n```html\n<button id=\"confirm\">Confirm</button>\n<vaadin-tooltip text=\"Click to save changes\" for=\"confirm\"></vaadin-tooltip>\n```\n\n### Styling\n\nThe following shadow DOM parts are available for styling:\n\nPart name   | Description\n----------- | ---------------\n`overlay`   | The overlay element\n`content`   | The overlay content element\n\nThe following state attributes are available for styling:\n\nAttribute        | Description\n-----------------|----------------------------------------\n`position`       | Reflects the `position` property value.\n\nNote: the `theme` attribute value set on `<vaadin-tooltip>` is\npropagated to the internal `<vaadin-tooltip-overlay>` component.\n\n### Custom CSS Properties\n\nThe following custom CSS properties are available on the `<vaadin-tooltip>` element:\n\nCustom CSS property              | Description\n---------------------------------|-------------\n`--vaadin-tooltip-offset-top`    | Used as an offset when the tooltip is aligned vertically below the target\n`--vaadin-tooltip-offset-bottom` | Used as an offset when the tooltip is aligned vertically above the target\n`--vaadin-tooltip-offset-start`  | Used as an offset when the tooltip is aligned horizontally after the target\n`--vaadin-tooltip-offset-end`    | Used as an offset when the tooltip is aligned horizontally before the target\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.",
           "extension": true,
           "attributes": [
             {

package/src/vaadin-lit-tooltip-overlay.js

@@ -1,60 +0,0 @@
-/**
- * @license
- * Copyright (c) 2022 - 2025 Vaadin Ltd.
- * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
- */
-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 { overlayStyles } from '@vaadin/overlay/src/vaadin-overlay-styles.js';
-import { PopoverOverlayMixin } from '@vaadin/popover/src/vaadin-popover-overlay-mixin.js';
-import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
-import { tooltipOverlayStyles } from './vaadin-tooltip-overlay-styles.js';
-
-/**
- * An element used internally by `<vaadin-tooltip>`. Not intended to be used separately.
- *
- * @customElement
- * @extends HTMLElement
- * @mixes DirMixin
- * @mixes ThemableMixin
- * @mixes PopoverOverlayMixin
- * @private
- */
-class TooltipOverlay extends PopoverOverlayMixin(DirMixin(ThemableMixin(PolylitMixin(LitElement)))) {
-  static get is() {
-    return 'vaadin-tooltip-overlay';
-  }
-
-  static get styles() {
-    return [overlayStyles, tooltipOverlayStyles];
-  }
-
-  /**
-   * Tag name prefix used by custom properties.
-   * @protected
-   * @return {string}
-   */
-  get _tagNamePrefix() {
-    return 'vaadin-tooltip';
-  }
-
-  /** @protected */
-  render() {
-    return html`
-      <div id="backdrop" part="backdrop" hidden></div>
-      <div part="overlay" id="overlay">
-        <div part="content" id="content"><slot></slot></div>
-      </div>
-    `;
-  }
-
-  requestContentUpdate() {
-    super.requestContentUpdate();
-
-    this.toggleAttribute('hidden', this.textContent.trim() === '');
-  }
-}
-
-defineCustomElement(TooltipOverlay);

package/src/vaadin-lit-tooltip.js

@@ -1,71 +0,0 @@
-/**
- * @license
- * Copyright (c) 2022 - 2025 Vaadin Ltd.
- * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
- */
-import './vaadin-lit-tooltip-overlay.js';
-import { css, html, LitElement } from 'lit';
-import { ifDefined } from 'lit/directives/if-defined.js';
-import { defineCustomElement } from '@vaadin/component-base/src/define.js';
-import { ElementMixin } from '@vaadin/component-base/src/element-mixin.js';
-import { PolylitMixin } from '@vaadin/component-base/src/polylit-mixin.js';
-import { ThemePropertyMixin } from '@vaadin/vaadin-themable-mixin/vaadin-theme-property-mixin.js';
-import { TooltipMixin } from './vaadin-tooltip-mixin.js';
-
-/**
- * LitElement based version of `<vaadin-tooltip>` web component.
- *
- * ## Disclaimer
- *
- * This component is an experiment and not yet a part of Vaadin platform.
- * There is no ETA regarding specific Vaadin version where it'll land.
- * Feel free to try this code in your apps as per Apache 2.0 license.
- *
- * @extends HTMLElement
- * @mixes ElementMixin
- * @mixes ThemePropertyMixin
- * @mixes TooltipMixin
- */
-class Tooltip extends TooltipMixin(ThemePropertyMixin(ElementMixin(PolylitMixin(LitElement)))) {
-  static get is() {
-    return 'vaadin-tooltip';
-  }
-
-  static get styles() {
-    return css`
-      :host {
-        display: none;
-      }
-    `;
-  }
-
-  /** @protected */
-  render() {
-    const effectivePosition = this.__effectivePosition;
-
-    return html`
-      <vaadin-tooltip-overlay
-        id="overlay"
-        .renderer="${this._renderer}"
-        .owner="${this}"
-        theme="${ifDefined(this._theme)}"
-        .opened="${this._isConnected && (this.manual ? this.opened : this._autoOpened)}"
-        .positionTarget="${this.target}"
-        .position="${effectivePosition}"
-        ?no-horizontal-overlap="${this.__computeNoHorizontalOverlap(effectivePosition)}"
-        ?no-vertical-overlap="${this.__computeNoVerticalOverlap(effectivePosition)}"
-        .horizontalAlign="${this.__computeHorizontalAlign(effectivePosition)}"
-        .verticalAlign="${this.__computeVerticalAlign(effectivePosition)}"
-        @mouseenter="${this.__onOverlayMouseEnter}"
-        @mouseleave="${this.__onOverlayMouseLeave}"
-        modeless
-      ></vaadin-tooltip-overlay>
-
-      <slot name="sr-label"></slot>
-    `;
-  }
-}
-
-defineCustomElement(Tooltip);
-
-export { Tooltip };

package/theme/lumo/vaadin-lit-tooltip.d.ts

@@ -1,2 +0,0 @@
-import './vaadin-tooltip-styles.js';
-import '../../src/vaadin-lit-tooltip.js';

package/theme/lumo/vaadin-lit-tooltip.js

@@ -1,2 +0,0 @@
-import './vaadin-tooltip-styles.js';
-import '../../src/vaadin-lit-tooltip.js';

package/theme/material/vaadin-lit-tooltip.d.ts

@@ -1,2 +0,0 @@
-import './vaadin-tooltip-styles.js';
-import '../../src/vaadin-lit-tooltip.js';

package/theme/material/vaadin-lit-tooltip.js

@@ -1,2 +0,0 @@
-import './vaadin-tooltip-styles.js';
-import '../../src/vaadin-lit-tooltip.js';

package/theme/material/vaadin-tooltip-styles.d.ts

@@ -1 +0,0 @@
-export {};

package/theme/material/vaadin-tooltip-styles.js

@@ -1,23 +0,0 @@
-import { overlay } from '@vaadin/vaadin-material-styles/mixins/overlay.js';
-import { css, registerStyles } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
-
-const tooltipOverlay = css`
-  :host {
-    --vaadin-tooltip-offset-top: 0.25rem;
-    --vaadin-tooltip-offset-bottom: 0.25rem;
-    --vaadin-tooltip-offset-start: 0.25rem;
-    --vaadin-tooltip-offset-end: 0.25rem;
-  }
-
-  [part='overlay'] {
-    background-color: rgba(97, 97, 97, 0.92);
-    color: #fff;
-    font-size: 0.6875rem;
-  }
-
-  [part='content'] {
-    padding: 0.25rem 0.5rem;
-  }
-`;
-
-registerStyles('vaadin-tooltip-overlay', [overlay, tooltipOverlay], { moduleId: 'material-tooltip-overlay' });

package/theme/material/vaadin-tooltip.d.ts

@@ -1,2 +0,0 @@
-import './vaadin-tooltip-styles.js';
-import '../../src/vaadin-tooltip.js';

package/theme/material/vaadin-tooltip.js

@@ -1,2 +0,0 @@
-import './vaadin-tooltip-styles.js';
-import '../../src/vaadin-tooltip.js';

package/vaadin-lit-tooltip.d.ts

@@ -1 +0,0 @@
-export * from './src/vaadin-tooltip.js';

package/vaadin-lit-tooltip.js

@@ -1,3 +0,0 @@
-import './theme/lumo/vaadin-lit-tooltip.js';
-
-export * from './src/vaadin-lit-tooltip.js';