@y14e/roving-tabindex 3.1.24 → 3.1.26

package/README.md

@@ -13,11 +13,11 @@ npm i @y14e/roving-tabindex
 import { createRovingTabIndex } from '@y14e/roving-tabindex';
 
 // CDNs
-import { createRovingTabIndex } from 'https://esm.sh/@y14e/roving-tabindex@3.1.24';
+import { createRovingTabIndex } from 'https://esm.sh/@y14e/roving-tabindex@3.1.26';
 // or
-import { createRovingTabIndex } from 'https://cdn.jsdelivr.net/npm/@y14e/roving-tabindex@3.1.24/+esm';
+import { createRovingTabIndex } from 'https://cdn.jsdelivr.net/npm/@y14e/roving-tabindex@3.1.26/+esm';
 // or
-import { createRovingTabIndex } from 'https://esm.unpkg.com/@y14e/roving-tabindex@3.1.24';
+import { createRovingTabIndex } from 'https://esm.unpkg.com/@y14e/roving-tabindex@3.1.26';
 ```
 
 ## 📦 APIs

package/dist/index.bundle.cjs

@@ -4,12 +4,11 @@
 var DEFAULT_PARSER = (value) => value.split(/\s+/);
 var DEFAULT_SERIALIZER = (tokens) => tokens.join(" ");
 function addAttributeToken(element, name, token, options = {}) {
+  if (!isValid(element, name, token)) {
+    return;
+  }
   const value = element.getAttribute(name)?.trim();
-  const {
-    caseInsensitive = false,
-    parse = DEFAULT_PARSER,
-    serialize = DEFAULT_SERIALIZER
-  } = options;
+  const { caseInsensitive, parse, serialize } = resolveOptions(options);
   const tokens = value ? parse(value).filter(Boolean) : [];
   if (caseInsensitive) {
     const lower = token.toLowerCase();
@@ -49,6 +48,45 @@ function saveAttributes(element_or_elements, name_or_names) {
     });
   });
 }
+function isValid(element, name, token) {
+  if (!(element instanceof Element)) {
+    console.warn("Invalid element");
+    return false;
+  }
+  if (!element.hasAttribute(name)) {
+    console.warn("Invalid attribute name");
+    return false;
+  }
+  if (typeof token !== "string" || !token.trim()) {
+    console.warn("Invalid token");
+    return false;
+  }
+  return true;
+}
+function resolveOptions(options) {
+  let {
+    caseInsensitive = false,
+    parse = DEFAULT_PARSER,
+    serialize = DEFAULT_SERIALIZER
+  } = options;
+  if (typeof caseInsensitive !== "boolean") {
+    console.warn("Invalid caseInsensitive option. Fallback: false.");
+    caseInsensitive = false;
+  }
+  if (typeof parse !== "function") {
+    console.warn(
+      "Invalid parser. Fallback: default parser (splits by whitespace)."
+    );
+    parse = DEFAULT_PARSER;
+  }
+  if (typeof serialize !== "function") {
+    console.warn(
+      "Invalid serializer. Fallback: default serializer (joins by whitespace)."
+    );
+    serialize = DEFAULT_SERIALIZER;
+  }
+  return { caseInsensitive, parse, serialize };
+}
 
 // node_modules/power-focusable/dist/index.js
 var FOCUSABLE_SELECTOR = `:is(a[href], area[href], button, embed, iframe, input:not([type="hidden" i]), object, select, details > summary:first-of-type, textarea, [contenteditable]:not([contenteditable="false" i]), [controls], [tabindex]):not(:disabled, [hidden], [inert], [tabindex="-1"])`;
@@ -340,64 +378,7 @@ var RovingTabIndex = class _RovingTabIndex {
   #isDestroyed = false;
   constructor(container, options = {}) {
     this.#container = container;
-    let {
-      direction = "both",
-      navigationOnly = false,
-      noMemory = false,
-      noStart = false,
-      selector = "",
-      typeahead = false,
-      wrap = false
-    } = options;
-    if (!["both", "horizontal", "vertical"].includes(direction)) {
-      console.warn("Invalid direction option. Fallback: 'both'.");
-      direction = "both";
-    }
-    if (typeof navigationOnly !== "boolean") {
-      console.warn("Invalid navigationOnly option. Fallback: false.");
-      navigationOnly = false;
-    }
-    if (typeof noMemory !== "boolean") {
-      console.warn("Invalid noMemory option. Fallback: false.");
-      noMemory = false;
-    }
-    if (typeof noStart !== "boolean") {
-      console.warn("Invalid noStart option. Fallback: false.");
-      noStart = false;
-    }
-    if (selector !== "") {
-      let hasError = false;
-      if (typeof selector !== "string" || !selector.trim()) {
-        hasError = true;
-      } else {
-        try {
-          this.#container.querySelector(selector);
-        } catch {
-          hasError = true;
-        }
-      }
-      if (hasError) {
-        console.warn("Invalid selector. Fallback: no selector string.");
-        selector = "";
-      }
-    }
-    if (typeof typeahead !== "boolean") {
-      console.warn("Invalid typeahead option. Fallback: false.");
-      typeahead = false;
-    }
-    if (typeof wrap !== "boolean") {
-      console.warn("Invalid wrap option. Fallback: false.");
-      wrap = false;
-    }
-    this.#settings = {
-      direction,
-      navigationOnly,
-      noMemory,
-      noStart,
-      selector,
-      typeahead,
-      wrap
-    };
+    this.#settings = this.#resolveOptions(options);
     this.#selectorFilter = this.#createSelectorFilter();
     this.#initialize();
   }
@@ -585,13 +566,65 @@ var RovingTabIndex = class _RovingTabIndex {
       skipVisibilityCheck: true
     });
   }
+  #resolveOptions(options) {
+    let {
+      direction = "both",
+      navigationOnly = false,
+      noMemory = false,
+      noStart = false,
+      selector = "",
+      typeahead = false,
+      wrap = false
+    } = options;
+    if (!["both", "horizontal", "vertical"].includes(direction)) {
+      console.warn("Invalid direction option. Fallback: 'both'.");
+      direction = "both";
+    }
+    if (typeof navigationOnly !== "boolean") {
+      console.warn("Invalid navigationOnly option. Fallback: false.");
+      navigationOnly = false;
+    }
+    if (typeof noMemory !== "boolean") {
+      console.warn("Invalid noMemory option. Fallback: false.");
+      noMemory = false;
+    }
+    if (typeof noStart !== "boolean") {
+      console.warn("Invalid noStart option. Fallback: false.");
+      noStart = false;
+    }
+    if (selector !== "") {
+      try {
+        document.querySelector(selector);
+      } catch {
+        console.warn("Invalid selector. Fallback: no selector string.");
+        selector = "";
+      }
+    }
+    if (typeof typeahead !== "boolean") {
+      console.warn("Invalid typeahead option. Fallback: false.");
+      typeahead = false;
+    }
+    if (typeof wrap !== "boolean") {
+      console.warn("Invalid wrap option. Fallback: false.");
+      wrap = false;
+    }
+    return {
+      direction,
+      navigationOnly,
+      noMemory,
+      noStart,
+      selector,
+      typeahead,
+      wrap
+    };
+  }
 };
 /**
  * Roving Tabindex
  * Lightweight roving tabindex utility with fully focus management.
  * Designed for accessible menus, tabs, toolbars, and composite widgets.
  *
- * @version 3.1.24
+ * @version 3.1.26
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane
@@ -603,7 +636,7 @@ var RovingTabIndex = class _RovingTabIndex {
   (**
    * Attribute Utils
    *
-   * @version 2.0.5
+   * @version 2.0.6
    * @author Yusuke Kamiyamane
    * @license MIT
    * @copyright Copyright (c) Yusuke Kamiyamane
@@ -616,7 +649,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.3.26
+   * @version 4.3.28
    * @author Yusuke Kamiyamane
    * @license MIT
    * @copyright Copyright (c) Yusuke Kamiyamane

package/dist/index.bundle.js

@@ -2,12 +2,11 @@
 var DEFAULT_PARSER = (value) => value.split(/\s+/);
 var DEFAULT_SERIALIZER = (tokens) => tokens.join(" ");
 function addAttributeToken(element, name, token, options = {}) {
+  if (!isValid(element, name, token)) {
+    return;
+  }
   const value = element.getAttribute(name)?.trim();
-  const {
-    caseInsensitive = false,
-    parse = DEFAULT_PARSER,
-    serialize = DEFAULT_SERIALIZER
-  } = options;
+  const { caseInsensitive, parse, serialize } = resolveOptions(options);
   const tokens = value ? parse(value).filter(Boolean) : [];
   if (caseInsensitive) {
     const lower = token.toLowerCase();
@@ -47,6 +46,45 @@ function saveAttributes(element_or_elements, name_or_names) {
     });
   });
 }
+function isValid(element, name, token) {
+  if (!(element instanceof Element)) {
+    console.warn("Invalid element");
+    return false;
+  }
+  if (!element.hasAttribute(name)) {
+    console.warn("Invalid attribute name");
+    return false;
+  }
+  if (typeof token !== "string" || !token.trim()) {
+    console.warn("Invalid token");
+    return false;
+  }
+  return true;
+}
+function resolveOptions(options) {
+  let {
+    caseInsensitive = false,
+    parse = DEFAULT_PARSER,
+    serialize = DEFAULT_SERIALIZER
+  } = options;
+  if (typeof caseInsensitive !== "boolean") {
+    console.warn("Invalid caseInsensitive option. Fallback: false.");
+    caseInsensitive = false;
+  }
+  if (typeof parse !== "function") {
+    console.warn(
+      "Invalid parser. Fallback: default parser (splits by whitespace)."
+    );
+    parse = DEFAULT_PARSER;
+  }
+  if (typeof serialize !== "function") {
+    console.warn(
+      "Invalid serializer. Fallback: default serializer (joins by whitespace)."
+    );
+    serialize = DEFAULT_SERIALIZER;
+  }
+  return { caseInsensitive, parse, serialize };
+}
 
 // node_modules/power-focusable/dist/index.js
 var FOCUSABLE_SELECTOR = `:is(a[href], area[href], button, embed, iframe, input:not([type="hidden" i]), object, select, details > summary:first-of-type, textarea, [contenteditable]:not([contenteditable="false" i]), [controls], [tabindex]):not(:disabled, [hidden], [inert], [tabindex="-1"])`;
@@ -338,64 +376,7 @@ var RovingTabIndex = class _RovingTabIndex {
   #isDestroyed = false;
   constructor(container, options = {}) {
     this.#container = container;
-    let {
-      direction = "both",
-      navigationOnly = false,
-      noMemory = false,
-      noStart = false,
-      selector = "",
-      typeahead = false,
-      wrap = false
-    } = options;
-    if (!["both", "horizontal", "vertical"].includes(direction)) {
-      console.warn("Invalid direction option. Fallback: 'both'.");
-      direction = "both";
-    }
-    if (typeof navigationOnly !== "boolean") {
-      console.warn("Invalid navigationOnly option. Fallback: false.");
-      navigationOnly = false;
-    }
-    if (typeof noMemory !== "boolean") {
-      console.warn("Invalid noMemory option. Fallback: false.");
-      noMemory = false;
-    }
-    if (typeof noStart !== "boolean") {
-      console.warn("Invalid noStart option. Fallback: false.");
-      noStart = false;
-    }
-    if (selector !== "") {
-      let hasError = false;
-      if (typeof selector !== "string" || !selector.trim()) {
-        hasError = true;
-      } else {
-        try {
-          this.#container.querySelector(selector);
-        } catch {
-          hasError = true;
-        }
-      }
-      if (hasError) {
-        console.warn("Invalid selector. Fallback: no selector string.");
-        selector = "";
-      }
-    }
-    if (typeof typeahead !== "boolean") {
-      console.warn("Invalid typeahead option. Fallback: false.");
-      typeahead = false;
-    }
-    if (typeof wrap !== "boolean") {
-      console.warn("Invalid wrap option. Fallback: false.");
-      wrap = false;
-    }
-    this.#settings = {
-      direction,
-      navigationOnly,
-      noMemory,
-      noStart,
-      selector,
-      typeahead,
-      wrap
-    };
+    this.#settings = this.#resolveOptions(options);
     this.#selectorFilter = this.#createSelectorFilter();
     this.#initialize();
   }
@@ -583,13 +564,65 @@ var RovingTabIndex = class _RovingTabIndex {
       skipVisibilityCheck: true
     });
   }
+  #resolveOptions(options) {
+    let {
+      direction = "both",
+      navigationOnly = false,
+      noMemory = false,
+      noStart = false,
+      selector = "",
+      typeahead = false,
+      wrap = false
+    } = options;
+    if (!["both", "horizontal", "vertical"].includes(direction)) {
+      console.warn("Invalid direction option. Fallback: 'both'.");
+      direction = "both";
+    }
+    if (typeof navigationOnly !== "boolean") {
+      console.warn("Invalid navigationOnly option. Fallback: false.");
+      navigationOnly = false;
+    }
+    if (typeof noMemory !== "boolean") {
+      console.warn("Invalid noMemory option. Fallback: false.");
+      noMemory = false;
+    }
+    if (typeof noStart !== "boolean") {
+      console.warn("Invalid noStart option. Fallback: false.");
+      noStart = false;
+    }
+    if (selector !== "") {
+      try {
+        document.querySelector(selector);
+      } catch {
+        console.warn("Invalid selector. Fallback: no selector string.");
+        selector = "";
+      }
+    }
+    if (typeof typeahead !== "boolean") {
+      console.warn("Invalid typeahead option. Fallback: false.");
+      typeahead = false;
+    }
+    if (typeof wrap !== "boolean") {
+      console.warn("Invalid wrap option. Fallback: false.");
+      wrap = false;
+    }
+    return {
+      direction,
+      navigationOnly,
+      noMemory,
+      noStart,
+      selector,
+      typeahead,
+      wrap
+    };
+  }
 };
 /**
  * Roving Tabindex
  * Lightweight roving tabindex utility with fully focus management.
  * Designed for accessible menus, tabs, toolbars, and composite widgets.
  *
- * @version 3.1.24
+ * @version 3.1.26
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane
@@ -601,7 +634,7 @@ var RovingTabIndex = class _RovingTabIndex {
   (**
    * Attribute Utils
    *
-   * @version 2.0.5
+   * @version 2.0.6
    * @author Yusuke Kamiyamane
    * @license MIT
    * @copyright Copyright (c) Yusuke Kamiyamane
@@ -614,7 +647,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.3.26
+   * @version 4.3.28
    * @author Yusuke Kamiyamane
    * @license MIT
    * @copyright Copyright (c) Yusuke Kamiyamane

package/dist/index.cjs

@@ -45,64 +45,7 @@ var RovingTabIndex = class _RovingTabIndex {
   #isDestroyed = false;
   constructor(container, options = {}) {
     this.#container = container;
-    let {
-      direction = "both",
-      navigationOnly = false,
-      noMemory = false,
-      noStart = false,
-      selector = "",
-      typeahead = false,
-      wrap = false
-    } = options;
-    if (!["both", "horizontal", "vertical"].includes(direction)) {
-      console.warn("Invalid direction option. Fallback: 'both'.");
-      direction = "both";
-    }
-    if (typeof navigationOnly !== "boolean") {
-      console.warn("Invalid navigationOnly option. Fallback: false.");
-      navigationOnly = false;
-    }
-    if (typeof noMemory !== "boolean") {
-      console.warn("Invalid noMemory option. Fallback: false.");
-      noMemory = false;
-    }
-    if (typeof noStart !== "boolean") {
-      console.warn("Invalid noStart option. Fallback: false.");
-      noStart = false;
-    }
-    if (selector !== "") {
-      let hasError = false;
-      if (typeof selector !== "string" || !selector.trim()) {
-        hasError = true;
-      } else {
-        try {
-          this.#container.querySelector(selector);
-        } catch {
-          hasError = true;
-        }
-      }
-      if (hasError) {
-        console.warn("Invalid selector. Fallback: no selector string.");
-        selector = "";
-      }
-    }
-    if (typeof typeahead !== "boolean") {
-      console.warn("Invalid typeahead option. Fallback: false.");
-      typeahead = false;
-    }
-    if (typeof wrap !== "boolean") {
-      console.warn("Invalid wrap option. Fallback: false.");
-      wrap = false;
-    }
-    this.#settings = {
-      direction,
-      navigationOnly,
-      noMemory,
-      noStart,
-      selector,
-      typeahead,
-      wrap
-    };
+    this.#settings = this.#resolveOptions(options);
     this.#selectorFilter = this.#createSelectorFilter();
     this.#initialize();
   }
@@ -290,13 +233,65 @@ var RovingTabIndex = class _RovingTabIndex {
       skipVisibilityCheck: true
     });
   }
+  #resolveOptions(options) {
+    let {
+      direction = "both",
+      navigationOnly = false,
+      noMemory = false,
+      noStart = false,
+      selector = "",
+      typeahead = false,
+      wrap = false
+    } = options;
+    if (!["both", "horizontal", "vertical"].includes(direction)) {
+      console.warn("Invalid direction option. Fallback: 'both'.");
+      direction = "both";
+    }
+    if (typeof navigationOnly !== "boolean") {
+      console.warn("Invalid navigationOnly option. Fallback: false.");
+      navigationOnly = false;
+    }
+    if (typeof noMemory !== "boolean") {
+      console.warn("Invalid noMemory option. Fallback: false.");
+      noMemory = false;
+    }
+    if (typeof noStart !== "boolean") {
+      console.warn("Invalid noStart option. Fallback: false.");
+      noStart = false;
+    }
+    if (selector !== "") {
+      try {
+        document.querySelector(selector);
+      } catch {
+        console.warn("Invalid selector. Fallback: no selector string.");
+        selector = "";
+      }
+    }
+    if (typeof typeahead !== "boolean") {
+      console.warn("Invalid typeahead option. Fallback: false.");
+      typeahead = false;
+    }
+    if (typeof wrap !== "boolean") {
+      console.warn("Invalid wrap option. Fallback: false.");
+      wrap = false;
+    }
+    return {
+      direction,
+      navigationOnly,
+      noMemory,
+      noStart,
+      selector,
+      typeahead,
+      wrap
+    };
+  }
 };
 /**
  * Roving Tabindex
  * Lightweight roving tabindex utility with fully focus management.
  * Designed for accessible menus, tabs, toolbars, and composite widgets.
  *
- * @version 3.1.24
+ * @version 3.1.26
  * @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 3.1.24
+ * @version 3.1.26
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane

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 3.1.24
+ * @version 3.1.26
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane

package/dist/index.js

@@ -22,64 +22,7 @@ var RovingTabIndex = class _RovingTabIndex {
   #isDestroyed = false;
   constructor(container, options = {}) {
     this.#container = container;
-    let {
-      direction = "both",
-      navigationOnly = false,
-      noMemory = false,
-      noStart = false,
-      selector = "",
-      typeahead = false,
-      wrap = false
-    } = options;
-    if (!["both", "horizontal", "vertical"].includes(direction)) {
-      console.warn("Invalid direction option. Fallback: 'both'.");
-      direction = "both";
-    }
-    if (typeof navigationOnly !== "boolean") {
-      console.warn("Invalid navigationOnly option. Fallback: false.");
-      navigationOnly = false;
-    }
-    if (typeof noMemory !== "boolean") {
-      console.warn("Invalid noMemory option. Fallback: false.");
-      noMemory = false;
-    }
-    if (typeof noStart !== "boolean") {
-      console.warn("Invalid noStart option. Fallback: false.");
-      noStart = false;
-    }
-    if (selector !== "") {
-      let hasError = false;
-      if (typeof selector !== "string" || !selector.trim()) {
-        hasError = true;
-      } else {
-        try {
-          this.#container.querySelector(selector);
-        } catch {
-          hasError = true;
-        }
-      }
-      if (hasError) {
-        console.warn("Invalid selector. Fallback: no selector string.");
-        selector = "";
-      }
-    }
-    if (typeof typeahead !== "boolean") {
-      console.warn("Invalid typeahead option. Fallback: false.");
-      typeahead = false;
-    }
-    if (typeof wrap !== "boolean") {
-      console.warn("Invalid wrap option. Fallback: false.");
-      wrap = false;
-    }
-    this.#settings = {
-      direction,
-      navigationOnly,
-      noMemory,
-      noStart,
-      selector,
-      typeahead,
-      wrap
-    };
+    this.#settings = this.#resolveOptions(options);
     this.#selectorFilter = this.#createSelectorFilter();
     this.#initialize();
   }
@@ -267,13 +210,65 @@ var RovingTabIndex = class _RovingTabIndex {
       skipVisibilityCheck: true
     });
   }
+  #resolveOptions(options) {
+    let {
+      direction = "both",
+      navigationOnly = false,
+      noMemory = false,
+      noStart = false,
+      selector = "",
+      typeahead = false,
+      wrap = false
+    } = options;
+    if (!["both", "horizontal", "vertical"].includes(direction)) {
+      console.warn("Invalid direction option. Fallback: 'both'.");
+      direction = "both";
+    }
+    if (typeof navigationOnly !== "boolean") {
+      console.warn("Invalid navigationOnly option. Fallback: false.");
+      navigationOnly = false;
+    }
+    if (typeof noMemory !== "boolean") {
+      console.warn("Invalid noMemory option. Fallback: false.");
+      noMemory = false;
+    }
+    if (typeof noStart !== "boolean") {
+      console.warn("Invalid noStart option. Fallback: false.");
+      noStart = false;
+    }
+    if (selector !== "") {
+      try {
+        document.querySelector(selector);
+      } catch {
+        console.warn("Invalid selector. Fallback: no selector string.");
+        selector = "";
+      }
+    }
+    if (typeof typeahead !== "boolean") {
+      console.warn("Invalid typeahead option. Fallback: false.");
+      typeahead = false;
+    }
+    if (typeof wrap !== "boolean") {
+      console.warn("Invalid wrap option. Fallback: false.");
+      wrap = false;
+    }
+    return {
+      direction,
+      navigationOnly,
+      noMemory,
+      noStart,
+      selector,
+      typeahead,
+      wrap
+    };
+  }
 };
 /**
  * Roving Tabindex
  * Lightweight roving tabindex utility with fully focus management.
  * Designed for accessible menus, tabs, toolbars, and composite widgets.
  *
- * @version 3.1.24
+ * @version 3.1.26
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@y14e/roving-tabindex",
-  "version": "3.1.24",
+  "version": "3.1.26",
   "description": "Lightweight roving tabindex utility with fully focus management",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -59,7 +59,7 @@
     "esbuild": true
   },
   "dependencies": {
-    "@y14e/attribute-utils": "^2.0.5",
-    "power-focusable": "^4.3.26"
+    "@y14e/attribute-utils": "^2.0.6",
+    "power-focusable": "^4.3.28"
   }
 }