@miaskiewicz/turbo-dom 0.1.20 → 0.1.21

package/README.md

@@ -105,13 +105,17 @@ the suite row (ms/file, lower = faster):
 
 | benchmark | turbo-dom | happy-dom | jsdom |
 |---|---:|---:|---:|
-| **per-file setup + 1 query** (ops/s) | **5,950** | 611 | 260 |
-| **realistic suite**, 200 files (ms/file) | **0.13** | 1.50 | 3.38 |
+| **per-file setup + 1 query** (ops/s) | **5,900** | 600 | 250 |
+| **realistic suite**, 200 files (ms/file) | **0.15** | 2.1 | 4.9 |
 | **parse 56 KB SSR** (ops/s) | **478** | 43 | 26 |
 | **parse 20 KB real page** (ops/s) | **4,203** | 190 | 114 |
-| repeated query throughput (iters/s) | **915k** | 615k | 3k |
+| repeated query throughput (iters/s) | **920k** | 600k | 3k |
 | html5lib conformance | **99.72%** | 37.35% | 97.03% |
 
+Roughly **~25–30× jsdom** and **~10–14× happy-dom** on per-file setup / realistic
+suites, **18–37×** on parsing, and it edges happy-dom on repeated queries while
+staying 99.7% spec-correct.
+
 **turbo-dom wins across the board on what test suites actually do**: per-file
 construction (~10× happy-dom, ~23× jsdom), parsing, realistic suites (~10× happy-dom,
 ~23× jsdom), spec-correctness (99.7% vs 37%), **and** repeated queries.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miaskiewicz/turbo-dom",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "description": "Faster, more spec-correct DOM for test runners — native html5ever (Rust/WASM) parser + lazy copy-on-write DOM. A drop-in-style alternative to jsdom/happy-dom for vitest & jest.",
   "license": "MIT",
   "main": "index.js",

package/src/runtime/dom.mjs

@@ -98,8 +98,12 @@ export class Node extends EventTarget {
   }
 
   get childNodes() {
+    // the NodeList reads __children() live, so one cached object per node is
+    // always correct — avoids re-allocating a Proxy on every .childNodes access
+    // (React/RTL hit this constantly).
+    if (this.__childNodesList) return this.__childNodesList;
     const self = this;
-    return liveNodeList(() => self.__children());
+    return (this.__childNodesList = liveNodeList(() => self.__children()));
   }
   get firstChild() { const k = this.__children(); return k[0] ?? null; }
   get lastChild() { const k = this.__children(); return k[k.length - 1] ?? null; }
