power-focusable 4.3.18 → 4.3.19

package/README.md

@@ -24,11 +24,11 @@ import {
 } from 'power-focusable';
 
 // CDNs
-import { ... } 'https://esm.sh/power-focusable@4.3.18';
+import { ... } 'https://esm.sh/power-focusable@4.3.19';
 // or
-import { ... } 'https://cdn.jsdelivr.net/npm/power-focusable@4.3.18/+esm';
+import { ... } 'https://cdn.jsdelivr.net/npm/power-focusable@4.3.19/+esm';
 // or
-import { ... } 'https://esm.unpkg.com/power-focusable@4.3.18';
+import { ... } 'https://esm.unpkg.com/power-focusable@4.3.19';
 ```
 
 ## 🪄 Options

package/dist/index.cjs

@@ -96,14 +96,14 @@ function getFocusables(container = document.body, options = {}) {
     console.warn("Invalid skipVisibilityCheck option. Fallback: false.");
     skipVisibilityCheck = false;
   }
-  const elements = [];
+  const candidates = [];
   if (composed || include) {
     let traverse2 = function(node) {
       if (isFocusable(node, {
         skipNegativeTabIndexCheck,
         skipVisibilityCheck
       }) || include?.(node)) {
-        elements[elements.length] = node;
+        candidates[candidates.length] = node;
       }
       const children2 = composed ? getComposedChildren(node) : getChildren(node);
       for (let i = 0, l = children2.length; i < l; i++) {
@@ -117,21 +117,22 @@ function getFocusables(container = document.body, options = {}) {
       child && traverse2(child);
     }
   } else {
-    const candidates = container.querySelectorAll(
+    const matches = container.querySelectorAll(
       skipNegativeTabIndexCheck ? FOCUSABLE_SELECTOR_WITH_NEGATIVE_TABINDEX : FOCUSABLE_SELECTOR
     );
-    for (let i = 0, l = candidates.length; i < l; i++) {
-      const candidate = candidates[i];
-      if (candidate && isFocusable(candidate, {
+    for (let i = 0, l = matches.length; i < l; i++) {
+      const matched = matches[i];
+      if (matched && isFocusable(matched, {
         skipNegativeTabIndexCheck,
         skipVisibilityCheck
       })) {
-        elements[elements.length] = candidate;
+        candidates[candidates.length] = matched;
       }
     }
   }
-  const filtered = filter ? elements.filter(filter) : elements;
-  return normalizeRadioGroup(sortByTabIndex(filtered));
+  return normalizeRadioGroup(
+    sortByTabIndex(filter ? candidates.filter(filter) : candidates)
+  );
 }
 function getNextFocusable(container = document.body, options = {}) {
   return getRelativeFocusable(container, 1, options);
@@ -265,12 +266,12 @@ function getRelativeFocusable(container, offset, options) {
     skipNegativeTabIndexCheck,
     skipVisibilityCheck
   };
-  const candidates = getFocusables(container, settings);
-  const { length } = candidates;
+  const focusables = getFocusables(container, settings);
+  const { length } = focusables;
   if (!length) {
     return null;
   }
-  const anchorIndex = candidates.indexOf(anchor);
+  const anchorIndex = focusables.indexOf(anchor);
   if (anchorIndex === -1) {
     return null;
   }
@@ -278,7 +279,7 @@ function getRelativeFocusable(container, offset, options) {
   if ((offsetIndex < 0 || offsetIndex >= length) && !wrap) {
     return null;
   }
-  return candidates[(offsetIndex + length) % length] ?? null;
+  return focusables[(offsetIndex + length) % length] ?? null;
 }
 function isDisabledDeep(element) {
   let current = element;
@@ -493,7 +494,7 @@ function isUngroupedRadio(element) {
  * High-precision focus management utility with full composed tree support.
  * Handles complex focus rules including tabindex ordering, radio groups, inert.
  *
- * @version 4.3.18
+ * @version 4.3.19
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane

package/dist/index.d.cts

@@ -3,7 +3,7 @@
  * High-precision focus management utility with full composed tree support.
  * Handles complex focus rules including tabindex ordering, radio groups, inert.
  *
- * @version 4.3.18
+ * @version 4.3.19
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane

package/dist/index.d.ts

@@ -3,7 +3,7 @@
  * High-precision focus management utility with full composed tree support.
  * Handles complex focus rules including tabindex ordering, radio groups, inert.
  *
- * @version 4.3.18
+ * @version 4.3.19
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane

package/dist/index.js

@@ -94,14 +94,14 @@ function getFocusables(container = document.body, options = {}) {
     console.warn("Invalid skipVisibilityCheck option. Fallback: false.");
     skipVisibilityCheck = false;
   }
-  const elements = [];
+  const candidates = [];
   if (composed || include) {
     let traverse2 = function(node) {
       if (isFocusable(node, {
         skipNegativeTabIndexCheck,
         skipVisibilityCheck
       }) || include?.(node)) {
-        elements[elements.length] = node;
+        candidates[candidates.length] = node;
       }
       const children2 = composed ? getComposedChildren(node) : getChildren(node);
       for (let i = 0, l = children2.length; i < l; i++) {
@@ -115,21 +115,22 @@ function getFocusables(container = document.body, options = {}) {
       child && traverse2(child);
     }
   } else {
-    const candidates = container.querySelectorAll(
+    const matches = container.querySelectorAll(
       skipNegativeTabIndexCheck ? FOCUSABLE_SELECTOR_WITH_NEGATIVE_TABINDEX : FOCUSABLE_SELECTOR
     );
-    for (let i = 0, l = candidates.length; i < l; i++) {
-      const candidate = candidates[i];
-      if (candidate && isFocusable(candidate, {
+    for (let i = 0, l = matches.length; i < l; i++) {
+      const matched = matches[i];
+      if (matched && isFocusable(matched, {
         skipNegativeTabIndexCheck,
         skipVisibilityCheck
       })) {
-        elements[elements.length] = candidate;
+        candidates[candidates.length] = matched;
       }
     }
   }
-  const filtered = filter ? elements.filter(filter) : elements;
-  return normalizeRadioGroup(sortByTabIndex(filtered));
+  return normalizeRadioGroup(
+    sortByTabIndex(filter ? candidates.filter(filter) : candidates)
+  );
 }
 function getNextFocusable(container = document.body, options = {}) {
   return getRelativeFocusable(container, 1, options);
@@ -263,12 +264,12 @@ function getRelativeFocusable(container, offset, options) {
     skipNegativeTabIndexCheck,
     skipVisibilityCheck
   };
-  const candidates = getFocusables(container, settings);
-  const { length } = candidates;
+  const focusables = getFocusables(container, settings);
+  const { length } = focusables;
   if (!length) {
     return null;
   }
-  const anchorIndex = candidates.indexOf(anchor);
+  const anchorIndex = focusables.indexOf(anchor);
   if (anchorIndex === -1) {
     return null;
   }
@@ -276,7 +277,7 @@ function getRelativeFocusable(container, offset, options) {
   if ((offsetIndex < 0 || offsetIndex >= length) && !wrap) {
     return null;
   }
-  return candidates[(offsetIndex + length) % length] ?? null;
+  return focusables[(offsetIndex + length) % length] ?? null;
 }
 function isDisabledDeep(element) {
   let current = element;
@@ -491,7 +492,7 @@ function isUngroupedRadio(element) {
  * High-precision focus management utility with full composed tree support.
  * Handles complex focus rules including tabindex ordering, radio groups, inert.
  *
- * @version 4.3.18
+ * @version 4.3.19
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "power-focusable",
-  "version": "4.3.18",
+  "version": "4.3.19",
   "description": "High-precision focus management utility with full composed tree support",
   "type": "module",
   "main": "./dist/index.cjs",