@testspectra/react 1.2.0 → 1.2.2

package/dist/index.js

@@ -196,6 +196,13 @@ function mockResponseBodyText(body) {
 }
 
 // ../../core/worker-runtime/src/dsl/selector_resolver.ts
+function parseElementSentinel(selector) {
+  const closest = /^(.*)::closest\((.+)\)$/.exec(selector);
+  if (closest) return { kind: "closest", base: closest[1], arg: closest[2] };
+  const parent = /^(.*)::parent$/.exec(selector);
+  if (parent) return { kind: "parent", base: parent[1] };
+  return null;
+}
 function parseA11ySelector(selector) {
   const trimmed = selector.trim();
   if (!trimmed.startsWith("~")) return null;
@@ -391,6 +398,35 @@ function resolveEl(selector, index) {
   if (parsed) return resolveLabelledBy(parsed.name, document, index);
   return null;
 }
+function selectorText(target) {
+  return typeof target === "string" ? target : target.selector;
+}
+function resolveSentinel(raw, parent) {
+  const sentinel = parseElementSentinel(raw);
+  if (!sentinel) return void 0;
+  const baseTarget = parent ? { selector: sentinel.base, index: null, parent } : sentinel.base;
+  const base = resolveScopedEl(baseTarget, null);
+  if (!base) return null;
+  if (sentinel.kind === "parent") return base.parentElement ?? null;
+  return base.closest(sentinel.arg) ?? null;
+}
+function resolveScopedEl(target, fallbackIndex) {
+  if (typeof target === "string") {
+    const sentinel = resolveSentinel(target, void 0);
+    if (sentinel !== void 0) return sentinel;
+    return resolveEl(target, fallbackIndex);
+  }
+  const childSentinel = resolveSentinel(target.selector, target.parent);
+  if (childSentinel !== void 0) return childSentinel;
+  const parentEl = target.parent ? resolveScopedEl(target.parent, target.parent.index) : document.documentElement;
+  if (!parentEl) return null;
+  const css = resolveSelector(target.selector);
+  const all = Array.from(parentEl.querySelectorAll(css));
+  const idx = target.index ?? fallbackIndex;
+  if (idx === null || idx === void 0) return all[0] ?? null;
+  if (idx >= 0) return all[idx] ?? null;
+  return all[all.length + idx] ?? null;
+}
 function isFormEl(el) {
   const tag = el.tagName;
   return tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT";
@@ -399,17 +435,18 @@ var DomDriverBridge = class {
   mockRules = [];
   consoleErrors = [];
   recordedNetwork = [];
-  /** Polls until `selector` resolves to an element, then returns it — shared by every
-   * interaction method below (user-event needs a real element handle, not a selector string). */
-  async waitForEl(selector, index) {
-    const immediate = resolveEl(selector, index);
+  /** Polls until `target` resolves to an element, then returns it — shared by every interaction
+   * method below (user-event needs a real element handle, not a selector string). Accepts a
+   * `ScopedSelector` so chained `.get()`/`.getAll()` lookups resolve within their parent. */
+  async waitForScopedEl(target, fallbackIndex) {
+    const immediate = resolveScopedEl(target, fallbackIndex);
     if (immediate) return immediate;
     let found = null;
     const ok = await globalThis.__TS_RUNTIME__.pollCondition(async () => {
-      found = resolveEl(selector, index);
+      found = resolveScopedEl(target, fallbackIndex);
       return found !== null;
     }, globalThis.__TS_RUNTIME__.getImplicitWaitMs());
-    if (!ok || !found) throw new Error("Element not found: " + JSON.stringify(selector));
+    if (!ok || !found) throw new Error("Element not found: " + selectorText(target));
     return found;
   }
   async connect() {
@@ -449,20 +486,20 @@ var DomDriverBridge = class {
   }
   // ─── Element Actions ─────────────────────────────────────────────────────
   async click(selector, index = null) {
-    const el = await this.waitForEl(selector, index);
+    const el = await this.waitForScopedEl(selector, index);
     await getUser().click(el);
   }
   async doubleClick(selector, index = null) {
-    const el = await this.waitForEl(selector, index);
+    const el = await this.waitForScopedEl(selector, index);
     await getUser().dblClick(el);
   }
   async rightClick(selector, index = null) {
-    const el = await this.waitForEl(selector, index);
+    const el = await this.waitForScopedEl(selector, index);
     await getUser().pointer({ keys: "[MouseRight]", target: el });
   }
   async setValue(selector, value, index = null) {
-    const el = await this.waitForEl(selector, index);
-    if (!isFormEl(el)) throw new Error("Element is not a form field: " + JSON.stringify(selector));
+    const el = await this.waitForScopedEl(selector, index);
+    if (!isFormEl(el)) throw new Error("Element is not a form field: " + selectorText(selector));
     if (el.tagName === "INPUT" && el.type === "file") {
       return this.upload(selector, value, index);
     }
@@ -473,7 +510,7 @@ var DomDriverBridge = class {
     }
   }
   async upload(selector, files, index = null) {
-    const el = await this.waitForEl(selector, index);
+    const el = await this.waitForScopedEl(selector, index);
     const fileList = Array.isArray(files) ? files : [files];
     const filesToUpload = [];
     const MIME_MAP = {
@@ -556,12 +593,12 @@ var DomDriverBridge = class {
     }
   }
   async clearValue(selector, index = null) {
-    const el = await this.waitForEl(selector, index);
+    const el = await this.waitForScopedEl(selector, index);
     await getUser().clear(el);
   }
   async select(selector, option, index = null) {
     const ok = await globalThis.__TS_RUNTIME__.pollCondition(async () => {
-      const el = resolveEl(selector, index);
+      const el = resolveScopedEl(selector, index);
       if (!el || el.tagName !== "SELECT") return false;
       for (let i = 0; i < el.options.length; i++) {
         const opt = el.options[i];
@@ -576,29 +613,71 @@ var DomDriverBridge = class {
     if (!ok) throw new Error("Select option not found: " + JSON.stringify(option));
   }
   async hover(selector, index = null) {
-    const el = await this.waitForEl(selector, index);
+    const el = await this.waitForScopedEl(selector, index);
     await getUser().hover(el);
   }
   async focus(selector, index = null) {
     const ok = await globalThis.__TS_RUNTIME__.pollCondition(async () => {
-      const el = resolveEl(selector, index);
+      const el = resolveScopedEl(selector, index);
       if (!el) return false;
       el.focus?.();
       return true;
     });
-    if (!ok) throw new Error("Element not found: " + JSON.stringify(selector));
+    if (!ok) throw new Error("Element not found: " + selectorText(selector));
   }
   async blur(selector, index = null) {
     const ok = await globalThis.__TS_RUNTIME__.pollCondition(async () => {
-      const el = resolveEl(selector, index);
+      const el = resolveScopedEl(selector, index);
       if (!el) return false;
       el.blur?.();
       return true;
     });
-    if (!ok) throw new Error("Element not found: " + JSON.stringify(selector));
+    if (!ok) throw new Error("Element not found: " + selectorText(selector));
+  }
+  async waitForElementRemoved(selector, timeoutMs = 5e3, index = null) {
+    const ok = await globalThis.__TS_RUNTIME__.pollCondition(async () => {
+      return !await this.isExisting(selector, index);
+    }, timeoutMs);
+    if (!ok) throw new Error("Element still exists after timeout: " + selectorText(selector));
+  }
+  async waitForUndisplayed(selector, opts, index = null) {
+    const ok = await globalThis.__TS_RUNTIME__.pollCondition(async () => {
+      return !await this.isDisplayed(selector, index);
+    }, opts?.timeout ?? 5e3);
+    if (!ok) throw new Error("Element still displayed after timeout: " + selectorText(selector));
+  }
+  async waitForClickable(selector, opts, index = null) {
+    return await globalThis.__TS_RUNTIME__.pollCondition(async () => {
+      return this.isClickable(selector, index);
+    }, opts?.timeout ?? 5e3);
+  }
+  async getBounds(selector, index = null) {
+    const el = resolveScopedEl(selector, index);
+    if (!el) return { x: 0, y: 0, top: 0, right: 0, bottom: 0, left: 0, width: 0, height: 0 };
+    const r = el.getBoundingClientRect();
+    return {
+      x: r.x,
+      y: r.y,
+      top: r.top,
+      right: r.right,
+      bottom: r.bottom,
+      left: r.left,
+      width: r.width,
+      height: r.height
+    };
+  }
+  async closest(selector, targetSelector, index = null) {
+    const el = resolveScopedEl(selector, index);
+    if (!el) return null;
+    const ancestor = el.closest(targetSelector);
+    return ancestor ? ancestor.tagName.toLowerCase() : null;
+  }
+  async clickAt(x, y) {
+    const el = document.elementFromPoint(x, y);
+    el?.click();
   }
   async dragDrop(sourceSelector, targetSelector, sourceIndex = null) {
-    const src = resolveEl(sourceSelector, sourceIndex);
+    const src = resolveScopedEl(sourceSelector, sourceIndex);
     const dest = resolveEl(targetSelector, null);
     if (!src || !dest) throw new Error("Drag source or destination not found");
     const dataTransfer = new DataTransfer();
@@ -608,30 +687,30 @@ var DomDriverBridge = class {
     src.dispatchEvent(new DragEvent("dragend", { bubbles: true, dataTransfer }));
   }
   async longPress(selector, duration, index = null) {
-    const el = resolveEl(selector, index);
-    if (!el) throw new Error("Element not found: " + JSON.stringify(selector));
+    const el = resolveScopedEl(selector, index);
+    if (!el) throw new Error("Element not found: " + selectorText(selector));
     el.dispatchEvent(new TouchEvent("touchstart", { bubbles: true }));
     await this.pause(duration);
     el.dispatchEvent(new TouchEvent("touchend", { bubbles: true }));
   }
   async scrollIntoView(selector, index = null) {
-    const el = resolveEl(selector, index);
+    const el = resolveScopedEl(selector, index);
     el?.scrollIntoView({ block: "center", inline: "center" });
   }
   // ─── Element State Inspection ────────────────────────────────────────────
   async getText(selector, index = null) {
-    const el = resolveEl(selector, index);
+    const el = resolveScopedEl(selector, index);
     if (!el) return "";
     return el.innerText !== void 0 ? el.innerText : el.textContent || "";
   }
   async getValue(selector, index = null) {
-    const el = resolveEl(selector, index);
+    const el = resolveScopedEl(selector, index);
     if (!el) return "";
     if (isFormEl(el)) return el.value ?? "";
     return el.getAttribute("value") || "";
   }
   async isDisplayed(selector, index = null) {
-    const el = resolveEl(selector, index);
+    const el = resolveScopedEl(selector, index);
     if (!el) return false;
     const style = window.getComputedStyle(el);
     if (style.visibility === "hidden" || style.display === "none" || style.opacity === "0") return false;
@@ -639,25 +718,25 @@ var DomDriverBridge = class {
     return rect.width > 0 && rect.height > 0 || el.getClientRects().length > 0 || el.offsetWidth > 0 && el.offsetHeight > 0;
   }
   async isExisting(selector, index = null) {
-    return resolveEl(selector, index) !== null;
+    return resolveScopedEl(selector, index) !== null;
   }
   async isEnabled(selector, index = null) {
-    const el = resolveEl(selector, index);
+    const el = resolveScopedEl(selector, index);
     if (!el) return false;
     return !el.disabled && !el.hasAttribute("disabled") && !el.classList.contains("disabled") && el.getAttribute("aria-disabled") !== "true";
   }
   async isSelected(selector, index = null) {
-    const el = resolveEl(selector, index);
+    const el = resolveScopedEl(selector, index);
     if (!el) return false;
     return !!el.checked || el.getAttribute("aria-checked") === "true" || el.getAttribute("data-state") === "checked";
   }
   async isFocused(selector, index = null) {
-    const el = resolveEl(selector, index);
+    const el = resolveScopedEl(selector, index);
     if (!el) return false;
     return document.activeElement === el || el.matches(":focus");
   }
   async isClickable(selector, index = null) {
-    const el = resolveEl(selector, index);
+    const el = resolveScopedEl(selector, index);
     if (!el) return false;
     const style = window.getComputedStyle(el);
     if (style.visibility === "hidden" || style.display === "none" || style.opacity === "0") return false;
@@ -666,19 +745,24 @@ var DomDriverBridge = class {
     return !el.disabled && !el.hasAttribute("disabled") && !el.classList.contains("disabled") && el.getAttribute("aria-disabled") !== "true";
   }
   async hasClass(selector, className, index = null) {
-    const el = resolveEl(selector, index);
+    const el = resolveScopedEl(selector, index);
     return el ? el.classList.contains(className) : false;
   }
   async getAttribute(selector, name, index = null) {
-    const el = resolveEl(selector, index);
+    const el = resolveScopedEl(selector, index);
     return el ? el.getAttribute(name) : null;
   }
   async getCSSProperty(selector, name, index = null) {
-    const el = resolveEl(selector, index);
+    const el = resolveScopedEl(selector, index);
     return { value: el ? window.getComputedStyle(el).getPropertyValue(name) : "" };
   }
   async count(selector) {
-    return document.querySelectorAll(resolveSelector(selector)).length;
+    if (typeof selector === "string") {
+      return document.querySelectorAll(resolveSelector(selector)).length;
+    }
+    const parentEl = selector.parent ? resolveScopedEl(selector.parent, selector.parent.index) : document.documentElement;
+    if (!parentEl) return 0;
+    return parentEl.querySelectorAll(resolveSelector(selector.selector)).length;
   }
   // ─── Gestures & Keys ─────────────────────────────────────────────────────
   async pressKey(key) {