@@ -523,8 +527,9 @@ export class Element extends Node {
 
   // ---- element-only traversal (live) ----
   get children() {
+    if (this.__childrenList) return this.__childrenList;
     const self = this;
-    return liveHTMLCollection(() => self.__children().filter((n) => n.nodeType === ELEMENT_NODE));
+    return (this.__childrenList = liveHTMLCollection(() => self.__children().filter((n) => n.nodeType === ELEMENT_NODE)));
   }
   get childElementCount() { return this.__children().filter((n) => n.nodeType === ELEMENT_NODE).length; }
   get firstElementChild() { return this.__children().find((n) => n.nodeType === ELEMENT_NODE) ?? null; }
@@ -750,7 +755,7 @@ export class DocumentFragment extends Node {
   get nodeName() { return '#document-fragment'; }
   querySelector(sel) { return cachedQS(this, sel); }
   querySelectorAll(sel) { return cachedQSA(this, sel); }
-  get children() { const self = this; return liveHTMLCollection(() => self.__children().filter((n) => n.nodeType === ELEMENT_NODE)); }
+  get children() { if (this.__childrenList) return this.__childrenList; const self = this; return (this.__childrenList = liveHTMLCollection(() => self.__children().filter((n) => n.nodeType === ELEMENT_NODE))); }
   append(...nodes) { for (const n of nodes) this.appendChild(toNode(this.ownerDocument, n)); }
   cloneNode(deep = false) { const f = new DocumentFragment(this.ownerDocument); if (deep) for (const c of this.__children()) f.appendChild(c.cloneNode(true)); return f; }
 }

package/src/runtime/events.mjs

@@ -150,8 +150,20 @@ export class EventTarget {
   dispatchEvent(event) {
     if (!(event instanceof Event)) throw new TypeError('dispatchEvent requires an Event');
     event.target = this;
-    event._path = this.__eventPath();
-    const path = event._path;
+
+    // Single ancestor walk: build the path AND note whether any node on it has a
+    // listener for this type. React fires thousands of events with zero matching
+    // listeners on the path — those skip the capture/target/bubble invoke loops.
+    const type = event.type;
+    const path = [];
+    let hasListener = false;
+    let node = this;
+    while (node) {
+      path.push(node);
+      if (!hasListener) { const l = node.__listeners && node.__listeners.get(type); if (l && l.length) hasListener = true; }
+      node = node.parentNode || node.__owner || null;
+    }
+    event._path = path;
 
     // pre-click activation (WHATWG): checkbox/radio toggle BEFORE click listeners
     // run, so React's change detection sees the new value. Undone if preventDefault.
@@ -185,18 +197,21 @@ export class EventTarget {
       }
     };
 
-    // capturing: root -> just before target
-    for (let i = path.length - 1; i >= 1; i--) {
-      if (event._stopPropagation) break;
-      invoke(path[i], PHASE_CAPTURING);
-    }
-    // at target
-    if (!event._stopPropagation) invoke(path[0], PHASE_AT_TARGET);
-    // bubbling: target's parent -> root
-    if (event.bubbles) {
-      for (let i = 1; i < path.length; i++) {
+    // no listener anywhere on the path → skip all three propagation phases
+    if (hasListener) {
+      // capturing: root -> just before target
+      for (let i = path.length - 1; i >= 1; i--) {
         if (event._stopPropagation) break;
-        invoke(path[i], PHASE_BUBBLING);
+        invoke(path[i], PHASE_CAPTURING);
+      }
+      // at target
+      if (!event._stopPropagation) invoke(path[0], PHASE_AT_TARGET);
+      // bubbling: target's parent -> root
+      if (event.bubbles) {
+        for (let i = 1; i < path.length; i++) {
+          if (event._stopPropagation) break;
+          invoke(path[i], PHASE_BUBBLING);
+        }
       }
     }
 

package/src/runtime/stubs.mjs

@@ -83,8 +83,13 @@ export function makeMatchMedia() {
 // invents cascade/layout numbers. A property that wasn't set reads as ''.
 export function makeGetComputedStyle() {
   return (el) => {
+    // The Proxy reads el.style LIVE on each access, so one cached Proxy per
+    // element is always correct (no version needed) — avoids re-allocating a
+    // Proxy on every call, which dom-accessibility-api does per element in
+    // getByRole/getByText visibility checks.
+    if (el && el.__computedStyle) return el.__computedStyle;
     const style = el && el.style ? el.style : null;
-    return new Proxy({}, {
+    const proxy = new Proxy({}, {
       get(_t, key) {
         if (key === 'getPropertyValue') return (p) => (style ? style.getPropertyValue(p) : '');
         if (key === '__honest') return 'computed style is inline-only; no layout/cascade available';
@@ -92,6 +97,8 @@ export function makeGetComputedStyle() {
         return style ? style[key] : '';
       },
     });
+    if (el) el.__computedStyle = proxy;
+    return proxy;
   };
 }
 

package/src/runtime/window.mjs

@@ -117,8 +117,8 @@ export function createWindow(document, { url = 'http://localhost/' } = {}) {
     HTMLHeadingElement: tagClass(/^h[1-6]$/),
     HTMLDocument: Document, DocumentFragment, ShadowRoot: DocumentFragment,
     MutationObserver, DOMParser, XMLSerializer,
-    URL: makeURL(), URLSearchParams,
-    Blob: globalThis.Blob, File: makeFile(), FileReader,
+    URL: TURBO_URL, URLSearchParams,
+    Blob: globalThis.Blob, File: TURBO_FILE, FileReader,
     customElements: makeCustomElements(),
     AbortController: globalThis.AbortController, AbortSignal: globalThis.AbortSignal,
     TextEncoder: globalThis.TextEncoder, TextDecoder: globalThis.TextDecoder,
@@ -247,6 +247,9 @@ function makeFile() {
     constructor(bits = [], name = 'file', opts = {}) { super(bits, opts); this.name = String(name); this.lastModified = opts.lastModified || 0; }
   };
 }
+// stateless — build the classes ONCE, not per createWindow() (per test file).
+const TURBO_URL = makeURL();
+const TURBO_FILE = makeFile();
 
 // Minimal XMLHttpRequest backed by fetch — enough that libraries that construct
 // one and issue a request don't crash. No-network setups still get a clean object.