@jterrazz/test 17.0.0 → 18.0.1

package/dist/in-place.global-setup.d.ts

@@ -8,4 +8,5 @@ type RunProject = {
 };
 export default function setup(project: RunProject): () => void;
 //#endregion
+export {};
 //# sourceMappingURL=in-place.global-setup.d.ts.map

package/dist/in-place.global-setup.js

@@ -1,5 +1,5 @@
 import { i as writePendingRewrites } from "./shared-in-place.js";
-import { l as VITEST_ARTIFACTS_DIR } from "./shared-artifacts.js";
+import { u as VITEST_ARTIFACTS_DIR } from "./shared-artifacts.js";
 import { t as setupEntry } from "./shared-setup-entry.js";
 import { join } from "node:path";
 import { randomUUID } from "node:crypto";

package/dist/index.d.ts

@@ -514,9 +514,6 @@ interface ApiSpecification<DatabaseKey extends string = string> extends ChainOf<
 }, ApiSpecification<DatabaseKey>> {}
 //#endregion
 //#region src/specifications/api/api.handle.d.ts
-type ApiConfig = ServicesConfig & {
-  server?: ServerPort | undefined;
-};
 /** Options for {@link startApi | specification.api}. */
 type ApiSpecificationOptions<Services extends ServiceRecord = ServiceRecord> = {
   /** Project root override; by default the nearest `package.json` above the specification file (`no-redundant-root`). */
@@ -1005,9 +1002,6 @@ type Job = {
   name: string;
   execute: () => Promise<void>;
 };
-type JobConfig = ServicesConfig & {
-  jobs?: Job[] | undefined;
-};
 /** Options for {@link startJob | specification.job}. */
 type JobSpecificationOptions<Services extends ServiceRecord = ServiceRecord> = {
   /** Named jobs `job.trigger(name)` runs: a factory of the started services, or an array. */
@@ -1239,10 +1233,6 @@ interface MobileSpecification extends ChainOf<typeof composition$2, {
 }, MobileSpecification> {}
 //#endregion
 //#region src/specifications/mobile/mobile.handle.d.ts
-type MobileConfig = StubsConfig & {
-  bundleId?: string | undefined;
-  device?: (() => Promise<DevicePort>) | undefined;
-};
 /** The stub backend behind the app; nothing is injected: wire `backendUrl` into your own bundler env. */
 type MobileBackendOptions = {
   /** Fixed port: Metro inlines `EXPO_PUBLIC_*` at serve time, so a stable port keeps a warm Metro valid. */
@@ -1562,9 +1552,6 @@ type WebsiteHandle = {
 declare function startWebsite<Services extends ServiceRecord>(options: WebsiteSpecificationOptions<Services>): Promise<WebsiteHandle>;
 //#endregion
 //#region src/specifications/specification.d.ts
-/** Every specification's configuration, as one. */
-type SpecificationConfig = ApiConfig & CliConfig & JobConfig & MobileConfig & WebsiteConfig;
-/** Created in a `*.specification.ts` under `specs/`, destructured with canonical names, cleaned up via `afterAll(cleanup)` (`runner-in-specification-file`, `no-runner-alias`, `cleanup-passed-to-after-all`). */
 /** The seven constructors, and only seven: the framework's whole entry surface. */
 type Specification = {
   api: typeof startApi;
@@ -1575,6 +1562,7 @@ type Specification = {
   mobile: typeof startMobile;
   website: typeof startWebsite;
 };
+/** Created in a `*.specification.ts` under `specs/`, destructured with canonical names, cleaned up via `afterAll(cleanup)` (`runner-in-specification-file`, `no-runner-alias`, `cleanup-passed-to-after-all`). */
 export declare const specification: Specification;
 //#endregion
 //#region src/specifications/component/render/scenario.d.ts
@@ -1924,5 +1912,5 @@ declare module 'vitest' {
   }
 }
 //#endregion
-export { type ApiHandle, type ApiSpecification, type ApiSpecificationOptions, type BaseResult, type BrowserConsoleMessage, type BrowserLinkElement, type BrowserMetaElement, type BrowserOpenOptions, type BrowserPage, type BrowserPort, type CallResult, type CaptureScope, type CliEnv, type CliHandle, type CliInput, type CliOutput, type CliPort, type CliResult, type CliSpecification, type CliSpecificationOptions, type ComponentChain, type ComponentScenario, type ComponentUi, type ComponentVisitor, type ContainerAccessor, type DeviceOpenOptions, type DevicePort, type DeviceScreen, type DeviceTimeouts, type DirectoryAccessor, type DiskDirectory, type DiskFile, type DiskTarget, type DockerSpecConfig, type DomMount, type ElementKind, type ElementMatch, type ExecOptions, type FetchResult, type FileAccessor, type FileAt, type FilesystemAccessor, type HonoApp, type HttpResult, type IntegrationHandle, type IntegrationSpecification, type IntegrationSpecificationOptions, type Job, type JobHandle, type JobResult, type JobSpecification, type JobSpecificationOptions, type JsonAccessor, type LandmarkKind, type LintConfig, type LintHandle, type LintResult, type LintRules, type LintRunOptions, type LintSpecification, type LintSpecificationOptions, type LiterateRunFlags, type LiterateServeRegistration, type MatchFixtureOptions, Matcher, type MatcherKind, type MobileBackendOptions, type MobileElementKind, type MobileElementMatch, type MobileHandle, type MobileScenario, type MobileSpecification, type MobileSpecificationOptions, type MobileVisitor, type MockOfOptions, type MockPort, type PackedPackage, type PageResult, type PinnedClock, type PositionedCases, type PositionedRuleTester, type PrepareStep, type RelativePath, type RenderResult, type RenderSubject, type RenderedText, type ResponseAccessor, type ScreenNode, type ScreenResult, type ServerPort, type ServerRequestOptions, type ServerResponse, type ServerSpec, type SpecDocument, type SpecEnvToken, type SpecFileAssertion, type SpecFixture, type SpecRun, type SpecServeEntry, type SpecStream, type SpecificationConfig, type TableAccessor, type Target, type TargetOptions, type TextAccessor, type VisitScenario, type WaitUntilOptions, type WebsiteBackendOptions, type WebsiteHandle, type WebsiteSpecification, type WebsiteSpecificationOptions, type WebsiteVisitor, directory, file, match };
+export { type ApiHandle, type ApiSpecification, type ApiSpecificationOptions, type BaseResult, type BrowserConsoleMessage, type BrowserLinkElement, type BrowserMetaElement, type BrowserOpenOptions, type BrowserPage, type BrowserPort, type CallResult, type CaptureScope, type CliEnv, type CliHandle, type CliInput, type CliOutput, type CliPort, type CliResult, type CliSpecification, type CliSpecificationOptions, type ComponentChain, type ComponentScenario, type ComponentUi, type ComponentVisitor, type ContainerAccessor, type DeviceOpenOptions, type DevicePort, type DeviceScreen, type DeviceTimeouts, type DirectoryAccessor, type DiskDirectory, type DiskFile, type DiskTarget, type DockerSpecConfig, type DomMount, type ElementKind, type ElementMatch, type ExecOptions, type FetchResult, type FileAccessor, type FileAt, type FilesystemAccessor, type HonoApp, type HttpResult, type IntegrationHandle, type IntegrationSpecification, type IntegrationSpecificationOptions, type Job, type JobHandle, type JobResult, type JobSpecification, type JobSpecificationOptions, type JsonAccessor, type LandmarkKind, type LintConfig, type LintHandle, type LintResult, type LintRules, type LintRunOptions, type LintSpecification, type LintSpecificationOptions, type LiterateRunFlags, type LiterateServeRegistration, type MatchFixtureOptions, Matcher, type MatcherKind, type MobileBackendOptions, type MobileElementKind, type MobileElementMatch, type MobileHandle, type MobileScenario, type MobileSpecification, type MobileSpecificationOptions, type MobileVisitor, type MockOfOptions, type MockPort, type PackedPackage, type PageResult, type PinnedClock, type PositionedCases, type PositionedRuleTester, type PrepareStep, type RelativePath, type RenderResult, type RenderSubject, type RenderedText, type ResponseAccessor, type ScreenNode, type ScreenResult, type ServerPort, type ServerRequestOptions, type ServerResponse, type ServerSpec, type SpecDocument, type SpecEnvToken, type SpecFileAssertion, type SpecFixture, type SpecRun, type SpecServeEntry, type SpecStream, type TableAccessor, type Target, type TargetOptions, type TextAccessor, type VisitScenario, type WaitUntilOptions, type WebsiteBackendOptions, type WebsiteHandle, type WebsiteSpecification, type WebsiteSpecificationOptions, type WebsiteVisitor, directory, file, match };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,16 +1,19 @@
-import { a as signalGroup, i as SIGNALS_GROUPS, r as KILL_GRACE_MS, t as ServedProcess } from "./shared-serve.js";
+import { a as endGroup, i as SIGNALS_GROUPS, o as signalGroup, r as KILL_GRACE_MS, t as ServedProcess } from "./shared-serve.js";
 import { i as safeRealpath, r as resolveRoot } from "./shared-resolve.js";
-import { n as deferRewritesTo, o as getCallerDir, r as writeInPlace, t as callSiteOf } from "./shared-in-place.js";
+import { a as getCallerDir, n as deferRewritesTo, r as writeInPlace, t as callSiteOf } from "./shared-in-place.js";
 import { t as isRecord } from "./shared-json-shape.js";
 import { n as refusal$1, t as invariant } from "./shared-refusal.js";
+import { a as field$1, c as containerLogs, d as findContainersByLabel, f as inspectContainer, h as requireDockerDaemon, l as execInContainer, m as removeContainers, p as readContainerFile, r as TestcontainersAdapter, u as fieldOf } from "./shared-testcontainers.adapter.js";
 import { _ as Matcher, d as structuralEquals, g as placeholderStringMatches, h as hasPlaceholders, l as isPlainObject, m as textEquals, n as isStreamBody, p as textContains, r as declared, u as renderExpected, v as match, y as CaptureScope } from "./shared-exchange.js";
-import { i as readSpecFile, l as SpecSyntaxError, s as RUN_KEYS, u as dedent } from "./shared-spec-document.js";
+import { a as RUN_KEYS, s as SpecSyntaxError } from "./shared-spec-grammar.js";
 import { a as renderValue, c as file, d as isDiskTarget, f as requireDiskFile, i as renderText, l as isDiskDirectory, o as resolveSpecPath, p as requireDiskTarget, r as renderRows, s as directory, t as grammarRefusal, u as isDiskFile } from "./shared-literate-plugin.js";
 import { c as writeLedger, l as missingHint, o as routesLedger, u as shouldUpdateSnapshots } from "./shared-ledger.js";
-import { t as pause } from "./shared-pause.js";
+import { i as readSpecFile, o as dedent } from "./shared-spec-document.js";
+import { n as untilDeadline } from "./shared-pause.js";
+import { t as listenedPort } from "./shared-listened-port.js";
 import { t as ProcessHandle } from "./shared-process.adapter.js";
-import { a as field$1, r as TestcontainersAdapter } from "./shared-testcontainers.adapter.js";
-import { n as StubQueue, t as toReadableStream } from "./shared-stream-body.js";
+import { n as toKebabCase, t as toConstantCase } from "./shared-record-key.js";
+import { a as toReadableStream, i as unmatchedSummary, n as replyOf, o as StubQueue, r as requestBody, t as refusedReply } from "./shared-stub-reply.js";
 import { d as renderYamlSource, n as blockScalar, o as isScalar, r as isMap, s as isSeq } from "./shared-yaml-document.js";
 import { a as sessionLedger, i as mobileSessions, o as mobileServer, s as reachAppium } from "./shared-session-ledger.js";
 import { S as testId, _ as listitem, a as main, b as status, d as button, f as content, g as link, h as heading, i as form, l as search, m as field, n as complementary, o as navigation, p as dialog, r as contentinfo, s as region, t as banner, u as within, v as option, x as table, y as row } from "./shared-landmarks.js";
@@ -18,8 +21,8 @@ import { createRequire } from "node:module";
 import { LESSON_PARTS, lessonParts, presetChecks } from "@jterrazz/typescript/rules";
 import { cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, rmSync, statSync, symlinkSync, writeFileSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, normalize, relative, resolve, sep } from "node:path";
+import { execFileSync, spawn, spawnSync } from "node:child_process";
 import { readdir } from "node:fs/promises";
-import { execFileSync, execSync, spawn, spawnSync } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { createServer } from "node:http";
 import { tmpdir } from "node:os";
@@ -177,7 +180,7 @@ var TableAccessor = class {
 const ANSI_RE = /\u001B\[[0-9;]*m/gu;
 /** rule `no-transform-duplicating-tokens`: a golden compares the text, never its colour. */
 function stripAnsiCodes(value) {
-	return value.replace(ANSI_RE, "");
+	return value.replaceAll(ANSI_RE, "");
 }
 //#endregion
 //#region src/expectations/text/grep.ts
@@ -338,110 +341,6 @@ var JsonAccessor = class {
 	}
 };
 //#endregion
-//#region src/expectations/command/docker-cli.ts
-const DEFAULT_TIMEOUT = 1e4;
-/** Docker-aware mode reads what the daemon answers: a run where none answers is refused, never passed. */
-function requireDockerDaemon() {
-	try {
-		execSync("docker version --format \"{{.Server.Version}}\"", {
-			stdio: "ignore",
-			timeout: DEFAULT_TIMEOUT
-		});
-	} catch (error) {
-		throw new Error(refusal$1({
-			fix: "start Docker (Docker Desktop, OrbStack, colima or another) and run again",
-			found: "specification.cli({ docker }) asked for Docker, and no Docker daemon answered",
-			read: "docs/guides/cli-specs.md#docker-aware-mode",
-			why: "Docker-aware mode reads the containers a run spawned, so it needs a Docker daemon."
-		}), { cause: error });
-	}
-}
-function findContainersByLabel(key, value) {
-	try {
-		return execSync(`docker ps -aq -f label=${key}=${value}`, {
-			encoding: "utf8",
-			timeout: DEFAULT_TIMEOUT
-		}).split("\n").map((line) => line.trim()).filter((line) => line.length > 0);
-	} catch {
-		return [];
-	}
-}
-/** A field of a value read off docker's JSON or a failed process: absent wherever the value does not hold it. */
-function fieldOf(value, ...keys) {
-	if (typeof value !== "object" || value === null) return;
-	const key = keys.find((candidate) => candidate in value);
-	return key === void 0 ? void 0 : Reflect.get(value, key);
-}
-const streamOf = (error, key) => {
-	const stream = fieldOf(error, key);
-	return typeof stream === "string" ? stream : void 0;
-};
-function inspectContainer(id) {
-	const raw = execSync(`docker inspect ${id}`, {
-		encoding: "utf8",
-		timeout: DEFAULT_TIMEOUT
-	});
-	const parsed = JSON.parse(raw);
-	if (!Array.isArray(parsed)) return parsed;
-	return parsed[0];
-}
-function removeContainers(ids) {
-	if (ids.length === 0) return;
-	try {
-		execSync(`docker rm -f ${ids.join(" ")}`, {
-			encoding: "utf8",
-			stdio: "pipe",
-			timeout: DEFAULT_TIMEOUT
-		});
-	} catch {}
-}
-function containerLogs(id) {
-	try {
-		return execSync(`docker logs ${id}`, {
-			encoding: "utf8",
-			stdio: [
-				"ignore",
-				"pipe",
-				"pipe"
-			],
-			timeout: DEFAULT_TIMEOUT
-		});
-	} catch (error) {
-		return streamOf(error, "stdout") ?? streamOf(error, "stderr") ?? "";
-	}
-}
-function readContainerFile(id, path) {
-	return execSync(`docker exec ${id} cat ${JSON.stringify(path)}`, {
-		encoding: "utf8",
-		timeout: DEFAULT_TIMEOUT
-	});
-}
-function execInContainer(id, argv) {
-	try {
-		const quoted = argv.map((a) => JSON.stringify(a)).join(" ");
-		return {
-			exitCode: 0,
-			stderr: "",
-			stdout: execSync(`docker exec ${id} ${quoted}`, {
-				encoding: "utf8",
-				stdio: [
-					"ignore",
-					"pipe",
-					"pipe"
-				],
-				timeout: DEFAULT_TIMEOUT
-			})
-		};
-	} catch (error) {
-		const status = fieldOf(error, "status");
-		return {
-			exitCode: typeof status === "number" ? status : 1,
-			stderr: streamOf(error, "stderr") ?? (error instanceof Error ? error.message : ""),
-			stdout: streamOf(error, "stdout") ?? ""
-		};
-	}
-}
-//#endregion
 //#region src/expectations/command/container.ts
 function readInspectState(inspect) {
 	const state = fieldOf(inspect, "State", "state");
@@ -1693,16 +1592,6 @@ function declaredDatabaseKeys(services) {
 	return Object.entries(services).filter(([, service]) => service.createDatabaseAdapter() !== null).map(([key]) => key);
 }
 //#endregion
-//#region lint/kit/project/record-key.ts
-/** `analyticsDb` gives `analytics-db`. */
-function toKebabCase(key) {
-	return key.replaceAll(/(?<lower>[a-z0-9])(?<upper>[A-Z])/gu, "$<lower>-$<upper>").toLowerCase();
-}
-/** `analyticsDb` gives `ANALYTICS_DB`, `db-main` gives `DB_MAIN`. */
-function toConstantCase(key) {
-	return key.replaceAll(/(?<lower>[a-z0-9])(?<upper>[A-Z])/gu, "$<lower>_$<upper>").replaceAll(/[^A-Za-z0-9]/gu, "_").toUpperCase();
-}
-//#endregion
 //#region src/services/containers/run-setup-container.adapter.ts
 function answered(value) {
 	const error = field$1(value, "error");
@@ -1970,12 +1859,12 @@ var Orchestrator = class {
 function getWorkerId() {
 	return process.env.VITEST_POOL_ID ?? "0";
 }
-async function acquireIsolation(services) {
+async function acquireIsolation(services, acquired) {
 	const workerId = getWorkerId();
-	for (const service of Object.values(services)) await service.isolation().acquire(workerId);
-}
-async function releaseIsolation(services) {
-	for (const service of Object.values(services)) await service.isolation().release();
+	for (const service of Object.values(services)) {
+		await service.isolation().acquire(workerId);
+		acquired.push(service);
+	}
 }
 function splitProcesses(services) {
 	const infrastructure = {};
@@ -2012,16 +1901,30 @@ async function startServices(services, root, subject) {
 		subject
 	});
 	await orchestrator.start();
-	await acquireIsolation(infrastructure);
+	const acquired = [];
+	const stopInfrastructure = async () => {
+		for (const service of acquired.splice(0)) await service.isolation().release();
+		await orchestrator.stop();
+	};
 	const runId = randomUUID();
-	const stopProcesses = await startProcessServices(services, root, runId);
+	let stopProcesses;
+	try {
+		await acquireIsolation(infrastructure, acquired);
+		stopProcesses = await startProcessServices(services, root, runId);
+	} catch (error) {
+		await stopInfrastructure();
+		throw error;
+	}
 	const databases = orchestrator.getDatabases();
 	return {
 		database: orchestrator.getDatabase() ?? void 0,
 		databases: databases.size > 0 ? databases : void 0,
 		orchestrator,
 		runId,
-		stopProcesses
+		stop: async () => {
+			await stopProcesses();
+			await stopInfrastructure();
+		}
 	};
 }
 //#endregion
@@ -2656,7 +2559,7 @@ async function startApi(options) {
 	const root = resolveRoot(options.root, callerDir);
 	const services = declaredServices(options.services);
 	const databaseKeys = declaredDatabaseKeys(services);
-	const { database, databases, orchestrator, stopProcesses } = await startServices(services, root);
+	const { database, databases, stop } = await startServices(services, root);
 	const server = new HonoAdapter(options.server(services));
 	const config = {
 		database,
@@ -2672,9 +2575,7 @@ async function startApi(options) {
 				declared: server.declared(),
 				reached: server.reached
 			});
-			await stopProcesses();
-			await releaseIsolation(services);
-			await orchestrator.stop();
+			await stop();
 		},
 		docker: createDockerReader(callerDir)
 	};
@@ -2699,15 +2600,10 @@ var StubBackend = class {
 			this.handle(request, response);
 		});
 		this.server = server;
-		await new Promise((resolve, reject) => {
-			server.once("error", reject);
-			server.listen(this.options.port ?? 0, "127.0.0.1", () => {
-				resolve();
-			});
-		});
-		const address = server.address();
-		if (address === null || typeof address === "string") throw invariant("the stub backend listens on no port");
-		return `http://127.0.0.1:${address.port}`;
+		return `http://127.0.0.1:${await listenedPort(server, {
+			host: "127.0.0.1",
+			port: this.options.port ?? 0
+		})}`;
 	}
 	async stop() {
 		const { server } = this;
@@ -2765,18 +2661,18 @@ var StubBackend = class {
 		const stub = this.queue.take(observed);
 		if (!stub) {
 			this.record(method, url);
+			const error = refusedReply(unmatchedSummary(method, url));
 			response.writeHead(501, {
 				...cors,
 				"content-type": "application/json"
 			});
 			response.end(JSON.stringify({
 				declared: this.queue.declaredRoutes(),
-				error: `@jterrazz/test declared backend: no stub matches ${method} ${url}`
+				error
 			}));
 			return;
 		}
-		const reply = typeof stub.response === "function" ? stub.response(observed) : stub.response;
-		await pause(reply.delay ?? 0);
+		const reply = await replyOf(stub.response, observed);
 		if (reply.transport === "network-error") {
 			request.socket.destroy();
 			return;
@@ -2835,13 +2731,7 @@ async function writeReply(response, reply, cors) {
 async function readBody(request) {
 	const chunks = [];
 	for await (const chunk of request) chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk)));
-	const raw = Buffer.concat(chunks).toString("utf8");
-	if (raw.length === 0) return null;
-	try {
-		return JSON.parse(raw);
-	} catch {
-		return raw;
-	}
+	return requestBody(Buffer.concat(chunks).toString("utf8"));
 }
 function corsHeaders(request) {
 	return {
@@ -3903,12 +3793,6 @@ async function observeProcess(child, options) {
 		});
 	});
 }
-function endGroup(child) {
-	signalGroup(child);
-	setTimeout(() => {
-		signalGroup(child, "SIGKILL");
-	}, KILL_GRACE_MS).unref();
-}
 /** Spawned, never `spawnSync`: the test's event loop keeps running while the binary does, so a server the test started (a collector, a stub) answers it. stdout and stderr are captured whatever the exit code, and many CLIs write banners to stderr. */
 var ExecAdapter = class {
 	command;
@@ -3923,8 +3807,8 @@ var ExecAdapter = class {
 			env,
 			shell: true
 		});
-		onTestFinished(() => {
-			endGroup(child);
+		onTestFinished(async () => {
+			await endGroup(child);
 		});
 		return await new Promise((resolve) => {
 			const output = {
@@ -3980,7 +3864,7 @@ var ExecAdapter = class {
 function dockerTestRunId() {
 	return `t-${Math.random().toString(36).slice(2, 10)}-${Date.now().toString(36)}`;
 }
-async function startedBackend(declared, defaults, started) {
+async function startedBackend$1(declared, defaults, started) {
 	if (declared === void 0) return {
 		backend: null,
 		defaults
@@ -3995,7 +3879,7 @@ async function startedBackend(declared, defaults, started) {
 			}
 		};
 	} catch (error) {
-		await started?.orchestrator.stop();
+		await started?.stop();
 		throw error;
 	}
 }
@@ -4009,7 +3893,7 @@ async function startCli(bin, options = {}) {
 	if (options.docker !== void 0) requireDockerDaemon();
 	let started = null;
 	if (Object.keys(services).length > 0) started = await startServices(services, root, { type: "none" });
-	const { backend, defaults } = await startedBackend(options.backend, options.defaults, started);
+	const { backend, defaults } = await startedBackend$1(options.backend, options.defaults, started);
 	const dockerTestRunIdOf = options.docker === void 0 ? void 0 : dockerTestRunId();
 	const declaredServicesOf = Object.keys(services).length > 0 ? services : void 0;
 	const config = {
@@ -4029,10 +3913,8 @@ async function startCli(bin, options = {}) {
 	};
 	return {
 		cleanup: async () => {
+			await started?.stop();
 			await backend?.stop();
-			await started?.stopProcesses();
-			await releaseIsolation(services);
-			if (started) await started.orchestrator.stop();
 		},
 		cli: cliDefinition.open(config),
 		docker: createDockerReader(callerDir),
@@ -4178,9 +4060,7 @@ async function startIntegration(options = {}) {
 	};
 	return {
 		cleanup: async () => {
-			await started?.stopProcesses();
-			await releaseIsolation(services);
-			if (started) await started.orchestrator.stop();
+			await started?.stop();
 		},
 		integration: integrationDefinition.open(config)
 	};
@@ -4278,9 +4158,7 @@ async function startJob(options) {
 	};
 	return {
 		cleanup: async () => {
-			await started?.stopProcesses();
-			await releaseIsolation(services);
-			if (started) await started.orchestrator.stop();
+			await started?.stop();
 		},
 		job: jobDefinition.open(config),
 		orchestrator: started?.orchestrator ?? null
@@ -4956,19 +4834,30 @@ async function startBesideAppium(services, root, appium) {
 		throw error;
 	}
 }
+async function startedBackend(declared, started, appium) {
+	if (!declared) return {
+		backend: null,
+		backendUrl: void 0
+	};
+	const backend = new StubBackend({ port: declared.port });
+	try {
+		return {
+			backend,
+			backendUrl: await backend.start()
+		};
+	} catch (error) {
+		await started?.stop();
+		await appium.stop();
+		throw error;
+	}
+}
 async function startMobile(options) {
 	const callerDir = getCallerDir();
 	await registerMatchers();
 	const root = resolveRoot(options.root, callerDir);
 	const { appium, device: driven, outlivesFile } = await reachAppium(options, root, await mobileServer());
-	const services = declaredServices(options.services);
-	const started = await startBesideAppium(services, root, appium);
-	let backend = null;
-	let backendUrl;
-	if (options.backend) {
-		backend = new StubBackend({ port: options.backend.port });
-		backendUrl = await backend.start();
-	}
+	const started = await startBesideAppium(declaredServices(options.services), root, appium);
+	const { backend, backendUrl } = await startedBackend(options.backend, started, appium);
 	const device = lazyDevice({
 		driven,
 		ledger: async () => await runLedger(outlivesFile),
@@ -4985,11 +4874,7 @@ async function startMobile(options) {
 		backendUrl,
 		cleanup: async () => {
 			await device.close();
-			if (started) {
-				await started.stopProcesses();
-				await releaseIsolation(services);
-				await started.orchestrator.stop();
-			}
+			await started?.stop();
 			await appium.stop();
 			if (backend) await backend.stop();
 		},
@@ -5449,8 +5334,7 @@ async function startSite(options, context) {
 			serve
 		};
 	} catch (error) {
-		await context.started?.stopProcesses();
-		await context.started?.orchestrator.stop();
+		await context.started?.stop();
 		await context.backend?.stop();
 		throw error;
 	}
@@ -5533,11 +5417,7 @@ async function startWebsite(options) {
 		cleanup: async () => {
 			await browser.close();
 			if (serve) await serve.stop();
-			if (started) {
-				await started.stopProcesses();
-				await releaseIsolation(services);
-				await started.orchestrator.stop();
-			}
+			await started?.stop();
 			if (backend) await backend.stop();
 		},
 		url: baseUrl,
@@ -5546,6 +5426,7 @@ async function startWebsite(options) {
 }
 //#endregion
 //#region src/specifications/specification.ts
+/** Created in a `*.specification.ts` under `specs/`, destructured with canonical names, cleaned up via `afterAll(cleanup)` (`runner-in-specification-file`, `no-runner-alias`, `cleanup-passed-to-after-all`). */
 const specification = {
 	/** Test an HTTP app: services via testcontainers, the app in this process. */
 	api: startApi,
@@ -5676,17 +5557,15 @@ const DEFAULT_INTERVAL_MS = 50;
 async function waitUntil(predicate, options = {}) {
 	const timeout = options.timeout ?? DEFAULT_TIMEOUT_MS;
 	const interval = options.interval ?? DEFAULT_INTERVAL_MS;
-	const deadline = performance.now() + timeout;
-	for (;;) {
-		if (await predicate()) return;
-		if (performance.now() >= deadline) throw new Error(refusal$1({
-			fix: "raise the budget if the wait is legitimate, or wait on what actually changes",
-			found: `waitUntil(): ${options.why ?? "the condition"} did not hold within ${timeout}ms`,
-			read: "docs/reference/assertions.md#two-helpers-that-are-not-matchers",
-			why: "`waitUntil()` waits on a condition, within a budget."
-		}));
-		await pause(interval);
-	}
+	if (await untilDeadline(async () => await predicate() || void 0, {
+		interval,
+		timeout
+	}) === void 0) throw new Error(refusal$1({
+		fix: "raise the budget if the wait is legitimate, or wait on what actually changes",
+		found: `waitUntil(): ${options.why ?? "the condition"} did not hold within ${timeout}ms`,
+		read: "docs/reference/assertions.md#two-helpers-that-are-not-matchers",
+		why: "`waitUntil()` waits on a condition, within a budget."
+	}));
 }
 //#endregion
 export { Matcher, banner, button, clock, complementary, component, content, contentinfo, dialog, directory, disabled, enabled, field, file, focused, form, heading, link, listitem, main, match, mockOf, navigation, option, packed, region, required, row, ruleTester, search, selected, specification, status, table, testId, text, valued, waitUntil, within };

package/dist/mobile-session.global-setup.d.ts

@@ -11,4 +11,5 @@ export declare function mobileSessionSetup(): string;
 /** One driver session per run: the first runner records it in the provided folder, later files attach, the teardown ends them. With `mobile({ device, root })` it also owns the Appium server. */
 export default function setup(project: SessionProject): Promise<() => Promise<void>>;
 //#endregion
+export {};
 //# sourceMappingURL=mobile-session.global-setup.d.ts.map

package/dist/oxlint.cjs

@@ -5628,14 +5628,14 @@ function literalOf(property) {
 		value
 	};
 }
-/** Only under `test` or in `projects`, listed or keyed: `optimizeDeps.include` and its kin list package specifiers, not globs over a tree. */
+/** Only under `test` or in `projects`: `optimizeDeps.include` and its kin list package specifiers, not globs over a tree. */
 function includedGlobs(program) {
 	const globs = [];
 	walk(program, (node) => {
 		const key = propertyKeyName(node);
 		if (key !== "projects" && key !== "test") return;
 		const value = child(node, "value");
-		const projects = key === "test" ? [value] : [...childList(value, "elements"), ...childList(value, "properties").map((property) => child(property, "value"))];
+		const projects = key === "test" ? [value] : childList(value, "properties").map((property) => child(property, "value"));
 		for (const project of projects) {
 			const include = child(findProperty(project, "include"), "value");
 			for (const element of childList(include, "elements")) {