docs: deprecate overlayRole property in dialog and popover (#9880)

Author: web-padawan

packages/dialog/src/vaadin-dialog-base-mixin.d.ts

@@ -36,6 +36,7 @@ export declare class DialogBaseMixinClass {
    * The `role` attribute value to be set on the dialog. Defaults to "dialog".
    *
    * @attr {string} overlay-role
+   * @deprecated Use standard `role` attribute on the dialog instead
    */
   overlayRole: string;
 

packages/dialog/src/vaadin-dialog-base-mixin.js

@@ -80,6 +80,7 @@ export const DialogBaseMixin = (superClass) =>
          * The `role` attribute value to be set on the dialog. Defaults to "dialog".
          *
          * @attr {string} overlay-role
+         * @deprecated Use standard `role` attribute on the dialog instead
          */
         overlayRole: {
           type: String,

packages/popover/src/vaadin-popover.d.ts

@@ -163,6 +163,7 @@ declare class Popover extends PopoverPositionMixin(
    * The `role` attribute value to be set on the overlay.
    *
    * @attr {string} overlay-role
+   * @deprecated Use standard `role` attribute on the popover instead
    */
   overlayRole: string;
 

packages/popover/src/vaadin-popover.js

@@ -329,6 +329,7 @@ class Popover extends PopoverPositionMixin(
        * The `role` attribute value to be set on the overlay.
        *
        * @attr {string} overlay-role
+       * @deprecated Use standard `role` attribute on the popover instead
        */
       overlayRole: {
         type: String,