@jterrazz/test 15.3.0 → 16.0.0

package/dist/ambiguity.js

@@ -1,4 +1,4 @@
-//#region src/specification/facets/website/ambiguity.ts
+//#region src/model/elements/ambiguity.ts
 /**
 * The ambiguity refusal — CONVENTIONS W3.
 *
@@ -52,8 +52,9 @@ const CONTEXT_LANDMARKS = {
 };
 /**
 * Render a descriptor as the source that would build it — `link('Articles')`,
-* `within(navigation(), link('Articles', { exact: true }))`. The error speaks
-* the vocabulary the author wrote, never playwright's.
+* `within(navigation(), link('Articles', { exact: false }))`. The error speaks
+* the vocabulary the author wrote, never playwright's — so the option appears
+* only when the AUTHOR stated one, whichever way.
 */
 function formatElement(element) {
 	const bare = formatBare(element);
@@ -62,7 +63,7 @@ function formatElement(element) {
 function formatBare(element) {
 	const args = [];
 	if (element.name !== void 0) args.push(JSON.stringify(element.name));
-	if (element.exact) args.push("{ exact: true }");
+	if (element.exact !== void 0) args.push(`{ exact: ${String(element.exact)} }`);
 	return `${CONSTRUCTORS[element.kind]}(${args.join(", ")})`;
 }
 /** `1. <a href="/articles">Articles</a>  in <nav>` — one evidence line per candidate. */
@@ -98,7 +99,7 @@ function formatFixes(element, matches) {
 		const alsoHere = rest.length > 0 ? `   [also here: ${rest.map(([name]) => name).join(", ")}]` : "";
 		fixes.push(first === void 0 ? `scope it       within(<a container holding only this one>, ${formatBare(element)})` : `scope it       within(${first[0]}, ${formatBare(element)})   [leaves ${first[1]} of ${matches.length}]${alsoHere}`);
 	}
-	if (!element.exact && element.name !== void 0) {
+	if (element.exact === false && element.name !== void 0) {
 		const remaining = matches.filter((match) => match.text === element.name).length;
 		if (remaining > 0 && remaining < matches.length) fixes.push(`exact name     ${formatBare({
 			...element,
@@ -138,7 +139,7 @@ function describeAmbiguity(options) {
 		"Disambiguate with one of:",
 		...fixes,
 		"",
-		"Docs: docs/14-website.md#designating-exactly-one-element (CONVENTIONS W3)"
+		"Docs: docs/13-elements.md#designating-exactly-one-element (CONVENTIONS W3)"
 	].join("\n");
 }
 //#endregion

package/dist/appium.adapter.js

@@ -2,7 +2,7 @@ import { r as formatElement, t as AmbiguousElementError } from "./ambiguity.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}`;
@@ -391,7 +391,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 {