@vaadin/a11y-base 25.2.0-alpha9 → 25.2.0-beta2

package/custom-elements.json

@@ -10,7 +10,22 @@
           "kind": "mixin",
           "description": "A mixin to toggle the `active` attribute.\n\nThe attribute is set whenever the user activates the element by a pointer\nor presses an activation key on the element from the keyboard.\n\nThe attribute is removed as soon as the element is deactivated\nby the pointer or by releasing the activation key.",
           "name": "ActiveMixin",
-          "members": [],
+          "members": [
+            {
+              "kind": "field",
+              "name": "disabled",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If true, the user cannot interact with this element.",
+              "attribute": "disabled",
+              "inheritedFrom": {
+                "name": "DisabledMixin",
+                "module": "src/disabled-mixin.js"
+              }
+            }
+          ],
           "mixins": [
             {
               "name": "DisabledMixin",
@@ -25,6 +40,20 @@
             {
               "name": "superclass"
             }
+          ],
+          "attributes": [
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If true, the user cannot interact with this element.",
+              "fieldName": "disabled",
+              "inheritedFrom": {
+                "name": "DisabledMixin",
+                "module": "src/disabled-mixin.js"
+              }
+            }
           ]
         }
       ],
@@ -44,9 +73,76 @@
       "path": "src/delegate-focus-mixin.js",
       "declarations": [
         {
-          "kind": "variable",
+          "kind": "mixin",
+          "description": "",
           "name": "DelegateFocusMixin",
-          "description": "A mixin to forward focus to an element in the light DOM."
+          "members": [
+            {
+              "kind": "field",
+              "name": "autofocus",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Specify that this control should have input focus when the page loads.",
+              "attribute": "autofocus"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If true, the user cannot interact with this element.",
+              "attribute": "disabled",
+              "inheritedFrom": {
+                "name": "DisabledMixin",
+                "module": "src/disabled-mixin.js"
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "autofocus",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Specify that this control should have input focus when the page loads.",
+              "fieldName": "autofocus"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If true, the user cannot interact with this element.",
+              "fieldName": "disabled",
+              "inheritedFrom": {
+                "name": "DisabledMixin",
+                "module": "src/disabled-mixin.js"
+              }
+            }
+          ],
+          "mixins": [
+            {
+              "name": "FocusMixin",
+              "module": "src/focus-mixin.js"
+            },
+            {
+              "name": "TabindexMixin",
+              "module": "src/tabindex-mixin.js"
+            },
+            {
+              "name": "dedupeMixin",
+              "package": "@open-wc/dedupe-mixin"
+            }
+          ],
+          "parameters": [
+            {
+              "name": "superclass"
+            }
+          ]
         }
       ],
       "exports": [
@@ -65,9 +161,42 @@
       "path": "src/disabled-mixin.js",
       "declarations": [
         {
-          "kind": "variable",
+          "kind": "mixin",
+          "description": "",
           "name": "DisabledMixin",
-          "description": "A mixin to provide disabled property for field components."
+          "members": [
+            {
+              "kind": "field",
+              "name": "disabled",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If true, the user cannot interact with this element.",
+              "attribute": "disabled"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If true, the user cannot interact with this element.",
+              "fieldName": "disabled"
+            }
+          ],
+          "parameters": [
+            {
+              "name": "superclass"
+            }
+          ],
+          "mixins": [
+            {
+              "name": "dedupeMixin",
+              "package": "@open-wc/dedupe-mixin"
+            }
+          ]
         }
       ],
       "exports": [
@@ -86,9 +215,21 @@
       "path": "src/focus-mixin.js",
       "declarations": [
         {
-          "kind": "variable",
+          "kind": "mixin",
+          "description": "",
           "name": "FocusMixin",
-          "description": "A mixin to handle `focused` and `focus-ring` attributes based on focus."
+          "members": [],
+          "parameters": [
+            {
+              "name": "superclass"
+            }
+          ],
+          "mixins": [
+            {
+              "name": "dedupeMixin",
+              "package": "@open-wc/dedupe-mixin"
+            }
+          ]
         }
       ],
       "exports": [
@@ -140,9 +281,21 @@
       "path": "src/keyboard-mixin.js",
       "declarations": [
         {
-          "kind": "variable",
+          "kind": "mixin",
+          "description": "",
           "name": "KeyboardMixin",
-          "description": "A mixin that manages keyboard handling.\nThe mixin subscribes to the keyboard events while an actual implementation\nfor the event handlers is left to the client (a component or another mixin)."
+          "members": [],
+          "parameters": [
+            {
+              "name": "superclass"
+            }
+          ],
+          "mixins": [
+            {
+              "name": "dedupeMixin",
+              "package": "@open-wc/dedupe-mixin"
+            }
+          ]
         }
       ],
       "exports": [
@@ -265,8 +418,36 @@
           "kind": "mixin",
           "description": "A mixin to toggle the `tabindex` attribute.\n\nThe attribute is set to -1 whenever the user disables the element\nand restored with the last known value once the element is enabled.",
           "name": "TabindexMixin",
-          "members": [],
-          "attributes": [],
+          "members": [
+            {
+              "kind": "field",
+              "name": "disabled",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If true, the user cannot interact with this element.",
+              "attribute": "disabled",
+              "inheritedFrom": {
+                "name": "DisabledMixin",
+                "module": "src/disabled-mixin.js"
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If true, the user cannot interact with this element.",
+              "fieldName": "disabled",
+              "inheritedFrom": {
+                "name": "DisabledMixin",
+                "module": "src/disabled-mixin.js"
+              }
+            }
+          ],
           "mixins": [
             {
               "name": "DisabledMixin",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/a11y-base",
-  "version": "25.2.0-alpha9",
+  "version": "25.2.0-beta2",
   "publishConfig": {
     "access": "public"
   },
@@ -32,15 +32,15 @@
   ],
   "dependencies": {
     "@open-wc/dedupe-mixin": "^1.3.0",
-    "@vaadin/component-base": "25.2.0-alpha9",
+    "@vaadin/component-base": "25.2.0-beta2",
     "lit": "^3.0.0"
   },
   "devDependencies": {
-    "@vaadin/chai-plugins": "25.2.0-alpha9",
-    "@vaadin/test-runner-commands": "25.2.0-alpha9",
+    "@vaadin/chai-plugins": "25.2.0-beta2",
+    "@vaadin/test-runner-commands": "25.2.0-beta2",
     "@vaadin/testing-helpers": "^2.0.0",
-    "sinon": "^21.0.2"
+    "sinon": "^22.0.0"
   },
   "customElements": "custom-elements.json",
-  "gitHead": "a38a03e8a8be45821f39c14054c63634dafe08d0"
+  "gitHead": "9e18feb8057baf278b72fec4e42657b19e48f499"
 }

package/src/active-mixin.d.ts

@@ -32,7 +32,7 @@ export declare class ActiveMixinClass {
   /**
    * Override to define if the component needs to be activated.
    */
-  protected _shouldSetFocus(event: KeyboardEvent | MouseEvent): boolean;
+  protected _shouldSetActive(event: KeyboardEvent | MouseEvent): boolean;
 
   /**
    * Toggles the `active` attribute on the element.

package/src/active-mixin.js

@@ -15,10 +15,6 @@ import { KeyboardMixin } from './keyboard-mixin.js';
  *
  * The attribute is removed as soon as the element is deactivated
  * by the pointer or by releasing the activation key.
- *
- * @polymerMixin
- * @mixes DisabledMixin
- * @mixes KeyboardMixin
  */
 export const ActiveMixin = (superclass) =>
   class ActiveMixinClass extends DisabledMixin(KeyboardMixin(superclass)) {

package/src/announce.js

@@ -23,7 +23,7 @@ let alertDebouncer;
  */
 export function announce(text, options = {}) {
   const mode = options.mode || 'polite';
-  const timeout = options.timeout === undefined ? 150 : options.timeout;
+  const timeout = options.timeout ?? 150;
 
   if (mode === 'alert') {
     region.removeAttribute('aria-live');

package/src/aria-hidden.js

@@ -27,7 +27,7 @@ let lockCount = 0;
  * @param {?Node} node
  * @return {boolean}
  */
-const isElement = (node) => node && node.nodeType === Node.ELEMENT_NODE;
+const isElement = (node) => node?.nodeType === Node.ELEMENT_NODE;
 
 /**
  * @param  {...unknown} args

package/src/aria-modal-controller.d.ts

@@ -3,13 +3,12 @@
  * Copyright (c) 2021 - 2026 Vaadin Ltd.
  * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
  */
-import type { ReactiveController } from 'lit';
 
 /**
  * A controller for handling modal state on the elements with `dialog` and `alertdialog` role.
  * See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-modal
  */
-export class AriaModalController implements ReactiveController {
+export class AriaModalController {
   /**
    * The controller host element.
    */
@@ -21,7 +20,7 @@ export class AriaModalController implements ReactiveController {
    */
   callback: () => HTMLElement | HTMLElement[];
 
-  constructor(node: HTMLElement);
+  constructor(host: HTMLElement, callback?: () => HTMLElement | HTMLElement[]);
 
   /**
    * Make the controller host element modal by trapping focus inside it and hiding