@vaadin/dialog 25.4.0-alpha2 → 25.4.0-alpha4

package/custom-elements.json

@@ -416,8 +416,7 @@
               "type": {
                 "text": "object"
               },
-              "description": "Custom function for rendering the dialog footer.",
-              "attribute": "footer-renderer"
+              "description": "Custom function for rendering the dialog footer."
             },
             {
               "kind": "method",
@@ -436,8 +435,7 @@
               "type": {
                 "text": "object"
               },
-              "description": "Custom function for rendering the dialog header.",
-              "attribute": "header-renderer"
+              "description": "Custom function for rendering the dialog header."
             },
             {
               "kind": "field",
@@ -449,6 +447,16 @@
               "description": "String used for rendering a dialog title.",
               "attribute": "header-title"
             },
+            {
+              "kind": "field",
+              "name": "headingLevel",
+              "privacy": "public",
+              "type": {
+                "text": "number"
+              },
+              "description": "The ARIA heading level of the title.",
+              "attribute": "heading-level"
+            },
             {
               "kind": "field",
               "name": "hidden",
@@ -481,7 +489,6 @@
                 "text": "object"
               },
               "description": "Object with properties that is passed to `renderer` function",
-              "attribute": "model",
               "inheritedFrom": {
                 "name": "OverlayMixin",
                 "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
@@ -523,7 +530,6 @@
                 "text": "HTMLElement"
               },
               "description": "Owner element passed with renderer function",
-              "attribute": "owner",
               "inheritedFrom": {
                 "name": "OverlayMixin",
                 "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
@@ -537,7 +543,6 @@
                 "text": "OverlayRenderer | null | undefined"
               },
               "description": "Custom function for rendering the content of the overlay.\nReceives three arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `owner` The host element of the renderer function.\n- `model` The object with the properties related with rendering.",
-              "attribute": "renderer",
               "inheritedFrom": {
                 "name": "OverlayMixin",
                 "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
@@ -546,11 +551,7 @@
             {
               "kind": "method",
               "name": "requestContentUpdate",
-              "description": "Requests an update for the content of the overlay.\nWhile performing the update, it invokes the renderer passed in the `renderer` property.\n\nIt is not guaranteed that the update happens immediately (synchronously) after it is requested.",
-              "inheritedFrom": {
-                "name": "OverlayMixin",
-                "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
-              }
+              "description": "Requests an update for the content of the overlay.\nWhile performing the update, it invokes the renderer passed in the `renderer` property.\n\nIt is not guaranteed that the update happens immediately (synchronously) after it is requested."
             },
             {
               "kind": "field",
@@ -560,7 +561,6 @@
                 "text": "HTMLElement"
               },
               "description": "Set to specify the element which should be focused on overlay close,\nif `restoreFocusOnClose` is set to true.",
-              "attribute": "restore-focus-node",
               "inheritedFrom": {
                 "name": "OverlayFocusMixin",
                 "package": "@vaadin/overlay/src/vaadin-overlay-focus-mixin.js"
@@ -592,11 +592,7 @@
                   "default": "true"
                 }
               ],
-              "description": "Override method from OverlayMixin to adjust the position of the overlay if `keepInViewport` is true.",
-              "inheritedFrom": {
-                "name": "OverlayMixin",
-                "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
-              }
+              "description": "Override method from OverlayMixin to adjust the position of the overlay if `keepInViewport` is true."
             },
             {
               "kind": "field",
@@ -646,6 +642,14 @@
               "description": "String used for rendering a dialog title.",
               "fieldName": "headerTitle"
             },
+            {
+              "name": "heading-level",
+              "type": {
+                "text": "number"
+              },
+              "description": "The ARIA heading level of the title.",
+              "fieldName": "headingLevel"
+            },
             {
               "name": "hidden",
               "type": {
@@ -690,42 +694,6 @@
                 "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
               }
             },
