@y14e/roving-tabindex 1.3.1 → 1.3.2

package/README.md

@@ -44,6 +44,7 @@ interface RovingTabIndexOptions {
   direction?: 'horizontal' | 'vertical' | undefined; // default: both (undefined)
   navigationOnly?: boolean;                          // default: false
   selector?: string | undefined;
+  skipVisibilityCheck?: boolean;                     // default: false
   typeahead?: boolean;                               // default: false
   wrap?: boolean;                                    // default: false
 }
@@ -53,6 +54,10 @@ interface RovingTabIndexOptions {
 
 If `true`, enables keyboard navigation without modifying `tabindex`. Useful for widgets like accordions where all items should remain tabbable while still supporting arrow key navigation.
 
+### `skipVisibilityCheck`
+
+If `true`, skips `checkVisibility()` when determining focusability. Useful for initializing.
+
 ### `typeahead`
 
 If `true`, enables character-based focus navigation. Typing a character moves focus to the next matching element.

package/dist/index.cjs

@@ -79,6 +79,10 @@ function getFocusables(container = document.body, options = {}) {
     );
     include = void 0;
   }
+  if (typeof skipVisibilityCheck !== "boolean") {
+    console.warn("Invalid skipVisibilityCheck option. Fallback: false.");
+    skipVisibilityCheck = false;
+  }
   const elements = [];
   if (composed || include) {
     let traverse2 = function(node) {
@@ -280,6 +284,7 @@ function createRovingTabIndex(container, options = {}) {
     direction,
     navigationOnly = false,
     selector,
+    skipVisibilityCheck = false,
     typeahead = false,
     wrap = false
   } = options;
@@ -297,6 +302,10 @@ function createRovingTabIndex(container, options = {}) {
     );
     selector = void 0;
   }
+  if (typeof skipVisibilityCheck !== "boolean") {
+    console.warn("Invalid skipVisibilityCheck option. Fallback: false.");
+    skipVisibilityCheck = false;
+  }
   if (typeof typeahead !== "boolean") {
     console.warn("Invalid typeahead option. Fallback: false.");
     typeahead = false;
@@ -309,6 +318,7 @@ function createRovingTabIndex(container, options = {}) {
     direction,
     navigationOnly,
     selector,
+    skipVisibilityCheck,
     typeahead,
     wrap
   });
@@ -422,7 +432,7 @@ var RovingTabIndex = class {
       ...getFocusables(this.#container, {
         composed: true,
         filter: this.#selectorFilter,
-        skipVisibilityCheck: true
+        skipVisibilityCheck: !!this.#options.skipVisibilityCheck
       })
     ]);
     for (const focusable of this.#focusables) {
@@ -489,7 +499,7 @@ var RovingTabIndex = class {
       composed: true,
       filter: this.#selectorFilter,
       include: (element) => this.#focusables.has(element),
-      skipVisibilityCheck: true
+      skipVisibilityCheck: !!this.#options.skipVisibilityCheck
     });
   }
 };
