@jterrazz/test 17.0.0 → 18.0.1

package/dist/route-coverage.global-setup.d.ts

@@ -39,4 +39,5 @@ export declare function routeCoverageSetup(): string;
 export declare function setupRoutes(project: RouteProject): () => Promise<void>;
 export default function setup(project: TestProject): () => Promise<void>;
 //#endregion
+export {};
 //# sourceMappingURL=route-coverage.global-setup.d.ts.map

package/dist/route-coverage.global-setup.js

@@ -1,2 +1 @@
-import { n as setup, r as setupRoutes, t as routeCoverageSetup } from "./shared-route-coverage.global-setup.js";
-export { setup as default, routeCoverageSetup, setupRoutes };
+export { n as default, t as routeCoverageSetup, r as setupRoutes } from "./shared-route-coverage.global-setup.js";

package/dist/services.global-setup.d.ts

@@ -26,7 +26,6 @@ declare function serveContainers(containers: RunContainers): Promise<ServedConta
 //#endregion
 //#region src/services/containers/services.global-setup.d.ts
 /** Every project's setup joins the one run's containers. Default images are pulled in the background, so the first file waits on a pull at most once; a project declaring no service needs no Docker. */
-export declare const DOCKER_ABSENT = "no Docker daemon answered";
 /** `connect` stands in for the runtime's own client lookup, so the refusal is reachable without a daemon to stop. */
 export declare function prepareDocker(connect?: () => Promise<ContainerRuntimeClient>): Promise<void>;
 export declare function servicesSetup(): string;
@@ -40,4 +39,5 @@ type RunSeams = {
 };
 export default function setup(project: RunProject, seams?: Partial<RunSeams>): Promise<() => Promise<void>>;
 //#endregion
+export {};
 //# sourceMappingURL=services.global-setup.d.ts.map

package/dist/services.global-setup.js

@@ -1,2 +1 @@
-import { i as setup, n as prepareDocker, r as servicesSetup, t as DOCKER_ABSENT } from "./shared-services.global-setup.js";
-export { DOCKER_ABSENT, setup as default, prepareDocker, servicesSetup };
+export { r as default, t as prepareDocker, n as servicesSetup } from "./shared-services.global-setup.js";

package/dist/services.js

@@ -3,7 +3,7 @@ import { n as refusal, t as invariant } from "./shared-refusal.js";
 import { t as pause } from "./shared-pause.js";
 import { n as processService, t as ProcessHandle } from "./shared-process.adapter.js";
 import { n as requireBuiltPeer, t as loadPeer } from "./shared-peer.js";
-import { c as SQLITE_TEMPLATE_DIR } from "./shared-artifacts.js";
+import { l as SQLITE_TEMPLATE_DIR } from "./shared-artifacts.js";
 import { t as SERVICE_IMAGES } from "./shared-service-images.js";
 import { closeSync, copyFileSync, existsSync, mkdirSync, openSync, readFileSync, readSync, readdirSync, renameSync, rmSync, statSync, unlinkSync, writeSync } from "node:fs";
 import { join, resolve } from "node:path";

package/dist/shared-appium.adapter.js

@@ -1,11 +1,10 @@
 import { n as refusal } from "./shared-refusal.js";
-import { t as pause } from "./shared-pause.js";
-import { u as evidenceDirectory } from "./shared-artifacts.js";
+import { n as untilDeadline } from "./shared-pause.js";
+import { d as evidenceFile } from "./shared-artifacts.js";
 import { n as SERVER_CALL_TIMEOUT_MS } from "./shared-session-ledger.js";
 import { c as scopeChain } from "./shared-landmarks.js";
 import { a as ambiguityError, c as asWrittenUnscoped, i as shortened, s as asWritten, t as scenarioFailure } from "./shared-scenario-failure.js";
