@vaadin/popover 25.2.0-alpha9 → 25.2.0-beta1

package/custom-elements.json

@@ -812,6 +812,16 @@
               "description": "Set to true to disable closing popover on outside click.",
               "attribute": "no-close-on-outside-click"
             },
+            {
+              "kind": "field",
+              "name": "noTabFocus",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "When true, pressing Tab on the target or a sibling element does not move\nfocus into the popover's content (including any nested popovers), and\nShift+Tab does not move focus into the popover's last focusable. Focus\nstill moves out of the popover on Tab / Shift+Tab if it was placed\ninside programmatically.\n\nHas no effect on modal popovers, which use their own focus trap.",
+              "attribute": "no-tab-focus"
+            },
             {
               "kind": "field",
               "name": "opened",
@@ -1072,6 +1082,14 @@
               "description": "Set to true to disable closing popover on outside click.",
               "fieldName": "noCloseOnOutsideClick"
             },
+            {
+              "name": "no-tab-focus",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "When true, pressing Tab on the target or a sibling element does not move\nfocus into the popover's content (including any nested popovers), and\nShift+Tab does not move focus into the popover's last focusable. Focus\nstill moves out of the popover on Tab / Shift+Tab if it was placed\ninside programmatically.\n\nHas no effect on modal popovers, which use their own focus trap.",
+              "fieldName": "noTabFocus"
+            },
             {
               "name": "opened",
               "type": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/popover",
-  "version": "25.2.0-alpha9",
+  "version": "25.2.0-beta1",
   "publishConfig": {
     "access": "public"
   },
@@ -37,19 +37,19 @@
   ],
   "dependencies": {
     "@open-wc/dedupe-mixin": "^1.3.0",
-    "@vaadin/a11y-base": "25.2.0-alpha9",
-    "@vaadin/component-base": "25.2.0-alpha9",
-    "@vaadin/lit-renderer": "25.2.0-alpha9",
-    "@vaadin/overlay": "25.2.0-alpha9",
-    "@vaadin/vaadin-themable-mixin": "25.2.0-alpha9",
+    "@vaadin/a11y-base": "25.2.0-beta1",
+    "@vaadin/component-base": "25.2.0-beta1",
+    "@vaadin/lit-renderer": "25.2.0-beta1",
+    "@vaadin/overlay": "25.2.0-beta1",
+    "@vaadin/vaadin-themable-mixin": "25.2.0-beta1",
     "lit": "^3.0.0"
   },
   "devDependencies": {
-    "@vaadin/aura": "25.2.0-alpha9",
-    "@vaadin/chai-plugins": "25.2.0-alpha9",
-    "@vaadin/test-runner-commands": "25.2.0-alpha9",
+    "@vaadin/aura": "25.2.0-beta1",
+    "@vaadin/chai-plugins": "25.2.0-beta1",
+    "@vaadin/test-runner-commands": "25.2.0-beta1",
     "@vaadin/testing-helpers": "^2.0.0",
-    "@vaadin/vaadin-lumo-styles": "25.2.0-alpha9",
+    "@vaadin/vaadin-lumo-styles": "25.2.0-beta1",
     "sinon": "^21.0.2"
   },
   "customElements": "custom-elements.json",
@@ -57,5 +57,5 @@
     "web-types.json",
     "web-types.lit.json"
   ],
-  "gitHead": "a38a03e8a8be45821f39c14054c63634dafe08d0"
+  "gitHead": "471a23f60d1eb725f98a33f62cb9664d9c0a4163"
 }

package/src/vaadin-popover-focus-controller.js

