@vaadin/notification 24.8.4 → 25.0.0-alpha10

package/README.md

@@ -34,29 +34,6 @@ Once installed, import the component in your application:
 import '@vaadin/notification';
 ```
 
-## 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/notification/vaadin-notification.js) of the package uses the Lumo theme.
-
-To use the Material theme, import the component from the `theme/material` folder:
-
-```js
-import '@vaadin/notification/theme/material/vaadin-notification.js';
-```
-
-You can also import the Lumo version of the component explicitly:
-
-```js
-import '@vaadin/notification/theme/lumo/vaadin-notification.js';
-```
-
-Finally, you can import the un-themed component from the `src` folder to get a minimal starting point:
-
-```js
-import '@vaadin/notification/src/vaadin-notification.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/notification",
-  "version": "24.8.4",
+  "version": "25.0.0-alpha10",
   "publishConfig": {
     "access": "public"
   },
@@ -33,30 +33,26 @@
     "Vaadin",
     "vaadin-notification",
     "web-components",
-    "web-component",
-    "polymer"
+    "web-component"
   ],
   "dependencies": {
     "@open-wc/dedupe-mixin": "^1.3.0",
-    "@polymer/polymer": "^3.0.0",
-    "@vaadin/component-base": "~24.8.4",
-    "@vaadin/lit-renderer": "~24.8.4",
-    "@vaadin/overlay": "~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/component-base": "25.0.0-alpha10",
+    "@vaadin/lit-renderer": "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/button": "~24.8.4",
-    "@vaadin/chai-plugins": "~24.8.4",
-    "@vaadin/test-runner-commands": "~24.8.4",
-    "@vaadin/testing-helpers": "^1.1.0",
+    "@vaadin/button": "25.0.0-alpha10",
+    "@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-notification-card-core-styles.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright (c) 2000 - 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 notificationCardStyles: CSSResult;

package/src/styles/vaadin-notification-card-core-styles.js

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright (c) 2016 - 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 notificationCardStyles = css`
+  :host {
+    display: block;
+  }
+
+  [part='overlay'] {
+    pointer-events: auto;
+  }
+
+  @media (forced-colors: active) {
+    [part='overlay'] {
+      outline: 3px solid;
+    }
+  }
+`;

package/src/styles/vaadin-notification-container-core-styles.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright (c) 2000 - 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 notificationContainerStyles: CSSResult;

package/src/{vaadin-notification-styles.js → styles/vaadin-notification-container-core-styles.js}

@@ -8,13 +8,20 @@ import { css } from 'lit';
 export const notificationContainerStyles = css`
   :host {
     position: fixed;
-    z-index: 1000;
     inset: 0;
     box-sizing: border-box;
     display: flex;
     flex-direction: column;
     align-items: stretch;
     pointer-events: none;
+
+    /* Override native [popover] user agent styles */
+    width: auto;
+    height: auto;
+    border: none;
+    padding: 0;
+    background-color: transparent;
+    overflow: visible;
   }
 
   [region-group] {
@@ -53,19 +60,3 @@ export const notificationContainerStyles = css`
     }
   }
 `;
-
-export const notificationCardStyles = css`
-  :host {
-    display: block;
-  }
-
-  [part='overlay'] {
-    pointer-events: auto;
-  }
-
-  @media (forced-colors: active) {
-    [part='overlay'] {
-      outline: 3px solid;
-    }
-  }
-`;

package/src/vaadin-notification-mixin.d.ts

@@ -1,6 +1,10 @@
+/**
+ * @license
+ * Copyright (c) 2000 - 2025 Vaadin Ltd.
+ * 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 { OverlayClassMixinClass } from '@vaadin/component-base/src/overlay-class-mixin.js';
-import type { OverlayStackMixinClass } from '@vaadin/overlay/src/vaadin-overlay-stack-mixin.js';
 import type { ThemePropertyMixinClass } from '@vaadin/vaadin-themable-mixin/vaadin-theme-property-mixin.js';
 import type { Notification } from './vaadin-notification.js';
 
@@ -22,7 +26,7 @@ export type NotificationRenderer = (root: HTMLElement, notification: Notificatio
  */
 export declare function NotificationContainerMixin<T extends Constructor<HTMLElement>>(
   base: T,
-): Constructor<NotificationContainerMixinClass> & Constructor<OverlayStackMixinClass> & T;
+): Constructor<NotificationContainerMixinClass> & T;
 
 export declare class NotificationContainerMixinClass {
   /**

package/src/vaadin-notification-mixin.js

@@ -7,18 +7,15 @@ import { render } from 'lit';
 import { isTemplateResult } from 'lit/directive-helpers.js';
 import { isIOS } from '@vaadin/component-base/src/browser-utils.js';
 import { OverlayClassMixin } from '@vaadin/component-base/src/overlay-class-mixin.js';
-import { processTemplates } from '@vaadin/component-base/src/templates.js';
-import { OverlayStackMixin } from '@vaadin/overlay/src/vaadin-overlay-stack-mixin.js';
 import { ThemePropertyMixin } from '@vaadin/vaadin-themable-mixin/vaadin-theme-property-mixin.js';
 
 /**
  * A mixin providing common notification container functionality.
  *
  * @polymerMixin
- * @mixes OverlayStackMixin
  */
 export const NotificationContainerMixin = (superClass) =>
-  class extends OverlayStackMixin(superClass) {
+  class extends superClass {
     static get properties() {
       return {
         /**
@@ -43,10 +40,28 @@ export const NotificationContainerMixin = (superClass) =>
       }
     }
 
+    /** @protected */
+    firstUpdated(props) {
+      super.firstUpdated(props);
+
+      this.popover = 'manual';
+    }
+
+    /**
+     * Move the notification container to the top of the stack.
+     */
+    bringToFront() {
+      if (this.matches(':popover-open')) {
+        this.hidePopover();
+        this.showPopover();
+      }
+    }
+
     /** @private */
     _openedChanged(opened) {
       if (opened) {
         document.body.appendChild(this);
+        this.showPopover();
         document.addEventListener('vaadin-overlay-close', this._boundVaadinOverlayClose);
         if (this._boundIosResizeListener) {
           this._detectIosNavbar();
@@ -54,6 +69,7 @@ export const NotificationContainerMixin = (superClass) =>
         }
       } else {
         document.body.removeChild(this);
+        this.hidePopover();
         document.removeEventListener('vaadin-overlay-close', this._boundVaadinOverlayClose);
         if (this._boundIosResizeListener) {
           window.removeEventListener('resize', this._boundIosResizeListener);
@@ -246,8 +262,6 @@ export const NotificationMixin = (superClass) =>
       super.ready();
 
       this._overlayElement = this.shadowRoot.querySelector('vaadin-notification-card');
-
-      processTemplates(this);
     }
 
     /** @protected */
@@ -361,7 +375,11 @@ export const NotificationMixin = (superClass) =>
         return;
       }
 
-      this._container.bringToFront();
+      // Only call bringToFront if the container already has a child / was already opened.
+      // Otherwise, just setting `opened` on the container will make it the topmost overlay.
+      if (this._container.firstElementChild) {
+        this._container.bringToFront();
+      }
 
       this._card.slot = this.position;
       if (this._container.firstElementChild && /top/u.test(this.position)) {

package/src/vaadin-notification.js

@@ -3,20 +3,16 @@
  * Copyright (c) 2017 - 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 { 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 { registerStyles, ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.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 { notificationCardStyles } from './styles/vaadin-notification-card-core-styles.js';
+import { notificationContainerStyles } from './styles/vaadin-notification-container-core-styles.js';
 import { NotificationContainerMixin, NotificationMixin } from './vaadin-notification-mixin.js';
-import { notificationCardStyles, notificationContainerStyles } from './vaadin-notification-styles.js';
-
-registerStyles('vaadin-notification-container', notificationContainerStyles, {
-  moduleId: 'vaadin-notification-container-styles',
-});
-
-registerStyles('vaadin-notification-card', notificationCardStyles, {
-  moduleId: 'vaadin-notification-card-styles',
-});
 
 /**
  * An element used internally by `<vaadin-notification>`. Not intended to be used separately.
@@ -28,8 +24,19 @@ registerStyles('vaadin-notification-card', notificationCardStyles, {
  * @mixes ThemableMixin
  * @private
  */
-class NotificationContainer extends NotificationContainerMixin(ThemableMixin(ElementMixin(PolymerElement))) {
-  static get template() {
+class NotificationContainer extends NotificationContainerMixin(
+  ThemableMixin(ElementMixin(PolylitMixin(LumoInjectionMixin(LitElement)))),
+) {
+  static get is() {
+    return 'vaadin-notification-container';
+  }
+
+  static get styles() {
+    return notificationContainerStyles;
+  }
+
+  /** @protected */
+  render() {
     return html`
       <div region="top-stretch"><slot name="top-stretch"></slot></div>
       <div region-group="top">
