@e2e-dev/web 0.15.3-nightly-20261021080401 → 0.15.3

package/dist/.build.json

@@ -1 +1 @@
-{"version":"0.15.3-nightly-20261021080401"}
+{"version":"0.15.3"}

package/dist/in-page/read-semantics.js

@@ -152,9 +152,60 @@ export const readSemanticsFunction = (element, options) => {
         el.isContentEditable &&
         NON_HOST_TAGS.indexOf(el.tagName.toLowerCase()) === -1 &&
         !(el.parentElement instanceof HTMLElement && el.parentElement.isContentEditable);
+    const NAME_PROHIBITED_ROLES = [
+        'caption', 'code', 'deletion', 'emphasis', 'generic', 'insertion', 'paragraph', 'presentation', 'strong',
+        'subscript', 'superscript',
+    ];
+    /** Global ARIA attributes, each with the roles it does not count on, as Playwright lists them. */
+    const GLOBAL_ARIA_ATTRIBUTES = [
+        ['aria-atomic', []],
+        ['aria-busy', []],
+        ['aria-controls', []],
+        ['aria-current', []],
+        ['aria-describedby', []],
+        ['aria-details', []],
+        ['aria-dropeffect', []],
+        ['aria-flowto', []],
+        ['aria-grabbed', []],
+        ['aria-hidden', []],
+        ['aria-keyshortcuts', []],
+        ['aria-label', NAME_PROHIBITED_ROLES],
+        ['aria-labelledby', NAME_PROHIBITED_ROLES],
+        ['aria-live', []],
+        ['aria-owns', []],
+        ['aria-relevant', []],
+        ['aria-roledescription', ['generic']],
+    ];
+    /** Playwright's implicit role for the tags whose role some global ARIA attributes do not count on. */
+    const NAME_PROHIBITED_TAG_ROLES = {
+        caption: 'caption', code: 'code', del: 'deletion', em: 'emphasis', ins: 'insertion', p: 'paragraph',
+        strong: 'strong', sub: 'subscript', sup: 'superscript',
+    };
+    /** True when the element carries a global ARIA attribute that counts on `role`. */
+    const hasGlobalAriaAttribute = (el, role) => GLOBAL_ARIA_ATTRIBUTES.some(([name, prohibited]) => (role === null || prohibited.indexOf(role) === -1) && el.hasAttribute(name));
+    /** True when `tabindex` parses as a number, as Playwright reads it. */
+    const hasTabIndex = (el) => !Number.isNaN(Number(String(el.getAttribute('tabindex'))));
+    /** Whether a person can focus the element, as Playwright decides presentational-role conflicts. */
+    const isFocusable = (el) => {
+        const tag = el.tagName.toLowerCase();
+        if (['button', 'input', 'select', 'textarea', 'option', 'optgroup'].indexOf(tag) !== -1 && el.matches(':disabled')) {
+            return false;
+        }
+        if (hasTabIndex(el) || ['button', 'details', 'select', 'textarea'].indexOf(tag) !== -1)
+            return true;
+        if (tag === 'a' || tag === 'area')
+            return el.hasAttribute('href');
+        return tag === 'input' && !el.hidden;
+    };
+    /**
+     * WAI-ARIA presentational-role conflict resolution: `presentation` or
+     * `none` is ignored on a focusable element or one with a global ARIA
+     * attribute, and the tag's role stands.
+     */
+    const hasPresentationConflict = (el) => isFocusable(el) || hasGlobalAriaAttribute(el, NAME_PROHIBITED_TAG_ROLES[el.tagName.toLowerCase()] ?? null);
     const implicitRole = memoized((el) => {
         const explicit = explicitRole(el);
-        if (explicit !== null) {
+        if (explicit !== null && !((explicit === 'presentation' || explicit === 'none') && hasPresentationConflict(el))) {
             // The vocabulary spells ARIA's `img` as `image`.
             return explicit === 'img' ? 'image' : explicit;
         }
@@ -176,7 +227,9 @@ export const readSemanticsFunction = (element, options) => {
             case 'textarea':
                 return 'textbox';
             case 'img':
-                return el.getAttribute('alt') === '' ? 'presentation' : 'image';
+                return el.getAttribute('alt') === '' && !el.getAttribute('title') && !hasGlobalAriaAttribute(el, null) && !hasTabIndex(el)
+                    ? 'presentation'
+                    : 'image';
             // An inline icon is a picture whether or not anything names it, as
             // Playwright reads it; Chrome ignores an unnamed one.
             case 'svg':
@@ -1061,6 +1114,16 @@ export const readSemanticsFunction = (element, options) => {
      * of the page is not in the style and stays listed.
      */
     const isInert = (el, style) => el.hasAttribute('inert') || style?.getPropertyValue('interactivity') === 'inert';
+    /** A closed select has no option boxes; explicit exclusions still remove choices it does not offer. */
+    const isOfferedOption = (option) => {
+        if (isSkippedContent(option))
+            return false;
+        for (let current = option; current !== null && current.tagName.toLowerCase() !== 'select'; current = parentOrHostOf(current)) {
+            if (hidesSubtree(current, styleOf(current)))
+                return false;
+        }
+        return true;
+    };
     /** Smallest side, in CSS pixels, an empty box must have to be worth reporting. */
     const MIN_BOX_SIDE = 12;
     /** True when a computed style paints something a person can see. */
@@ -1529,8 +1592,13 @@ export const readSemanticsFunction = (element, options) => {
         // has to guess the labels it may pick. The options are what the control
         // offers, so they are listed under it, bounded like any long list.
         if (tag === 'select') {
-            const choices = Array.from(el.options).slice(0, MAX_SELECT_OPTIONS);
-            for (const option of choices) {
+            let offered = 0;
+            for (const option of Array.from(el.options)) {
+                if (offered >= MAX_SELECT_OPTIONS)
+                    break;
+                if (!isOfferedOption(option))
+                    continue;
+                offered += 1;
                 if (nodes.length >= maxNodes) {
                     truncated = true;
                     return;

package/dist/locators.js

@@ -164,6 +164,10 @@ function narrowedToVisible(located, query) {
 function positioned(locator, index) {
     return index === 'first' ? locator.first() : index === 'last' ? locator.last() : locator.nth(index);
 }
+/** A projection whose matches are exactly `locator`'s, with nothing left for the surface to apply. */
+function plain(locator) {
+    return { locator, displayValue: null, name: null, composable: null, steps: [], visible: false };
+}
 const DISPLAY_VALUE_COMPOSITION_MESSAGE = 'displayValue queries cannot scope child queries or serve as a has-filter in this engine';
 /**
  * Projects a complete immutable expression onto a Playwright locator within
@@ -190,6 +194,11 @@ const DISPLAY_VALUE_COMPOSITION_MESSAGE = 'displayValue queries cannot scope chi
  */
 function project(scope, expression, testIdAttribute) {
     switch (expression.kind) {
+        case 'union': {
+            const left = requireComposable(project(scope, expression.left, testIdAttribute));
+            const right = requireComposable(project(scope, expression.right, testIdAttribute));
+            return plain(left.or(right));
+        }
         case 'query': {
             const inner = expression.scope === undefined
                 ? scope
@@ -233,24 +242,10 @@ function project(scope, expression, testIdAttribute) {
                     steps: [...source.steps, { kind: 'index', index: expression.index }],
                 };
             }
-            return {
-                locator: positioned(source.locator, expression.index),
-                displayValue: null,
-                name: null,
-                composable: null,
-                steps: [],
-                visible: false,
-            };
+            return plain(positioned(source.locator, expression.index));
         }
         case 'selector':
-            return {
-                locator: scope.locator(expression.selector),
-                displayValue: null,
-                name: null,
-                composable: null,
-                steps: [],
-                visible: false,
-            };
+            return plain(scope.locator(expression.selector));
         case 'frame':
             return project(scope.frameLocator(expression.selector), expression.source, testIdAttribute);
     }
@@ -306,6 +301,16 @@ export async function applyPostSteps(matches, steps, passesFilter) {
 /** Returns every frame selector along an expression, outermost first. */
 export function frameSelectors(expression) {
     switch (expression.kind) {
+        case 'union': {
+            const left = frameSelectors(expression.left);
+            const right = frameSelectors(expression.right);
+            if (left.length !== right.length || left.some((selector, index) => selector !== right[index])) {
+                throw new EngineError('UNSUPPORTED_CAPABILITY', 'locator.or requires both branches in the same document', {
+                    retryable: false,
+                });
+            }
+            return left;
+        }
         case 'query':
             return expression.scope === undefined ? [] : frameSelectors(expression.scope);
         case 'filter':

package/dist/support.js

@@ -290,7 +290,7 @@ export function isNavigationRace(cause) {
  * be captured in time is not a race.
  */
 export function navigationStaleOr(cause, operation) {
-    if (!isClassified(cause) && isNavigationRace(cause)) {
+    if (!isClassified(cause) && !isPwTimeout(cause) && isNavigationRace(cause)) {
         return new EngineError('NODE_STALE', `${operation}: ${message(cause)}`, {
             retryable: true,
             cause,
@@ -304,8 +304,8 @@ export function navigationStaleOr(cause, operation) {
  * waits, so a `TimeoutError` there is a budget that ran out, not a miss.
  */
 export function staleOr(cause, operation) {
-    if (isClassified(cause))
-        return cause;
+    if (isClassified(cause) || isPwTimeout(cause))
+        return translatePwError(cause, operation);
     const text = message(cause);
     if (STALE_PATTERN.test(text) || isNavigationRace(cause)) {
         return new EngineError('NODE_STALE', `${operation}: ${text}`, { retryable: true, cause });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@e2e-dev/web",
-  "version": "0.15.3-nightly-20261021080401",
+  "version": "0.15.3",
   "description": "Web engine for e2e agentic end-to-end testing, built on Playwright",
   "keywords": [
     "e2e",
@@ -50,11 +50,11 @@
     "playwright-core": "1.64.1"
   },
   "peerDependencies": {
-    "e2e": "0.21.3-nightly-20261021080401"
+    "e2e": ">=0.18.0 <1"
   },
   "devDependencies": {
     "@types/node": "26.6.2",
-    "e2e": "0.21.3-nightly-20261021080401",
+    "e2e": "0.21.3",
     "@types/pngjs": "6.0.5",
     "pngjs": "7.0.0",
     "typescript": "7.0.2",