@y14e/tabs 1.5.1 → 1.5.3

package/README.md

@@ -10,14 +10,14 @@ npm i @y14e/tabs
 
 ```ts
 // npm
-import Tabs from '@y14e/tabs';
+import Tabs from '@y14e/tabs@1.5.3';
 
 // CDNs
-import Tabs from 'https://esm.sh/@y14e/tabs'
+import Tabs from 'https://esm.sh/@y14e/tabs@1.5.3';
 // or
-import Tabs from 'https://cdn.jsdelivr.net/npm/@y14e/tabs/+esm';
+import Tabs from 'https://cdn.jsdelivr.net/npm/@y14e/tabs@1.5.3/+esm';
 // or
-import Tabs from 'https://unpkg.com/@y14e/tabs/dist/index.js';
+import Tabs from 'https://esm.unpkg.com/@y14e/tabs@1.5.3';
 ```
 
 ## Usage

package/dist/index.cjs

@@ -165,6 +165,7 @@ function getFocusables(container = document.body, options = {}) {
     composed = false,
     filter,
     include,
+    skipNegativeTabIndexCheck = false,
     skipVisibilityCheck = false
   } = options;
   if (typeof composed !== "boolean") {
@@ -183,6 +184,10 @@ function getFocusables(container = document.body, options = {}) {
     );
     include = void 0;
   }
