@jterrazz/test 10.0.0 → 10.1.0

package/dist/oxlint.cjs

@@ -166,7 +166,7 @@ const RULE_DOCS = {
 	},
 	"a2-known-constructors": {
 		channel: "statique",
-		convention: "Quatre constructeurs et seulement quatre : `specification.api()`, `specification.jobs()`, `specification.cli(bin)`, `specification.website()` ; tout autre membre (`.app`, `.http`, `.stack`…) est une erreur.",
+		convention: "Cinq constructeurs et seulement cinq : `specification.api()`, `specification.jobs()`, `specification.cli(bin)`, `specification.website()`, `specification.mobile()` ; tout autre membre (`.app`, `.http`, `.stack`…) est une erreur.",
 		family: "A",
 		id: "A2",
 		rationale: "Une surface fermée empêche l’invention de constructeurs parallèles et garde l’API mémorisable."
@@ -439,16 +439,16 @@ const RULE_DOCS = {
 	},
 	"w1-scenario-pure": {
 		channel: "statique",
-		convention: "Un scénario de visite est le When : le visiteur agit, la capture reflète l’état final ; aucun `expect()` dans le callback — les assertions vivent dans le Then, sur le résultat retourné.",
-		facet: "website",
+		convention: "Un scénario (`.visit()` website, `.open()` mobile) est le When : le visiteur agit, la capture reflète l’état final ; aucun `expect()` dans le callback — les assertions vivent dans le Then, sur le résultat retourné.",
+		facet: "shared",
 		family: "W",
 		id: "W1",
 		rationale: "Séparer l’interaction de l’assertion garde la grammaire setup → action → résultat intacte et les scénarios rejouables."
 	},
 	"w2w-user-facing-elements": {
 		channel: "statique",
-		convention: "Les éléments d’un scénario sont user-facing (`button`, `link`, `field`, `heading`, `content`) ; `testId()` est l’unique échappatoire et déclenche un avertissement.",
-		facet: "website",
+		convention: "Les éléments d’un scénario sont user-facing (`button`, `link`, `field`, `heading`, `content` ; côté mobile `button`, `field`, `content`) ; `testId()` est l’unique échappatoire et déclenche un avertissement.",
+		facet: "shared",
 		family: "W",
 		id: "W2",
 		rationale: "Tester ce que l’utilisateur voit (rôles, labels) rend les specs robustes aux refontes DOM ; un test-id contourne cette garantie."
@@ -573,13 +573,22 @@ const RUNTIME_RULES = [
 	},
 	{
 		channel: "runtime",
-		convention: "Un descripteur d’élément doit désigner exactement UN élément : si plusieurs correspondent, l’action est refusée avec une erreur qui énumère les candidats et propose les réécritures (`within(...)`, `{ exact: true }`). Le framework n’agit jamais sur « le premier ».",
-		facet: "website",
+		convention: "Un descripteur d’élément doit désigner exactement UN élément quand un verbe AGIT dessus (`click`/`tap`/`fill`) : si plusieurs correspondent, l’action est refusée avec une erreur qui énumère les candidats et propose les réécritures (`within(...)`, `{ exact: true }`). Le framework n’agit jamais sur « le premier ». Vaut pour les deux facettes à scénario : website et mobile ; sur mobile, `see()` — qui n’agit sur rien — est satisfait par n’importe quel match visible (l’arbre XCUITest duplique légitimement un label entre conteneur et enfant).",
+		facet: "shared",
 		family: "W",
 		id: "W3",
 		name: "w3-unambiguous-element",
 		rationale: "Agir sur le premier match rend le spec vert alors que le visiteur clique autre chose, et rien ne le signale jamais — une ambiguïté est une faute d’écriture, pas un cas à arbitrer par l’ordre du DOM. Le comptage n’existe qu’à l’exécution : aucune analyse statique ne peut le faire, d’où le canal runtime."
 	},
+	{
+		channel: "runtime",
+		convention: "Le vocabulaire d’éléments est UNIQUE entre les facettes website et mobile ; un landmark ARIA (`main()`, `navigation()`…) passé à un verbe mobile est refusé à l’exécution — un écran iOS n’a pas de régions ARIA ; scoper avec `within(testId(…), …)`.",
+		facet: "mobile",
+		family: "W",
+		id: "W4",
+		name: "w4-no-landmarks-on-mobile",
+		rationale: "Un seul vocabulaire garde l’API mémorisable ; refuser explicitement la partie sans équivalent iOS évite une approximation silencieuse."
+	},
 	{
 		channel: "runtime",
 		convention: "`.intercept()` n’existe que sur `api`/`jobs` et lève immédiatement en mode compose (MSW est in-process).",
@@ -765,18 +774,19 @@ const a10DuplicateBinding = {
 };
 //#endregion
 //#region src/lint/rules/a2-known-constructors.ts
-/** The four constructors, and only four (A2 — see docs/10-linting.md). */
+/** The five constructors, and only five (A2 — see docs/10-linting.md). */
 const KNOWN_CONSTRUCTORS = /* @__PURE__ */ new Set([
 	"api",
 	"cli",
 	"jobs",
+	"mobile",
 	"website"
 ]);
 /**
 * CONVENTIONS A2 — `specification.api()`, `specification.jobs()`,
-* `specification.cli()` and `specification.website()` are the only members.
-* Any other access (`specification.app`, `.http`, `.stack`, …) is flagged at
-* the member site.
+* `specification.cli()`, `specification.website()` and
+* `specification.mobile()` are the only members. Any other access
+* (`specification.app`, `.http`, `.stack`, …) is flagged at the member site.
 */
 const a2KnownConstructors = {
 	create(context) {
@@ -793,7 +803,7 @@ const a2KnownConstructors = {
 	},
 	meta: {
 		docs: RULE_DOCS["a2-known-constructors"],
-		messages: { unknownConstructor: "specification.{{member}} does not exist — the only constructors are specification.api(), specification.jobs(), specification.cli() and specification.website() (A2 — see docs/10-linting.md)." },
+		messages: { unknownConstructor: "specification.{{member}} does not exist — the only constructors are specification.api(), specification.jobs(), specification.cli(), specification.website() and specification.mobile() (A2 — see docs/10-linting.md)." },
 		type: "problem"
 	}
 };
@@ -2430,6 +2440,7 @@ const f5FixturesOnlyFromTests = {
 */
 const INTEGRATION_DEPS = {
 	anthropic: ["@anthropic-ai/sdk"],
+	appium: ["webdriverio"],
 	compose: ["yaml"],
 	docker: [],
 	hono: ["hono", "@hono/node-server"],
@@ -2507,6 +2518,7 @@ const i1LayerBoundaries = {
 				if (target.startsWith("core/") || target.startsWith("integrations/docker/") || target.startsWith("integrations/hono/") || withoutExtension(target) === "vitest/matchers") return null;
 				if (target.startsWith("integrations/msw/") && inside === "core/specification/shared/builder.ts") return null;
 				if (target.startsWith("integrations/playwright/") && inside === "core/specification/website/start-website.ts") return null;
+				if (target.startsWith("integrations/appium/") && inside === "core/specification/mobile/start-mobile.ts") return null;
 				return "crossLayer";
 			}
 			if (layer === "integrations") return target.startsWith("core/") || target.startsWith(`integrations/${integrationFolder}/`) ? null : "crossLayer";
@@ -2832,6 +2844,82 @@ const TITLED = /* @__PURE__ */ new Set([
 * `HTTP`, `DI`. Such a word names a symbol verbatim — lowercasing it would
 * misspell it — so it is exempt. A prose word (`Rejects`, `Builds`) is not. */
 const ALL_CAPS_IDENTIFIER = /^[A-Z][A-Z0-9_]*$/u;
+/**
+* CONVENTIONS J5 — the first character of a `test('…')` / `describe('…')` title
+* literal must be lowercase.
+*
+* The test name is the sole description of behaviour (B3): a sentence fragment,
+* lowercase-led like prose (`'rejects an unknown job'`). Exempt are titles
+* whose first WORD is an identifier-shaped all-caps/underscored token
+* (`'VALID_CATEGORIES is rejected'`, `'HTTP is upgraded'`, `'DI wires …'`) —
+* lowercasing a named symbol would misspell it — and titles opening on a
+* non-letter (a `$`, a `{`, a `%s` placeholder). Only lowercase-able prose
+* first words are enforced. Covers the modifier and parametrized forms
+* (`test.only`, `describe.each(...)(...)`) via the chain root.
+*/
+const j5LowercaseTitle = {
+	create(context) {
+		return { CallExpression(node) {
+			const callee = node.callee;
+			const root = chainRootName(callee);
+			if (root === void 0 || !TITLED.has(root)) return;
+			const title = stringValue(node.arguments?.[0]);
+			if (title === void 0) return;
+			const first = [...title][0];
+			if (first === void 0 || !/\p{L}/u.test(first)) return;
+			const firstWord = title.split(/\s+/u)[0];
+			if (ALL_CAPS_IDENTIFIER.test(firstWord)) return;
+			if (first !== first.toLocaleLowerCase()) context.report({
+				data: { runner: root },
+				messageId: "uppercase",
+				node
+			});
+		} };
+	},
+	meta: {
+		docs: RULE_DOCS["j5-lowercase-title"],
+		messages: { uppercase: "A {{runner}}() title must start lowercase — the test name is a prose fragment, not a sentence (J5 — see docs/10-linting.md)." },
+		type: "problem"
+	}
+};
+//#endregion
+//#region src/lint/rules/w1-scenario-pure.ts
+/** The scenario-carrying terminal actions: `.visit()` (website) and `.open()` (mobile). */
+const SCENARIO_ACTIONS$1 = /* @__PURE__ */ new Set(["open", "visit"]);
+/**
+* CONVENTIONS W1 — a visit (or mobile open) scenario is the When: the
+* visitor interacts, the capture reflects the final state, and assertions
+* live in the Then on the returned result. An `expect()` inside the scenario
+* callback is flagged.
+*/
+const w1ScenarioPure = {
+	create(context) {
+		return { CallExpression(node) {
+			const callee = node.callee;
+			const member = callee ? memberPropertyName(callee) : void 0;
+			if (member === void 0 || !SCENARIO_ACTIONS$1.has(member)) return;
+			const scenario = node.arguments?.[1];
+			if (scenario?.type !== "ArrowFunctionExpression" && scenario?.type !== "FunctionExpression") return;
+			walk(scenario, (inner) => {
+				if (inner.type !== "CallExpression") return;
+				const innerCallee = inner.callee;
+				if (innerCallee?.type === "Identifier" && innerCallee.name === "expect") context.report({
+					messageId: "expectInScenario",
+					node: inner
+				});
+			});
+		} };
+	},
+	meta: {
+		docs: RULE_DOCS["w1-scenario-pure"],
+		messages: { expectInScenario: "No expect() inside a scenario — the scenario is the When; assert the final state on the returned result in the Then (W1 — see docs/10-linting.md)." },
+		type: "problem"
+	}
+};
+//#endregion
+//#region src/lint/rules/w2w-user-facing-elements.ts
+/** The scenario-carrying terminal actions: `.visit()` (website) and `.open()` (mobile). */
+const SCENARIO_ACTIONS = /* @__PURE__ */ new Set(["open", "visit"]);
 //#endregion
 //#region src/lint/plugin.ts
 /**
@@ -2891,59 +2979,14 @@ const plugin = {
 		"j2-no-sleep-in-specs": j2NoSleepInSpecs,
 		"j3-no-expectless-test": j3NoExpectlessTest,
 		"j4-unique-test-names": j4UniqueTestNames,
-		"j5-lowercase-title": {
-			create(context) {
-				return { CallExpression(node) {
-					const callee = node.callee;
-					const root = chainRootName(callee);
-					if (root === void 0 || !TITLED.has(root)) return;
-					const title = stringValue(node.arguments?.[0]);
-					if (title === void 0) return;
-					const first = [...title][0];
-					if (first === void 0 || !/\p{L}/u.test(first)) return;
-					const firstWord = title.split(/\s+/u)[0];
-					if (ALL_CAPS_IDENTIFIER.test(firstWord)) return;
-					if (first !== first.toLocaleLowerCase()) context.report({
-						data: { runner: root },
-						messageId: "uppercase",
-						node
-					});
-				} };
-			},
-			meta: {
-				docs: RULE_DOCS["j5-lowercase-title"],
-				messages: { uppercase: "A {{runner}}() title must start lowercase — the test name is a prose fragment, not a sentence (J5 — see docs/10-linting.md)." },
-				type: "problem"
-			}
-		},
-		"w1-scenario-pure": {
-			create(context) {
-				return { CallExpression(node) {
-					const callee = node.callee;
-					if (!callee || memberPropertyName(callee) !== "visit") return;
-					const scenario = node.arguments?.[1];
-					if (scenario?.type !== "ArrowFunctionExpression" && scenario?.type !== "FunctionExpression") return;
-					walk(scenario, (inner) => {
-						if (inner.type !== "CallExpression") return;
-						const innerCallee = inner.callee;
-						if (innerCallee?.type === "Identifier" && innerCallee.name === "expect") context.report({
-							messageId: "expectInScenario",
-							node: inner
-						});
-					});
-				} };
-			},
-			meta: {
-				docs: RULE_DOCS["w1-scenario-pure"],
-				messages: { expectInScenario: "No expect() inside a visit scenario — the scenario is the When; assert the final state on the returned result in the Then (W1 — see docs/10-linting.md)." },
-				type: "problem"
-			}
-		},
+		"j5-lowercase-title": j5LowercaseTitle,
+		"w1-scenario-pure": w1ScenarioPure,
 		"w2w-user-facing-elements": {
 			create(context) {
 				return { CallExpression(node) {
 					const callee = node.callee;
-					if (!callee || memberPropertyName(callee) !== "visit") return;
+					const member = callee ? memberPropertyName(callee) : void 0;
+					if (member === void 0 || !SCENARIO_ACTIONS.has(member)) return;
 					const scenario = node.arguments?.[1];
 					if (scenario?.type !== "ArrowFunctionExpression" && scenario?.type !== "FunctionExpression") return;
 					walk(scenario, (inner) => {

package/dist/oxlint.d.cts

@@ -65,7 +65,7 @@ type RuleDoc = {
    * The specification facet the rule guards — segments the catalogue like
    * the constructors segment the API. `'shared'` for cross-facet rules.
    */
-  facet?: 'api' | 'cli' | 'jobs' | 'shared' | 'website';
+  facet?: 'api' | 'cli' | 'jobs' | 'mobile' | 'shared' | 'website';
   /** Convention family letter, e.g. `'A'`. */
   family: string;
   /** Convention code, e.g. `'A1'`. */

package/dist/oxlint.d.ts

@@ -65,7 +65,7 @@ type RuleDoc = {
    * The specification facet the rule guards — segments the catalogue like
    * the constructors segment the API. `'shared'` for cross-facet rules.
    */
-  facet?: 'api' | 'cli' | 'jobs' | 'shared' | 'website';
+  facet?: 'api' | 'cli' | 'jobs' | 'mobile' | 'shared' | 'website';
   /** Convention family letter, e.g. `'A'`. */
   family: string;
   /** Convention code, e.g. `'A1'`. */

package/dist/oxlint.js

@@ -162,7 +162,7 @@ const RULE_DOCS = {
 	},
 	"a2-known-constructors": {
 		channel: "statique",
-		convention: "Quatre constructeurs et seulement quatre : `specification.api()`, `specification.jobs()`, `specification.cli(bin)`, `specification.website()` ; tout autre membre (`.app`, `.http`, `.stack`…) est une erreur.",
+		convention: "Cinq constructeurs et seulement cinq : `specification.api()`, `specification.jobs()`, `specification.cli(bin)`, `specification.website()`, `specification.mobile()` ; tout autre membre (`.app`, `.http`, `.stack`…) est une erreur.",
 		family: "A",
 		id: "A2",
 		rationale: "Une surface fermée empêche l’invention de constructeurs parallèles et garde l’API mémorisable."
@@ -435,16 +435,16 @@ const RULE_DOCS = {
 	},
 	"w1-scenario-pure": {
 		channel: "statique",
-		convention: "Un scénario de visite est le When : le visiteur agit, la capture reflète l’état final ; aucun `expect()` dans le callback — les assertions vivent dans le Then, sur le résultat retourné.",
-		facet: "website",
+		convention: "Un scénario (`.visit()` website, `.open()` mobile) est le When : le visiteur agit, la capture reflète l’état final ; aucun `expect()` dans le callback — les assertions vivent dans le Then, sur le résultat retourné.",
+		facet: "shared",
 		family: "W",
 		id: "W1",
 		rationale: "Séparer l’interaction de l’assertion garde la grammaire setup → action → résultat intacte et les scénarios rejouables."
 	},
 	"w2w-user-facing-elements": {
 		channel: "statique",
-		convention: "Les éléments d’un scénario sont user-facing (`button`, `link`, `field`, `heading`, `content`) ; `testId()` est l’unique échappatoire et déclenche un avertissement.",
-		facet: "website",
+		convention: "Les éléments d’un scénario sont user-facing (`button`, `link`, `field`, `heading`, `content` ; côté mobile `button`, `field`, `content`) ; `testId()` est l’unique échappatoire et déclenche un avertissement.",
+		facet: "shared",
 		family: "W",
 		id: "W2",
 		rationale: "Tester ce que l’utilisateur voit (rôles, labels) rend les specs robustes aux refontes DOM ; un test-id contourne cette garantie."
@@ -569,13 +569,22 @@ const RUNTIME_RULES = [
 	},
 	{
 		channel: "runtime",
-		convention: "Un descripteur d’élément doit désigner exactement UN élément : si plusieurs correspondent, l’action est refusée avec une erreur qui énumère les candidats et propose les réécritures (`within(...)`, `{ exact: true }`). Le framework n’agit jamais sur « le premier ».",
-		facet: "website",
+		convention: "Un descripteur d’élément doit désigner exactement UN élément quand un verbe AGIT dessus (`click`/`tap`/`fill`) : si plusieurs correspondent, l’action est refusée avec une erreur qui énumère les candidats et propose les réécritures (`within(...)`, `{ exact: true }`). Le framework n’agit jamais sur « le premier ». Vaut pour les deux facettes à scénario : website et mobile ; sur mobile, `see()` — qui n’agit sur rien — est satisfait par n’importe quel match visible (l’arbre XCUITest duplique légitimement un label entre conteneur et enfant).",
+		facet: "shared",
 		family: "W",
 		id: "W3",
 		name: "w3-unambiguous-element",
 		rationale: "Agir sur le premier match rend le spec vert alors que le visiteur clique autre chose, et rien ne le signale jamais — une ambiguïté est une faute d’écriture, pas un cas à arbitrer par l’ordre du DOM. Le comptage n’existe qu’à l’exécution : aucune analyse statique ne peut le faire, d’où le canal runtime."
 	},
+	{
+		channel: "runtime",
+		convention: "Le vocabulaire d’éléments est UNIQUE entre les facettes website et mobile ; un landmark ARIA (`main()`, `navigation()`…) passé à un verbe mobile est refusé à l’exécution — un écran iOS n’a pas de régions ARIA ; scoper avec `within(testId(…), …)`.",
+		facet: "mobile",
+		family: "W",
+		id: "W4",
+		name: "w4-no-landmarks-on-mobile",
+		rationale: "Un seul vocabulaire garde l’API mémorisable ; refuser explicitement la partie sans équivalent iOS évite une approximation silencieuse."
+	},
 	{
 		channel: "runtime",
 		convention: "`.intercept()` n’existe que sur `api`/`jobs` et lève immédiatement en mode compose (MSW est in-process).",
@@ -761,18 +770,19 @@ const a10DuplicateBinding = {
 };
 //#endregion
 //#region src/lint/rules/a2-known-constructors.ts
-/** The four constructors, and only four (A2 — see docs/10-linting.md). */
+/** The five constructors, and only five (A2 — see docs/10-linting.md). */
 const KNOWN_CONSTRUCTORS = /* @__PURE__ */ new Set([
 	"api",
 	"cli",
 	"jobs",
+	"mobile",
 	"website"
 ]);
 /**
 * CONVENTIONS A2 — `specification.api()`, `specification.jobs()`,
-* `specification.cli()` and `specification.website()` are the only members.
-* Any other access (`specification.app`, `.http`, `.stack`, …) is flagged at
-* the member site.
+* `specification.cli()`, `specification.website()` and
+* `specification.mobile()` are the only members. Any other access
+* (`specification.app`, `.http`, `.stack`, …) is flagged at the member site.
 */
 const a2KnownConstructors = {
 	create(context) {
@@ -789,7 +799,7 @@ const a2KnownConstructors = {
 	},
 	meta: {
 		docs: RULE_DOCS["a2-known-constructors"],
-		messages: { unknownConstructor: "specification.{{member}} does not exist — the only constructors are specification.api(), specification.jobs(), specification.cli() and specification.website() (A2 — see docs/10-linting.md)." },
+		messages: { unknownConstructor: "specification.{{member}} does not exist — the only constructors are specification.api(), specification.jobs(), specification.cli(), specification.website() and specification.mobile() (A2 — see docs/10-linting.md)." },
 		type: "problem"
 	}
 };
@@ -2426,6 +2436,7 @@ const f5FixturesOnlyFromTests = {
 */
 const INTEGRATION_DEPS = {
 	anthropic: ["@anthropic-ai/sdk"],
+	appium: ["webdriverio"],
 	compose: ["yaml"],
 	docker: [],
 	hono: ["hono", "@hono/node-server"],
@@ -2503,6 +2514,7 @@ const i1LayerBoundaries = {
 				if (target.startsWith("core/") || target.startsWith("integrations/docker/") || target.startsWith("integrations/hono/") || withoutExtension(target) === "vitest/matchers") return null;
 				if (target.startsWith("integrations/msw/") && inside === "core/specification/shared/builder.ts") return null;
 				if (target.startsWith("integrations/playwright/") && inside === "core/specification/website/start-website.ts") return null;
+				if (target.startsWith("integrations/appium/") && inside === "core/specification/mobile/start-mobile.ts") return null;
 				return "crossLayer";
 			}
 			if (layer === "integrations") return target.startsWith("core/") || target.startsWith(`integrations/${integrationFolder}/`) ? null : "crossLayer";
@@ -2828,6 +2840,82 @@ const TITLED = /* @__PURE__ */ new Set([
 * `HTTP`, `DI`. Such a word names a symbol verbatim — lowercasing it would
 * misspell it — so it is exempt. A prose word (`Rejects`, `Builds`) is not. */
 const ALL_CAPS_IDENTIFIER = /^[A-Z][A-Z0-9_]*$/u;
+/**
+* CONVENTIONS J5 — the first character of a `test('…')` / `describe('…')` title
+* literal must be lowercase.
+*
+* The test name is the sole description of behaviour (B3): a sentence fragment,
+* lowercase-led like prose (`'rejects an unknown job'`). Exempt are titles
+* whose first WORD is an identifier-shaped all-caps/underscored token
+* (`'VALID_CATEGORIES is rejected'`, `'HTTP is upgraded'`, `'DI wires …'`) —
+* lowercasing a named symbol would misspell it — and titles opening on a
+* non-letter (a `$`, a `{`, a `%s` placeholder). Only lowercase-able prose
+* first words are enforced. Covers the modifier and parametrized forms
+* (`test.only`, `describe.each(...)(...)`) via the chain root.
+*/
+const j5LowercaseTitle = {
+	create(context) {
+		return { CallExpression(node) {
+			const callee = node.callee;
+			const root = chainRootName(callee);
+			if (root === void 0 || !TITLED.has(root)) return;
+			const title = stringValue(node.arguments?.[0]);
+			if (title === void 0) return;
+			const first = [...title][0];
+			if (first === void 0 || !/\p{L}/u.test(first)) return;
+			const firstWord = title.split(/\s+/u)[0];
+			if (ALL_CAPS_IDENTIFIER.test(firstWord)) return;
+			if (first !== first.toLocaleLowerCase()) context.report({
+				data: { runner: root },
+				messageId: "uppercase",
+				node
+			});
+		} };
+	},
+	meta: {
+		docs: RULE_DOCS["j5-lowercase-title"],
+		messages: { uppercase: "A {{runner}}() title must start lowercase — the test name is a prose fragment, not a sentence (J5 — see docs/10-linting.md)." },
+		type: "problem"
+	}
+};
+//#endregion
+//#region src/lint/rules/w1-scenario-pure.ts
+/** The scenario-carrying terminal actions: `.visit()` (website) and `.open()` (mobile). */
+const SCENARIO_ACTIONS$1 = /* @__PURE__ */ new Set(["open", "visit"]);
+/**
+* CONVENTIONS W1 — a visit (or mobile open) scenario is the When: the
+* visitor interacts, the capture reflects the final state, and assertions
+* live in the Then on the returned result. An `expect()` inside the scenario
+* callback is flagged.
+*/
+const w1ScenarioPure = {
+	create(context) {
+		return { CallExpression(node) {
+			const callee = node.callee;
+			const member = callee ? memberPropertyName(callee) : void 0;
+			if (member === void 0 || !SCENARIO_ACTIONS$1.has(member)) return;
+			const scenario = node.arguments?.[1];
+			if (scenario?.type !== "ArrowFunctionExpression" && scenario?.type !== "FunctionExpression") return;
+			walk(scenario, (inner) => {
+				if (inner.type !== "CallExpression") return;
+				const innerCallee = inner.callee;
+				if (innerCallee?.type === "Identifier" && innerCallee.name === "expect") context.report({
+					messageId: "expectInScenario",
+					node: inner
+				});
+			});
+		} };
+	},
+	meta: {
+		docs: RULE_DOCS["w1-scenario-pure"],
+		messages: { expectInScenario: "No expect() inside a scenario — the scenario is the When; assert the final state on the returned result in the Then (W1 — see docs/10-linting.md)." },
+		type: "problem"
+	}
+};
+//#endregion
+//#region src/lint/rules/w2w-user-facing-elements.ts
+/** The scenario-carrying terminal actions: `.visit()` (website) and `.open()` (mobile). */
+const SCENARIO_ACTIONS = /* @__PURE__ */ new Set(["open", "visit"]);
 //#endregion
 //#region src/lint/plugin.ts
 /**
@@ -2887,59 +2975,14 @@ const plugin = {
 		"j2-no-sleep-in-specs": j2NoSleepInSpecs,
 		"j3-no-expectless-test": j3NoExpectlessTest,
 		"j4-unique-test-names": j4UniqueTestNames,
-		"j5-lowercase-title": {
-			create(context) {
-				return { CallExpression(node) {
-					const callee = node.callee;
-					const root = chainRootName(callee);
-					if (root === void 0 || !TITLED.has(root)) return;
-					const title = stringValue(node.arguments?.[0]);
-					if (title === void 0) return;
-					const first = [...title][0];
-					if (first === void 0 || !/\p{L}/u.test(first)) return;
-					const firstWord = title.split(/\s+/u)[0];
-					if (ALL_CAPS_IDENTIFIER.test(firstWord)) return;
-					if (first !== first.toLocaleLowerCase()) context.report({
-						data: { runner: root },
-						messageId: "uppercase",
-						node
-					});
-				} };
-			},
-			meta: {
-				docs: RULE_DOCS["j5-lowercase-title"],
-				messages: { uppercase: "A {{runner}}() title must start lowercase — the test name is a prose fragment, not a sentence (J5 — see docs/10-linting.md)." },
-				type: "problem"
-			}
-		},
-		"w1-scenario-pure": {
-			create(context) {
-				return { CallExpression(node) {
-					const callee = node.callee;
-					if (!callee || memberPropertyName(callee) !== "visit") return;
-					const scenario = node.arguments?.[1];
-					if (scenario?.type !== "ArrowFunctionExpression" && scenario?.type !== "FunctionExpression") return;
-					walk(scenario, (inner) => {
-						if (inner.type !== "CallExpression") return;
-						const innerCallee = inner.callee;
-						if (innerCallee?.type === "Identifier" && innerCallee.name === "expect") context.report({
-							messageId: "expectInScenario",
-							node: inner
-						});
-					});
-				} };
-			},
-			meta: {
-				docs: RULE_DOCS["w1-scenario-pure"],
-				messages: { expectInScenario: "No expect() inside a visit scenario — the scenario is the When; assert the final state on the returned result in the Then (W1 — see docs/10-linting.md)." },
-				type: "problem"
-			}
-		},
+		"j5-lowercase-title": j5LowercaseTitle,
+		"w1-scenario-pure": w1ScenarioPure,
 		"w2w-user-facing-elements": {
 			create(context) {
 				return { CallExpression(node) {
 					const callee = node.callee;
-					if (!callee || memberPropertyName(callee) !== "visit") return;
+					const member = callee ? memberPropertyName(callee) : void 0;
+					if (member === void 0 || !SCENARIO_ACTIONS.has(member)) return;
 					const scenario = node.arguments?.[1];
 					if (scenario?.type !== "ArrowFunctionExpression" && scenario?.type !== "FunctionExpression") return;
 					walk(scenario, (inner) => {

package/dist/playwright.adapter.js

@@ -1,131 +1,7 @@
+import { n as describeAmbiguity, t as AmbiguousElementError } from "./ambiguity.js";
 import { mkdtempSync } from "node:fs";
 import { resolve } from "node:path";
 import { tmpdir } from "node:os";
-//#region src/core/specification/website/ambiguity.ts
-/**
-* The ambiguity refusal — CONVENTIONS W3.
-*
-* A visit descriptor must designate exactly one element. Acting on "the
-* first match" is the failure mode this module exists to prevent: the spec
-* keeps passing while the visitor clicks something else, and nothing ever
-* reports it. So when a descriptor matches several elements the framework
-* refuses, and the refusal has to carry everything needed to fix it without
-* opening a browser — the descriptor in the caller's own vocabulary, every
-* candidate, and the concrete rewrites that would resolve it.
-*
-* Pure string building: it takes captured data and returns a message, so the
-* wording is unit-testable and the browser integration stays a thin adapter.
-*/
-/** `kind` → the constructor that builds it, so errors echo the caller's source. */
-const CONSTRUCTORS = {
-	banner: "banner",
-	button: "button",
-	complementary: "complementary",
-	contentinfo: "contentinfo",
-	field: "field",
-	form: "form",
-	heading: "heading",
-	link: "link",
-	main: "main",
-	navigation: "navigation",
-	region: "region",
-	search: "search",
-	testId: "testId",
-	text: "content"
-};
-/** The landmark a context string maps back to, for a copy-pasteable suggestion. */
-const CONTEXT_LANDMARKS = {
-	aside: "complementary()",
-	banner: "banner()",
-	complementary: "complementary()",
-	contentinfo: "contentinfo()",
-	footer: "contentinfo()",
-	form: "form()",
-	header: "banner()",
-	main: "main()",
-	nav: "navigation()",
-	navigation: "navigation()",
-	search: "search()"
-};
-/**
-* 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.
-*/
-function formatElement(element) {
-	const bare = formatBare(element);
-	return element.scope ? `within(${formatElement(element.scope)}, ${bare})` : bare;
-}
-function formatBare(element) {
-	const args = [];
-	if (element.name !== void 0) args.push(JSON.stringify(element.name));
-	if (element.exact) args.push("{ exact: true }");
-	return `${CONSTRUCTORS[element.kind]}(${args.join(", ")})`;
-}
-/** `1. <a href="/articles">Articles</a>  in <nav>` — one evidence line per candidate. */
-function formatMatch(match, index) {
-	const attribute = match.detail ? ` ${quoteDetail(match)}` : "";
-	const context = match.context ? `  in <${match.context}>` : "";
-	return `  ${index + 1}. <${match.tag}${attribute}>${match.text}</${match.tag}>${context}`;
-}
-function quoteDetail(match) {
-	return `${match.tag === "a" ? "href" : "name"}=${JSON.stringify(match.detail)}`;
-}
-/**
-* 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.
-*/
-function formatFixes(element, matches) {
-	const fixes = [];
-	const landmarks = [...new Set(matches.map((match) => match.context && CONTEXT_LANDMARKS[match.context]).filter((landmark) => Boolean(landmark)))];
-	if (landmarks.length > 0 && !element.scope) fixes.push(`scope it       within(${landmarks[0]}, ${formatBare(element)})${landmarks.length > 1 ? `   [also here: ${landmarks.slice(1).join(", ")}]` : ""}`);
-	else if (!element.scope) fixes.push(`scope it       within(main(), ${formatBare(element)})`);
-	if (!element.exact && 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,
-			exact: true
-		})}   [leaves ${remaining} of ${matches.length}]`);
-	}
-	fixes.push("other element  a heading(), button() or field() may name one thing where this does not");
-	return fixes;
-}
-/**
-* The W3 refusal. A distinct class so the visit wrapper can recognize an
-* already-complete message and let it through instead of nesting it inside
-* `visit scenario failed: …`, which would print the whole thing twice.
-*/
-var AmbiguousElementError = class extends Error {
-	name = "AmbiguousElementError";
-};
-/**
-* Build the refusal thrown when a descriptor matches more than one element.
-*
-* @param options.element The descriptor as the caller wrote it.
-* @param options.matches Every candidate, in DOM order (already truncated).
-* @param options.url The page the visitor was on when it happened.
-*/
-function describeAmbiguity(options) {
-	const { element, matches, url } = options;
-	const fixes = formatFixes(element, matches).map((fix) => `  • ${fix}`);
-	return [
-		`Ambiguous element: ${formatElement(element)} matched ${matches.length} elements on ${url}.`,
-		"",
-		"A spec must designate exactly one element. Acting on the first match would let",
-		"this test keep passing while the visitor interacts with something else.",
-		"",
-		"Matched:",
-		...matches.map((match, index) => formatMatch(match, index)),
-		"",
-		"Disambiguate with one of:",
-		...fixes,
-		"",
-		"Docs: docs/11-website.md#designating-exactly-one-element (CONVENTIONS W3)"
-	].join("\n");
-}
-//#endregion
 //#region src/integrations/playwright/playwright.adapter.ts
 /** How many candidates the ambiguity error enumerates before truncating. */
 const MAX_REPORTED_MATCHES = 10;
@@ -245,9 +121,9 @@ var PlaywrightAdapter = class {
 	async open(url, options) {
 		const context = await (await this.launch()).newContext({ extraHTTPHeaders: options.headers });
 		if (options.external === "block") {
-			const origin = new URL(options.baseUrl).origin;
+			const allowed = /* @__PURE__ */ new Set([new URL(options.baseUrl).origin, ...options.allowedOrigins ?? []]);
 			await context.route("**/*", (route) => {
-				if (new URL(route.request().url()).origin === origin) route.continue();
+				if (allowed.has(new URL(route.request().url()).origin)) route.continue();
 				else route.abort();
 			});
 		}