-            {
-              "name": "owner",
-              "type": {
-                "text": "HTMLElement"
-              },
-              "description": "Owner element passed with renderer function",
-              "fieldName": "owner",
-              "inheritedFrom": {
-                "name": "OverlayMixin",
-                "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
-              }
-            },
-            {
-              "name": "renderer",
-              "type": {
-                "text": "OverlayRenderer | null | undefined"
-              },
-              "description": "Custom function for rendering the content of the overlay.\nReceives three arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `owner` The host element of the renderer function.\n- `model` The object with the properties related with rendering.",
-              "fieldName": "renderer",
-              "inheritedFrom": {
-                "name": "OverlayMixin",
-                "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
-              }
-            },
-            {
-              "name": "restore-focus-node",
-              "type": {
-                "text": "HTMLElement"
-              },
-              "description": "Set to specify the element which should be focused on overlay close,\nif `restoreFocusOnClose` is set to true.",
-              "fieldName": "restoreFocusNode",
-              "inheritedFrom": {
-                "name": "OverlayFocusMixin",
-                "package": "@vaadin/overlay/src/vaadin-overlay-focus-mixin.js"
-              }
-            },
             {
               "name": "restore-focus-on-close",
               "type": {
@@ -814,8 +782,7 @@
                 "text": "DialogRenderer | undefined"
               },
               "description": "Custom function for rendering the dialog footer.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.\n\nWhen `footerRenderer` is set, the attribute `has-footer` is set on the dialog.",
-              "deprecated": "Add footer content as children of the dialog using `slot=\"footer\"` instead",
-              "attribute": "footer-renderer"
+              "deprecated": "Add footer content as children of the dialog using `slot=\"footer\"` instead"
             },
             {
               "kind": "field",
@@ -825,8 +792,7 @@
                 "text": "DialogRenderer | undefined"
               },
               "description": "Custom function for rendering the dialog header.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.\n\nIf both `headerTitle` and `headerRenderer` are defined, the title\nand the elements created by the renderer will be placed next to\neach other, with the title coming first.\n\nWhen `headerRenderer` is set, the attribute `has-header` is set on the dialog.",
-              "deprecated": "Add header content as children of the dialog using `slot=\"header-content\"` instead",
-              "attribute": "header-renderer"
+              "deprecated": "Add header content as children of the dialog using `slot=\"header-content\"` instead"
             },
             {
               "kind": "field",
@@ -838,6 +804,16 @@
               "description": "String used for rendering a dialog title.\n\nIf both `headerTitle` and `headerRenderer` are defined, the title\nand the elements created by the renderer will be placed next to\neach other, with the title coming first.\n\nWhen `headerTitle` is set, the attribute `has-title` is set on the dialog.",
               "attribute": "header-title"
             },
+            {
+              "kind": "field",
+              "name": "headingLevel",
+              "privacy": "public",
+              "type": {
+                "text": "number"
+              },
+              "description": "The ARIA heading level, used to set the `aria-level` attribute\non the title element. When not set, defaults to `1` for modal\ndialogs and `2` for modeless dialogs.",
+              "attribute": "heading-level"
+            },
             {
               "kind": "field",
               "name": "renderer",
@@ -846,8 +822,7 @@
                 "text": "DialogRenderer | undefined"
               },
               "description": "Custom function for rendering the content of the dialog.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.",
