power-focusable 4.1.3 → 4.1.5

package/README.md

@@ -105,11 +105,14 @@ getFocusables(container, { composed: true });
 
 // Uses custom filter function
 getFocusables(container, { filter: (element) => !element.matches('[data-skip-focus]') });
+
+// Uses custom include function
+getFocusables(container, { filter: (element) => element.matches('[data-roving-tabindex]') });
 ```
 
 ### `getNextFocusable`
 
-Returns the next focusable element within the container, starting from `document.activeElement`.
+Returns the next focusable element within the container, starting from active element.
 
 ```ts
 getNextFocusable(container);
@@ -126,13 +129,16 @@ getNextFocusable(container, { composed: true });
 // Uses custom filter function
 getNextFocusable(container, { filter: (element) => !element.matches('[data-skip-focus]') });
 
+// Uses custom include function
+getNextFocusable(container, { filter: (element) => element.matches('[data-roving-tabindex]') });
+
 // Wraps around to the first element when reaching the end
 getNextFocusable(container, { wrap: true });
 ```
 
 ### `getPreviousFocusable`
 
-Returns the previous focusable element within the container, starting from `document.activeElement`.
+Returns the previous focusable element within the container, starting from active element.
 
 ```ts
 getPreviousFocusable(container);
@@ -149,7 +155,10 @@ getPreviousFocusable(container, { composed: true });
 // Uses custom filter function
 getPreviousFocusable(container, { filter: (element) => !element.matches('[data-skip-focus]') });
 
-//Wraps around to the last element when reaching the end
+// Uses custom include function
+getPreviousFocusable(container, { filter: (element) => element.matches('[data-roving-tabindex]') });
+
+// Wraps around to the last element when reaching the end
 getPreviousFocusable(container, { wrap: true });
 
 ```
@@ -169,6 +178,9 @@ hasFocusable(container, { composed: true });
 
 // Uses custom filter function
 hasFocusable(container, { filter: (element) => !element.matches('[data-skip-focus]') });
+
+// Uses custom include function
+hasFocusable(container, { filter: (element) => element.matches('[data-roving-tabindex]') });
 ```
 
 ### `inertOutside`

package/dist/index.cjs

@@ -6,10 +6,10 @@ function createFocusTrap(container = document.body) {
   if (!(container instanceof Element)) {
     throw new Error("Invalid container element");
   }
-  focus(container);
+  focusElement(container);
   if (getActiveElement() !== container) {
     const first = getFocusables(container, { composed: true })[0];
-    first && focus(first);
+    first && focusElement(first);
   }
   function onKeyDown(event) {
     const { key, altKey, ctrlKey, metaKey, shiftKey } = event;
@@ -27,7 +27,7 @@ function createFocusTrap(container = document.body) {
       return;
     }
     event.preventDefault();
-    focus(focusable);
+    focusElement(focusable);
   }
   let controller = new AbortController();
   document.addEventListener("keydown", onKeyDown, {
@@ -47,11 +47,11 @@ function getFocusables(container = document.body, options = {}) {
   const { composed = false } = options;
   let { filter, include } = options;
   if (filter && typeof filter !== "function") {
-    console.warn("Invalid filter function. Fallback: undefined.");
+    console.warn("Invalid filter function");
     filter = void 0;
   }
   if (include && typeof include !== "function") {
-    console.warn("Invalid include function. Fallback: undefined.");
+    console.warn("Invalid include function");
     include = void 0;
   }
   const elements = [];
@@ -177,7 +177,7 @@ function getRelativeFocusable(container, offset, options) {
     }
   }
   if (!containsComposed(container, anchor)) {
-    console.warn("Mismatch elements");
+    console.warn("Anchor (active) element not within container");
     return null;
   }
   const focusables = getFocusables(container, { composed, filter, include });
@@ -345,7 +345,7 @@ function applyInert(element) {
   }
   const count = inertRefCounts.get(element) ?? 0;
   inertRefCounts.set(element, count + 1);
-  count === 0 && element.toggleAttribute("inert", true);
+  count === 0 && element.setAttribute("inert", "");
   return true;
 }
 function restoreInert(element) {
@@ -355,12 +355,12 @@ function restoreInert(element) {
   }
   if (count === 1) {
     inertRefCounts.delete(element);
-    element.toggleAttribute("inert", false);
+    element.removeAttribute("inert");
     return;
   }
   inertRefCounts.set(element, count - 1);
 }
-function focus(element) {
+function focusElement(element) {
   "focus" in element && typeof element.focus === "function" && element.focus();
 }
 function getActiveElement() {
@@ -411,7 +411,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.1.3
+ * @version 4.1.5
  * @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.1.3
+ * @version 4.1.5
  * @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.1.3
+ * @version 4.1.5
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane

package/dist/index.js

@@ -4,10 +4,10 @@ function createFocusTrap(container = document.body) {
   if (!(container instanceof Element)) {
     throw new Error("Invalid container element");
   }
-  focus(container);
+  focusElement(container);
   if (getActiveElement() !== container) {
     const first = getFocusables(container, { composed: true })[0];
-    first && focus(first);
+    first && focusElement(first);
   }
   function onKeyDown(event) {
     const { key, altKey, ctrlKey, metaKey, shiftKey } = event;
@@ -25,7 +25,7 @@ function createFocusTrap(container = document.body) {
       return;
     }
     event.preventDefault();
-    focus(focusable);
+    focusElement(focusable);
   }
   let controller = new AbortController();
   document.addEventListener("keydown", onKeyDown, {
@@ -45,11 +45,11 @@ function getFocusables(container = document.body, options = {}) {
   const { composed = false } = options;
   let { filter, include } = options;
   if (filter && typeof filter !== "function") {
-    console.warn("Invalid filter function. Fallback: undefined.");
+    console.warn("Invalid filter function");
     filter = void 0;
   }
   if (include && typeof include !== "function") {
-    console.warn("Invalid include function. Fallback: undefined.");
+    console.warn("Invalid include function");
     include = void 0;
   }
   const elements = [];
@@ -175,7 +175,7 @@ function getRelativeFocusable(container, offset, options) {
     }
   }
   if (!containsComposed(container, anchor)) {
-    console.warn("Mismatch elements");
+    console.warn("Anchor (active) element not within container");
     return null;
   }
   const focusables = getFocusables(container, { composed, filter, include });
@@ -343,7 +343,7 @@ function applyInert(element) {
   }
   const count = inertRefCounts.get(element) ?? 0;
   inertRefCounts.set(element, count + 1);
-  count === 0 && element.toggleAttribute("inert", true);
+  count === 0 && element.setAttribute("inert", "");
   return true;
 }
 function restoreInert(element) {
@@ -353,12 +353,12 @@ function restoreInert(element) {
   }
   if (count === 1) {
     inertRefCounts.delete(element);
-    element.toggleAttribute("inert", false);
+    element.removeAttribute("inert");
     return;
   }
   inertRefCounts.set(element, count - 1);
 }
-function focus(element) {
+function focusElement(element) {
   "focus" in element && typeof element.focus === "function" && element.focus();
 }
 function getActiveElement() {
@@ -409,7 +409,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.1.3
+ * @version 4.1.5
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane

package/package.json

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