@@ -40,13 +40,19 @@ export class PopoverFocusController {
 
     if (targetFocusable && isElementFocused(targetFocusable)) {
       event.preventDefault();
-      host.focus();
+      if (host.noTabFocus) {
+        this.__moveLogicalNext(event, targetFocusable);
+      } else {
+        host.focus();
+      }
       return;
     }
 
     const lastPopoverFocusable = this.__getLastPopoverFocusable();
     if (isElementFocused(lastPopoverFocusable)) {
-      this.__moveLogicalNext(event, host);
+      // With noTabFocus the popover isn't in the logical list, so the target
+      // becomes the reference for "next after the popover".
+      this.__moveLogicalNext(event, host.noTabFocus ? targetFocusable : host);
       return;
     }
 
@@ -65,10 +71,12 @@ export class PopoverFocusController {
     const host = this.host;
     const targetFocusable = this.__getTargetFocusable();
 
-    // Just clear the flag so native Shift+Tab from the target doesn't reopen.
+    // Clear the flag so native Shift+Tab from the target doesn't reopen. Fall
+    // through to the redirect logic: when the popover is DOM-prev of the target,
+    // case 5 steers focus away from it instead of letting the browser land on
+    // the popover host or its content.
     if (targetFocusable && isElementFocused(targetFocusable) && host.__shouldRestoreFocus) {
       host.__shouldRestoreFocus = false;
-      return;
     }
 
     if (isElementFocused(host)) {
@@ -104,6 +112,10 @@ export class PopoverFocusController {
         prevFocusable.focus();
       } else if (getActiveTrappingNode(host)) {
         this.__wrapToLogicalLast(event, logicalFocusables);
+      } else if (host.noTabFocus) {
+        // No redirect target and no trap: still block native Shift+Tab so the
+        // popover host can never receive Shift+Tab focus.
+        event.preventDefault();
       }
       return;
     }
@@ -165,7 +177,7 @@ export class PopoverFocusController {
   /**
    * Scope focusables in *logical* tab order: the popover is moved from its DOM
    * position to right after the target focusable. The popover is left out of
-   * the list entirely when there is no target.
+   * the list entirely when there is no target, or when `noTabFocus` is set.
    * @private
    */
   __buildLogicalList(scopeFocusables = this.__getScopeFocusables()) {
@@ -173,7 +185,7 @@ export class PopoverFocusController {
     const targetFocusable = this.__getTargetFocusable();
     const logicalFocusables = scopeFocusables.filter((el) => el !== host);
 
-    if (targetFocusable && targetFocusable !== host) {
+    if (!host.noTabFocus && targetFocusable && targetFocusable !== host) {
       const targetIdx = logicalFocusables.indexOf(targetFocusable);
       if (targetIdx >= 0) {
         logicalFocusables.splice(targetIdx + 1, 0, host);
@@ -187,28 +199,32 @@ export class PopoverFocusController {
     const host = this.host;
     const logicalFocusables = this.__buildLogicalList(scopeFocusables);
     const fromIdx = logicalFocusables.indexOf(from);
-    if (fromIdx < 0) {
-      return;
-    }
 
-    // The popover sits right after the target in the logical list, so it can
-    // be the logical next only when `from` is the target. Skip it: the popover
-    // is Tab-reachable only from its target (handled in __handleTab case 1).
-    let nextIdx = fromIdx + 1;
-    if (logicalFocusables[nextIdx] === host) {
-      nextIdx += 1;
-    }
+    let focusable;
+    if (fromIdx >= 0) {
+      // The popover sits right after the target in the logical list, so it can
+      // be the logical next only when `from` is the target. Skip it: the popover
+      // is Tab-reachable only from its target (handled in __handleTab case 1).
+      let nextIdx = fromIdx + 1;
+      if (logicalFocusables[nextIdx] === host) {
+        nextIdx += 1;
+      }
 
-    // Past the end inside a trap: wrap to the first element. The popover
-    // never sits at position 0 (it only follows a target), so list[0] is real.
-    let focusable = logicalFocusables[nextIdx];
-    if (!focusable && getActiveTrappingNode(host)) {
-      focusable = logicalFocusables[0];
+      // Past the end inside a trap: wrap to the first element. The popover
+      // never sits at position 0 (it only follows a target), so list[0] is real.
+      focusable = logicalFocusables[nextIdx];
+      if (!focusable && getActiveTrappingNode(host)) {
+        focusable = logicalFocusables[0];
+      }
     }
 
     if (focusable) {
       event.preventDefault();
       focusable.focus();
+    } else if (host.noTabFocus) {
+      // No redirect target found: still block native Tab so the popover host
+      // can never receive Tab focus when it is DOM-adjacent.
+      event.preventDefault();
     }
   }
 

package/src/vaadin-popover-overlay-mixin.js

@@ -8,10 +8,6 @@ import { PositionMixin } from '@vaadin/overlay/src/vaadin-overlay-position-mixin
 
 /**
  * A mixin providing common popover overlay functionality.
- *
- * @polymerMixin
- * @mixes PositionMixin
- * @mixes OverlayMixin
  */
 export const PopoverOverlayMixin = (superClass) =>
   class PopoverOverlayMixinClass extends PositionMixin(OverlayMixin(superClass)) {

package/src/vaadin-popover-overlay.js

@@ -18,9 +18,6 @@ import { PopoverOverlayMixin } from './vaadin-popover-overlay-mixin.js';
  *
  * @customElement vaadin-popover-overlay
  * @extends HTMLElement
- * @mixes DirMixin
- * @mixes PopoverOverlayMixin
- * @mixes ThemableMixin
  * @private
  */
 class PopoverOverlay extends PopoverOverlayMixin(

package/src/vaadin-popover-position-mixin.js

@@ -6,8 +6,6 @@
 
 /**
  * A mixin providing popover position functionality.
- *
- * @polymerMixin
  */
 export const PopoverPositionMixin = (superClass) =>
   class PopoverPositionMixinClass extends superClass {

package/src/vaadin-popover-target-mixin.js

@@ -8,8 +8,6 @@ import { Debouncer } from '@vaadin/component-base/src/debounce.js';
 
 /**
  * A mixin providing popover target functionality.
- *
- * @polymerMixin
  */
 export const PopoverTargetMixin = (superClass) =>
   class PopoverTargetMixinClass extends superClass {
@@ -34,6 +32,7 @@ export const PopoverTargetMixin = (superClass) =>
          */
         target: {
           type: Object,
+          sync: true,
         },
 
         /** @private */

package/src/vaadin-popover.d.ts

@@ -205,6 +205,19 @@ declare class Popover extends PopoverPositionMixin(PopoverTargetMixin(ThemePrope
    */
   noCloseOnEsc: boolean;
 
+  /**
+   * When true, pressing Tab on the target or a sibling element does not move
+   * focus into the popover's content (including any nested popovers), and
+   * Shift+Tab does not move focus into the popover's last focusable. Focus
+   * still moves out of the popover on Tab / Shift+Tab if it was placed
+   * inside programmatically.
+   *
+   * Has no effect on modal popovers, which use their own focus trap.
+   *
+   * @attr {boolean} no-tab-focus
+   */
+  noTabFocus: boolean;
+
   /**
    * Popover trigger mode, used to configure how the popover is opened or closed.
    * Could be set to multiple by providing an array, e.g. `trigger = ['hover', 'focus']`.

package/src/vaadin-popover.js

@@ -209,10 +209,6 @@ const isLastOverlay = (overlay) => {
  *
  * @customElement vaadin-popover
  * @extends HTMLElement
- * @mixes ElementMixin
- * @mixes PopoverPositionMixin
- * @mixes PopoverTargetMixin
- * @mixes ThemePropertyMixin
  */
 class Popover extends PopoverPositionMixin(
   PopoverTargetMixin(ThemePropertyMixin(ElementMixin(PolylitMixin(LitElement)))),
@@ -398,6 +394,22 @@ class Popover extends PopoverPositionMixin(
         value: false,
       },
 
+      /**
+       * When true, pressing Tab on the target or a sibling element does not move
+       * focus into the popover's content (including any nested popovers), and
+       * Shift+Tab does not move focus into the popover's last focusable. Focus
+       * still moves out of the popover on Tab / Shift+Tab if it was placed
+       * inside programmatically.
+       *
+       * Has no effect on modal popovers, which use their own focus trap.
+       *
+       * @attr {boolean} no-tab-focus
+       */
+      noTabFocus: {
+        type: Boolean,
+        value: false,
+      },
+
       /**
        * Popover trigger mode, used to configure how the popover is opened or closed.
        * Could be set to multiple by providing an array, e.g. `trigger = ['hover', 'focus']`.
@@ -936,12 +948,6 @@ class Popover extends PopoverPositionMixin(
   __hasTrigger(trigger) {
     return Array.isArray(this.trigger) && this.trigger.includes(trigger);
   }
-
-  /**
-   * Fired when the popover is closed.
-   *
-   * @event closed
-   */
 }
 
 defineCustomElement(Popover);

package/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/popover",
-  "version": "25.2.0-alpha9",
+  "version": "25.2.0-beta1",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -15,9 +15,7 @@
               "description": "String used to label the popover to screen reader users.",
               "value": {
                 "type": [
-                  "string",
-                  "null",
-                  "undefined"
+                  "string"
                 ]
               }
             },
@@ -26,9 +24,7 @@
               "description": "Id of the element used as label of the popover to screen reader users.",
               "value": {
                 "type": [
-                  "string",
-                  "null",
-                  "undefined"
+                  "string"
                 ]
               }
             },
@@ -37,9 +33,7 @@
               "description": "When true, the popover content automatically receives focus after\nit is opened. Modal popovers use this behavior by default.",
               "value": {
                 "type": [
-                  "boolean",
-                  "null",
-                  "undefined"
+                  "boolean"
                 ]
               }
             },
@@ -48,9 +42,7 @@
               "description": "The delay in milliseconds before the popover is opened\non focus when the corresponding trigger is used.\n\nWhen not specified, the global default (500ms) is used.",
               "value": {
                 "type": [
-                  "number",
-                  "null",
-                  "undefined"
+                  "number"
                 ]
               }
             },
@@ -59,9 +51,7 @@
               "description": "The id of the element to be used as `target` value.\nThe element should be in the DOM by the time when\nthe attribute is set, otherwise a warning is shown.",
               "value": {
                 "type": [
-                  "string",
-                  "null",
-                  "undefined"
+                  "string"
                 ]
               }
             },
@@ -70,9 +60,7 @@
               "description": "Set the height of the popover.\nIf a unitless number is provided, pixels are assumed.",
               "value": {
                 "type": [
-                  "string",
-                  "null",
-                  "undefined"
+                  "string"
                 ]
               }
             },
@@ -81,9 +69,7 @@
               "description": "The delay in milliseconds before the popover is closed\non losing hover, when the corresponding trigger is used.\nOn blur, the popover is closed immediately.\n\nWhen not specified, the global default (500ms) is used.",
               "value": {
                 "type": [
-                  "number",
-                  "null",
-                  "undefined"
+                  "number"
                 ]
               }
             },
@@ -92,9 +78,7 @@
               "description": "The delay in milliseconds before the popover is opened\non hover when the corresponding trigger is used.\n\nWhen not specified, the global default (500ms) is used.",
               "value": {
                 "type": [
-                  "number",
-                  "null",
-                  "undefined"
+                  "number"
                 ]
               }
             },
@@ -103,9 +87,7 @@
               "description": "When true, the popover prevents interacting with background elements\nby setting `pointer-events` style on the document body to `none`.\nThis also enables trapping focus inside the popover.",
               "value": {
                 "type": [
-                  "boolean",
-                  "null",
-                  "undefined"
+                  "boolean"
                 ]
               }
             },
@@ -114,9 +96,7 @@
               "description": "Set to true to disable closing popover on Escape press.",
               "value": {
                 "type": [
-                  "boolean",
-                  "null",
-                  "undefined"
+                  "boolean"
                 ]
               }
             },
@@ -125,9 +105,16 @@
               "description": "Set to true to disable closing popover on outside click.",
               "value": {
                 "type": [
-                  "boolean",
-                  "null",
-                  "undefined"
+                  "boolean"
+                ]
+              }
+            },
+            {
+              "name": "no-tab-focus",
+              "description": "When true, pressing Tab on the target or a sibling element does not move\nfocus into the popover's content (including any nested popovers), and\nShift+Tab does not move focus into the popover's last focusable. Focus\nstill moves out of the popover on Tab / Shift+Tab if it was placed\ninside programmatically.\n\nHas no effect on modal popovers, which use their own focus trap.",
+              "value": {
+                "type": [
+                  "boolean"
                 ]
               }
             },
@@ -136,9 +123,7 @@
               "description": "True if the popover is visible and available for interaction.",
               "value": {
                 "type": [
-                  "boolean",
-                  "null",
-                  "undefined"
+                  "boolean"
                 ]
               }
             },
@@ -147,9 +132,7 @@
               "description": "The `role` attribute value to be set on the popover.",
               "value": {
                 "type": [
-                  "string",
-                  "null",
-                  "undefined"
+                  "string"
                 ]
               }
             },
@@ -158,9 +141,7 @@
               "description": "Position of the overlay with respect to the target.\nSupported values: `top-start`, `top`, `top-end`,\n`bottom-start`, `bottom`, `bottom-end`, `start-top`,\n`start`, `start-bottom`, `end-top`, `end`, `end-bottom`.",
               "value": {
                 "type": [
-                  "string",
-                  "null",
-                  "undefined"
+                  "string"
                 ]
               }
             },
@@ -169,9 +150,7 @@
               "description": "The `role` attribute value to be set on the popover.\nWhen not specified, defaults to 'dialog'.",
               "value": {
                 "type": [
-                  "string",
-                  "null",
-                  "undefined"
+                  "string"
                 ]
               }
             },