-              "deprecated": "Add content elements as children of the dialog instead",
-              "attribute": "renderer"
+              "deprecated": "Add content elements as children of the dialog instead"
             },
             {
               "kind": "method",
@@ -857,24 +832,6 @@
             }
           ],
           "attributes": [
-            {
-              "name": "footer-renderer",
-              "type": {
-                "text": "DialogRenderer | undefined"
-              },
-              "description": "Custom function for rendering the dialog footer.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.\n\nWhen `footerRenderer` is set, the attribute `has-footer` is set on the dialog.",
-              "deprecated": "Add footer content as children of the dialog using `slot=\"footer\"` instead",
-              "fieldName": "footerRenderer"
-            },
-            {
-              "name": "header-renderer",
-              "type": {
-                "text": "DialogRenderer | undefined"
-              },
-              "description": "Custom function for rendering the dialog header.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.\n\nIf both `headerTitle` and `headerRenderer` are defined, the title\nand the elements created by the renderer will be placed next to\neach other, with the title coming first.\n\nWhen `headerRenderer` is set, the attribute `has-header` is set on the dialog.",
-              "deprecated": "Add header content as children of the dialog using `slot=\"header-content\"` instead",
-              "fieldName": "headerRenderer"
-            },
             {
               "name": "header-title",
               "type": {
@@ -884,13 +841,12 @@
               "fieldName": "headerTitle"
             },
             {
-              "name": "renderer",
+              "name": "heading-level",
               "type": {
-                "text": "DialogRenderer | undefined"
+                "text": "number"
               },
-              "description": "Custom function for rendering the content of the dialog.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.",
-              "deprecated": "Add content elements as children of the dialog instead",
-              "fieldName": "renderer"
+              "description": "The ARIA heading level, used to set the `aria-level` attribute\non the title element. When not set, defaults to `1` for modal\ndialogs and `2` for modeless dialogs.",
+              "fieldName": "headingLevel"
             }
           ],
           "parameters": [
@@ -1125,7 +1081,6 @@
               },
               "description": "Custom function for rendering the dialog footer.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.\n\nWhen `footerRenderer` is set, the attribute `has-footer` is set on the dialog.",
               "deprecated": "Add footer content as children of the dialog using `slot=\"footer\"` instead",
-              "attribute": "footer-renderer",
               "inheritedFrom": {
                 "name": "DialogRendererMixin",
                 "module": "src/vaadin-dialog-renderer-mixin.js"
@@ -1140,7 +1095,6 @@
               },
               "description": "Custom function for rendering the dialog header.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.\n\nIf both `headerTitle` and `headerRenderer` are defined, the title\nand the elements created by the renderer will be placed next to\neach other, with the title coming first.\n\nWhen `headerRenderer` is set, the attribute `has-header` is set on the dialog.",
               "deprecated": "Add header content as children of the dialog using `slot=\"header-content\"` instead",
-              "attribute": "header-renderer",
               "inheritedFrom": {
                 "name": "DialogRendererMixin",
                 "module": "src/vaadin-dialog-renderer-mixin.js"
@@ -1160,6 +1114,20 @@
                 "module": "src/vaadin-dialog-renderer-mixin.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "headingLevel",
+              "privacy": "public",
+              "type": {
+                "text": "number"
+              },
+              "description": "The ARIA heading level, used to set the `aria-level` attribute\non the title element. When not set, defaults to `1` for modal\ndialogs and `2` for modeless dialogs.",
+              "attribute": "heading-level",
+              "inheritedFrom": {
+                "name": "DialogRendererMixin",
+                "module": "src/vaadin-dialog-renderer-mixin.js"
+              }
+            },
             {
               "kind": "field",
               "name": "height",
@@ -1311,7 +1279,6 @@
               },
               "description": "Custom function for rendering the content of the dialog.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.",
               "deprecated": "Add content elements as children of the dialog instead",
-              "attribute": "renderer",
               "inheritedFrom": {
                 "name": "DialogRendererMixin",
                 "module": "src/vaadin-dialog-renderer-mixin.js"
@@ -1372,37 +1339,25 @@
           ],
           "events": [
             {
-              "name": "closed",
               "type": {
                 "text": "CustomEvent"
               },
               "description": "Fired when the dialog is closed.",
-              "inheritedFrom": {
-                "name": "DialogBaseMixin",
-                "module": "src/vaadin-dialog-base-mixin.js"
-              }
+              "name": "closed"
             },
             {
-              "name": "drag-start",
               "type": {
                 "text": "CustomEvent"
               },
               "description": "Fired when the dialog drag is started.",
-              "inheritedFrom": {
-                "name": "DialogDraggableMixin",
-                "module": "src/vaadin-dialog-draggable-mixin.js"
-              }
+              "name": "drag-start"
             },
             {
-              "name": "dragged",
               "type": {
                 "text": "CustomEvent"
               },
               "description": "Fired when the dialog drag is finished.",
-              "inheritedFrom": {
-                "name": "DialogDraggableMixin",
-                "module": "src/vaadin-dialog-draggable-mixin.js"
-              }
+              "name": "dragged"
             },
             {
               "type": {
@@ -1412,26 +1367,18 @@
               "name": "opened-changed"
             },
             {
-              "name": "resize",
               "type": {
                 "text": "CustomEvent"
               },
               "description": "Fired when the dialog resize is finished.",
-              "inheritedFrom": {
-                "name": "DialogResizableMixin",
-                "module": "src/vaadin-dialog-resizable-mixin.js"
-              }
+              "name": "resize"
             },
             {
-              "name": "resize-start",
               "type": {
                 "text": "CustomEvent"
               },
               "description": "Fired when the dialog resize is started.",
-              "inheritedFrom": {
-                "name": "DialogResizableMixin",
-                "module": "src/vaadin-dialog-resizable-mixin.js"
-              }
+              "name": "resize-start"
             }
           ],
           "attributes": [
@@ -1448,38 +1395,24 @@
               }
             },
             {
-              "name": "footer-renderer",
-              "type": {
-                "text": "DialogRenderer | undefined"
-              },
-              "description": "Custom function for rendering the dialog footer.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.\n\nWhen `footerRenderer` is set, the attribute `has-footer` is set on the dialog.",
-              "deprecated": "Add footer content as children of the dialog using `slot=\"footer\"` instead",
-              "fieldName": "footerRenderer",
-              "inheritedFrom": {
-                "name": "DialogRendererMixin",
-                "module": "src/vaadin-dialog-renderer-mixin.js"
-              }
-            },
-            {
-              "name": "header-renderer",
+              "name": "header-title",
               "type": {
-                "text": "DialogRenderer | undefined"
+                "text": "string"
               },
-              "description": "Custom function for rendering the dialog header.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.\n\nIf both `headerTitle` and `headerRenderer` are defined, the title\nand the elements created by the renderer will be placed next to\neach other, with the title coming first.\n\nWhen `headerRenderer` is set, the attribute `has-header` is set on the dialog.",
-              "deprecated": "Add header content as children of the dialog using `slot=\"header-content\"` instead",
-              "fieldName": "headerRenderer",
+              "description": "String used for rendering a dialog title.\n\nIf both `headerTitle` and `headerRenderer` are defined, the title\nand the elements created by the renderer will be placed next to\neach other, with the title coming first.\n\nWhen `headerTitle` is set, the attribute `has-title` is set on the dialog.",
+              "fieldName": "headerTitle",
               "inheritedFrom": {
                 "name": "DialogRendererMixin",
                 "module": "src/vaadin-dialog-renderer-mixin.js"
               }
             },
             {
-              "name": "header-title",
+              "name": "heading-level",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "description": "String used for rendering a dialog title.\n\nIf both `headerTitle` and `headerRenderer` are defined, the title\nand the elements created by the renderer will be placed next to\neach other, with the title coming first.\n\nWhen `headerTitle` is set, the attribute `has-title` is set on the dialog.",
-              "fieldName": "headerTitle",
+              "description": "The ARIA heading level, used to set the `aria-level` attribute\non the title element. When not set, defaults to `1` for modal\ndialogs and `2` for modeless dialogs.",
+              "fieldName": "headingLevel",
               "inheritedFrom": {
                 "name": "DialogRendererMixin",
                 "module": "src/vaadin-dialog-renderer-mixin.js"
@@ -1607,19 +1540,6 @@
                 "module": "src/vaadin-dialog-base-mixin.js"
               }
             },
-            {
-              "name": "renderer",
-              "type": {
-                "text": "DialogRenderer | undefined"
-              },
-              "description": "Custom function for rendering the content of the dialog.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.",
-              "deprecated": "Add content elements as children of the dialog instead",
-              "fieldName": "renderer",
-              "inheritedFrom": {
-                "name": "DialogRendererMixin",
-                "module": "src/vaadin-dialog-renderer-mixin.js"
-              }
-            },
             {
               "name": "resizable",
               "type": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/dialog",
-  "version": "25.4.0-alpha2",
+  "version": "25.4.0-alpha4",
   "publishConfig": {
     "access": "public"
   },
@@ -37,19 +37,19 @@
   ],
   "dependencies": {
     "@open-wc/dedupe-mixin": "^1.3.0",
-    "@vaadin/a11y-base": "25.4.0-alpha2",
-    "@vaadin/component-base": "25.4.0-alpha2",
-    "@vaadin/lit-renderer": "25.4.0-alpha2",
-    "@vaadin/overlay": "25.4.0-alpha2",
-    "@vaadin/vaadin-themable-mixin": "25.4.0-alpha2",
+    "@vaadin/a11y-base": "25.4.0-alpha4",
+    "@vaadin/component-base": "25.4.0-alpha4",
+    "@vaadin/lit-renderer": "25.4.0-alpha4",
+    "@vaadin/overlay": "25.4.0-alpha4",
+    "@vaadin/vaadin-themable-mixin": "25.4.0-alpha4",
     "lit": "^3.0.0"
   },
   "devDependencies": {
-    "@vaadin/aura": "25.4.0-alpha2",
-    "@vaadin/chai-plugins": "25.4.0-alpha2",
-    "@vaadin/test-runner-commands": "25.4.0-alpha2",
+    "@vaadin/aura": "25.4.0-alpha4",
+    "@vaadin/chai-plugins": "25.4.0-alpha4",
+    "@vaadin/test-runner-commands": "25.4.0-alpha4",
     "@vaadin/testing-helpers": "^2.0.0",
-    "@vaadin/vaadin-lumo-styles": "25.4.0-alpha2",
+    "@vaadin/vaadin-lumo-styles": "25.4.0-alpha4",
     "sinon": "^22.0.0"
   },
   "customElements": "custom-elements.json",
@@ -57,5 +57,5 @@
     "web-types.json",
     "web-types.lit.json"
   ],
