@jterrazz/test 16.0.0 → 16.1.1

package/docs/reference/variables/specification.md

@@ -0,0 +1,8 @@
+<!-- GENERATED by `typescript docs` — DO NOT EDIT -->
+# Variable: specification
+
+```ts
+const specification: Specification;
+```
+
+Defined in: [src/facets/specification.ts:42](https://github.com/jterrazz/package-test/blob/main/src/facets/specification.ts#L42)

package/docs/reference/variables/status.md

@@ -0,0 +1,10 @@
+<!-- GENERATED by `typescript docs` — DO NOT EDIT -->
+# Variable: status
+
+```ts
+const status: LandmarkFactory;
+```
+
+Defined in: [src/model/elements/elements.ts:130](https://github.com/jterrazz/package-test/blob/main/src/model/elements/elements.ts#L130)
+
+A live region announcing a result — `role="status"`, an `<output>`.

package/docs/reference/variables/table.md

@@ -0,0 +1,10 @@
+<!-- GENERATED by `typescript docs` — DO NOT EDIT -->
+# Variable: table
+
+```ts
+const table: LandmarkFactory;
+```
+
+Defined in: [src/model/elements/elements.ts:133](https://github.com/jterrazz/package-test/blob/main/src/model/elements/elements.ts#L133)
+
+A table, by its caption or accessible name.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jterrazz/test",
-    "version": "16.0.0",
+    "version": "16.1.1",
     "description": "Declarative testing framework for HTTP APIs, CLIs, background jobs, websites, mobile apps and rendered components — one entry point, real infrastructure and a real browser, golden-file assertions, plus an oxlint convention plugin.",
     "keywords": [
         "api-testing",
@@ -32,6 +32,7 @@
         "dist",
         "!dist/catalog.*",
         "!dist/coverage.*",
+        "docs",
         "schema"
     ],
     "type": "module",
@@ -76,7 +77,7 @@
     },
     "devDependencies": {
         "@hono/node-server": "^2.0.8",
-        "@jterrazz/typescript": "^10.2.1",
+        "@jterrazz/typescript": "^10.3.1",
         "@types/better-sqlite3": "^7.6.13",
         "@types/node": "^26.1.1",
         "@types/pg": "^8.20.0",

package/dist/ambiguity.js

@@ -1,146 +0,0 @@
-//#region src/model/elements/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",
-	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"
-};
-/** 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: false }))`. The error speaks
-* the vocabulary the author wrote, never playwright's — so the option appears
-* only when the AUTHOR stated one, whichever way.
-*/
-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 !== void 0) args.push(`{ exact: ${String(element.exact)} }`);
-	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 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}>${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
-* the count it would leave is stated so a still-ambiguous suggestion never
-* reads as a fix.
-*/
-function formatFixes(element, matches) {
-	const fixes = [];
-	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 === false && 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/13-elements.md#designating-exactly-one-element (CONVENTIONS W3)"
-	].join("\n");
-}
-//#endregion
-export { describeAmbiguity as n, formatElement as r, AmbiguousElementError as t };