@vaadin/login 25.0.0-alpha2 → 25.0.0-alpha21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/login",
-  "version": "25.0.0-alpha2",
+  "version": "25.0.0-alpha21",
   "publishConfig": {
     "access": "public"
   },
@@ -21,7 +21,6 @@
   "type": "module",
   "files": [
     "src",
-    "theme",
     "vaadin-*.d.ts",
     "vaadin-*.js",
     "web-types.json",
@@ -35,25 +34,26 @@
   ],
   "dependencies": {
     "@open-wc/dedupe-mixin": "^1.3.0",
-    "@vaadin/button": "25.0.0-alpha2",
-    "@vaadin/component-base": "25.0.0-alpha2",
-    "@vaadin/overlay": "25.0.0-alpha2",
-    "@vaadin/password-field": "25.0.0-alpha2",
-    "@vaadin/text-field": "25.0.0-alpha2",
-    "@vaadin/vaadin-lumo-styles": "25.0.0-alpha2",
-    "@vaadin/vaadin-themable-mixin": "25.0.0-alpha2",
+    "@vaadin/button": "25.0.0-alpha21",
+    "@vaadin/component-base": "25.0.0-alpha21",
+    "@vaadin/overlay": "25.0.0-alpha21",
+    "@vaadin/password-field": "25.0.0-alpha21",
+    "@vaadin/text-field": "25.0.0-alpha21",
+    "@vaadin/vaadin-themable-mixin": "25.0.0-alpha21",
     "lit": "^3.0.0"
   },
   "devDependencies": {
-    "@vaadin/chai-plugins": "25.0.0-alpha2",
-    "@vaadin/checkbox": "25.0.0-alpha2",
-    "@vaadin/test-runner-commands": "25.0.0-alpha2",
+    "@vaadin/a11y-base": "25.0.0-alpha21",
+    "@vaadin/chai-plugins": "25.0.0-alpha21",
+    "@vaadin/checkbox": "25.0.0-alpha21",
+    "@vaadin/test-runner-commands": "25.0.0-alpha21",
     "@vaadin/testing-helpers": "^2.0.0",
-    "sinon": "^18.0.0"
+    "@vaadin/vaadin-lumo-styles": "25.0.0-alpha21",
+    "sinon": "^21.0.0"
   },
   "web-types": [
     "web-types.json",
     "web-types.lit.json"
   ],
-  "gitHead": "67ffcd5355cf21ce1b5039c598525109fc4c164b"
+  "gitHead": "8fb9e9710c01449edf623a1aaac4655cdc11a933"
 }

package/src/styles/vaadin-login-form-wrapper-base-styles.js

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Copyright (c) 2018 - 2025 Vaadin Ltd.
+ * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
+ */
+import '@vaadin/component-base/src/styles/style-props.js';
+import { css } from 'lit';
+
+export const loginFormWrapperStyles = css`
+  :host {
+    background: var(--vaadin-login-form-background, transparent);
+    border-radius: var(--vaadin-login-form-border-radius, 0);
+    display: flex;
+    box-sizing: border-box;
+    flex-direction: column;
+    gap: var(--vaadin-login-form-gap, var(--vaadin-gap-l));
+    padding: var(--vaadin-login-form-padding, var(--vaadin-padding-l));
+    max-width: 100%;
+    width: var(--vaadin-login-form-width, 360px);
+  }
+
+  :host([hidden]) {
+    display: none !important;
+  }
+
+  ::slotted(form) {
+    display: flex;
+    flex-direction: column;
+    gap: var(--vaadin-login-form-gap, var(--vaadin-gap-m));
+  }
+
+  ::slotted([slot='form-title']) {
+    color: var(--vaadin-login-form-title-color, var(--vaadin-text-color));
+    font-size: var(--vaadin-login-form-title-font-size, 1.25rem);
+    font-weight: var(--vaadin-login-form-title-font-weight, 600);
+    line-height: var(--vaadin-login-form-title-line-height, inherit);
+  }
+
+  :host([error]) [part='error-message'] {
+    display: grid;
+  }
+
+  [part='error-message'] {
+    color: var(--vaadin-login-form-error-color, var(--vaadin-text-color));
+    font-size: var(--vaadin-login-form-error-font-size, inherit);
+    font-weight: var(--vaadin-login-form-error-font-weight, 400);
+    gap: var(--vaadin-login-form-error-gap, 0 var(--vaadin-gap-s));
+    grid-template-columns: auto 1fr;
+    line-height: var(--vaadin-login-form-error-line-height, inherit);
+  }
+
+  [part='error-message']::before {
+    background: currentColor;
+    content: '';
+    display: inline-block;
+    flex: none;
+    height: var(--vaadin-icon-size, 1lh);
+    mask: var(--_vaadin-icon-warn) 50% / var(--vaadin-icon-visual-size, 100%) no-repeat;
+    width: var(--vaadin-icon-size, 1lh);
+  }
+
+  [part='error-message-description'] {
+    grid-column: 2;
+  }
+`;