@@ -191,9 +170,7 @@
               "description": "Set the width of the popover.\nIf a unitless number is provided, pixels are assumed.",
               "value": {
                 "type": [
-                  "string",
-                  "null",
-                  "undefined"
+                  "string"
                 ]
               }
             },
@@ -202,9 +179,7 @@
               "description": "When true, the popover has a backdrop (modality curtain) on top of the\nunderlying page content, covering the whole viewport.",
               "value": {
                 "type": [
-                  "boolean",
-                  "null",
-                  "undefined"
+                  "boolean"
                 ]
               }
             }
@@ -216,9 +191,7 @@
                 "description": "String used to label the popover to screen reader users.",
                 "value": {
                   "type": [
-                    "string",
-                    "null",
-                    "undefined"
+                    "string"
                   ]
                 }
               },
@@ -227,9 +200,7 @@
                 "description": "Id of the element used as label of the popover to screen reader users.",
                 "value": {
                   "type": [
-                    "string",
-                    "null",
-                    "undefined"
+                    "string"
                   ]
                 }
               },
@@ -238,9 +209,7 @@
                 "description": "When true, the popover content automatically receives focus after\nit is opened. Modal popovers use this behavior by default.",
                 "value": {
                   "type": [
-                    "boolean",
-                    "null",
-                    "undefined"
+                    "boolean"
                   ]
                 }
               },
