@asamuzakjp/dom-selector 7.1.1 → 8.0.0-a.1

package/package.json

@@ -25,7 +25,6 @@
   },
   "dependencies": {
     "@asamuzakjp/generational-cache": "^1.0.1",
-    "@asamuzakjp/nwsapi": "^2.3.9",
     "bidi-js": "^1.0.3",
     "css-tree": "^3.2.1",
     "is-potential-custom-element-name": "^1.0.1"
@@ -33,7 +32,6 @@
   "devDependencies": {
     "@types/css-tree": "^2.3.11",
     "@types/node": "^25.6.0",
-    "benchmark": "^2.1.4",
     "c8": "^11.0.0",
     "chai": "^6.2.2",
     "commander": "^14.0.3",
@@ -44,12 +42,13 @@
     "eslint-plugin-regexp": "^3.1.0",
     "eslint-plugin-unicorn": "^64.0.0",
     "globals": "^17.5.0",
-    "jsdom": "^29.0.2",
+    "jsdom": "^29.1.0",
     "mitata": "^1.0.34",
     "mocha": "^11.7.5",
     "neostandard": "^0.13.0",
     "prettier": "^3.8.3",
     "sinon": "^21.1.2",
+    "tinybench": "^6.0.1",
     "typescript": "^6.0.3",
     "wpt-runner": "^7.0.0"
   },
@@ -64,6 +63,7 @@
     "bench": "node benchmark/bench.js",
     "bench:cache": "node benchmark/bench-cache.js",
     "bench:cacheMonster": "node benchmark/bench-cache-monster.js",
+    "bench:nwsapi": "node benchmark/bench-nwsapi.js",
     "bench:sizzle": "node benchmark/bench-sizzle.js",
     "build": "npm run tsc && npm run lint && npm test",
     "lint": "eslint --fix .",
@@ -73,7 +73,7 @@
     "update:wpt": "git submodule update --init --recursive --remote"
   },
   "engines": {
-    "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+    "node": "^20.19.0 || ^22.13.0 || >=24.0.0"
   },
-  "version": "7.1.1"
+  "version": "8.0.0-a.1"
 }

package/src/index.js

@@ -8,8 +8,13 @@
 /* import */
 import { GenerationalCache } from '@asamuzakjp/generational-cache';
 import { Finder } from './js/finder.js';