+  if (typeof skipNegativeTabIndexCheck !== "boolean") {
+    console.warn("Invalid skipNegativeTabIndexCheck option. Fallback: false.");
+    skipNegativeTabIndexCheck = false;
+  }
   if (typeof skipVisibilityCheck !== "boolean") {
     console.warn("Invalid skipVisibilityCheck option. Fallback: false.");
     skipVisibilityCheck = false;
@@ -191,7 +196,10 @@ function getFocusables(container = document.body, options = {}) {
   if (composed || include) {
     let traverse2 = function(node) {
       if (node instanceof Element) {
-        if (isFocusable(node, { skipVisibilityCheck }) || include?.(node)) {
+        if (isFocusable(node, {
+          skipNegativeTabIndexCheck,
+          skipVisibilityCheck
+        }) || include?.(node)) {
           elements[elements.length] = node;
         }
       }
@@ -212,7 +220,10 @@ function getFocusables(container = document.body, options = {}) {
       if (!(candidate instanceof Element)) {
         continue;
       }
-      if (isFocusable(candidate, { skipVisibilityCheck })) {
+      if (isFocusable(candidate, {
+        skipNegativeTabIndexCheck,
+        skipVisibilityCheck
+      })) {
         elements[elements.length] = candidate;
       }
     }
@@ -225,7 +236,11 @@ function isFocusable(element, options = {}) {
     console.warn("Invalid element");
     return false;
   }
-  let { skipVisibilityCheck = false } = options;
+  let { skipNegativeTabIndexCheck = false, skipVisibilityCheck = false } = options;
+  if (typeof skipNegativeTabIndexCheck !== "boolean") {
+    console.warn("Invalid skipNegativeTabIndexCheck option. Fallback: false.");
+    skipNegativeTabIndexCheck = false;
+  }
   if (typeof skipVisibilityCheck !== "boolean") {
     console.warn("Invalid skipVisibilityCheck option. Fallback: false.");
     skipVisibilityCheck = false;
@@ -233,10 +248,12 @@ function isFocusable(element, options = {}) {
   if (element.hasAttribute("hidden") || isInert(element)) {
     return false;
   }
-  if (getTabIndex(element) < 0) {
+  if (!skipNegativeTabIndexCheck && getTabIndex(element) < 0) {
     return false;
   }
-  if (!element.matches(FOCUSABLE_SELECTOR)) {
+  if (!element.matches(
+    skipNegativeTabIndexCheck ? FOCUSABLE_SELECTOR.replace(/(,\s*)?\[tabindex="-1"\]/g, "") : FOCUSABLE_SELECTOR
+  )) {
     return false;
   }
   if (isDisabledDeep(element)) {
@@ -386,7 +403,6 @@ function createRovingTabIndex(container, options = {}) {
     direction,
     navigationOnly = false,
     selector,
-    skipVisibilityCheck = false,
     typeahead = false,
     wrap = false
   } = options;
@@ -404,10 +420,6 @@ 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;
@@ -416,14 +428,14 @@ function createRovingTabIndex(container, options = {}) {
     console.warn("Invalid wrap option. Fallback: false.");
     wrap = false;
   }
-  const roving = new RovingTabIndex(container, {
-    direction,
-    navigationOnly,
-    selector,
-    skipVisibilityCheck,
-    typeahead,
-    wrap
-  });
+  const settings = { navigationOnly, typeahead, wrap };
+  if (direction !== void 0) {
+    Object.assign(settings, { direction });
+  }
+  if (selector !== void 0) {
+    Object.assign(settings, { selector });
+  }
+  const roving = new RovingTabIndex(container, settings);
   return () => roving.destroy();
 }
 var RovingTabIndex = class {
@@ -465,8 +477,8 @@ var RovingTabIndex = class {
     if (!event.composedPath().includes(this.#container)) {
       return;
     }
-    const { key, altKey, ctrlKey, metaKey } = event;
-    if (altKey || ctrlKey || metaKey) {
+    const { key, altKey, ctrlKey, metaKey, shiftKey } = event;
+    if (altKey || ctrlKey || metaKey || shiftKey) {
       return;
     }
     const { direction, typeahead, wrap } = this.#options;
@@ -529,14 +541,7 @@ var RovingTabIndex = class {
     focusElement(focusable);
   };
   #update(active) {
-    const current = /* @__PURE__ */ new Set([
-      ...this.#getFocusables(),
-      ...getFocusables(this.#container, {
-        composed: true,
-        filter: this.#selectorFilter,
-        skipVisibilityCheck: !!this.#options.skipVisibilityCheck
-      })
-    ]);
+    const current = new Set(this.#getFocusables());
     for (const focusable of this.#focusables) {
       if (current.has(focusable)) {
         continue;
@@ -600,8 +605,7 @@ var RovingTabIndex = class {
     return getFocusables(this.#container, {
       composed: true,
       filter: this.#selectorFilter,
-      include: (element) => this.#focusables.has(element),
-      skipVisibilityCheck: !!this.#options.skipVisibilityCheck
+      skipNegativeTabIndexCheck: !this.#options.navigationOnly
     });
   }
 };
@@ -964,15 +968,14 @@ var Tabs = class _Tabs {
         signal
       });
     });
+    const options = { selector: this.#settings.selector.tab, wrap: true };
     this.#listElements.forEach((list) => {
-      this.#cleanupsRovingTabIndex.push(
-        createRovingTabIndex(list, {
-          direction: list.ariaOrientation === "undefined" ? void 0 : this.#settings.vertical ? "vertical" : "horizontal",
-          selector: this.#settings.selector.tab,
-          skipVisibilityCheck: true,
-          wrap: true
-        })
-      );
+      if (list.ariaOrientation !== "undefined") {
+        Object.assign(options, {
+          direction: this.#settings.vertical ? "vertical" : "horizontal"
+        });
+      }
+      this.#cleanupsRovingTabIndex.push(createRovingTabIndex(list, options));
       list.querySelectorAll(this.#settings.selector.tab).forEach((tab) => {
         tab.setAttribute(
           "tabindex",
@@ -1140,7 +1143,7 @@ function isFocusable2(element) {
  * Tabs
  * WAI-ARIA compliant tabs pattern implementation in TypeScript.
  *
- * @version 1.5.1
+ * @version 1.5.3
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane
@@ -1152,7 +1155,7 @@ function isFocusable2(element) {
   (**
    * Attributes Utils
    *
-   * @version 1.0.5
+   * @version 1.1.0
    * @author Yusuke Kamiyamane
    * @license MIT
    * @copyright Copyright (c) Yusuke Kamiyamane
@@ -1176,7 +1179,7 @@ function isFocusable2(element) {
    * Lightweight roving tabindex utility with fully focus management.
    * Designed for accessible menus, tabs, toolbars, and composite widgets.
    *
-   * @version 1.3.2
+   * @version 2.0.3
    * @author Yusuke Kamiyamane
    * @license MIT
    * @copyright Copyright (c) Yusuke Kamiyamane
@@ -1188,7 +1191,7 @@ function isFocusable2(element) {
     (**
      * Attributes Utils
      *
-     * @version 1.0.5
+     * @version 1.1.0
      * @author Yusuke Kamiyamane
      * @license MIT
      * @copyright Copyright (c) Yusuke Kamiyamane
@@ -1201,7 +1204,7 @@ function isFocusable2(element) {
      * High-precision focus management utility with full composed tree support.
      * Handles complex focus rules including tabindex ordering, radio groups, inert.
      *
-     * @version 4.2.1
+     * @version 4.3.1
      * @author Yusuke Kamiyamane
      * @license MIT
      * @copyright Copyright (c) Yusuke Kamiyamane

package/dist/index.d.cts

@@ -2,7 +2,7 @@
  * Tabs
  * WAI-ARIA compliant tabs pattern implementation in TypeScript.
  *
- * @version 1.5.1
+ * @version 1.5.3
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane

package/dist/index.d.ts

@@ -2,7 +2,7 @@
  * Tabs
  * WAI-ARIA compliant tabs pattern implementation in TypeScript.
  *
- * @version 1.5.1
+ * @version 1.5.3
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane

package/dist/index.js

@@ -163,6 +163,7 @@ function getFocusables(container = document.body, options = {}) {
     composed = false,
     filter,
     include,
+    skipNegativeTabIndexCheck = false,
     skipVisibilityCheck = false
   } = options;
   if (typeof composed !== "boolean") {
@@ -181,6 +182,10 @@ function getFocusables(container = document.body, options = {}) {
     );
     include = void 0;
   }
+  if (typeof skipNegativeTabIndexCheck !== "boolean") {
+    console.warn("Invalid skipNegativeTabIndexCheck option. Fallback: false.");
+    skipNegativeTabIndexCheck = false;
+  }
   if (typeof skipVisibilityCheck !== "boolean") {
     console.warn("Invalid skipVisibilityCheck option. Fallback: false.");
     skipVisibilityCheck = false;
@@ -189,7 +194,10 @@ function getFocusables(container = document.body, options = {}) {
   if (composed || include) {
     let traverse2 = function(node) {
       if (node instanceof Element) {
-        if (isFocusable(node, { skipVisibilityCheck }) || include?.(node)) {
+        if (isFocusable(node, {
+          skipNegativeTabIndexCheck,
+          skipVisibilityCheck
+        }) || include?.(node)) {
           elements[elements.length] = node;
         }
       }
@@ -210,7 +218,10 @@ function getFocusables(container = document.body, options = {}) {
       if (!(candidate instanceof Element)) {
         continue;
       }
-      if (isFocusable(candidate, { skipVisibilityCheck })) {
+      if (isFocusable(candidate, {
+        skipNegativeTabIndexCheck,
+        skipVisibilityCheck
+      })) {
         elements[elements.length] = candidate;
       }
     }
@@ -223,7 +234,11 @@ function isFocusable(element, options = {}) {
     console.warn("Invalid element");
     return false;
   }
-  let { skipVisibilityCheck = false } = options;
+  let { skipNegativeTabIndexCheck = false, skipVisibilityCheck = false } = options;
+  if (typeof skipNegativeTabIndexCheck !== "boolean") {
+    console.warn("Invalid skipNegativeTabIndexCheck option. Fallback: false.");
+    skipNegativeTabIndexCheck = false;
+  }
   if (typeof skipVisibilityCheck !== "boolean") {
     console.warn("Invalid skipVisibilityCheck option. Fallback: false.");
     skipVisibilityCheck = false;
@@ -231,10 +246,12 @@ function isFocusable(element, options = {}) {
   if (element.hasAttribute("hidden") || isInert(element)) {
     return false;
   }
-  if (getTabIndex(element) < 0) {
+  if (!skipNegativeTabIndexCheck && getTabIndex(element) < 0) {
     return false;
   }
-  if (!element.matches(FOCUSABLE_SELECTOR)) {
+  if (!element.matches(
+    skipNegativeTabIndexCheck ? FOCUSABLE_SELECTOR.replace(/(,\s*)?\[tabindex="-1"\]/g, "") : FOCUSABLE_SELECTOR
+  )) {
     return false;
   }
   if (isDisabledDeep(element)) {
@@ -384,7 +401,6 @@ function createRovingTabIndex(container, options = {}) {
     direction,
     navigationOnly = false,
     selector,
-    skipVisibilityCheck = false,
     typeahead = false,
     wrap = false
   } = options;
@@ -402,10 +418,6 @@ 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;
@@ -414,14 +426,14 @@ function createRovingTabIndex(container, options = {}) {
     console.warn("Invalid wrap option. Fallback: false.");
     wrap = false;
   }
-  const roving = new RovingTabIndex(container, {
-    direction,
-    navigationOnly,
-    selector,
-    skipVisibilityCheck,
-    typeahead,
-    wrap
-  });
+  const settings = { navigationOnly, typeahead, wrap };
+  if (direction !== void 0) {
+    Object.assign(settings, { direction });
+  }
+  if (selector !== void 0) {
+    Object.assign(settings, { selector });
+  }
+  const roving = new RovingTabIndex(container, settings);
   return () => roving.destroy();
 }
 var RovingTabIndex = class {
@@ -463,8 +475,8 @@ var RovingTabIndex = class {
     if (!event.composedPath().includes(this.#container)) {
       return;
     }
-    const { key, altKey, ctrlKey, metaKey } = event;
-    if (altKey || ctrlKey || metaKey) {
+    const { key, altKey, ctrlKey, metaKey, shiftKey } = event;
+    if (altKey || ctrlKey || metaKey || shiftKey) {
       return;
     }
     const { direction, typeahead, wrap } = this.#options;
@@ -527,14 +539,7 @@ var RovingTabIndex = class {
     focusElement(focusable);
   };
   #update(active) {
-    const current = /* @__PURE__ */ new Set([
-      ...this.#getFocusables(),
-      ...getFocusables(this.#container, {
-        composed: true,
-        filter: this.#selectorFilter,
-        skipVisibilityCheck: !!this.#options.skipVisibilityCheck
-      })
-    ]);
+    const current = new Set(this.#getFocusables());
     for (const focusable of this.#focusables) {
       if (current.has(focusable)) {
         continue;
@@ -598,8 +603,7 @@ var RovingTabIndex = class {
     return getFocusables(this.#container, {
       composed: true,
       filter: this.#selectorFilter,
-      include: (element) => this.#focusables.has(element),
-      skipVisibilityCheck: !!this.#options.skipVisibilityCheck
+      skipNegativeTabIndexCheck: !this.#options.navigationOnly
     });
   }
 };
@@ -962,15 +966,14 @@ var Tabs = class _Tabs {
         signal
       });
     });
+    const options = { selector: this.#settings.selector.tab, wrap: true };
     this.#listElements.forEach((list) => {
-      this.#cleanupsRovingTabIndex.push(
-        createRovingTabIndex(list, {
-          direction: list.ariaOrientation === "undefined" ? void 0 : this.#settings.vertical ? "vertical" : "horizontal",
-          selector: this.#settings.selector.tab,
-          skipVisibilityCheck: true,
-          wrap: true
-        })
-      );
+      if (list.ariaOrientation !== "undefined") {
+        Object.assign(options, {
+          direction: this.#settings.vertical ? "vertical" : "horizontal"
+        });
+      }
+      this.#cleanupsRovingTabIndex.push(createRovingTabIndex(list, options));
       list.querySelectorAll(this.#settings.selector.tab).forEach((tab) => {
         tab.setAttribute(
           "tabindex",
@@ -1138,7 +1141,7 @@ function isFocusable2(element) {
  * Tabs
  * WAI-ARIA compliant tabs pattern implementation in TypeScript.
  *
- * @version 1.5.1
+ * @version 1.5.3
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane
@@ -1150,7 +1153,7 @@ function isFocusable2(element) {
   (**
    * Attributes Utils
    *
-   * @version 1.0.5
+   * @version 1.1.0
    * @author Yusuke Kamiyamane
    * @license MIT
    * @copyright Copyright (c) Yusuke Kamiyamane
@@ -1174,7 +1177,7 @@ function isFocusable2(element) {
    * Lightweight roving tabindex utility with fully focus management.
    * Designed for accessible menus, tabs, toolbars, and composite widgets.
    *
-   * @version 1.3.2
+   * @version 2.0.3
    * @author Yusuke Kamiyamane
    * @license MIT
    * @copyright Copyright (c) Yusuke Kamiyamane
@@ -1186,7 +1189,7 @@ function isFocusable2(element) {
     (**
      * Attributes Utils
      *
-     * @version 1.0.5
+     * @version 1.1.0
      * @author Yusuke Kamiyamane
      * @license MIT
      * @copyright Copyright (c) Yusuke Kamiyamane
@@ -1199,7 +1202,7 @@ function isFocusable2(element) {
      * High-precision focus management utility with full composed tree support.
      * Handles complex focus rules including tabindex ordering, radio groups, inert.
      *
-     * @version 4.2.1
+     * @version 4.3.1
      * @author Yusuke Kamiyamane
      * @license MIT
      * @copyright Copyright (c) Yusuke Kamiyamane

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@y14e/tabs",
-  "version": "1.5.1",
+  "version": "1.5.3",
   "description": "WAI-ARIA compliant tabs pattern implementation in TypeScript",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -42,9 +42,9 @@
   },
   "homepage": "https://github.com/y14e/tabs#readme",
   "devDependencies": {
-    "@y14e/attributes-utils": "^1.0.5",
+    "@y14e/attributes-utils": "^1.1.0",
     "@y14e/button": "^1.0.0",
-    "@y14e/roving-tabindex": "^1.3.2",
+    "@y14e/roving-tabindex": "^2.0.3",
     "bun-types": "latest",
     "tsup": "^8.0.0",
     "typescript": "^5.6.0",