package/src/styles/vaadin-login-overlay-wrapper-base-styles.js

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright (c) 2018 - 2025 Vaadin Ltd.
+ * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
+ */
+import '@vaadin/component-base/src/styles/style-props.js';
+import { css } from 'lit';
+import { overlayStyles } from '@vaadin/overlay/src/styles/vaadin-overlay-base-styles.js';
+
+const loginOverlayWrapper = css`
+  [part='overlay'] {
+    background: var(
+      --vaadin-login-overlay-background,
+      var(--vaadin-overlay-background, var(--vaadin-background-color))
+    );
+    border: var(--vaadin-login-overlay-border-width, var(--vaadin-overlay-border-width, 1px)) solid
+      var(--vaadin-login-overlay-border-color, var(--vaadin-overlay-border-color, var(--vaadin-border-color-secondary)));
+    border-radius: var(--vaadin-login-overlay-border-radius, var(--vaadin-radius-l));
+    box-shadow: var(--vaadin-login-overlay-shadow, var(--vaadin-overlay-shadow, 0 8px 24px -4px rgba(0, 0, 0, 0.3)));
+  }
+
+  [part='card'] {
+    box-sizing: border-box;
+    display: flex;
+    flex-direction: column;
+    max-width: 100%;
+    overflow: hidden;
+  }
+
+  [part='brand'] {
+    background: var(--vaadin-login-overlay-brand-background, var(--vaadin-background-container));
+    display: flex;
+    flex-direction: column;
+    padding: var(--vaadin-login-overlay-brand-padding, var(--vaadin-padding-l));
+  }
+
+  ::slotted([slot='title']) {
+    color: var(--vaadin-login-overlay-title-color, var(--vaadin-text-color));
+    font-size: var(--vaadin-login-overlay-title-font-size, inherit);
+    font-weight: var(--vaadin-login-overlay-title-font-weight, 600);
+    line-height: var(--vaadin-login-overlay-title-line-height, inherit);
+  }
+
+  [part='description'] {
+    color: var(--vaadin-login-overlay-description-color, var(--vaadin-text-color-secondary));
+    font-size: var(--vaadin-login-overlay-description-font-size, inherit);
+    font-weight: var(--vaadin-login-overlay-description-font-weight, inherit);
+    line-height: var(--vaadin-login-overlay-description-line-height, inherit);
+  }
+`;
+
+export const loginOverlayWrapperStyles = [overlayStyles, loginOverlayWrapper];

package/src/title-controller.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright (c) 2018 - 2025 Vaadin Ltd.
+ * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
+ */
+import { SlotChildObserveController } from '@vaadin/component-base/src/slot-child-observe-controller.js';
+
+/**
+ * A controller to manage the title element.
+ */
+export class TitleController extends SlotChildObserveController {}

package/src/title-controller.js