@@ -46,10 +53,6 @@ class NotificationContainer extends NotificationContainerMixin(ThemableMixin(Ele
       <div region="bottom-stretch"><slot name="bottom-stretch"></slot></div>
     `;
   }
-
-  static get is() {
-    return 'vaadin-notification-container';
-  }
 }
 
 /**
@@ -60,8 +63,17 @@ class NotificationContainer extends NotificationContainerMixin(ThemableMixin(Ele
  * @mixes ThemableMixin
  * @private
  */
-class NotificationCard extends ThemableMixin(PolymerElement) {
-  static get template() {
+class NotificationCard extends ThemableMixin(PolylitMixin(LumoInjectionMixin(LitElement))) {
+  static get is() {
+    return 'vaadin-notification-card';
+  }
+
+  static get styles() {
+    return notificationCardStyles;
+  }
+
+  /** @protected */
+  render() {
     return html`
       <div part="overlay">
         <div part="content">
@@ -71,10 +83,6 @@ class NotificationCard extends ThemableMixin(PolymerElement) {
     `;
   }
 
-  static get is() {
-    return 'vaadin-notification-card';
-  }
-
   /** @protected */
   ready() {
     super.ready();
@@ -134,24 +142,34 @@ class NotificationCard extends ThemableMixin(PolymerElement) {
  * @mixes NotificationMixin
  * @mixes ElementMixin
  */
-class Notification extends NotificationMixin(ElementMixin(PolymerElement)) {
-  static get template() {
+class Notification extends NotificationMixin(ElementMixin(ThemableMixin(PolylitMixin(LitElement)))) {
+  static get is() {
+    return 'vaadin-notification';
+  }
+
+  static get styles() {
+    return css`
+      :host {
+        display: none !important;
+      }
+    `;
+  }
+
+  /** @protected */
+  render() {
     return html`
-      <style>
-        :host {
-          display: none !important;
-        }
-      </style>
       <vaadin-notification-card
-        theme$="[[_theme]]"
-        aria-live$="[[__computeAriaLive(assertive)]]"
+        theme="${ifDefined(this._theme)}"
+        aria-live="${this.__computeAriaLive(this.assertive)}"
       ></vaadin-notification-card>
     `;
   }
 
-  static get is() {
-    return 'vaadin-notification';
-  }
+  /**
+   * Fired when the notification is closed.
+   *
+   * @event closed
+   */
 }
 
 defineCustomElement(NotificationContainer);

package/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/notification",
-  "version": "24.8.4",
+  "version": "25.0.0-alpha10",
   "description-markup": "markdown",
   "contributions": {
     "html": {

package/web-types.lit.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/notification",
-  "version": "24.8.4",
+  "version": "25.0.0-alpha10",
   "description-markup": "markdown",
   "framework": "lit",
   "framework-config": {

package/src/vaadin-lit-notification.js

@@ -1,133 +0,0 @@
-/**
- * @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, 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 { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
-import { NotificationContainerMixin, NotificationMixin } from './vaadin-notification-mixin.js';
-import { notificationCardStyles, notificationContainerStyles } from './vaadin-notification-styles.js';
-
-/**
- * An element used internally by `<vaadin-notification>`. Not intended to be used separately.
- *
- * @customElement
- * @extends HTMLElement
- * @mixes NotificationContainerMixin
- * @mixes ElementMixin
- * @mixes ThemableMixin
- * @private
- */
-class NotificationContainer extends NotificationContainerMixin(ElementMixin(ThemableMixin(PolylitMixin(LitElement)))) {
-  static get styles() {
-    return notificationContainerStyles;
-  }
-
-  /** @protected */
-  render() {
-    return html`
-      <div region="top-stretch"><slot name="top-stretch"></slot></div>
-      <div region-group="top">
-        <div region="top-start"><slot name="top-start"></slot></div>
-        <div region="top-center"><slot name="top-center"></slot></div>
-        <div region="top-end"><slot name="top-end"></slot></div>
-      </div>
-      <div region="middle"><slot name="middle"></slot></div>
-      <div region-group="bottom">
-        <div region="bottom-start"><slot name="bottom-start"></slot></div>
-        <div region="bottom-center"><slot name="bottom-center"></slot></div>
-        <div region="bottom-end"><slot name="bottom-end"></slot></div>
-      </div>
-      <div region="bottom-stretch"><slot name="bottom-stretch"></slot></div>
-    `;
-  }
-
-  static get is() {
-    return 'vaadin-notification-container';
-  }
-}
-
-/**
- * An element used internally by `<vaadin-notification>`. Not intended to be used separately.
- *
- * @customElement
- * @extends HTMLElement
- * @mixes ThemableMixin
- * @mixes ElementMixin
- * @private
- */
-class NotificationCard extends ElementMixin(ThemableMixin(PolylitMixin(LitElement))) {
-  static get styles() {
-    return notificationCardStyles;
-  }
-
-  /** @protected */
-  render() {
-    return html`
-      <div part="overlay">
-        <div part="content">
-          <slot></slot>
-        </div>
-      </div>
-    `;
-  }
-
-  static get is() {
-    return 'vaadin-notification-card';
-  }
-
-  /** @protected */
-  ready() {
-    super.ready();
-    this.setAttribute('role', 'alert');
-  }
-}
-
-/**
- * LitElement based version of `<vaadin-notification>` 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.
- */
-class Notification extends NotificationMixin(ElementMixin(ThemableMixin(PolylitMixin(LitElement)))) {
-  static get styles() {
-    return css`
-      :host {
-        display: none !important;
-      }
-    `;
-  }
-
-  /** @protected */
-  render() {
-    return html`
-      <vaadin-notification-card
-        theme="${ifDefined(this._theme)}"
-        aria-live="${this.__computeAriaLive(this.assertive)}"
-      ></vaadin-notification-card>
-    `;
-  }
-
-  static get is() {
-    return 'vaadin-notification';
-  }
-
-  /**
-   * Fired when the notification is closed.
-   *
-   * @event closed
-   */
-}
-
-defineCustomElement(NotificationContainer);
-defineCustomElement(NotificationCard);
-defineCustomElement(Notification);
-
-export { Notification };

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

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

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

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

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

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

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

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

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

@@ -1,2 +0,0 @@
-import '@vaadin/vaadin-material-styles/typography.js';
-import '@vaadin/vaadin-material-styles/shadow.js';

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

@@ -1,149 +0,0 @@
-import '@vaadin/vaadin-material-styles/typography.js';
-import '@vaadin/vaadin-material-styles/shadow.js';
-import { colorDark } from '@vaadin/vaadin-material-styles/color.js';
-import { css, registerStyles } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
-
-registerStyles(
-  'vaadin-notification-container',
-  css`
-    :host {
-      inset: 0 4px;
-    }
-
-    @media (min-width: 420px) {
-      :host {
-        inset: 0 12px;
-      }
-    }
-  `,
-  { moduleId: 'material-notification-container' },
-);
-
-const notificationCard = css`
-  :host {
-    min-height: 48px;
-    margin: 8px 4px;
-    background-color: transparent;
-  }
-
-  [part='overlay'] {
-    background-color: var(--material-background-color);
-    border-radius: 4px;
-    box-shadow: var(--material-shadow-elevation-6dp);
-    padding: 14px 16px;
-    justify-content: stretch;
-  }
-
-  [part='content'] {
-    font-family: var(--material-font-family);
-    font-size: var(--material-small-font-size);
-    font-weight: 400;
-    line-height: 20px;
-    letter-spacing: 0;
-    text-transform: none;
-    box-sizing: border-box;
-    display: flex;
-    justify-content: space-between;
-    align-items: center;
-  }
-
-  /* NOTE(platosha): Makes the button take exactly 1 line of vertical space */
-  [part='content'] ::slotted(vaadin-button) {
-    margin: -8px 0;
-  }
-
-  :host([slot$='stretch']) {
-    margin: 0 -4px;
-  }
-
-  :host([slot$='stretch']) [part='overlay'] {
-    border-radius: 0;
-  }
-
-  @media (min-width: 420px) {
-    :host {
-      margin: 24px 12px;
-    }
-
-    :host([slot^='middle']) {
-      width: 372px;
-      margin: auto;
-    }
-
-    :host([slot$='stretch']) {
-      margin: 0 -12px;
-    }
-  }
-
-  @keyframes material-notification-exit-fade-out {
-    100% {
-      opacity: 0;
-    }
-  }
-
-  @keyframes material-notification-enter-fade-in {
-    0% {
-      opacity: 0;
-    }
-
-    100% {
-      opacity: 1;
-    }
-  }
-
-  @keyframes material-notification-enter-slide-down {
-    0% {
-      transform: translateY(-200%);
-      opacity: 0;
-    }
-  }
-
-  @keyframes material-notification-exit-slide-up {
-    100% {
-      transform: translateY(-200%);
-      opacity: 0;
-    }
-  }
-
-  @keyframes material-notification-enter-slide-up {
-    0% {
-      transform: translateY(200%);
-      opacity: 0;
-    }
-  }
-
-  @keyframes material-notification-exit-slide-down {
-    100% {
-      transform: translateY(200%);
-      opacity: 0;
-    }
-  }
-
-  :host([slot='middle'][opening]) {
-    animation: material-notification-enter-fade-in 300ms;
-  }
-
-  :host([slot='middle'][closing]) {
-    animation: material-notification-exit-fade-out 300ms;
-  }
-
-  :host([slot^='top'][opening]) {
-    animation: material-notification-enter-slide-down 300ms;
-  }
-
-  :host([slot^='top'][closing]) {
-    animation: material-notification-exit-slide-up 300ms;
-  }
-
-  :host([slot^='bottom'][opening]) {
-    animation: material-notification-enter-slide-up 300ms;
-  }
-
-  :host([slot^='bottom'][closing]) {
-    animation: material-notification-exit-slide-down 300ms;
-  }
-`;
-
-registerStyles('vaadin-notification-card', [colorDark, notificationCard], {
-  moduleId: 'material-notification-card',
-});

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

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

package/theme/material/vaadin-notification.js

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

package/vaadin-lit-notification.d.ts

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

package/vaadin-lit-notification.js

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