@@ -249,9 +218,7 @@
                 "description": "The delay in milliseconds before the popover is opened\non focus when the corresponding trigger is used.\n\nWhen not specified, the global default (500ms) is used.",
                 "value": {
                   "type": [
-                    "number",
-                    "null",
-                    "undefined"
+                    "number"
                   ]
                 }
               },
@@ -260,9 +227,7 @@
                 "description": "The id of the element to be used as `target` value.\nThe element should be in the DOM by the time when\nthe attribute is set, otherwise a warning is shown.",
                 "value": {
                   "type": [
-                    "string",
-                    "null",
-                    "undefined"
+                    "string"
                   ]
                 }
               },
@@ -271,9 +236,7 @@
                 "description": "Set the height of the popover.\nIf a unitless number is provided, pixels are assumed.",
                 "value": {
                   "type": [
-                    "string",
-                    "null",
-                    "undefined"
+                    "string"
                   ]
                 }
               },
@@ -282,9 +245,7 @@
                 "description": "The delay in milliseconds before the popover is closed\non losing hover, when the corresponding trigger is used.\nOn blur, the popover is closed immediately.\n\nWhen not specified, the global default (500ms) is used.",
                 "value": {
                   "type": [
-                    "number",
-                    "null",
-                    "undefined"
+                    "number"
                   ]
                 }
               },