-import { unescapeSelector, parseAstName } from './js/parser.js';
-import { filterSelector, getType, initNwsapi } from './js/utility.js';
+import { Nwsapi } from './js/nwsapi.js';
+import { extractSubjectsAst } from './js/parser.js';
+import {
+  filterSelector,
+  getType,
+  extractSubjectsRegExp
+} from './js/utility.js';
 
 /* constants */
 import {
@@ -19,14 +24,13 @@ import {
   TARGET_ALL,
   TARGET_FIRST,
   TARGET_LINEAL,
-  TARGET_SELF,
-  COMBINATOR,
-  ID_SELECTOR,
-  CLASS_SELECTOR,
-  TYPE_SELECTOR
+  TARGET_SELF
 } from './js/constant.js';
 const CACHE_SIZE = 2048;
 
+/* regexp */
+const REG_SELECTOR = /[[\]():\\"'`]/;
+
 /**
  * @typedef {object} CheckResult
  * @property {boolean} match - The match result.
@@ -54,10 +58,10 @@ export class DOMSelector {
     const { cacheSize, idlUtils } = opt;
     this.#window = window;
     this.#document = document ?? window.document;
-    this.#finder = new Finder(window);
     this.#idlUtils = idlUtils;
-    this.#nwsapi = initNwsapi(window, document);
     this.#cache = new GenerationalCache(cacheSize ?? CACHE_SIZE);
+    this.#finder = new Finder(this.#window);
+    this.#nwsapi = new Nwsapi(this.#window, this.#document);
   }
 
   /**
@@ -71,48 +75,28 @@ export class DOMSelector {
   /**
    * Parses a selector and extracts the rightmost subject keys (Id, Class, Tag).
    * @param {string} selector - The CSS selector to parse.
+   * @param {boolean} caseSensitive - True if tag key should be case sensitive.
    * @returns {Array<{id: string|null, className: string|null, tag: string|null}>} The list of extracted keys for each selector group.
    */
-  extractSubjects = selector => {
+  extractSubjects = (selector, caseSensitive = false) => {
     if (!selector || typeof selector !== 'string') {
       return [{ id: null, className: null, tag: null }];
     }
-    const cacheKey = `extract_${selector}`;
+    const cacheKey = `extract_${selector}_${caseSensitive}`;
     let subjects = this.#cache.get(cacheKey);
     if (subjects !== undefined) {
       return subjects;
     }
     subjects = [];
-    try {
-      const ast = this.#finder.getAST(selector);
-      if (ast?.type === 'SelectorList') {
-        for (const selectorNode of ast.children) {
-          let idKey = null;
-          let classKey = null;
-          let tagKey = null;
-          let current = selectorNode.children.tail;
-          while (current) {
-            const node = current.data;
-            if (node.type === COMBINATOR) {
-              break;
-            }
-            if (node.type === ID_SELECTOR) {
-              idKey = idKey ?? unescapeSelector(node.name);
-            } else if (node.type === CLASS_SELECTOR) {
-              classKey = classKey ?? unescapeSelector(node.name);
-            } else if (node.type === TYPE_SELECTOR) {
-              const { localName } = parseAstName(unescapeSelector(node.name));
-              if (localName !== '*') {
-                tagKey = tagKey ?? localName.toLowerCase();
-              }
-            }
-            current = current.prev;
-          }
-          subjects.push({ id: idKey, className: classKey, tag: tagKey });
-        }
+    if (!REG_SELECTOR.test(selector)) {
+      subjects = extractSubjectsRegExp(selector, caseSensitive);
+    } else {
+      try {
+        const ast = this.#finder.getAST(selector);
+        subjects = extractSubjectsAst(ast);
+      } catch (e) {
+        // fall through
       }
-    } catch (e) {
-      // fall through
     }
     if (!subjects.length) {
       subjects.push({ id: null, className: null, tag: null });

package/src/js/event-tracker.js

@@ -0,0 +1,131 @@
+/**
+ * event-tracker.js
+ */
+
+/* constants */
+const KEYS_MODIFIER = new Set([
+  'Alt',
+  'AltGraph',
+  'CapsLock',
+  'Control',
+  'Fn',
+  'FnLock',
+  'Hyper',
+  'Meta',
+  'NumLock',
+  'ScrollLock',
+  'Shift',
+  'Super',
+  'Symbol',
+  'SymbolLock'
+]);
+
+/**
+ * A class to track and manage browser events for the Finder.
+ */
+export class EventTracker {
+  #event = null;
+  #eventHandlers;
+  #focus = null;
+  #lastFocusVisible = null;
+  #window;
+
+  /**
+   * Creates an instance of EventTracker.
+   * @param {object} window - The browser window object.
+   */
+  constructor(window) {
+    this.#window = window;
+    this.#eventHandlers = new Set([
+      { keys: ['focus', 'focusin'], handler: this._handleFocusEvent },
+      { keys: ['keydown', 'keyup'], handler: this._handleKeyboardEvent },
+      {
+        keys: ['mouseover', 'mousedown', 'mouseup', 'click', 'mouseout'],
+        handler: this._handleMouseEvent
+      }
+    ]);
+    this._registerEventListeners();
+  }
+
+  /**
+   * Gets the last significant UI event.
+   * @returns {Event|null} The last event.
+   */
+  get event() {
+    return this.#event;
+  }
+
+  /**
+   * Gets the last focus event.
+   * @returns {FocusEvent|null} The last focus event.
+   */
+  get focus() {
+    return this.#focus;
+  }
+
+  /**
+   * Gets the last element that had a focus-visible state.
+   * @returns {Element|null} The last focus-visible element.
+   */
+  get lastFocusVisible() {
+    return this.#lastFocusVisible;
+  }
+
+  /**
+   * Sets the last element that had a focus-visible state.
+   * @param {Element|null} node - The element to set.
+   */
+  set lastFocusVisible(node) {
+    this.#lastFocusVisible = node;
+  }
+
+  /**
+   * Handles focus events.
+   * @private
+   * @param {FocusEvent} evt - The focus event.
+   */
+  _handleFocusEvent = evt => {
+    this.#focus = evt;
+  };
+
+  /**
+   * Handles keyboard events. Modifier keys are ignored.
+   * @private
+   * @param {KeyboardEvent} evt - The keyboard event.
+   */
+  _handleKeyboardEvent = evt => {
+    const { key } = evt;
+    if (!KEYS_MODIFIER.has(key)) {
+      this.#event = evt;
+    }
+  };
+
+  /**
+   * Handles mouse events.
+   * @private
+   * @param {MouseEvent} evt - The mouse event.
+   */
+  _handleMouseEvent = evt => {
+    this.#event = evt;
+  };
+
+  /**
+   * Registers event listeners to the window object.
+   * @private
+   * @returns {Array<void>} An array of return values from addEventListener.
+   */
+  _registerEventListeners = () => {
+    const func = [];
+    for (const { keys, handler } of this.#eventHandlers) {
+      for (const key of keys) {
+        func.push(
+          this.#window.addEventListener(key, handler, {
+            capture: true,
+            passive: true
+          })
+        );
+      }
+    }
+    return func;
+  };
+}