@jterrazz/test 15.1.0 → 15.2.0

package/dist/ambiguity.js

@@ -19,14 +19,20 @@ const CONSTRUCTORS = {
 	button: "button",
 	complementary: "complementary",
 	contentinfo: "contentinfo",
+	dialog: "dialog",
 	field: "field",
 	form: "form",
 	heading: "heading",
 	link: "link",
+	listitem: "listitem",
 	main: "main",
 	navigation: "navigation",
+	option: "option",
 	region: "region",
+	row: "row",
 	search: "search",
+	status: "status",
+	table: "table",
 	testId: "testId",
 	text: "content"
 };
@@ -62,12 +68,22 @@ function formatBare(element) {
 /** `1. <a href="/articles">Articles</a>  in <nav>` — one evidence line per candidate. */
 function formatMatch(match, index) {
 	const attribute = match.detail ? ` ${quoteDetail(match)}` : "";
+	const named = match.accessibleName ? `  named ${JSON.stringify(match.accessibleName)}` : "";
 	const context = match.context ? `  in <${match.context}>` : "";
-	return `  ${index + 1}. <${match.tag}${attribute}>${match.text}</${match.tag}>${context}`;
+	return `  ${index + 1}. <${match.tag}${attribute}>${match.text}</${match.tag}>${named}${context}`;
 }
 function quoteDetail(match) {
 	return `${match.tag === "a" ? "href" : "name"}=${JSON.stringify(match.detail)}`;
 }
+/** Each landmark the candidates sit in, and how many of them it holds. */
+function landmarkCounts(matches) {
+	const counts = /* @__PURE__ */ new Map();
+	for (const match of matches) {
+		const landmark = match.context === void 0 ? void 0 : CONTEXT_LANDMARKS[match.context];
+		if (landmark !== void 0) counts.set(landmark, (counts.get(landmark) ?? 0) + 1);
+	}
+	return [...counts].toSorted(([, a], [, b]) => a - b);
+}
 /**
 * 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
@@ -76,9 +92,12 @@ function quoteDetail(match) {
 */
 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)})`);
+	const narrowing = landmarkCounts(matches).filter(([, count]) => count < matches.length);
+	if (!element.scope) {
+		const [first, ...rest] = narrowing;
+		const alsoHere = rest.length > 0 ? `   [also here: ${rest.map(([name]) => name).join(", ")}]` : "";
+		fixes.push(first === void 0 ? `scope it       within(<a container holding only this one>, ${formatBare(element)})` : `scope it       within(${first[0]}, ${formatBare(element)})   [leaves ${first[1]} of ${matches.length}]${alsoHere}`);
+	}
 	if (!element.exact && element.name !== void 0) {
 		const remaining = matches.filter((match) => match.text === element.name).length;
 		if (remaining > 0 && remaining < matches.length) fixes.push(`exact name     ${formatBare({

package/dist/artifacts.js

@@ -1,82 +1,10 @@
 import { i as SpecSyntaxError, l as updateSpecFile, s as readSpecFile } from "./spec-document.js";
 import { a as copyPlan, n as Matcher, r as TOKEN_KINDS, t as CaptureScope } from "./match.js";
 import { cpSync, existsSync, readFileSync, realpathSync, statSync, writeFileSync } from "node:fs";
-import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
 import { execSync, spawn } from "node:child_process";
 import { readdir } from "node:fs/promises";
 import { createServer } from "node:net";
-//#region src/specification/facets/_common/caller.ts
-/** Sibling module tests are callers, not internals (CONVENTIONS I2). */
-const TEST_FILE = /\.test\.[cm]?[jt]s$/u;
-/** Where this very module sits inside the framework's SOURCE tree. */
-const SOURCE_LOCATION = join("specification", "facets", "_common");
-/** The real path of `path`, or `path` itself when it cannot be resolved. */
-function realPath(path) {
-	try {
-		return realpathSync(path);
-	} catch {
-		return path;
-	}
-}
-/**
-* Directory of the running framework module itself. From the built package
-* this is `<package root>/dist`, whatever the resolution path — including a
-* `file:` link, where the real path carries neither `node_modules` nor
-* `/src/…` and would otherwise be mistaken for a caller frame.
-*/
-const FRAMEWORK_DIR = realPath(import.meta.dirname);
-/**
-* The directory holding the framework's OWN modules: `<package>/dist` for a
-* built install (everything is bundled there), `<repo>/src` when the framework
-* runs from source — this module's known location inside that tree is what
-* tells the two apart.
-*/
-const FRAMEWORK_TREE = FRAMEWORK_DIR.endsWith(`${sep}${SOURCE_LOCATION}`) ? resolve(FRAMEWORK_DIR, "../../..") : FRAMEWORK_DIR;
-/** Is `path` inside `directory` (strictly — a directory is not inside itself)? */
-function isInside(directory, path) {
-	const rest = relative(directory, path);
-	return rest !== "" && !rest.startsWith("..") && !isAbsolute(rest);
-}
-/**
-* Is this stack frame a module of the framework itself, rather than of the code
-* calling it?
-*
-* Answered by IDENTITY: the frame is inside the framework's own directory.
-* Answering it by substring — `/src/core/`, `/src/integrations/`, `/src/vitest/`
-* — was answering a different question, "does this path look like the framework's
-* layout", and a consumer that happens to have its own `src/core/` matched it.
-* Its files were then skipped as framework internals, and fixture resolution
-* anchored on the wrong directory (or fell through to the cwd) with nothing
-* reported.
-*
-* @internal
-*/
-function isFrameworkFrame(filePath, frameworkTree = FRAMEWORK_TREE) {
-	if (TEST_FILE.test(filePath)) return false;
-	return isInside(realPath(frameworkTree), realPath(filePath));
-}
-/**
-* Detect the directory of the first stack frame that lives outside this
-* package. Used to anchor fixture resolution (`_seeds/`, `_requests/`,
-* `_expected/`, …) on the calling test / specification file.
-*
-* @internal
-*/
-function getCallerDir() {
-	const { stack } = /* @__PURE__ */ new Error("caller detection");
-	if (!stack) throw new Error("Cannot detect caller directory: no stack trace");
-	const lines = stack.split("\n");
-	for (const line of lines) {
-		const match = /at\s+(?:.*?\()?(?:file:\/\/)?(?<filePath>[^:)]+):\d+:\d+/u.exec(line);
-		if (!match?.groups?.filePath) continue;
-		const { filePath } = match.groups;
-		if (filePath.includes("node_modules")) continue;
-		if (isFrameworkFrame(filePath)) continue;
-		return resolve(filePath, "..");
-	}
-	return process.cwd();
-}
-//#endregion
 //#region src/specification/facets/_common/result/grep.ts
 /**
 * Extract text blocks from output that contain a pattern.
@@ -163,26 +91,6 @@ var TextAccessor = class TextAccessor {
 		return this.text;
 	}
 };
-/**
-* Wrap an arbitrary string into a {@link TextAccessor} anchored on the calling
-* test's directory — the same caller-detection the builders use.
-*
-* The product surface of a test framework is its own error messages, checker
-* output, and reports; those deserve the same goldening as any other output.
-* `text()` makes an ad-hoc string a first-class snapshot subject:
-*
-* ```typescript
-* const message = await catchMessage(() => expect(result.response).toMatch('wrong-body.http'));
-* expect(text(message)).toMatch('wrong-body-error.txt'); // resolves to _expected/
-* ```
-*
-* ANSI is stripped before every comparison (the raw form stays on `.text`),
-* the `{{token}}` grammar applies to the fixture, and `.grep()` composition
-* works exactly as on any stream accessor.
-*/
-function text(value) {
-	return new TextAccessor(value, "text", getCallerDir());
-}
 //#endregion
 //#region src/specification/facets/_common/result/json.ts
 /**
@@ -228,45 +136,35 @@ var JsonAccessor = class {
 	}
 };
 //#endregion
-//#region src/integrations/docker/docker-lookup.ts
+//#region src/specification/facets/_common/result/table.ts
 /**
-* Thin synchronous wrappers around the `docker` CLI used by the docker() spec
-* mode. Sync is deliberate — the calls are fast, run only on the host, and
-* keep the dispose path straightforward (`Symbol.asyncDispose` can still be
-* async without needing these to be).
+* Read-only accessor for a database table after a specification run.
+*
+* Assertions go through `expect()` (async — they query the database):
+*
+*     await expect(result.table('users', { database: 'db' })).toMatchRows({
+*         columns: ['name'],
+*         rows: [['Alice']],
+*     });
+*     await expect(result.table('users', { database: 'db' })).toBeEmpty();
 */
-const DEFAULT_TIMEOUT = 1e4;
-/** Return all container IDs (running or stopped) that carry `key=value`. */
-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 [];
+var TableAccessor = class {
+	/** @internal Ref-capture scope shared by the current spec execution. */
+	captures;
+	/** @internal */
+	db;
+	/** The table name this accessor reads. */
+	name;
+	constructor(name, db, captures) {
+		this.name = name;
+		this.db = db;
+		this.captures = captures ?? new CaptureScope();
 	}
-}
-/** Return the raw `docker inspect` payload (object, not array) for a container. */
-function inspectContainer(id) {
-	const raw = execSync(`docker inspect ${id}`, {
-		encoding: "utf8",
-		timeout: DEFAULT_TIMEOUT
-	});
-	const parsed = JSON.parse(raw);
-	return Array.isArray(parsed) ? parsed[0] : parsed;
-}
-/** Force-remove the given container IDs in a single call. Errors are swallowed. */
-function removeContainers(ids) {
-	if (ids.length === 0) return;
-	try {
-		execSync(`docker rm -f ${ids.join(" ")}`, {
-			encoding: "utf8",
-			stdio: "pipe",
-			timeout: DEFAULT_TIMEOUT
-		});
-	} catch {}
-}
+	/** @internal Query the table — used by the toMatchRows / toBeEmpty matchers. */
+	async query(columns) {
+		return await this.db.query(this.name, columns);
+	}
+};
 //#endregion
 //#region src/specification/matching/structural.ts
 /**
@@ -605,6 +503,46 @@ function mergeTextPreservingPlaceholders(previous, actual, scope) {
 	return merged.join("\n");
 }
 //#endregion
+//#region src/integrations/docker/docker-lookup.ts
+/**
+* Thin synchronous wrappers around the `docker` CLI used by the docker() spec
+* mode. Sync is deliberate — the calls are fast, run only on the host, and
+* keep the dispose path straightforward (`Symbol.asyncDispose` can still be
+* async without needing these to be).
+*/
+const DEFAULT_TIMEOUT = 1e4;
+/** Return all container IDs (running or stopped) that carry `key=value`. */
+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 [];
+	}
+}
+/** Return the raw `docker inspect` payload (object, not array) for a container. */
+function inspectContainer(id) {
+	const raw = execSync(`docker inspect ${id}`, {
+		encoding: "utf8",
+		timeout: DEFAULT_TIMEOUT
+	});
+	const parsed = JSON.parse(raw);
+	return Array.isArray(parsed) ? parsed[0] : parsed;
+}
+/** Force-remove the given container IDs in a single call. Errors are swallowed. */
+function removeContainers(ids) {
+	if (ids.length === 0) return;
+	try {
+		execSync(`docker rm -f ${ids.join(" ")}`, {
+			encoding: "utf8",
+			stdio: "pipe",
+			timeout: DEFAULT_TIMEOUT
+		});
+	} catch {}
+}
+//#endregion
 //#region src/specification/facets/_common/result/directory.ts
 const DEFAULT_IGNORES = [
 	".git",
@@ -811,36 +749,6 @@ function expandWorkdir(env, workDir) {
 	return expanded;
 }
 //#endregion
-//#region src/specification/facets/_common/result/table.ts
-/**
-* Read-only accessor for a database table after a specification run.
-*
-* Assertions go through `expect()` (async — they query the database):
-*
-*     await expect(result.table('users', { database: 'db' })).toMatchRows({
-*         columns: ['name'],
-*         rows: [['Alice']],
-*     });
-*     await expect(result.table('users', { database: 'db' })).toBeEmpty();
-*/
-var TableAccessor = class {
-	/** @internal Ref-capture scope shared by the current spec execution. */
-	captures;
-	/** @internal */
-	db;
-	/** The table name this accessor reads. */
-	name;
-	constructor(name, db, captures) {
-		this.name = name;
-		this.db = db;
-		this.captures = captures ?? new CaptureScope();
-	}
-	/** @internal Query the table — used by the toMatchRows / toBeEmpty matchers. */
-	async query(columns) {
-		return await this.db.query(this.name, columns);
-	}
-};
-//#endregion
 //#region src/specification/facets/_common/result/result.ts
 /**
 * Base result - common accessors available after any action type.
@@ -1794,4 +1702,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 { placeholderPatternSource as A, text as B, FilesystemAccessor as C, hasPlaceholders as D, walkDirectory as E, findContainersByLabel as F, inspectContainer as I, removeContainers as L, structuralEquals as M, structuralSubset as N, mergePreservingPlaceholders as O, textEquals as P, JsonAccessor as R, resolveRoot as S, diffDirectories as T, getCallerDir as V, validateDatabaseOption as _, specDescription as a, expandWorkdir as b, shouldUpdateSnapshots as c, formatStartupReport as d, formatStdoutDiff as f, BaseResult as g, CliResult as h, runSpecDocument as i, renderExpected as j, mergeTextPreservingPlaceholders as k, formatDirectoryDiff as l, ContainerAccessor as m, SQLITE_TEMPLATE_DIR as n, ServeAdapter as o, formatTableDiff as p, VITEST_ARTIFACTS_DIR as r, UPDATE_HINT as s, COVERAGE_DIR as t, formatResponseDiff as u, TableAccessor as v, DirectoryAccessor as w, resolveCommand as x, discoverRoot as y, TextAccessor as z };
+export { mergePreservingPlaceholders as A, DirectoryAccessor as C, inspectContainer as D, findContainersByLabel as E, structuralSubset as F, textEquals as I, TableAccessor as L, placeholderPatternSource as M, renderExpected as N, removeContainers as O, structuralEquals as P, JsonAccessor as R, FilesystemAccessor as S, walkDirectory as T, validateDatabaseOption as _, specDescription as a, resolveCommand as b, shouldUpdateSnapshots as c, formatStartupReport as d, formatStdoutDiff as f, BaseResult as g, CliResult as h, runSpecDocument as i, mergeTextPreservingPlaceholders as j, hasPlaceholders as k, formatDirectoryDiff as l, ContainerAccessor as m, SQLITE_TEMPLATE_DIR as n, ServeAdapter as o, formatTableDiff as p, VITEST_ARTIFACTS_DIR as r, UPDATE_HINT as s, COVERAGE_DIR as t, formatResponseDiff as u, discoverRoot as v, diffDirectories as w, resolveRoot as x, expandWorkdir as y, TextAccessor as z };