@@ -293,9 +254,7 @@
                 "description": "The delay in milliseconds before the popover is opened\non hover when the corresponding trigger is used.\n\nWhen not specified, the global default (500ms) is used.",
                 "value": {
                   "type": [
-                    "number",
-                    "null",
-                    "undefined"
+                    "number"
                   ]
                 }
               },
@@ -304,9 +263,7 @@
                 "description": "When true, the popover prevents interacting with background elements\nby setting `pointer-events` style on the document body to `none`.\nThis also enables trapping focus inside the popover.",
                 "value": {
                   "type": [
-                    "boolean",
-                    "null",
-                    "undefined"
+                    "boolean"
                   ]
                 }
               },
@@ -315,9 +272,7 @@
                 "description": "Set to true to disable closing popover on Escape press.",
                 "value": {
                   "type": [
-                    "boolean",
-                    "null",
-                    "undefined"
+                    "boolean"
                   ]
                 }
               },
@@ -326,9 +281,16 @@
                 "description": "Set to true to disable closing popover on outside click.",
                 "value": {
                   "type": [
-                    "boolean",
-                    "null",
-                    "undefined"
+                    "boolean"
+                  ]
+                }
+              },
+              {
+                "name": "noTabFocus",
+                "description": "When true, pressing Tab on the target or a sibling element does not move\nfocus into the popover's content (including any nested popovers), and\nShift+Tab does not move focus into the popover's last focusable. Focus\nstill moves out of the popover on Tab / Shift+Tab if it was placed\ninside programmatically.\n\nHas no effect on modal popovers, which use their own focus trap.",
+                "value": {
+                  "type": [
+                    "boolean"
                   ]
                 }
               },
