@jterrazz/test 14.1.0 → 14.3.0

package/dist/appium.adapter.js

@@ -179,12 +179,12 @@ function projectScreen(xml) {
 }
 //#endregion
 //#region src/integrations/appium/appium.adapter.ts
-const ACTION_TIMEOUT_MS = 3e4;
+const DEFAULT_ACTION_TIMEOUT_MS = 3e4;
 const POLL_INTERVAL_MS = 500;
 /** How many candidates the ambiguity error enumerates before truncating. */
 const MAX_REPORTED_MATCHES = 10;
 /** WebDriverAgent builds once per simulator — the first session is the slow one. */
-const WDA_LAUNCH_TIMEOUT_MS = 24e4;
+const DEFAULT_WDA_LAUNCH_TIMEOUT_MS = 24e4;
 const delay = (ms) => new Promise((resolveDelay) => setTimeout(resolveDelay, ms));
 /** Escape a name for an NSPredicate single-quoted string literal. */
 function escapePredicate(value) {
@@ -213,6 +213,19 @@ function scopeChain(element) {
 	for (let current = element; current; current = current.scope) chain.unshift(current);
 	return chain;
 }
+/**
+* Load webdriverio's session factory, naming the install when the optional
+* peer dependency is absent. Lazy: the dependency is only required by a spec
+* that actually opens the app.
+*/
+async function loadRemote() {
+	try {
+		const { remote: remoteFn } = await import("webdriverio");
+		return remoteFn;
+	} catch {
+		throw new Error(".open() requires webdriverio (optional peer dependency): npm install -D appium webdriverio && npx appium driver install xcuitest");
+	}
+}
 /** Capture one candidate's evidence for the ambiguity refusal. */
 async function captureMatch(element) {
 	const [type, label, value, identifier] = await Promise.all([
@@ -241,10 +254,27 @@ async function captureMatch(element) {
 * this module is only loaded when a spec calls `.open()`.
 */
 var AppiumAdapter = class {
+	/** The verb poll budget — the runner's `timeouts.action`, or the default. */
+	actionTimeoutMs;
 	driver = null;
+	/** The WebDriverAgent launch budget — the runner's `timeouts.launch`, or the default. */
+	launchTimeoutMs;
 	options;
+	/**
+	* The session factory. Absent in production — webdriverio is then loaded
+	* lazily on the first `open()`. Injected by this module's own unit test,
+	* which drives the waits over a stub driver with no simulator in reach
+	* (mocks are CODE here, CONVENTIONS I4).
+	*/
+	remote;
 	constructor(options) {
-		this.options = options;
+		this.options = {
+			serverUrl: options.serverUrl,
+			udid: options.udid
+		};
+		this.remote = options.remote;
+		this.actionTimeoutMs = options.timeouts?.action ?? DEFAULT_ACTION_TIMEOUT_MS;
+		this.launchTimeoutMs = options.timeouts?.launch ?? DEFAULT_WDA_LAUNCH_TIMEOUT_MS;
 	}
 	async close() {
 		if (this.driver) {
@@ -305,7 +335,7 @@ var AppiumAdapter = class {
 	*/
 	async resolveOne(driver, element, verb, cardinality) {
 		const chain = scopeChain(element);
-		const deadline = Date.now() + ACTION_TIMEOUT_MS;
+		const deadline = Date.now() + this.actionTimeoutMs;
 		let scrollAttempted = false;
 		for (;;) {
 			const resolved = await this.resolveChain(driver, chain, cardinality, { tryScroll: !scrollAttempted });
@@ -367,17 +397,12 @@ var AppiumAdapter = class {
 			const labels = [...new Set([...source.matchAll(/label="(?<label>[^"]{2,60})"/g)].map((match) => match.groups?.["label"] ?? ""))].slice(0, 15);
 			if (labels.length > 0) excerpt = `\nCurrently on screen: ${labels.join(" | ")}`;
 		} catch {}
-		return /* @__PURE__ */ new Error(`${verb}(${formatElement(element)}) timed out after ${ACTION_TIMEOUT_MS}ms — no visible match.${excerpt}`);
+		return /* @__PURE__ */ new Error(`${verb}(${formatElement(element)}) timed out after ${this.actionTimeoutMs}ms — no visible match.${excerpt}`);
 	}
 	/** Create the shared driver session (once), with an actionable error when webdriverio is absent. */
 	async session(bundleId) {
 		if (this.driver) return this.driver;
-		let remoteFn;
-		try {
-			({remote: remoteFn} = await import("webdriverio"));
-		} catch {
-			throw new Error(".open() requires webdriverio (optional peer dependency): npm install -D appium webdriverio && npx appium driver install xcuitest");
-		}
+		const remoteFn = this.remote ?? await loadRemote();
 		const url = new URL(this.options.serverUrl);
 		this.driver = await remoteFn({
 			capabilities: {
@@ -385,7 +410,7 @@ var AppiumAdapter = class {
 				"appium:bundleId": bundleId,
 				"appium:noReset": true,
 				"appium:udid": this.options.udid,
-				"appium:wdaLaunchTimeout": WDA_LAUNCH_TIMEOUT_MS,
+				"appium:wdaLaunchTimeout": this.launchTimeoutMs,
 				platformName: "iOS"
 			},
 			hostname: url.hostname,

package/dist/artifacts.js

@@ -932,6 +932,95 @@ function removeContainers(ids) {
 	} catch {}
 }
 //#endregion
+//#region src/core/specification/shared/resolve.ts
+/** What makes a directory a project root — a manifest, or a test stack. */
+const ROOT_MARKERS = ["package.json", "docker/compose.test.yaml"];
+/**
+* The NEAREST ancestor of `startDir` (itself included) carrying a root marker,
+* `undefined` when none does.
+*
+* Both markers are probed at each ancestor, in ONE walk. Two walks — the
+* compose file all the way up, then `package.json` all the way up — made the
+* further directory win: in a workspace, a `docker/compose.test.yaml` at the
+* repository root outranked the `package.json` of the very package being
+* tested, and every path the runner resolved was measured from the wrong unit.
+* The unit is the nearest thing that declares itself a project.
+*
+* The existence probe is injected so the lint layer can pass its cached one
+* (A9's `a9w-redundant-root` derives the same root, and must derive it the
+* same way).
+*/
+function findRoot(startDir, exists) {
+	let dir = startDir;
+	for (;;) {
+		if (ROOT_MARKERS.some((marker) => exists(resolve(dir, marker)))) return dir;
+		const parent = dirname(dir);
+		if (parent === dir) return;
+		dir = parent;
+	}
+}
+/**
+* Auto-discover the project root from a starting directory (CONVENTIONS A9):
+* walk up to the first directory that carries `package.json` or
+* `docker/compose.test.yaml`; if none does, the starting directory itself.
+*/
+function discoverRoot(startDir) {
+	return findRoot(startDir, existsSync) ?? startDir;
+}
+/**
+* Resolve the project root for a specification. An explicit `root` option is
+* an override (resolved from the caller's directory when relative); when
+* absent, the root is auto-discovered by walking up from the calling
+* specification file.
+*/
+function resolveRoot(root, callerDir) {
+	if (!root) return discoverRoot(callerDir);
+	if (isAbsolute(root)) return root;
+	return resolve(callerDir, root);
+}
+/**
+* Resolve a command — checks node_modules/.bin, then treats as absolute/PATH.
+*/
+function resolveCommand(command, root) {
+	if (isAbsolute(command)) return command;
+	const binPath = resolve(root, "node_modules/.bin", command);
+	if (existsSync(binPath)) return binPath;
+	const cwdBinPath = resolve(process.cwd(), "node_modules/.bin", command);
+	if (existsSync(cwdBinPath)) return cwdBinPath;
+	return command;
+}
+/**
+* The realpath form of a working directory — what a child process prints as
+* `$PWD` (macOS resolves the tmpdir symlink), and therefore what `{{workdir}}`
+* compares against. Falls back to the path itself when it cannot be resolved.
+*
+* @internal Shared by the result scope, the literate runner and `$WORKDIR`.
+*/
+function safeRealpath(path) {
+	try {
+		return realpathSync(path);
+	} catch {
+		return path;
+	}
+}
+/**
+* Expand the `$WORKDIR` token in every string value of a child environment —
+* the one place the token is spelled out, for both doors (`.env()` on the
+* chain, `env:` in a `<case>.spec.yaml`).
+*
+* It expands to the RESOLVED directory, never the raw temp path: a value the
+* child receives comes back in its output, and it must come back spelled the
+* way `{{workdir}}` holds it (realpath form, CONVENTIONS D4). Expanding the raw
+* path made `HOME=$WORKDIR` on macOS echo `/var/folders/…` against a
+* `{{workdir}}` holding `/private/var/folders/…` — a golden no run could match.
+*/
+function expandWorkdir(env, workDir) {
+	const workdir = safeRealpath(workDir);
+	const expanded = {};
+	for (const [key, value] of Object.entries(env)) expanded[key] = typeof value === "string" ? value.replace(/\$WORKDIR/g, workdir) : value;
+	return expanded;
+}
+//#endregion
 //#region src/core/specification/shared/result/result.ts
 /**
 * Base result - common accessors available after any action type.
@@ -986,20 +1075,6 @@ var BaseResult = class {
 	}
 };
 /**
-* The realpath form of a working directory — what a child process prints as
-* `$PWD` (macOS resolves the tmpdir symlink), and therefore what `{{workdir}}`
-* compares against. Falls back to the path itself when it cannot be resolved.
-*
-* @internal Shared with the literate runner, which builds its own file-wide scope.
-*/
-function safeRealpath(path) {
-	try {
-		return realpathSync(path);
-	} catch {
-		return path;
-	}
-}
-/**
 * Enforce CONVENTIONS A7: with two or more databases in the services record
 * the `database` option is mandatory on `.seed()` / `.table()`; with exactly
 * one it is forbidden (redundant).
@@ -1596,11 +1671,19 @@ function updates(outcomes, scope) {
 	}));
 }
 /**
-* Start every server the document names, in declaration order, before the first
-* run. They all stay live for the whole file and are stopped together — one
-* document is one scenario, and its servers are part of its ground.
+* Start every server the document names, in declaration order, after `fixture:`
+* has been copied and before the first run. They all stay live for the whole
+* file and are stopped together — one document is one scenario, and its servers
+* are part of its ground.
+*
+* Every child is seeded with `TEST_WORKDIR`, the resolved working directory the
+* `{{workdir}}` token holds and `$WORKDIR` expands to. The fixtures are already
+* on disk when the child starts, so a served stub reads the world the document
+* laid down exactly as a stub binary reads its own fixture tree: a scenario is
+* a layer of files, never a flag threaded through the server. A document's
+* mapping-form env wins over it, key by key.
 */
-async function startServers(document, config, displayPath) {
+async function startServers(document, config, displayPath, workdir) {
 	const registry = config.serveRegistry ?? {};
 	const started = [];
 	const env = {};
@@ -1617,7 +1700,10 @@ async function startServers(document, config, displayPath) {
 		const adapter = new ServeAdapter({
 			command: registration.command,
 			ready: registration.ready
-		}, config.root ?? process.cwd(), "cli", entry.env);
+		}, config.root ?? process.cwd(), "cli", {
+			TEST_WORKDIR: workdir,
+			...entry.env
+		});
 		started.push(adapter);
 		try {
 			await adapter.start();
@@ -1650,11 +1736,6 @@ function documentEnv(document, config, displayPath) {
 	}
 	return env;
 }
-function expandWorkdir(env, workDir) {
-	const resolved = {};
-	for (const [key, value] of Object.entries(env)) resolved[key] = typeof value === "string" ? value.replace(/\$WORKDIR/g, workDir) : value;
-	return resolved;
-}
 /**
 * Run one spec document end to end and resolve with the LAST run's result —
 * the handle a `.test.ts` adds its own assertion to (a directory golden, a
@@ -1679,8 +1760,9 @@ async function runSpecDocument(options) {
 		const { dest, src } = copyPlan(fixture.path, fileDir, workDir);
 		cpSync(src, dest, { recursive: true });
 	}
-	const servers = await startServers(document, config, displayPath);
-	const scope = new CaptureScope(safeRealpath(workDir));
+	const workdir = safeRealpath(workDir);
+	const servers = await startServers(document, config, displayPath, workdir);
+	const scope = new CaptureScope(workdir);
 	const env = expandWorkdir({
 		...options.baseEnv,
 		...servers.env,
@@ -1734,4 +1816,4 @@ const COVERAGE_DIR = `${VITEST_ARTIFACTS_DIR}/coverage`;
 /** Where `sqlite()` caches the schema template it copies per worker. */
 const SQLITE_TEMPLATE_DIR = `${VITEST_ARTIFACTS_DIR}/sqlite`;
 //#endregion
-export { hasPlaceholders as A, diffDirectories as C, formatStartupReport as D, formatResponseDiff as E, structuralEquals as F, structuralSubset as I, textEquals as L, mergeTextPreservingPlaceholders as M, placeholderPatternSource as N, formatStdoutDiff as O, renderExpected as P, DirectoryAccessor as S, formatDirectoryDiff as T, JsonAccessor as _, specDescription as a, getCallerDir as b, shouldUpdateSnapshots as c, BaseResult as d, validateDatabaseOption as f, TableAccessor as g, removeContainers as h, runSpecDocument as i, mergePreservingPlaceholders as j, formatTableDiff as k, ContainerAccessor as l, inspectContainer as m, SQLITE_TEMPLATE_DIR as n, ServeAdapter as o, findContainersByLabel as p, VITEST_ARTIFACTS_DIR as r, UPDATE_HINT as s, COVERAGE_DIR as t, CliResult as u, TextAccessor as v, walkDirectory as w, FilesystemAccessor as x, text as y };
+export { formatResponseDiff as A, structuralSubset as B, text as C, diffDirectories as D, DirectoryAccessor as E, mergePreservingPlaceholders as F, mergeTextPreservingPlaceholders as I, placeholderPatternSource as L, formatStdoutDiff as M, formatTableDiff as N, walkDirectory as O, hasPlaceholders as P, renderExpected as R, TextAccessor as S, FilesystemAccessor as T, textEquals as V, findContainersByLabel as _, specDescription as a, TableAccessor as b, shouldUpdateSnapshots as c, BaseResult as d, validateDatabaseOption as f, resolveRoot as g, resolveCommand as h, runSpecDocument as i, formatStartupReport as j, formatDirectoryDiff as k, ContainerAccessor as l, expandWorkdir as m, SQLITE_TEMPLATE_DIR as n, ServeAdapter as o, discoverRoot as p, VITEST_ARTIFACTS_DIR as r, UPDATE_HINT as s, COVERAGE_DIR as t, CliResult as u, inspectContainer as v, getCallerDir as w, JsonAccessor as x, removeContainers as y, structuralEquals as z };

package/dist/index.d.ts

@@ -798,6 +798,24 @@ interface DeviceOpenOptions {
   /** The interaction scenario to run after launch; the capture reflects the final state. */
   scenario?: MobileScenario;
 }
+/**
+ * How long a device session waits, in milliseconds. Every field is optional
+ * and falls back to the framework's own default, so a runner states only the
+ * wait it needs to move — the defaults suit a release build, and a project
+ * that drives a DEV build pays for its bundler's cold boot.
+ */
+interface DeviceTimeouts {
+  /**
+   * How long every verb polls for a visible match before refusing.
+   * Default: `30_000` — enough for a cold app boot on a release bundle.
+   */
+  action?: number;
+  /**
+   * How long the FIRST session waits for WebDriverAgent to build and
+   * launch on the simulator. Default: `240_000`.
+   */
+  launch?: number;
+}
 /**
  * Abstract device interface for the mobile specification runner.
  * One implementation lives in `integrations/appium/` — a single driver
@@ -1776,6 +1794,13 @@ interface MobileSpecificationOptions {
    * file when absent.
    */
   root?: string;
+  /**
+   * How long this runner's session waits, in milliseconds — every field
+   * optional, each falling back to the framework's default. A project
+   * driving a DEV build states the wait its bundler's cold boot needs
+   * (`{ action: 45_000 }`) instead of sleeping inside its scenarios.
+   */
+  timeouts?: DeviceTimeouts;
 }
 /**
  * The record returned by {@link startMobile | specification.mobile}.
@@ -2512,4 +2537,4 @@ declare module 'vitest' {
   }
 }
 //#endregion
-export { type ApiHandle, type ApiSpecification, type ApiSpecificationOptions, BaseResult, type BrowserConsoleMessage, type BrowserLinkElement, type BrowserMetaElement, type BrowserOpenOptions, type BrowserPage, type BrowserPort, type CaptureScope, type CliEnv, type CliHandle, type CliInput, type CliOutput, type CliPort, CliResult, type CliSpecification, type CliSpecificationOptions, ContainerAccessor, type ContainerPort, type Contract, type ContractInput, type ContractRequest, type ContractResponder, type ContractResponse, type ContractResponseValue, type Contracts, type DatabaseKeys, type DatabasePort, type DeviceOpenOptions, type DevicePort, type DeviceScreen, DirectoryAccessor, type DockerSpecConfig, type ElementKind, type ElementMatch, type ElementOptions, type ElementRef, type ExecOptions, FetchResult, type FileAccessor, FilesystemAccessor, type HonoApp, type HttpContractFilter, type HttpResponseInit, HttpResult, type IsolationStrategy, type JobHandle, type JobsHandle, type JobsSpecification, type JobsSpecificationOptions, JsonAccessor, type LandmarkKind, type LiterateRunFlags, type LiterateServeRegistration, type MatchFixtureOptions, type MatchableRequest, Matcher, type MatcherKind, type MobileBackendOptions, type MobileElementKind, type MobileElementMatch, type MobileElementRef, type MobileHandle, type MobileScenario, type MobileSpecification, type MobileSpecificationOptions, type MobileVisitor, type MockDatePort, type MockPort, Orchestrator, PageResult, type PostgresOptions, type RedisOptions, ResponseAccessor, type ScreenNode, ScreenResult, type ServeOptions, type ServerPort, type ServerResponse, type ServiceHandle, type ServiceRecord, type SpecDocument, type SpecEnvToken, type SpecFileAssertion, type SpecFixture, type SpecKind, type SpecRun, type SpecServeEntry, type SpecStream, type SpecificationConfig, type SpecificationMode, type SqliteOptions, TableAccessor, TextAccessor, type TextFilter, type VisitScenario, type Visitor, type WebsiteBackendOptions, type WebsiteHandle, type WebsiteSpecification, type WebsiteSpecificationOptions, anthropic, banner, button, complementary, content, contentinfo, defineContract, defineContracts, field, findContainersByLabel, form, heading, http, inspectContainer, link, main, match, mockOf, mockOfDate, navigation, openai, postgres, redis, region, removeContainers, search, specification, sqlite, testId, text, within };
+export { type ApiHandle, type ApiSpecification, type ApiSpecificationOptions, BaseResult, type BrowserConsoleMessage, type BrowserLinkElement, type BrowserMetaElement, type BrowserOpenOptions, type BrowserPage, type BrowserPort, type CaptureScope, type CliEnv, type CliHandle, type CliInput, type CliOutput, type CliPort, CliResult, type CliSpecification, type CliSpecificationOptions, ContainerAccessor, type ContainerPort, type Contract, type ContractInput, type ContractRequest, type ContractResponder, type ContractResponse, type ContractResponseValue, type Contracts, type DatabaseKeys, type DatabasePort, type DeviceOpenOptions, type DevicePort, type DeviceScreen, type DeviceTimeouts, DirectoryAccessor, type DockerSpecConfig, type ElementKind, type ElementMatch, type ElementOptions, type ElementRef, type ExecOptions, FetchResult, type FileAccessor, FilesystemAccessor, type HonoApp, type HttpContractFilter, type HttpResponseInit, HttpResult, type IsolationStrategy, type JobHandle, type JobsHandle, type JobsSpecification, type JobsSpecificationOptions, JsonAccessor, type LandmarkKind, type LiterateRunFlags, type LiterateServeRegistration, type MatchFixtureOptions, type MatchableRequest, Matcher, type MatcherKind, type MobileBackendOptions, type MobileElementKind, type MobileElementMatch, type MobileElementRef, type MobileHandle, type MobileScenario, type MobileSpecification, type MobileSpecificationOptions, type MobileVisitor, type MockDatePort, type MockPort, Orchestrator, PageResult, type PostgresOptions, type RedisOptions, ResponseAccessor, type ScreenNode, ScreenResult, type ServeOptions, type ServerPort, type ServerResponse, type ServiceHandle, type ServiceRecord, type SpecDocument, type SpecEnvToken, type SpecFileAssertion, type SpecFixture, type SpecKind, type SpecRun, type SpecServeEntry, type SpecStream, type SpecificationConfig, type SpecificationMode, type SqliteOptions, TableAccessor, TextAccessor, type TextFilter, type VisitScenario, type Visitor, type WebsiteBackendOptions, type WebsiteHandle, type WebsiteSpecification, type WebsiteSpecificationOptions, anthropic, banner, button, complementary, content, contentinfo, defineContract, defineContracts, field, findContainersByLabel, form, heading, http, inspectContainer, link, main, match, mockOf, mockOfDate, navigation, openai, postgres, redis, region, removeContainers, search, specification, sqlite, testId, text, within };

package/dist/index.js

@@ -1,8 +1,8 @@
 import { a as copyPlan, c as GROUND_EXPECTED, d as GROUND_SEEDS, i as match, n as Matcher, t as CaptureScope, u as GROUND_REQUESTS } from "./match.js";
-import { C as diffDirectories, D as formatStartupReport, E as formatResponseDiff, F as structuralEquals, I as structuralSubset, L as textEquals, M as mergeTextPreservingPlaceholders, O as formatStdoutDiff, P as renderExpected, S as DirectoryAccessor, T as formatDirectoryDiff, _ as JsonAccessor, b as getCallerDir, c as shouldUpdateSnapshots, d as BaseResult, f as validateDatabaseOption, g as TableAccessor, h as removeContainers, i as runSpecDocument, j as mergePreservingPlaceholders, k as formatTableDiff, l as ContainerAccessor, m as inspectContainer, n as SQLITE_TEMPLATE_DIR, o as ServeAdapter, p as findContainersByLabel, s as UPDATE_HINT, u as CliResult, v as TextAccessor, w as walkDirectory, x as FilesystemAccessor, y as text } from "./artifacts.js";
+import { A as formatResponseDiff, B as structuralSubset, C as text, D as diffDirectories, E as DirectoryAccessor, F as mergePreservingPlaceholders, I as mergeTextPreservingPlaceholders, M as formatStdoutDiff, N as formatTableDiff, O as walkDirectory, R as renderExpected, S as TextAccessor, T as FilesystemAccessor, V as textEquals, _ as findContainersByLabel, b as TableAccessor, c as shouldUpdateSnapshots, d as BaseResult, f as validateDatabaseOption, g as resolveRoot, h as resolveCommand, i as runSpecDocument, j as formatStartupReport, k as formatDirectoryDiff, l as ContainerAccessor, m as expandWorkdir, n as SQLITE_TEMPLATE_DIR, o as ServeAdapter, p as discoverRoot, s as UPDATE_HINT, u as CliResult, v as inspectContainer, w as getCallerDir, x as JsonAccessor, y as removeContainers, z as structuralEquals } from "./artifacts.js";
 import { a as isContract, i as defineContracts, n as contractsOf, o as isContracts, r as defineContract, t as ContractQueue } from "./queue.js";
 import { closeSync, copyFileSync, cpSync, existsSync, mkdirSync, mkdtempSync, openSync, readFileSync, readSync, readdirSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync, writeSync } from "node:fs";
-import { dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { dirname, join, relative, resolve } from "node:path";
 import { parse } from "yaml";
 import { execFile, execSync, spawn, spawnSync } from "node:child_process";
 import { Client } from "pg";
@@ -1092,8 +1092,10 @@ var SpecificationBuilder = class {
 	* Set environment variables for the command process. Merged on top of process.env.
 	* Use `null` to unset a variable. Multiple calls merge.
 	*
-	* The token `$WORKDIR` (in any value) is replaced with the actual working
-	* directory at run-time — useful for tests that need a fully isolated `HOME`.
+	* The token `$WORKDIR` (in any value) is replaced at run-time with the
+	* spec's working directory in its resolved form — the same string
+	* `{{workdir}}` asserts against — so a path handed to the child comes back
+	* matchable. Useful for tests that need a fully isolated `HOME`.
 	*
 	* @example
 	*   cli.env({ HOME: "$WORKDIR", TZ: "UTC" }).exec("status");
@@ -1346,14 +1348,8 @@ var SpecificationBuilder = class {
 		}
 	}
 	resolveEnv(workDir) {
-		const keys = Object.keys(this.commandEnv);
-		if (keys.length === 0) return;
-		const resolved = {};
-		for (const key of keys) {
-			const value = this.commandEnv[key];
-			resolved[key] = typeof value === "string" ? value.replace(/\$WORKDIR/g, workDir) : value;
-		}
-		return resolved;
+		if (Object.keys(this.commandEnv).length === 0) return;
+		return expandWorkdir(this.commandEnv, workDir);
 	}
 	prepareWorkDir() {
 		return mkdtempSync(resolve(tmpdir(), "spec-command-"));
@@ -1890,64 +1886,6 @@ var Orchestrator = class {
 	}
 };
 //#endregion
-//#region src/core/specification/shared/resolve.ts
-/** What makes a directory a project root — a manifest, or a test stack. */
-const ROOT_MARKERS = ["package.json", "docker/compose.test.yaml"];
-/**
-* The NEAREST ancestor of `startDir` (itself included) carrying a root marker,
-* `undefined` when none does.
-*
-* Both markers are probed at each ancestor, in ONE walk. Two walks — the
-* compose file all the way up, then `package.json` all the way up — made the
-* further directory win: in a workspace, a `docker/compose.test.yaml` at the
-* repository root outranked the `package.json` of the very package being
-* tested, and every path the runner resolved was measured from the wrong unit.
-* The unit is the nearest thing that declares itself a project.
-*
-* The existence probe is injected so the lint layer can pass its cached one
-* (A9's `a9w-redundant-root` derives the same root, and must derive it the
-* same way).
-*/
-function findRoot(startDir, exists) {
-	let dir = startDir;
-	for (;;) {
-		if (ROOT_MARKERS.some((marker) => exists(resolve(dir, marker)))) return dir;
-		const parent = dirname(dir);
-		if (parent === dir) return;
-		dir = parent;
-	}
-}
-/**
-* Auto-discover the project root from a starting directory (CONVENTIONS A9):
-* walk up to the first directory that carries `package.json` or
-* `docker/compose.test.yaml`; if none does, the starting directory itself.
-*/
-function discoverRoot(startDir) {
-	return findRoot(startDir, existsSync) ?? startDir;
-}
-/**
-* Resolve the project root for a specification. An explicit `root` option is
-* an override (resolved from the caller's directory when relative); when
-* absent, the root is auto-discovered by walking up from the calling
-* specification file.
-*/
-function resolveRoot(root, callerDir) {
-	if (!root) return discoverRoot(callerDir);
-	if (isAbsolute(root)) return root;
-	return resolve(callerDir, root);
-}
-/**
-* Resolve a command — checks node_modules/.bin, then treats as absolute/PATH.
-*/
-function resolveCommand(command, root) {
-	if (isAbsolute(command)) return command;
-	const binPath = resolve(root, "node_modules/.bin", command);
-	if (existsSync(binPath)) return binPath;
-	const cwdBinPath = resolve(process.cwd(), "node_modules/.bin", command);
-	if (existsSync(cwdBinPath)) return cwdBinPath;
-	return command;
-}
-//#endregion
 //#region src/core/specification/shared/services.ts
 function getWorkerId() {
 	return process.env.VITEST_POOL_ID ?? "0";
@@ -2615,6 +2553,7 @@ async function startMobile(options) {
 			const { AppiumAdapter } = await import("./appium.adapter.js");
 			device = new AppiumAdapter({
 				serverUrl: appium.url,
+				timeouts: options.timeouts,
 				udid
 			});
 		}

package/dist/queue.js

@@ -1,5 +1,5 @@
 import { t as CaptureScope } from "./match.js";
-import { A as hasPlaceholders, L as textEquals, N as placeholderPatternSource } from "./artifacts.js";
+import { L as placeholderPatternSource, P as hasPlaceholders, V as textEquals } from "./artifacts.js";
 //#region src/core/contracts/contract.ts
 /**
 * Declare one contract. Identity function — its value is the enforced shape

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jterrazz/test",
-    "version": "14.1.0",
+    "version": "14.3.0",
     "description": "Declarative testing framework for HTTP APIs, CLIs, and background jobs — one entry point, real infrastructure, golden-file assertions, plus an oxlint convention plugin.",
     "keywords": [
         "api-testing",