@@ -0,0 +1,100 @@
+/**
+ * @license
+ * Copyright (c) 2018 - 2025 Vaadin Ltd.
+ * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
+ */
+import { SlotChildObserveController } from '@vaadin/component-base/src/slot-child-observe-controller.js';
+
+/**
+ * A controller to manage the title element.
+ */
+export class TitleController extends SlotChildObserveController {
+  constructor(host) {
+    super(host, 'title', 'div');
+  }
+
+  /**
+   * Set title based on corresponding host property.
+   *
+   * @param {string} title
+   */
+  setTitle(title) {
+    this.title = title;
+
+    // Restore the default title, if needed.
+    const titleNode = this.getSlotChild();
+    if (!titleNode) {
+      this.restoreDefaultNode();
+    }
+
+    // When default title is used, update it.
+    if (this.node === this.defaultNode) {
+      this.updateDefaultNode(this.node);
+    }
+  }
+
+  /**
+   * Set level based on corresponding host property.
+   *
+   * @param {string} level
+   */
+  setLevel(level) {
+    this.level = level;
+
+    // When default title is used, update it.
+    if (this.node === this.defaultNode) {
+      this.updateDefaultNode(this.node);
+    }
+  }
+
+  /**
+   * Override method inherited from `SlotController`
+   * to customize heading on the default title node.
+   *
+   * @param {Node} node
+   * @protected
+   * @override
+   */
+  initNode(node) {
+    if (node === this.defaultNode) {
+      node.setAttribute('role', 'heading');
+    }
+
+    this.host.setAttribute('aria-labelledby', node.id);
+  }
+
+  /**
+   * Override method inherited from `SlotChildObserveController`
+   * to restore the default title element.
+   *
+   * @protected
+   * @override
+   */
+  restoreDefaultNode() {
+    const { title } = this;
+
+    // Restore the default title.
+    if (title && title.trim() !== '') {
+      const node = this.attachDefaultNode();
+      this.initNode(node);
+    }
+  }
+
+  /**
+   * Override method inherited from `SlotChildObserveController`
+   * to update the default title element.
+   *
+   * @param {Node | undefined} node
+   * @protected
+   * @override
+   */
+  updateDefaultNode(node) {
+    if (node) {
+      node.textContent = this.title;
+      node.setAttribute('aria-level', this.level);
+    }
+
+    // Notify the host after update.
+    super.updateDefaultNode(node);
+  }
+}

package/src/vaadin-login-form-mixin.js

@@ -3,6 +3,8 @@
  * Copyright (c) 2018 - 2025 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