@@ -337,9 +299,7 @@
                 "description": "True if the popover is visible and available for interaction.",
                 "value": {
                   "type": [
-                    "boolean",
-                    "null",
-                    "undefined"
+                    "boolean"
                   ]
                 }
               },
@@ -348,9 +308,7 @@
                 "description": "The `role` attribute value to be set on the popover.",
                 "value": {
                   "type": [
-                    "string",
-                    "null",
-                    "undefined"
+                    "string"
                   ]
                 }
               },
@@ -359,9 +317,7 @@
                 "description": "Position of the overlay with respect to the target.\nSupported values: `top-start`, `top`, `top-end`,\n`bottom-start`, `bottom`, `bottom-end`, `start-top`,\n`start`, `start-bottom`, `end-top`, `end`, `end-bottom`.",
                 "value": {
                   "type": [
-                    "string",
-                    "null",
-                    "undefined"
+                    "string"
                   ]
                 }
               },
@@ -370,9 +326,7 @@
                 "description": "Custom function for rendering the content of the popover.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `popover` The reference to the `vaadin-popover` element.",
                 "value": {
                   "type": [
-                    "Object",
-                    "null",
-                    "undefined"
+                    "object"
                   ]
                 }
               },
@@ -381,9 +335,7 @@
                 "description": "The `role` attribute value to be set on the popover.\nWhen not specified, defaults to 'dialog'.",
                 "value": {
                   "type": [
-                    "string",
-                    "null",
-                    "undefined"
+                    "string"
                   ]
                 }
               },