-  "gitHead": "213f8b55112558d2f976d8730fe44370ca868333"
+  "gitHead": "7809e4c099538333a6dbd11d8da18a0c6ec30dad"
 }

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

@@ -68,14 +68,18 @@ export const dialogOverlayBase = css`
 
   :host([theme~='no-padding']) [part='content'] {
     padding: 0 !important;
+    margin: 0 !important;
   }
 
+  /* Keep focus outlines inside the scrollable content's clipping area. */
   :host(:is([has-header], [has-title])) [part='content'] {
-    padding-top: 0;
+    padding-top: calc(var(--vaadin-focus-ring-width, 2px) + 2px);
+    margin-top: calc(var(--vaadin-focus-ring-width, 2px) * -1 - 2px);
   }
 
   :host([has-footer]) [part='content'] {
-    padding-bottom: 0;
+    padding-bottom: calc(var(--vaadin-focus-ring-width, 2px) + 2px);
+    margin-bottom: calc(var(--vaadin-focus-ring-width, 2px) * -1 - 2px);
   }
 
   [part='header'] {

package/src/vaadin-dialog-overlay-mixin.d.ts

@@ -25,6 +25,11 @@ export declare class DialogOverlayMixinClass {
    */
   headerTitle: string;
 
+  /**
+   * The ARIA heading level of the title.
+   */
+  headingLevel: number | null | undefined;
+
   /**
    * Whether to keep the overlay within the viewport.
    */

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

@@ -4,6 +4,7 @@
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
 import { getDeepActiveElement } from '@vaadin/a11y-base/src/focus-utils.js';
+import { setOrRemoveAttribute } from '@vaadin/component-base/src/dom-utils.js';
 import { SlotObserver } from '@vaadin/component-base/src/slot-observer.js';
 import { OverlayMixin } from '@vaadin/overlay/src/vaadin-overlay-mixin.js';
 import { setOverlayStateAttribute } from '@vaadin/overlay/src/vaadin-overlay-utils.js';
@@ -20,6 +21,13 @@ export const DialogOverlayMixin = (superClass) =>
           type: String,
         },
 
+        /**
+         * The ARIA heading level of the title.
+         */
+        headingLevel: {
+          type: Number,
+        },
+
         /**
          * Custom function for rendering the dialog header.
          */
@@ -127,6 +135,10 @@ export const DialogOverlayMixin = (superClass) =>
           window.removeEventListener('resize', this.__handleWindowResize);
         }
       }
+
+      if (props.has('headingLevel') && this.headerTitleElement) {
+        setOrRemoveAttribute(this.headerTitleElement, 'aria-level', this.headingLevel);
+      }
     }
 
     /** @private */
@@ -217,6 +229,7 @@ export const DialogOverlayMixin = (superClass) =>
         }
         this.owner.appendChild(this.headerTitleElement);
         this.headerTitleElement.textContent = this.headerTitle;
+        setOrRemoveAttribute(this.headerTitleElement, 'aria-level', this.headingLevel);
       } else if (this.headerTitleElement) {
         this.headerTitleElement.remove();
         this.headerTitleElement = null;

package/src/vaadin-dialog-renderer-mixin.d.ts

@@ -34,6 +34,15 @@ export declare class DialogRendererMixinClass {
    */
   headerTitle: string | null | undefined;
 
+  /**
+   * The ARIA heading level, used to set the `aria-level` attribute
+   * on the title element. When not set, defaults to `1` for modal
+   * dialogs and `2` for modeless dialogs.
+   *
+   * @attr {number} heading-level
+   */
+  headingLevel: number | null | undefined;
+
   /**
    * Custom function for rendering the dialog header.
    * Receives two arguments:

package/src/vaadin-dialog-renderer-mixin.js

@@ -35,6 +35,17 @@ export const DialogRendererMixin = (superClass) =>
           type: String,
         },
 
+        /**
+         * The ARIA heading level, used to set the `aria-level` attribute
+         * on the title element. When not set, defaults to `1` for modal
+         * dialogs and `2` for modeless dialogs.
+         *
+         * @attr {number} heading-level
+         */
+        headingLevel: {
+          type: Number,
+        },
+
         /**
          * Custom function for rendering the dialog header.
          * Receives two arguments:

package/src/vaadin-dialog.js

@@ -161,6 +161,7 @@ class Dialog extends DialogSizeMixin(
         .owner="${this}"
         .opened="${this.opened}"
         .headerTitle="${this.headerTitle}"
+        .headingLevel="${this.headingLevel ?? (this.modeless ? 2 : 1)}"
         .renderer="${this.renderer}"
         .headerRenderer="${this.headerRenderer}"
         .footerRenderer="${this.footerRenderer}"

package/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/dialog",
-  "version": "25.4.0-alpha2",
+  "version": "25.4.0-alpha4",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -28,6 +28,15 @@
                 ]
               }
             },
+            {
+              "name": "heading-level",
+              "description": "The ARIA heading level, used to set the `aria-level` attribute\non the title element. When not set, defaults to `1` for modal\ndialogs and `2` for modeless dialogs.",
+              "value": {
+                "type": [
+                  "number"
+                ]
+              }
+            },
             {
               "name": "height",
               "description": "Set the height of the dialog.\nIf a unitless number is provided, pixels are assumed.",
@@ -98,7 +107,8 @@
                 "type": [
                   "boolean"
                 ]
-              }
+              },
+              "deprecated": "This property is deprecated and will be removed in Vaadin 26."
             },
             {
               "name": "opened",
@@ -116,7 +126,8 @@
                 "type": [
                   "string"
                 ]
-              }
+              },
+              "deprecated": "Use standard `role` attribute on the dialog instead"
             },
             {
               "name": "resizable",
@@ -174,7 +185,8 @@
                     "DialogRenderer",
                     "undefined"
                   ]
-                }
+                },
+                "deprecated": "Add footer content as children of the dialog using `slot=\"footer\"` instead"
               },
               {
                 "name": "headerRenderer",
@@ -184,7 +196,8 @@
                     "DialogRenderer",
                     "undefined"
                   ]
