@jterrazz/test 15.3.0 → 16.1.0

package/dist/appium.adapter.js

@@ -1,8 +1,8 @@
-import { r as formatElement, t as AmbiguousElementError } from "./ambiguity.js";
+import { a as formatElement, r as AmbiguousElementError, t as warnSubstringOnly } from "./substring-warning.js";
 import { mkdtempSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { tmpdir } from "node:os";
-//#region src/specification/facets/mobile/ambiguity.ts
+//#region src/facets/mobile/ambiguity.ts
 /**
 * The ambiguity refusal, mobile edition — CONVENTIONS W3.
 *
@@ -28,15 +28,15 @@ function formatMatch(match, index) {
 }
 /**
 * The rewrites worth offering, in the order they should be tried. Scoping is
-* always available; `exact` only when it would actually narrow the set, and
-* the count it would leave is stated so a still-ambiguous suggestion never
-* reads as a fix; distinct identifiers make `testId()` a concrete rewrite
-* rather than a guess.
+* always available; `exact` only to a descriptor that opted OUT of it (exact
+* is the default), and the count it would leave is stated so a
+* still-ambiguous suggestion never reads as a fix; distinct identifiers make
+* `testId()` a concrete rewrite rather than a guess.
 */
 function formatFixes(element, matches) {
 	const fixes = [];
 	if (!element.scope) fixes.push(`scope it       within(testId('…'), ${formatElement(element)}) — a screen has no landmarks; any descriptor works as the scope`);
-	if (!element.exact && element.name !== void 0) {
+	if (element.exact === false && element.name !== void 0) {
 		const remaining = matches.filter((match) => match.label === element.name).length;
 		if (remaining > 0 && remaining < matches.length) fixes.push(`exact name     ${formatElement({
 			exact: true,
@@ -71,11 +71,11 @@ function describeMobileAmbiguity(options) {
 		"Disambiguate with one of:",
 		...fixes,
 		"",
-		"Docs: docs/15-mobile.md#designating-exactly-one-element (CONVENTIONS W3)"
+		"Docs: docs/13-elements.md#designating-exactly-one-element (CONVENTIONS W3)"
 	].join("\n");
 }
 //#endregion
-//#region src/specification/facets/mobile/projection.ts
+//#region src/facets/mobile/projection.ts
 const TAG_PATTERN = /<(?<openTag>[A-Za-z][\w.]*)(?<rawAttributes>(?:\s+[\w:.-]+="[^"]*")*)\s*(?<selfClosing>\/?)>|<\/(?<closeTag>[\w.]*)\s*>/gu;
 const ATTRIBUTE_PATTERN = /(?<key>[\w:.-]+)="(?<value>[^"]*)"/gu;
 const NAMED_ENTITIES = {
@@ -180,7 +180,7 @@ function projectScreen(xml) {
 	};
 }
 //#endregion
-//#region src/integrations/appium/appium.adapter.ts
+//#region src/seams/appium/appium.adapter.ts
 const DEFAULT_ACTION_TIMEOUT_MS = 3e4;
 const POLL_INTERVAL_MS = 500;
 /** How many candidates the ambiguity error enumerates before truncating. */
@@ -201,7 +201,7 @@ function escapePredicate(value) {
 */
 function compilePredicate(element, options) {
 	const name = escapePredicate(element.name ?? "");
-	const contains = (attribute) => element.exact ? `${attribute} == '${name}'` : `${attribute} CONTAINS '${name}'`;
+	const contains = (attribute) => element.exact === false ? `${attribute} CONTAINS '${name}'` : `${attribute} == '${name}'`;
 	const visible = options?.anyVisibility ? "1 == 1" : "visible == 1";
 	switch (element.kind) {
 		case "button": return `type == 'XCUIElementTypeButton' AND ${contains("label")} AND ${visible}`;
@@ -211,6 +211,16 @@ function compilePredicate(element, options) {
 		default: throw new Error(`${formatElement(element)}: landmarks are a website concept — an iOS screen has no '${element.kind}' region. Scope with within(testId('…'), …) instead.`);
 	}
 }
+/**
+* Every element a predicate designates under `scope`.
+*
+* ONE place awaits webdriverio's query: `$$` answers a chainable typed as the
+* array it resolves to, so the await that makes the array real reads to the
+* typechecker as an await of a non-promise.
+*/
+async function matching(scope, element, options) {
+	return await scope.$$(`-ios predicate string:${compilePredicate(element, options)}`);
+}
 /** The outside-in scope chain of a descriptor, ending on the target itself. */
 function scopeChain(element) {
 	const chain = [];
@@ -341,10 +351,16 @@ var AppiumAdapter = class {
 		const chain = scopeChain(element);
 		const deadline = Date.now() + this.actionTimeoutMs;
 		let scrollAttempted = false;
+		let windowAsked = false;
+		let looking = chain;
 		for (;;) {
-			const resolved = await this.resolveChain(driver, chain, cardinality, { tryScroll: !scrollAttempted });
+			const resolved = await this.resolveChain(driver, looking, cardinality, { tryScroll: !scrollAttempted });
 			scrollAttempted = true;
 			if (resolved) return resolved;
+			if (!windowAsked) {
+				windowAsked = true;
+				looking = await this.widenedChain(driver, chain) ?? chain;
+			}
 			if (Date.now() > deadline) throw await this.timeoutError(driver, element, verb);
 			await delay(POLL_INTERVAL_MS);
 		}
@@ -353,11 +369,11 @@ var AppiumAdapter = class {
 	async resolveChain(driver, chain, cardinality, options) {
 		let scope = driver;
 		for (const [index, level] of chain.entries()) {
-			const matches = await scope.$$(`-ios predicate string:${compilePredicate(level)}`);
+			const matches = await matching(scope, level);
 			const count = await matches.length;
 			if (count === 0) {
 				if (options?.tryScroll) {
-					const first = (await scope.$$(`-ios predicate string:${compilePredicate(level, { anyVisibility: true })}`))[0];
+					const first = (await matching(scope, level, { anyVisibility: true }))[0];
 					if (first !== void 0) try {
 						await driver.executeScript("mobile: scroll", [{
 							elementId: first.elementId,
@@ -378,6 +394,45 @@ var AppiumAdapter = class {
 		}
 		return scope;
 	}
+	/**
+	* The chain to keep polling with, level by level: a descriptor that
+	* designated nothing as a whole label but designates exactly one thing as a
+	* SUBSTRING is widened, with the warning that names the label to write. The
+	* window is the vocabulary's, not one surface's — chapter 13 — so the
+	* screen answers it exactly as a page does.
+	*
+	* `null` when nothing would change, which is the ordinary wait.
+	*/
+	async widenedChain(driver, chain) {
+		let scope = driver;
+		const widened = [];
+		let changed = false;
+		for (const level of chain) {
+			const found = await this.widenedLevel(scope, level);
+			changed ||= found !== null;
+			const candidate = found ?? level;
+			const next = (await matching(scope, candidate))[0];
+			if (next === void 0) return null;
+			scope = next;
+			widened.push(candidate);
+		}
+		return changed ? widened : null;
+	}
+	/** One level of the chain, widened and warned about, or `null`. */
+	async widenedLevel(scope, level) {
+		if (level.exact !== void 0 || level.name === void 0) return null;
+		if (await (await matching(scope, level)).length > 0) return null;
+		const loose = {
+			...level,
+			exact: false
+		};
+		const matches = await matching(scope, loose);
+		const first = matches[0];
+		if (first === void 0 || await matches.length !== 1) return null;
+		const evidence = await captureMatch(first);
+		warnSubstringOnly(level, this.options.udid, evidence.label);
+		return loose;
+	}
 	/** Enumerate the candidates' evidence, truncated. */
 	async captureMatches(matches) {
 		const count = Math.min(await matches.length, MAX_REPORTED_MATCHES);
@@ -391,7 +446,8 @@ var AppiumAdapter = class {
 	/** Screenshot the failing state into a temp file; never masks the original error. */
 	async captureEvidence(driver) {
 		try {
-			const path = resolve(mkdtempSync(resolve(tmpdir(), "spec-mobile-")), "failure.png");
+			const dir = mkdtempSync(resolve(tmpdir(), "spec-mobile-"));
+			const path = resolve(dir, "failure.png");
 			writeFileSync(path, Buffer.from(await driver.takeScreenshot(), "base64"));
 			return path;
 		} catch {