@@ -392,9 +344,7 @@
                 "description": "Reference to the DOM element used both to trigger the overlay\nby user interaction and to visually position it on the screen.\n\nDefaults to an element referenced with `for` attribute, in\nwhich case it must be located in the same shadow scope.",
                 "value": {
                   "type": [
-                    "Object",
-                    "null",
-                    "undefined"
+                    "object"
                   ]
                 }
               },
@@ -403,9 +353,7 @@
                 "description": "Popover trigger mode, used to configure how the popover is opened or closed.\nCould be set to multiple by providing an array, e.g. `trigger = ['hover', 'focus']`.\n\nSupported values:\n- `click` (default) - opens and closes on target click.\n- `hover` - opens on target mouseenter, closes on target mouseleave. Moving mouse\nto the popover content keeps the popover opened.\n- `focus` - opens on target focus, closes on target blur. Moving focus to the\npopover content keeps the popover opened.\n\nIn addition to the behavior specified by `trigger`, the popover can be closed by:\n- pressing Escape key (unless `noCloseOnEsc` property is true)\n- outside click (unless `noCloseOnOutsideClick` property is true)\n\nWhen setting `trigger` property to `null`, `undefined` or empty array, the popover\ncan be only opened programmatically by changing `opened` property. Note, closing\non Escape press or outside click is still allowed unless explicitly disabled.",
                 "value": {
                   "type": [
-                    "Array",
-                    "null",
-                    "undefined"
+                    "array"
                   ]
                 }
               },
@@ -414,9 +362,7 @@
                 "description": "Set the width of the popover.\nIf a unitless number is provided, pixels are assumed.",
                 "value": {
                   "type": [
-                    "string",
-                    "null",
-                    "undefined"
+                    "string"
                   ]
                 }
               },
@@ -425,9 +371,7 @@
                 "description": "When true, the popover has a backdrop (modality curtain) on top of the\nunderlying page content, covering the whole viewport.",
                 "value": {
                   "type": [
-                    "boolean",
-                    "null",
-                    "undefined"
+                    "boolean"
                   ]
                 }
               }