-                }
+                },
+                "deprecated": "Add header content as children of the dialog using `slot=\"header-content\"` instead"
               },
               {
                 "name": "headerTitle",
@@ -195,6 +208,15 @@
                   ]
                 }
               },
+              {
+                "name": "headingLevel",
+                "description": "The ARIA heading level, used to set the `aria-level` attribute\non the title element. When not set, defaults to `1` for modal\ndialogs and `2` for modeless dialogs.",
+                "value": {
+                  "type": [
+                    "number"
+                  ]
+                }
+              },
               {
                 "name": "height",
                 "description": "Set the height of the dialog.\nIf a unitless number is provided, pixels are assumed.",
@@ -265,7 +287,8 @@
                   "type": [
                     "boolean"
                   ]
-                }
+                },
+                "deprecated": "This property is deprecated and will be removed in Vaadin 26."
               },
               {
                 "name": "opened",
@@ -283,7 +306,8 @@
                   "type": [
                     "string"
                   ]
-                }
+                },
+                "deprecated": "Use standard `role` attribute on the dialog instead"
               },
               {
                 "name": "renderer",
@@ -293,7 +317,8 @@
                     "DialogRenderer",
                     "undefined"
                   ]
-                }
+                },
+                "deprecated": "Add content elements as children of the dialog instead"
               },
               {
                 "name": "resizable",

package/web-types.lit.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/dialog",
-  "version": "25.4.0-alpha2",
+  "version": "25.4.0-alpha4",
   "description-markup": "markdown",
   "framework": "lit",
   "framework-config": {
@@ -31,14 +31,16 @@
               "description": "Custom function for rendering the dialog footer.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.\n\nWhen `footerRenderer` is set, the attribute `has-footer` is set on the dialog.",
               "value": {
                 "kind": "expression"
-              }
+              },
+              "deprecated": "Add footer content as children of the dialog using `slot=\"footer\"` instead"
             },
             {
               "name": ".headerRenderer",
               "description": "Custom function for rendering the dialog header.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.\n\nIf both `headerTitle` and `headerRenderer` are defined, the title\nand the elements created by the renderer will be placed next to\neach other, with the title coming first.\n\nWhen `headerRenderer` is set, the attribute `has-header` is set on the dialog.",
               "value": {
                 "kind": "expression"
-              }
+              },
+              "deprecated": "Add header content as children of the dialog using `slot=\"header-content\"` instead"
             },
             {
               "name": ".headerTitle",
@@ -47,6 +49,13 @@
                 "kind": "expression"
               }
             },