@@ -508,7 +518,7 @@ function getActiveElement() {
  * Lightweight roving tabindex utility with fully focus management.
  * Designed for accessible menus, tabs, toolbars, and composite widgets.
  *
- * @version 1.3.1
+ * @version 1.3.2
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane
@@ -533,7 +543,7 @@ power-focusable/dist/index.js:
    * High-precision focus management utility with full composed tree support.
    * Handles complex focus rules including tabindex ordering, radio groups, inert.
    *
-   * @version 4.2.0
+   * @version 4.2.1
    * @author Yusuke Kamiyamane
    * @license MIT
    * @copyright Copyright (c) Yusuke Kamiyamane

package/dist/index.d.cts

@@ -3,7 +3,7 @@
  * Lightweight roving tabindex utility with fully focus management.
  * Designed for accessible menus, tabs, toolbars, and composite widgets.
  *
- * @version 1.3.1
+ * @version 1.3.2
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane
@@ -13,6 +13,7 @@ interface RovingTabIndexOptions {
     readonly direction?: 'horizontal' | 'vertical' | undefined;
     readonly navigationOnly?: boolean;
     readonly selector?: string | undefined;
+    readonly skipVisibilityCheck?: boolean;
     readonly typeahead?: boolean;
     readonly wrap?: boolean;
 }

package/dist/index.d.ts

@@ -3,7 +3,7 @@
  * Lightweight roving tabindex utility with fully focus management.
  * Designed for accessible menus, tabs, toolbars, and composite widgets.
  *
- * @version 1.3.1
+ * @version 1.3.2
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane
@@ -13,6 +13,7 @@ interface RovingTabIndexOptions {
     readonly direction?: 'horizontal' | 'vertical' | undefined;
     readonly navigationOnly?: boolean;
     readonly selector?: string | undefined;
+    readonly skipVisibilityCheck?: boolean;
     readonly typeahead?: boolean;
     readonly wrap?: boolean;
 }

package/dist/index.js

@@ -77,6 +77,10 @@ function getFocusables(container = document.body, options = {}) {
     );
     include = void 0;
   }
+  if (typeof skipVisibilityCheck !== "boolean") {
+    console.warn("Invalid skipVisibilityCheck option. Fallback: false.");
+    skipVisibilityCheck = false;
+  }
   const elements = [];
   if (composed || include) {
     let traverse2 = function(node) {
@@ -278,6 +282,7 @@ function createRovingTabIndex(container, options = {}) {
     direction,
     navigationOnly = false,
     selector,
+    skipVisibilityCheck = false,
     typeahead = false,
     wrap = false
   } = options;
@@ -295,6 +300,10 @@ function createRovingTabIndex(container, options = {}) {
     );
     selector = void 0;
   }
+  if (typeof skipVisibilityCheck !== "boolean") {
+    console.warn("Invalid skipVisibilityCheck option. Fallback: false.");
+    skipVisibilityCheck = false;
+  }
   if (typeof typeahead !== "boolean") {
     console.warn("Invalid typeahead option. Fallback: false.");
     typeahead = false;
@@ -307,6 +316,7 @@ function createRovingTabIndex(container, options = {}) {
     direction,
     navigationOnly,
     selector,
+    skipVisibilityCheck,
     typeahead,
     wrap
   });
@@ -420,7 +430,7 @@ var RovingTabIndex = class {
       ...getFocusables(this.#container, {
         composed: true,
         filter: this.#selectorFilter,
-        skipVisibilityCheck: true
+        skipVisibilityCheck: !!this.#options.skipVisibilityCheck
       })
     ]);
     for (const focusable of this.#focusables) {
@@ -487,7 +497,7 @@ var RovingTabIndex = class {
       composed: true,
       filter: this.#selectorFilter,
       include: (element) => this.#focusables.has(element),
-      skipVisibilityCheck: true
+      skipVisibilityCheck: !!this.#options.skipVisibilityCheck
     });
   }
 };
@@ -506,7 +516,7 @@ function getActiveElement() {
  * Lightweight roving tabindex utility with fully focus management.
  * Designed for accessible menus, tabs, toolbars, and composite widgets.
  *
- * @version 1.3.1
+ * @version 1.3.2
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane
@@ -531,7 +541,7 @@ power-focusable/dist/index.js:
    * High-precision focus management utility with full composed tree support.
    * Handles complex focus rules including tabindex ordering, radio groups, inert.
    *
-   * @version 4.2.0
+   * @version 4.2.1
    * @author Yusuke Kamiyamane
    * @license MIT
    * @copyright Copyright (c) Yusuke Kamiyamane

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@y14e/roving-tabindex",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "description": "Lightweight roving tabindex utility with fully focus management",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -50,7 +50,7 @@
   "devDependencies": {
     "@y14e/attributes-utils": "^1.0.5",
     "bun-types": "latest",
-    "power-focusable": "^4.2.0",
+    "power-focusable": "^4.2.1",
     "tsup": "^8.0.0",
     "typescript": "^5.6.0"
   },