+import { html, render } from 'lit';
+import { ifDefined } from 'lit/directives/if-defined.js';
 import { LoginMixin } from './vaadin-login-mixin.js';
 
 function isCheckbox(field) {
@@ -15,16 +17,43 @@ function isCheckbox(field) {
  */
 export const LoginFormMixin = (superClass) =>
   class LoginFormMixin extends LoginMixin(superClass) {
-    static get observers() {
-      return ['_errorChanged(error)'];
-    }
-
+    /** @protected */
     get _customFields() {
-      return [...this.$.vaadinLoginFormWrapper.children].filter((node) => {
+      return [...this.children].filter((node) => {
         return node.getAttribute('slot') === 'custom-form-area' && node.hasAttribute('name');
       });
     }
 
+    /** @protected */
+    get _userNameField() {
+      return this.querySelector('#vaadinLoginUsername');
+    }
+
+    /** @protected */
+    get _passwordField() {
+      return this.querySelector('#vaadinLoginPassword');
+    }
+
+    /**
+     * Override update to render slotted form and buttons
+     * into light DOM after rendering shadow DOM.
+     * @protected
+     */
+    update(props) {
+      super.update(props);
+
+      this.__renderSlottedForm();
+    }
+
+    /** @protected */
+    updated(props) {
+      super.updated(props);
+
+      if (props.has('error') && this.error && !this._preventAutoEnable) {
+        this.disabled = false;
+      }
+    }
+
     /** @protected */
     async connectedCallback() {
       super.connectedCallback();
@@ -32,23 +61,70 @@ export const LoginFormMixin = (superClass) =>
       if (!this.noAutofocus) {
         // Wait for the form to fully render.
         await new Promise(requestAnimationFrame);
-        this.$.vaadinLoginUsername.focus();
+        this._userNameField.focus();
       }
     }
 
-    /** @private */
-    _errorChanged() {
-      if (this.error && !this._preventAutoEnable) {
-        this.disabled = false;
-      }
+    __renderSlottedForm() {
+      render(
+        html`
+          <form method="POST" action="${ifDefined(this.action)}" @formdata="${this._onFormData}" slot="form">
+            <input id="csrf" type="hidden" />
+            <vaadin-text-field
+              name="username"
+              .label="${this.__effectiveI18n.form.username}"
+              .errorMessage="${this.__effectiveI18n.errorMessage.username}"
+              id="vaadinLoginUsername"
+              required
+              @keydown="${this._handleInputKeydown}"
+              autocapitalize="none"
+              autocorrect="off"
+              spellcheck="false"
+              autocomplete="username"
+              manual-validation
+            >
+              <input type="text" slot="input" @keyup="${this._handleInputKeyup}" />
+            </vaadin-text-field>
+
+            <vaadin-password-field
+              name="password"
+              .label="${this.__effectiveI18n.form.password}"
+              .errorMessage="${this.__effectiveI18n.errorMessage.password}"
+              id="vaadinLoginPassword"
+              required
+              @keydown="${this._handleInputKeydown}"
+              spellcheck="false"
+              autocomplete="current-password"
+              manual-validation
+            >
+              <input type="password" slot="input" @keyup="${this._handleInputKeyup}" />
+            </vaadin-password-field>
+          </form>
+
+          <vaadin-button slot="submit" theme="primary submit" @click="${this.submit}" .disabled="${this.disabled}">
+            ${this.__effectiveI18n.form.submit}
+          </vaadin-button>
+
+          <vaadin-button
+            slot="forgot-password"
+            theme="tertiary small"
+            @click="${this._onForgotPasswordClick}"
+            ?hidden="${this.noForgotPassword}"
+          >
+            ${this.__effectiveI18n.form.forgotPassword}
+          </vaadin-button>
+        `,
+        this,
+        { host: this },
+      );
     }
 
     /**
      * Submits the form.
      */
     submit() {
-      const userName = this.$.vaadinLoginUsername;
-      const password = this.$.vaadinLoginPassword;
+      const userName = this._userNameField;
+      const password = this._passwordField;
 
       // eslint-disable-next-line no-restricted-syntax
       userName.validate();
@@ -91,8 +167,9 @@ export const LoginFormMixin = (superClass) =>
         const csrfMetaName = document.querySelector('meta[name=_csrf_parameter]');
         const csrfMetaValue = document.querySelector('meta[name=_csrf]');
         if (csrfMetaName && csrfMetaValue) {
-          this.$.csrf.name = csrfMetaName.content;
-          this.$.csrf.value = csrfMetaValue.content;
+          const csrf = this.querySelector('#csrf');
+          csrf.name = csrfMetaName.content;
+          csrf.value = csrfMetaValue.content;
         }
         this.querySelector('form').submit();
       }
@@ -117,8 +194,7 @@ export const LoginFormMixin = (superClass) =>
     _handleInputKeydown(e) {
       if (e.key === 'Enter') {
         const { currentTarget: inputActive } = e;
-        const nextInput =
-          inputActive.id === 'vaadinLoginUsername' ? this.$.vaadinLoginPassword : this.$.vaadinLoginUsername;
+        const nextInput = inputActive.id === 'vaadinLoginUsername' ? this._passwordField : this._userNameField;
         // eslint-disable-next-line no-restricted-syntax
         if (inputActive.validate()) {
           if (nextInput.checkValidity()) {

package/src/vaadin-login-form-wrapper.js

@@ -6,8 +6,9 @@
 import { html, LitElement } from 'lit';
 import { defineCustomElement } from '@vaadin/component-base/src/define.js';
 import { PolylitMixin } from '@vaadin/component-base/src/polylit-mixin.js';
+import { LumoInjectionMixin } from '@vaadin/vaadin-themable-mixin/lumo-injection-mixin.js';
 import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
-import { loginFormWrapperStyles } from './vaadin-login-form-wrapper-styles.js';
+import { loginFormWrapperStyles } from './styles/vaadin-login-form-wrapper-base-styles.js';
 
 /**
  * An element used internally by `<vaadin-login-form>`. Not intended to be used separately.
@@ -16,7 +17,7 @@ import { loginFormWrapperStyles } from './vaadin-login-form-wrapper-styles.js';
  * @mixes ThemableMixin
  * @private
  */
-class LoginFormWrapper extends ThemableMixin(PolylitMixin(LitElement)) {
+class LoginFormWrapper extends ThemableMixin(PolylitMixin(LumoInjectionMixin(LitElement))) {
   static get is() {
     return 'vaadin-login-form-wrapper';
   }
@@ -44,39 +45,30 @@ class LoginFormWrapper extends ThemableMixin(PolylitMixin(LitElement)) {
       i18n: {
         type: Object,
       },
-
-      /**
-       * Used to customize the `aria-level` attribute on the heading element.
-       */
-      headingLevel: {
-        type: Number,
-      },
     };
   }
 
   /** @protected */
   render() {
     return html`
-      <section part="form">
-        <div part="form-title" role="heading" aria-level="${this.headingLevel}">${this.i18n.form.title}</div>
-        <div part="error-message" ?hidden="${!this.error}">
-          <strong part="error-message-title">${this.i18n.errorMessage.title}</strong>
-          <p part="error-message-description">${this.i18n.errorMessage.message}</p>
-        </div>
+      <slot name="form-title"></slot>
+      <div part="error-message" ?hidden="${!this.error}">
+        <strong part="error-message-title">${this.i18n.errorMessage.title}</strong>
+        <div part="error-message-description">${this.i18n.errorMessage.message}</div>
+      </div>
 
-        <slot name="form"></slot>
+      <slot name="form"></slot>
 
-        <slot name="custom-form-area"></slot>
+      <slot name="custom-form-area"></slot>
 
-        <slot name="submit"></slot>
+      <slot name="submit"></slot>
 
-        <slot name="forgot-password"></slot>
+      <slot name="forgot-password"></slot>
 
-        <div part="footer">
-          <slot name="footer"></slot>
-          <p>${this.i18n.additionalInformation}</p>
-        </div>
-      </section>
+      <div part="footer">
+        <slot name="footer"></slot>
+        <div>${this.i18n.additionalInformation}</div>
+      </div>
     `;
   }
 }

package/src/vaadin-login-form.d.ts

@@ -39,7 +39,7 @@ export interface LoginFormEventMap extends HTMLElementEventMap, LoginFormCustomE
  * `<vaadin-login-form>` is a Web Component providing an easy way to require users
  * to log in into an application. Note that component has no shadowRoot.
  *
- * ```
+ * ```html
  * <vaadin-login-form></vaadin-login-form>
  * ```
  *
@@ -48,10 +48,7 @@ export interface LoginFormEventMap extends HTMLElementEventMap, LoginFormCustomE
  *
  * ### Styling
  *
- * The component doesn't have a shadowRoot, so the `<form>` and input fields can be styled from a global scope.
- *
- * Use `<vaadin-login-form-wrapper>` themable component to apply styles.
- * The following shadow DOM parts of the `<vaadin-login-form-wrapper>` are available for styling:
+ * The following shadow DOM parts are available for styling:
  *
  * Part name      | Description
  * ---------------|---------------------------------------------------------|

package/src/vaadin-login-form.js

@@ -7,7 +7,7 @@ import '@vaadin/button/src/vaadin-button.js';
 import '@vaadin/text-field/src/vaadin-text-field.js';
 import '@vaadin/password-field/src/vaadin-password-field.js';
 import './vaadin-login-form-wrapper.js';
-import { html, LitElement } from 'lit';
+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';
@@ -19,7 +19,7 @@ import { LoginFormMixin } from './vaadin-login-form-mixin.js';
  * `<vaadin-login-form>` is a Web Component providing an easy way to require users
  * to log in into an application. Note that component has no shadowRoot.
  *
- * ```
+ * ```html
  * <vaadin-login-form></vaadin-login-form>
  * ```
  *
@@ -28,10 +28,7 @@ import { LoginFormMixin } from './vaadin-login-form-mixin.js';
  *
  * ### Styling
  *
- * The component doesn't have a shadowRoot, so the `<form>` and input fields can be styled from a global scope.
- * Use `<vaadin-login-form-wrapper>` themable component to apply styles.
- *
- * The following shadow DOM parts of the `<vaadin-login-form-wrapper>` are available for styling:
+ * The following shadow DOM parts are available for styling:
  *
  * Part name      | Description
  * ---------------|---------------------------------------------------------|
@@ -60,74 +57,40 @@ class LoginForm extends LoginFormMixin(ElementMixin(ThemableMixin(PolylitMixin(L
     return 'vaadin-login-form';
   }
 
-  /**
-   * @protected
-   * @override
-   */
-  createRenderRoot() {
-    return this;
+  static get styles() {
+    return css`
+      :host {
+        display: block;
+        max-width: 100%;
+      }
+
+      :host([hidden]) {
+        display: none !important;
+      }
+    `;
   }
 
   /** @protected */
   render() {
     return html`
-      <style>
-        vaadin-login-form-wrapper > form > * {
-          width: 100%;
-        }
-      </style>
       <vaadin-login-form-wrapper
-        id="vaadinLoginFormWrapper"
+        id="form"
         theme="${ifDefined(this._theme)}"
         .error="${this.error}"
         .i18n="${this.__effectiveI18n}"
-        .headingLevel="${this.headingLevel}"
+        part="form"
+        role="region"
+        aria-labelledby="title"
+        exportparts="error-message, error-message-title, error-message-description, footer"
       >
-        <form method="POST" action="${ifDefined(this.action)}" @formdata="${this._onFormData}" slot="form">
-          <input id="csrf" type="hidden" />
-          <vaadin-text-field
-            name="username"
-            .label="${this.__effectiveI18n.form.username}"
-            .errorMessage="${this.__effectiveI18n.errorMessage.username}"
-            id="vaadinLoginUsername"
-            required
-            @keydown="${this._handleInputKeydown}"
-            autocapitalize="none"
-            autocorrect="off"
-            spellcheck="false"
-            autocomplete="username"
-            manual-validation
-          >
-            <input type="text" slot="input" @keyup="${this._handleInputKeyup}" />
-          </vaadin-text-field>
-
-          <vaadin-password-field
-            name="password"
-            .label="${this.__effectiveI18n.form.password}"
-            .errorMessage="${this.__effectiveI18n.errorMessage.password}"
-            id="vaadinLoginPassword"
-            required
-            @keydown="${this._handleInputKeydown}"
-            spellcheck="false"
-            autocomplete="current-password"
-            manual-validation
-          >
-            <input type="password" slot="input" @keyup="${this._handleInputKeyup}" />
-          </vaadin-password-field>
-        </form>
-
-        <vaadin-button slot="submit" theme="primary submit" @click="${this.submit}" .disabled="${this.disabled}">
-          ${this.__effectiveI18n.form.submit}
-        </vaadin-button>
-
-        <vaadin-button
-          slot="forgot-password"
-          theme="tertiary small"
-          @click="${this._onForgotPasswordClick}"
-          ?hidden="${this.noForgotPassword}"
-        >
-          ${this.__effectiveI18n.form.forgotPassword}
-        </vaadin-button>
+        <div id="title" slot="form-title" part="form-title" role="heading" aria-level="${this.headingLevel}">
+          ${this.__effectiveI18n.form.title}
+        </div>
+        <slot name="form" slot="form"></slot>
+        <slot name="custom-form-area" slot="custom-form-area"></slot>
+        <slot name="submit" slot="submit"></slot>
+        <slot name="forgot-password" slot="forgot-password"></slot>
+        <slot name="footer" slot="footer"></slot>
       </vaadin-login-form-wrapper>
     `;
   }

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

@@ -69,7 +69,7 @@ export declare class LoginMixinClass {
    * and `header` sections, `header` can be added to override `title` and `description` properties
    * in `vaadin-login-overlay`):
    *
-   * ```
+   * ```js
    * {
    *   header: {
    *     title: 'App name',