package/web-types.lit.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/popover",
-  "version": "25.2.0-alpha9",
+  "version": "25.2.0-beta1",
   "description-markup": "markdown",
   "framework": "lit",
   "framework-config": {
@@ -20,92 +20,92 @@
           "extension": true,
           "attributes": [
             {
-              "name": "?autofocus",
-              "description": "When true, the popover content automatically receives focus after\nit is opened. Modal popovers use this behavior by default.",
+              "name": ".accessibleName",
+              "description": "String used to label the popover to screen reader users.",
               "value": {
                 "kind": "expression"
               }
             },
             {
-              "name": "?modal",
-              "description": "When true, the popover prevents interacting with background elements\nby setting `pointer-events` style on the document body to `none`.\nThis also enables trapping focus inside the popover.",
+              "name": ".accessibleNameRef",
+              "description": "Id of the element used as label of the popover to screen reader users.",
               "value": {
                 "kind": "expression"
               }
             },
             {
-              "name": "?noCloseOnEsc",
-              "description": "Set to true to disable closing popover on Escape press.",
+              "name": "?autofocus",
+              "description": "When true, the popover content automatically receives focus after\nit is opened. Modal popovers use this behavior by default.",
               "value": {
                 "kind": "expression"
               }
             },
             {
-              "name": "?noCloseOnOutsideClick",
-              "description": "Set to true to disable closing popover on outside click.",
+              "name": ".focusDelay",
+              "description": "The delay in milliseconds before the popover is opened\non focus when the corresponding trigger is used.\n\nWhen not specified, the global default (500ms) is used.",
               "value": {
                 "kind": "expression"
               }
             },
             {
-              "name": "?opened",
-              "description": "True if the popover is visible and available for interaction.",
+              "name": ".for",
+              "description": "The id of the element to be used as `target` value.\nThe element should be in the DOM by the time when\nthe attribute is set, otherwise a warning is shown.",
               "value": {
                 "kind": "expression"
               }
             },
             {
-              "name": "?withBackdrop",
-              "description": "When true, the popover has a backdrop (modality curtain) on top of the\nunderlying page content, covering the whole viewport.",
+              "name": ".height",
+              "description": "Set the height of the popover.\nIf a unitless number is provided, pixels are assumed.",
               "value": {
                 "kind": "expression"
               }
             },
             {
-              "name": ".accessibleName",
-              "description": "String used to label the popover to screen reader users.",
+              "name": ".hideDelay",
+              "description": "The delay in milliseconds before the popover is closed\non losing hover, when the corresponding trigger is used.\nOn blur, the popover is closed immediately.\n\nWhen not specified, the global default (500ms) is used.",
               "value": {
                 "kind": "expression"
               }
             },
             {
-              "name": ".accessibleNameRef",
-              "description": "Id of the element used as label of the popover to screen reader users.",
+              "name": ".hoverDelay",
+              "description": "The delay in milliseconds before the popover is opened\non hover when the corresponding trigger is used.\n\nWhen not specified, the global default (500ms) is used.",
               "value": {
                 "kind": "expression"
               }
             },
             {
-              "name": ".focusDelay",
-              "description": "The delay in milliseconds before the popover is opened\non focus when the corresponding trigger is used.\n\nWhen not specified, the global default (500ms) is used.",
+              "name": "?modal",
+              "description": "When true, the popover prevents interacting with background elements\nby setting `pointer-events` style on the document body to `none`.\nThis also enables trapping focus inside the popover.",
               "value": {
                 "kind": "expression"
               }
             },
             {
-              "name": ".for",
-              "description": "The id of the element to be used as `target` value.\nThe element should be in the DOM by the time when\nthe attribute is set, otherwise a warning is shown.",
+              "name": "?noCloseOnEsc",
+              "description": "Set to true to disable closing popover on Escape press.",
               "value": {
                 "kind": "expression"
               }
             },
             {
-              "name": ".height",
-              "description": "Set the height of the popover.\nIf a unitless number is provided, pixels are assumed.",
+              "name": "?noCloseOnOutsideClick",
+              "description": "Set to true to disable closing popover on outside click.",
               "value": {
                 "kind": "expression"
               }
             },
             {
-              "name": ".hideDelay",
-              "description": "The delay in milliseconds before the popover is closed\non losing hover, when the corresponding trigger is used.\nOn blur, the popover is closed immediately.\n\nWhen not specified, the global default (500ms) is used.",
+              "name": "?noTabFocus",
+              "description": "When true, pressing Tab on the target or a sibling element does not move\nfocus into the popover's content (including any nested popovers), and\nShift+Tab does not move focus into the popover's last focusable. Focus\nstill moves out of the popover on Tab / Shift+Tab if it was placed\ninside programmatically.\n\nHas no effect on modal popovers, which use their own focus trap.",
               "value": {
                 "kind": "expression"
               }
             },
             {
-              "name": ".hoverDelay",
-              "description": "The delay in milliseconds before the popover is opened\non hover when the corresponding trigger is used.\n\nWhen not specified, the global default (500ms) is used.",
+              "name": "?opened",
+              "description": "True if the popover is visible and available for interaction.",
               "value": {
                 "kind": "expression"
               }
@@ -159,6 +159,13 @@
                 "kind": "expression"
               }
             },
+            {
+              "name": "?withBackdrop",
+              "description": "When true, the popover has a backdrop (modality curtain) on top of the\nunderlying page content, covering the whole viewport.",
+              "value": {
+                "kind": "expression"
+              }
+            },
             {
               "name": "@closed",
               "description": "Fired when the popover is closed.",