-import { mkdtempSync, writeFileSync } from "node:fs";
-import { resolve } from "node:path";
+import { writeFileSync } from "node:fs";
 //#region src/specifications/mobile/session/driver-session.ts
 const IDLE_SESSION_BUDGET_S = 300;
 const IOS_PREFIX = /^ios\s+/iu;
@@ -355,15 +354,17 @@ var AppiumAdapter = class {
 	async resolveOne(driver, target, verb) {
 		const chain = scopeChain(target);
 		const anyTarget = verb === "see";
-		const deadline = Date.now() + this.actionTimeoutMs;
 		let tryScroll = true;
-		for (;;) {
-			const resolved = await this.resolveChain(driver, chain, anyTarget, tryScroll);
+		const resolved = await untilDeadline(async () => {
+			const found = await this.resolveChain(driver, chain, anyTarget, tryScroll);
 			tryScroll = false;
-			if (resolved) return resolved;
-			if (Date.now() > deadline) throw await this.timeoutError(driver, target, verb);
-			await pause(POLL_INTERVAL_MS);
-		}
+			return found ?? void 0;
+		}, {
+			interval: POLL_INTERVAL_MS,
+			timeout: this.actionTimeoutMs
+		});
+		if (resolved === void 0) throw await this.timeoutError(driver, target, verb);
+		return resolved;
 	}
 	async resolveChain(driver, chain, anyTarget, tryScroll) {
 		let scope = driver;
@@ -385,11 +386,10 @@ var AppiumAdapter = class {
 		}
 		return element;
 	}
-	/** Screenshot the failing state into a temp file; never masks the original error. */
+	/** Screenshot the failing state into the evidence folder; never masks the original error. */
 	async captureEvidence(driver) {
 		try {
-			const dir = mkdtempSync(evidenceDirectory("mobile-"));
-			const path = resolve(dir, "failure.png");
+			const path = evidenceFile("mobile");
 			writeFileSync(path, Buffer.from(await driver.takeScreenshot(), "base64"));
 			return path;
 		} catch {

package/dist/shared-artifacts.js

@@ -1,4 +1,4 @@
-import { mkdirSync } from "node:fs";
+import { mkdirSync, mkdtempSync } from "node:fs";
 import { basename, join, resolve } from "node:path";
 import { tmpdir } from "node:os";
 //#region lint/kit/project/artifacts.ts
@@ -11,14 +11,16 @@ const SQLITE_TEMPLATE_DIR = `${VITEST_ARTIFACTS_DIR}/sqlite`;
 const ATTACHMENTS_DIR = `${VITEST_ARTIFACTS_DIR}/attachments`;
 /** Under the project: the run's temp root is gone by the time the error naming the file is read. */
 const EVIDENCE_DIR = `${VITEST_ARTIFACTS_DIR}/evidence`;
-/** Filed under the run's temp root name, `<pid>-...`: the next run's start sweeps every run that is no longer alive. */
-function evidenceDirectory(prefix) {
+/** Where a failing scenario's screenshot goes, in a folder of its own filed under the run's temp root name, `<pid>-...`: the next run's start sweeps every run that is no longer alive. */
+function evidenceFile(kind) {
 	const parent = resolve(EVIDENCE_DIR, basename(tmpdir()));
 	mkdirSync(parent, { recursive: true });
-	return join(parent, prefix);
+	return join(mkdtempSync(join(parent, `${kind}-`)), "failure.png");
 }
 const SCREENSHOTS_DIR = `${VITEST_ARTIFACTS_DIR}/screenshots`;
 const BLOB_DIR = `${VITEST_ARTIFACTS_DIR}/blob`;
+/** Node's compile cache, which every Node process of a run reads and writes: keyed by content, so an edit is never served old code. */
+const NODE_COMPILE_CACHE_DIR = `${ARTIFACTS_DIR}/node-compile-cache`;
 /** Vitest 5's file-writing reporters, each pinned under the artifacts folder. */
 const REPORTER_OUTPUT_FILES = {
 	blob: `${BLOB_DIR}/blob.json`,
@@ -27,6 +29,6 @@ const REPORTER_OUTPUT_FILES = {
 	junit: `${VITEST_ARTIFACTS_DIR}/junit/output.xml`
 };
 //#endregion
-export { EVIDENCE_DIR as a, SQLITE_TEMPLATE_DIR as c, COVERAGE_DIR as i, VITEST_ARTIFACTS_DIR as l, ATTACHMENTS_DIR as n, REPORTER_OUTPUT_FILES as o, BLOB_DIR as r, SCREENSHOTS_DIR as s, ARTIFACTS_DIR as t, evidenceDirectory as u };
+export { EVIDENCE_DIR as a, SCREENSHOTS_DIR as c, evidenceFile as d, COVERAGE_DIR as i, SQLITE_TEMPLATE_DIR as l, ATTACHMENTS_DIR as n, NODE_COMPILE_CACHE_DIR as o, BLOB_DIR as r, REPORTER_OUTPUT_FILES as s, ARTIFACTS_DIR as t, VITEST_ARTIFACTS_DIR as u };
 
 //# sourceMappingURL=shared-artifacts.js.map

package/dist/shared-derived-projects.js

@@ -1,15 +1,17 @@
 import { t as SPECIFICATIONS } from "./shared-specifications.js";
 import { TESTS_FOLDER } from "@jterrazz/typescript/rules";
-import { existsSync, readdirSync } from "node:fs";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { basename, join } from "node:path";
 //#region lint/kit/project/derived-projects.ts
 const SPECS = "specs";
 const UNIT = "unit";
 const FOLDERED = /* @__PURE__ */ new Set([...SPECIFICATIONS, "component"]);
-const IN_PROCESS = /* @__PURE__ */ new Set([
+const RUNNER_SHARED = /* @__PURE__ */ new Set([
 	"api",
+	"cli",
 	"integration",
-	"job"
+	"job",
+	"website"
 ]);
 const SPECIFICATION_MODULE = ".specification.ts";
 const MODULE_TEST = /\.test\.ts$/u;
@@ -23,14 +25,27 @@ function holds(path, pattern) {
 	});
 }
 const foldersIn = (path) => existsSync(path) ? readdirSync(path, { withFileTypes: true }).filter((entry) => entry.isDirectory() && !isUnwalked(entry.name)).map(({ name }) => name).toSorted() : [];
+function inImportOrder(directory, modules) {
+	const ordered = [];
+	const seen = /* @__PURE__ */ new Set();
+	const visit = (module) => {
+		if (seen.has(module)) return;
+		seen.add(module);
+		const text = readFileSync(join(directory, module), "utf8");
+		for (const imported of modules.filter((other) => text.includes(`'./${other.slice(0, -2)}js'`))) visit(imported);
+		ordered.push(module);
+	};
+	for (const module of modules) visit(module);
+	return ordered;
+}
 function runnerOf(root, folder, specification) {
-	if (!IN_PROCESS.has(specification)) return {};
-	const modules = readdirSync(join(root, folder)).filter((name) => name.endsWith(SPECIFICATION_MODULE));
-	const own = `${specification}${SPECIFICATION_MODULE}`;
-	return modules.length === 1 && modules[0] === own ? { runner: `./${folder}/${own}` } : {};
+	if (!RUNNER_SHARED.has(specification)) return {};
+	const directory = join(root, folder);
+	const modules = readdirSync(directory).filter((name) => name.endsWith(SPECIFICATION_MODULE)).toSorted();
+	return modules.length === 0 ? {} : { runner: inImportOrder(directory, modules).map((name) => `./${folder}/${name}`) };
 }
 const isSpecsMember = (root) => basename(root) === SPECS && existsSync(join(root, "package.json"));
-/** The projects a tree names, each with the options it derives: one per `specs/<specification>/` folder (an in-process one handed as its `runner` the folder's one specification module, `<specification>.specification.ts`), `unit` over each root holding a module test (`specs/unit/` is one root among them), `component` over each holding a rendered one. */
+/** The projects a tree names, each with the options it derives: one per `specs/<specification>/` folder (one whose spec files meet their subject through a runner handed as its `runner` every specification module of the folder, `*.specification.ts`, a module after those it imports), `unit` over each root holding a module test (`specs/unit/` is one root among them), `component` over each holding a rendered one. */
 function derivedProjects(root) {
 	const member = isSpecsMember(root);
 	const prefix = member ? "" : `${SPECS}/`;

package/dist/shared-in-place.js

@@ -167,6 +167,6 @@ function writeInPlace(site, render, folder = pendingFolder?.()) {
 	save(site.file, source, folder);
 }
 //#endregion
-export { callerFrames as a, writePendingRewrites as i, deferRewritesTo as n, getCallerDir as o, writeInPlace as r, callSiteOf as t };
+export { getCallerDir as a, writePendingRewrites as i, deferRewritesTo as n, writeInPlace as r, callSiteOf as t };
 
 //# sourceMappingURL=shared-in-place.js.map

package/dist/shared-ledger.js

@@ -1,5 +1,5 @@
 import { t as isRecord } from "./shared-json-shape.js";
-import { l as VITEST_ARTIFACTS_DIR } from "./shared-artifacts.js";
+import { u as VITEST_ARTIFACTS_DIR } from "./shared-artifacts.js";
 import { mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { randomUUID } from "node:crypto";

package/dist/shared-listened-port.js

@@ -0,0 +1,19 @@
+import { t as invariant } from "./shared-refusal.js";
+//#region src/chain/listened-port.ts
+/** Listens, on `host` when one is named, and answers the port it got; a port another server holds rejects with its error. */
+async function listenedPort(server, { host, port = 0 } = {}) {
+	await new Promise((resolve, reject) => {
+		server.once("error", reject);
+		server.listen(port, host, () => {
+			server.off("error", reject);
+			resolve();
+		});
+	});
+	const address = server.address();
+	if (address === null || typeof address === "string") throw invariant("a server listening on a TCP port answered no port");
+	return address.port;
+}
+//#endregion
+export { listenedPort as t };
+
+//# sourceMappingURL=shared-listened-port.js.map

package/dist/shared-literate-plugin.js

@@ -1,5 +1,6 @@
 import { n as refusal } from "./shared-refusal.js";
-import { d as isRelativePath, i as readSpecFile, l as SpecSyntaxError, u as dedent } from "./shared-spec-document.js";
+import { c as isRelativePath, s as SpecSyntaxError } from "./shared-spec-grammar.js";
+import { i as readSpecFile, o as dedent } from "./shared-spec-document.js";
 import { readFileSync } from "node:fs";
 import { basename, isAbsolute, resolve } from "node:path";
 //#region src/disk/spec-path.ts

package/dist/shared-pause.js

@@ -5,7 +5,18 @@ async function pause(ms) {
 		setTimeout(resolve, ms);
 	});
 }
+/** Asks `probe` until it answers something other than `undefined`, which it hands back, or answers `undefined` once `timeout` has passed. Measured on `performance.now()`, so `clock.at()`, which fakes `Date`, cannot freeze it. */
+async function untilDeadline(probe, { interval = 0, timeout, wait }) {
+	const deadline = performance.now() + timeout;
+	for (;;) {
+		const answer = await probe();
+		if (answer !== void 0) return answer;
+		const remaining = deadline - performance.now();
+		if (remaining <= 0) return;
+		await (wait === void 0 ? pause(interval) : wait(remaining));
+	}
+}
 //#endregion
-export { pause as t };
+export { untilDeadline as n, pause as t };
 
 //# sourceMappingURL=shared-pause.js.map

package/dist/shared-playwright.adapter.js

@@ -1,10 +1,8 @@
 import { n as refusal } from "./shared-refusal.js";
-import { u as evidenceDirectory } from "./shared-artifacts.js";
+import { n as untilDeadline } from "./shared-pause.js";
+import { d as evidenceFile } from "./shared-artifacts.js";
 import { c as scopeChain } from "./shared-landmarks.js";
 import { n as CANDIDATE_LIMITS, o as ambiguousTargetError, r as candidatesOf, s as asWritten, t as scenarioFailure } from "./shared-scenario-failure.js";
-import { mkdtempSync } from "node:fs";
-import { resolve } from "node:path";
-import { setTimeout } from "node:timers/promises";
 //#region src/specifications/website/browser/page-scripts.ts
 function extractPage() {
 	const links = [...document.querySelectorAll("link")].map((link) => ({
@@ -135,20 +133,21 @@ async function currentValue(locator) {
 		return null;
 	}
 }
-async function waitForValue(locator, target, wanted) {
+async function waitForValue(locator, target, wanted, timeout = VALUE_TIMEOUT_MS) {
 	const value = target.value ?? "";
-	const deadline = Date.now() + VALUE_TIMEOUT_MS;
-	for (;;) {
-		const actual = await currentValue(locator);
-		if (actual === null ? !wanted : actual === value === wanted) return;
-		if (Date.now() >= deadline) throw new Error(refusal({
-			fix: "correct the value the scenario states, or what the page puts in the field",
-			found: `${asWritten(target)} ${wanted ? "never held" : "still holds"} ${JSON.stringify(value)}${actual === null ? " (it is not on the page)" : `, it holds ${JSON.stringify(actual)}`}`,
-			read: "docs/reference/visitor.md#see-and-gone-are-the-synchronization",
-			why: "A verb waits for what it states to hold, within its budget, and never sleeps."
-		}));
-		await setTimeout(VALUE_POLL_MS);
-	}
+	let actual = null;
+	if (await untilDeadline(async () => {
+		actual = await currentValue(locator);
+		return actual === value === wanted || void 0;
+	}, {
+		interval: VALUE_POLL_MS,
+		timeout
+	}) === void 0) throw new Error(refusal({
+		fix: "correct the value the scenario states, or what the page puts in the field",
+		found: `${asWritten(target)} ${wanted ? "never held" : "still holds"} ${JSON.stringify(value)}${actual === null ? " (it is not on the page)" : `, it holds ${JSON.stringify(actual)}`}`,
+		read: "docs/reference/visitor.md#see-and-gone-are-the-synchronization",
+		why: "A verb waits for what it states to hold, within its budget, and never sleeps."
+	}));
 }
 async function settle(page, locator, target, present) {
 	if (target.value !== void 0) {
@@ -312,8 +311,7 @@ var PlaywrightAdapter = class {
 	/** Screenshot the failing state into the evidence folder; never masks the original error. */
 	async captureEvidence(page) {
 		try {
-			const dir = mkdtempSync(evidenceDirectory("website-"));
-			const path = resolve(dir, "failure.png");
+			const path = evidenceFile("website");
 			await page.screenshot({
 				fullPage: true,
 				path

package/dist/shared-process-alive.js

@@ -0,0 +1,13 @@
+//#region src/chain/process-alive.ts
+function processAlive(pid, probe = (target) => process.kill(target, 0)) {
+	try {
+		probe(pid);
+		return true;
+	} catch (error) {
+		return Reflect.get(new Object(error), "code") !== "ESRCH";
+	}
+}
+//#endregion
+export { processAlive as t };
+
+//# sourceMappingURL=shared-process-alive.js.map

package/dist/shared-record-key.js

@@ -0,0 +1,13 @@
+//#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
+export { toKebabCase as n, toConstantCase as t };
+
+//# sourceMappingURL=shared-record-key.js.map