@vaadin/notification 22.0.0-alpha7 → 22.0.0-beta2

package/README.md

@@ -1,13 +1,10 @@
-# <vaadin-notification>
+# @vaadin/notification
 
-[Live Demo ↗](https://vaadin.com/components/vaadin-notification/html-examples)
-|
-[API documentation ↗](https://vaadin.com/components/vaadin-notification/html-api)
+A web component for providing feedback to the user.
 
-[<vaadin-notification>](https://vaadin.com/components/vaadin-notification) is a Web Component providing accessible and customizable notifications (toasts), part of the [Vaadin components](https://vaadin.com/components).
+[Documentation + Live Demo ↗](https://vaadin.com/docs/latest/ds/components/notification)
 
 [![npm version](https://badgen.net/npm/v/@vaadin/notification)](https://www.npmjs.com/package/@vaadin/notification)
-[![Published on Vaadin Directory](https://img.shields.io/badge/Vaadin%20Directory-published-00b4f0.svg)](https://vaadin.com/directory/component/vaadinvaadin-notification)
 [![Discord](https://img.shields.io/discord/732335336448852018?label=discord)](https://discord.gg/PHmkCKC)
 
 ```html
@@ -22,41 +19,44 @@
 </script>
 ```
 
-[<img src="https://raw.githubusercontent.com/vaadin/vaadin-notification/master/screenshot.png" width="336" alt="Screenshot of vaadin-notification">](https://vaadin.com/components/vaadin-notification)
+[<img src="https://raw.githubusercontent.com/vaadin/web-components/master/packages/notification/screenshot.png" width="336" alt="Screenshot of vaadin-notification">](https://vaadin.com/docs/latest/ds/components/notification)
 
 ## Installation
 
-Install `vaadin-notification`:
+Install the component:
 
 ```sh
-npm i @vaadin/notification --save
+npm i @vaadin/notification
 ```
 
-Once installed, import it in your application:
+Once installed, import the component in your application:
 
 ```js
-import '@vaadin/notification/vaadin-notification.js';
+import '@vaadin/notification';
 ```
 
-## Getting started
+## Themes
 
-Vaadin components use the Lumo theme by default.
+Vaadin components come with two built-in [themes](https://vaadin.com/docs/latest/ds/customization/using-themes), Lumo and Material.
+The [main entrypoint](https://github.com/vaadin/web-components/blob/master/packages/notification/vaadin-notification.js) of the package uses the Lumo theme.
 
-To use the Material theme, import the correspondent file from the `theme/material` folder.
+To use the Material theme, import the component from the `theme/material` folder:
 
-## Entry points
-
-- The component with the Lumo theme:
-
-  `theme/lumo/vaadin-notification.js`
+```js
+import '@vaadin/notification/theme/material/vaadin-notification.js';
+```
 
-- The component with the Material theme:
+You can also import the Lumo version of the component explicitly:
 
-  `theme/material/vaadin-notification.js`
+```js
+import '@vaadin/notification/theme/lumo/vaadin-notification.js';
+```
 
-- Alias for `theme/lumo/vaadin-notification.js`:
+Finally, you can import the un-themed component from the `src` folder to get a minimal starting point:
 
-- `vaadin-notification.js`
+```js
+import '@vaadin/notification/src/vaadin-notification.js';
+```
 
 ## Contributing
 
@@ -66,4 +66,5 @@ Read the [contributing guide](https://vaadin.com/docs/latest/guide/contributing/
 
 Apache License 2.0
 
-Vaadin collects development time usage statistics to improve this product. For details and to opt-out, see https://github.com/vaadin/vaadin-usage-statistics.
+Vaadin collects usage statistics at development time to improve this product.
+For details and to opt-out, see https://github.com/vaadin/vaadin-usage-statistics.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/notification",
-  "version": "22.0.0-alpha7",
+  "version": "22.0.0-beta2",
   "publishConfig": {
     "access": "public"
   },
@@ -33,18 +33,18 @@
   ],
   "dependencies": {
     "@polymer/polymer": "^3.0.0",
-    "@vaadin/component-base": "22.0.0-alpha7",
-    "@vaadin/vaadin-lumo-styles": "22.0.0-alpha7",
-    "@vaadin/vaadin-material-styles": "22.0.0-alpha7",
-    "@vaadin/vaadin-themable-mixin": "22.0.0-alpha7",
+    "@vaadin/component-base": "22.0.0-beta2",
+    "@vaadin/vaadin-lumo-styles": "22.0.0-beta2",
+    "@vaadin/vaadin-material-styles": "22.0.0-beta2",
+    "@vaadin/vaadin-themable-mixin": "22.0.0-beta2",
     "lit": "^2.0.0"
   },
   "devDependencies": {
     "@esm-bundle/chai": "^4.3.4",
-    "@vaadin/button": "22.0.0-alpha7",
-    "@vaadin/polymer-legacy-adapter": "22.0.0-alpha7",
+    "@vaadin/button": "22.0.0-beta2",
+    "@vaadin/polymer-legacy-adapter": "22.0.0-beta2",
     "@vaadin/testing-helpers": "^0.3.0",
     "sinon": "^9.2.1"
   },
-  "gitHead": "8e89419c6b44a1d225d5859e180d7b35e47ddb52"
+  "gitHead": "f13833683e6667f6ca6678452db14aa6b7eac4a4"
 }

package/src/vaadin-notification.d.ts

@@ -1,8 +1,42 @@
+/**
+ * @license
+ * Copyright (c) 2021 Vaadin Ltd.
+ * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
+ */
 import { TemplateResult } from 'lit';
 import { ElementMixin } from '@vaadin/component-base/src/element-mixin.js';
 import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
 import { ThemePropertyMixin } from '@vaadin/vaadin-themable-mixin/vaadin-theme-property-mixin.js';
-import { NotificationEventMap, NotificationPosition, NotificationRenderer, ShowOptions } from './interfaces';
+
+export type NotificationPosition =
+  | 'top-stretch'
+  | 'top-start'
+  | 'top-center'
+  | 'top-end'
+  | 'middle'
+  | 'bottom-start'
+  | 'bottom-center'
+  | 'bottom-end'
+  | 'bottom-stretch';
+
+export type NotificationRenderer = (root: HTMLElement, notification?: Notification) => void;
+
+/**
+ * Fired when the `opened` property changes.
+ */
+export type NotificationOpenedChangedEvent = CustomEvent<{ value: boolean }>;
+
+export interface NotificationCustomEventMap {
+  'opened-changed': NotificationOpenedChangedEvent;
+}
+
+export interface NotificationEventMap extends HTMLElementEventMap, NotificationCustomEventMap {}
+
+export interface ShowOptions {
+  duration?: number;
+  position?: NotificationPosition;
+  theme?: string;
+}
 
 /**
  * An element used internally by `<vaadin-notification>`. Not intended to be used separately.
@@ -101,13 +135,6 @@ declare class Notification extends ThemePropertyMixin(ElementMixin(HTMLElement))
    */
   requestContentUpdate(): void;
 
-  /**
-   * Manually invoke existing renderer.
-   *
-   * @deprecated Since Vaadin 21, `render()` is deprecated. Please use `requestContentUpdate()` instead.
-   */
-  render(): void;
-
   /**
    * Opens the notification.
    */
@@ -140,6 +167,7 @@ declare class Notification extends ThemePropertyMixin(ElementMixin(HTMLElement))
    * {
    *   position?: string
    *   duration?: number
+   *   theme?: string
    * }
    * ```
    *

package/src/vaadin-notification.js

@@ -3,7 +3,7 @@
  * Copyright (c) 2021 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
-import { PolymerElement, html } from '@polymer/polymer/polymer-element.js';
+import { html, PolymerElement } from '@polymer/polymer/polymer-element.js';
 import { render } from 'lit';
 import { isTemplateResult } from 'lit/directive-helpers.js';
 import { ElementMixin } from '@vaadin/component-base/src/element-mixin.js';
@@ -325,17 +325,6 @@ class Notification extends ThemePropertyMixin(ElementMixin(PolymerElement)) {
     this.renderer(this._card, this);
   }
 
-  /**
-   * Manually invoke existing renderer.
-   *
-   * @deprecated Since Vaadin 21, `render()` is deprecated. Please use `requestContentUpdate()` instead.
-   */
-  render() {
-    console.warn('WARNING: Since Vaadin 21, render() is deprecated. Please use requestContentUpdate() instead.');
-
-    this.requestContentUpdate();
-  }
-
   /** @private */
   _rendererChanged(renderer, opened, card) {
     if (!card) {
@@ -484,6 +473,7 @@ class Notification extends ThemePropertyMixin(ElementMixin(PolymerElement)) {
    * {
    *   position?: string
    *   duration?: number
+   *   theme?: string
    * }
    * ```
    *
@@ -515,6 +505,9 @@ class Notification extends ThemePropertyMixin(ElementMixin(PolymerElement)) {
     if (options && options.position) {
       notification.position = options.position;
     }
+    if (options && options.theme) {
+      notification.setAttribute('theme', options.theme);
+    }
     notification.renderer = renderer;
     document.body.appendChild(notification);
     notification.opened = true;

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

@@ -1,8 +1,8 @@
-import { registerStyles, css } from '@vaadin/vaadin-themable-mixin/register-styles.js';
 import '@vaadin/vaadin-lumo-styles/color.js';
 import '@vaadin/vaadin-lumo-styles/spacing.js';
 import '@vaadin/vaadin-lumo-styles/style.js';
 import '@vaadin/vaadin-lumo-styles/typography.js';
+import { css, registerStyles } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
 
 registerStyles(
   'vaadin-notification-card',

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

@@ -1,7 +1,7 @@
-import { registerStyles, css } from '@vaadin/vaadin-themable-mixin/register-styles.js';
-import { colorDark } from '@vaadin/vaadin-material-styles/color.js';
 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',

package/vaadin-notification.d.ts

@@ -1,2 +1 @@
 export * from './src/vaadin-notification.js';
-export * from './src/interfaces';

package/src/interfaces.d.ts

@@ -1,30 +0,0 @@
-import { Notification } from './vaadin-notification';
-
-export type NotificationPosition =
-  | 'top-stretch'
-  | 'top-start'
-  | 'top-center'
-  | 'top-end'
-  | 'middle'
-  | 'bottom-start'
-  | 'bottom-center'
-  | 'bottom-end'
-  | 'bottom-stretch';
-
-export type NotificationRenderer = (root: HTMLElement, notification?: Notification) => void;
-
-/**
- * Fired when the `opened` property changes.
- */
-export type NotificationOpenedChangedEvent = CustomEvent<{ value: boolean }>;
-
-export interface NotificationCustomEventMap {
-  'opened-changed': NotificationOpenedChangedEvent;
-}
-
-export interface NotificationEventMap extends HTMLElementEventMap, NotificationCustomEventMap {}
-
-export interface ShowOptions {
-  duration?: number;
-  position?: NotificationPosition;
-}