+            {
+              "name": ".headingLevel",
+              "description": "The ARIA heading level, used to set the `aria-level` attribute\non the title element. When not set, defaults to `1` for modal\ndialogs and `2` for modeless dialogs.",
+              "value": {
+                "kind": "expression"
+              }
+            },
             {
               "name": ".height",
               "description": "Set the height of the dialog.\nIf a unitless number is provided, pixels are assumed.",
@@ -101,7 +110,8 @@
               "description": "Set to true to prevent the dialog from receiving focus\non open and trapping it inside.\n\nA field with `autofocus` inside the dialog still receives\nfocus on open.",
               "value": {
                 "kind": "expression"
-              }
+              },
+              "deprecated": "This property is deprecated and will be removed in Vaadin 26."
             },
             {
               "name": "?opened",
@@ -115,14 +125,16 @@
               "description": "The `role` attribute value to be set on the dialog. Defaults to \"dialog\".",
               "value": {
                 "kind": "expression"
-              }
+              },
+              "deprecated": "Use standard `role` attribute on the dialog instead"
             },
             {
               "name": ".renderer",
               "description": "Custom function for rendering the content of the dialog.\nReceives two arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `dialog` The reference to the `<vaadin-dialog>` element.",
               "value": {
                 "kind": "expression"
-              }
+              },
+              "deprecated": "Add content elements as children of the dialog instead"
             },
             {
               "name": "?resizable",