@jterrazz/test 15.0.0 → 15.1.0

package/dist/playwright.adapter.js

@@ -14,8 +14,8 @@ const MAX_REPORTED_MATCHES = 10;
 */
 function locate(root, element) {
 	const scope = element.scope ? locate(root, element.scope) : root;
-	const options = {
-		exact: element.exact,
+	const options = element.name === void 0 ? { exact: element.exact ?? false } : {
+		exact: element.exact ?? false,
 		name: element.name
 	};
 	switch (element.kind) {
@@ -30,9 +30,9 @@ function locate(root, element) {
 		case "button":
 		case "heading":
 		case "link": return scope.getByRole(element.kind, options);
-		case "field": return scope.getByLabel(element.name ?? "", { exact: element.exact });
+		case "field": return scope.getByLabel(element.name ?? "", { exact: element.exact ?? false });
 		case "testId": return scope.getByTestId(element.name ?? "");
-		case "text": return scope.getByText(element.name ?? "", { exact: element.exact });
+		case "text": return scope.getByText(element.name ?? "", { exact: element.exact ?? false });
 	}
 }
 /** Playwright signals "more than one match" through this error text. */
@@ -41,7 +41,7 @@ function isStrictViolation(error) {
 }
 /** Capture the candidates in-page — the evidence the refusal enumerates. */
 async function captureMatches(locator) {
-	return locator.evaluateAll((nodes, limit) => {
+	return await locator.evaluateAll((nodes, limit) => {
 		const LANDMARKS = "nav, header, footer, main, aside, section, form, [role]";
 		return nodes.slice(0, limit).map((node) => {
 			const element = node;
@@ -52,7 +52,7 @@ async function captureMatches(locator) {
 				context: context ?? void 0,
 				detail: detail ?? void 0,
 				tag: element.tagName.toLowerCase(),
-				text: (element.textContent ?? "").replace(/\s+/g, " ").trim().slice(0, 80)
+				text: (element.textContent ?? "").replaceAll(/\s+/gu, " ").trim().slice(0, 80)
 			};
 		});
 	}, MAX_REPORTED_MATCHES);
@@ -86,17 +86,39 @@ async function findAmbiguousLevel(page, element) {
 /** The visitor implementation — every action auto-waits via playwright actionability. */
 function createVisitor(page, baseUrl) {
 	return {
-		check: (element) => act(page, element, (locator) => locator.check()),
-		click: (element) => act(page, element, (locator) => locator.click()),
-		fill: (element, value) => act(page, element, (locator) => locator.fill(value)),
+		check: async (element) => {
+			await act(page, element, async (locator) => {
+				await locator.check();
+			});
+		},
+		click: async (element) => {
+			await act(page, element, async (locator) => {
+				await locator.click();
+			});
+		},
+		fill: async (element, value) => {
+			await act(page, element, async (locator) => {
+				await locator.fill(value);
+			});
+		},
 		goto: async (path) => {
 			await page.goto(`${baseUrl}${path}`, { waitUntil: "load" });
 		},
-		hover: (element) => act(page, element, (locator) => locator.hover()),
-		press: (key) => page.keyboard.press(key),
-		see: (element) => act(page, element, (locator) => locator.waitFor({ state: "visible" })),
+		hover: async (element) => {
+			await act(page, element, async (locator) => {
+				await locator.hover();
+			});
+		},
+		press: async (key) => {
+			await page.keyboard.press(key);
+		},
+		see: async (element) => {
+			await act(page, element, async (locator) => {
+				await locator.waitFor({ state: "visible" });
+			});
+		},
 		select: async (element, option) => {
-			await act(page, element, (locator) => locator.selectOption(option));
+			await act(page, element, async (locator) => await locator.selectOption(option));
 		}
 	};
 }
@@ -119,7 +141,7 @@ var PlaywrightAdapter = class {
 		}
 	}
 	async open(url, options) {
-		const context = await (await this.launch()).newContext({ extraHTTPHeaders: options.headers });
+		const context = await (await this.launch()).newContext({ extraHTTPHeaders: options.headers ?? {} });
 		if (options.external === "block") {
 			const allowed = /* @__PURE__ */ new Set([new URL(options.baseUrl).origin, ...options.allowedOrigins ?? []]);
 			await context.route("**/*", (route) => {

package/dist/queue.js

@@ -1,6 +1,6 @@
 import { t as CaptureScope } from "./match.js";
-import { L as placeholderPatternSource, P as hasPlaceholders, V as textEquals } from "./artifacts.js";
-//#region src/core/contracts/contract.ts
+import { A as placeholderPatternSource, D as hasPlaceholders, P as textEquals } from "./artifacts.js";
+//#region src/specification/contracts/contract.ts
 /**
 * Declare one contract. Identity function — its value is the enforced shape
 * and the naming convention:
@@ -86,7 +86,7 @@ function contractsOf(input) {
 	return flatten([input]);
 }
 //#endregion
-//#region src/core/contracts/queue.ts
+//#region src/specification/contracts/queue.ts
 /**
 * The ONE contract queue — pure, engine-agnostic (no MSW, no node:http).
 * Both engines consume it: the MSW integration on api/jobs chains, and the
@@ -172,20 +172,27 @@ function contractMatches(contract, request) {
 function routePatternOf(declared) {
 	if (declared instanceof RegExp) return declared;
 	const { base } = splitDeclared(declared);
-	if (base.startsWith("/")) return new RegExp(String.raw`^https?:\/\/[^/?#]+${placeholderPatternSource(base)}(?:\?[^#]*)?(?:#.*)?$`);
-	if (hasPlaceholders(base)) return new RegExp(String.raw`^${placeholderPatternSource(base)}(?:\?[^#]*)?(?:#.*)?$`);
+	if (base.startsWith("/")) return new RegExp(String.raw`^https?:\/\/[^/?#]+${placeholderPatternSource(base)}(?:\?[^#]*)?(?:#.*)?$`, "u");
+	if (hasPlaceholders(base)) return new RegExp(String.raw`^${placeholderPatternSource(base)}(?:\?[^#]*)?(?:#.*)?$`, "u");
 	return base;
 }
+/** How a declared contract reads in a failure message: spent, served, or silent. */
+function stateOf({ contract, served }) {
+	const { times } = contract;
+	if (times !== void 0 && served >= times) return ` (exhausted after ${times})`;
+	return served === 0 ? "" : ` (served ${served} time(s))`;
+}
 var ContractQueue = class {
-	contracts;
-	served;
+	entries;
 	constructor(contracts) {
-		this.contracts = contracts;
-		this.served = contracts.map(() => 0);
+		this.entries = contracts.map((contract) => ({
+			contract,
+			served: 0
+		}));
 	}
 	/** How many contracts the chain declared. */
 	get size() {
-		return this.contracts.length;
+		return this.entries.length;
 	}
 	/**
 	* Routes to register with an out-of-process router, deduped by pattern —
@@ -193,7 +200,7 @@ var ContractQueue = class {
 	*/
 	get routes() {
 		const routes = /* @__PURE__ */ new Map();
-		for (const contract of this.contracts) {
+		for (const { contract } of this.entries) {
 			const url = routePatternOf(contract.request.url);
 			const key = String(url);
 			const route = routes.get(key) ?? {
@@ -207,7 +214,7 @@ var ContractQueue = class {
 	}
 	/** The declared routes, in order — the enumeration a 501 body carries. */
 	declaredRoutes() {
-		return this.contracts.map((contract) => describeRoute(contract));
+		return this.entries.map(({ contract }) => describeRoute(contract));
 	}
 	/**
 	* Serve the first contract in declaration order that matches and is not
@@ -215,13 +222,12 @@ var ContractQueue = class {
 	* matches is spent") — the strict-violation signal.
 	*/
 	take(request) {
-		for (let i = 0; i < this.contracts.length; i++) {
-			const contract = this.contracts[i];
-			const { times } = contract;
-			if (times !== void 0 && this.served[i] >= times) continue;
-			if (!contractMatches(contract, request)) continue;
-			this.served[i] += 1;
-			return contract;
+		for (const entry of this.entries) {
+			const { times } = entry.contract;
+			if (times !== void 0 && entry.served >= times) continue;
+			if (!contractMatches(entry.contract, request)) continue;
+			entry.served += 1;
+			return entry.contract;
 		}
 		return null;
 	}
@@ -232,9 +238,8 @@ var ContractQueue = class {
 	*/
 	requiredError() {
 		const unmet = [];
-		for (const [i, contract] of this.contracts.entries()) {
+		for (const { contract, served } of this.entries) {
 			if (!contract.required) continue;
-			const served = this.served[i];
 			const { times } = contract;
 			if (times === void 0) {
 				if (served === 0) unmet.push(`  - ${describeRoute(contract)} — declared and required but never requested`);
@@ -249,15 +254,9 @@ var ContractQueue = class {
 	* and how often it was served.
 	*/
 	unmatchedError(method, url) {
-		const declared = this.contracts.length === 0 ? "  (no contracts declared)" : this.contracts.map((contract, i) => `  - ${describeRoute(contract)}${this.stateOf(i)}`).join("\n");
+		const declared = this.entries.length === 0 ? "  (no contracts declared)" : this.entries.map((entry) => `  - ${describeRoute(entry.contract)}${stateOf(entry)}`).join("\n");
 		return /* @__PURE__ */ new Error(`Unmatched outgoing HTTP request during spec: ${method} ${url}\nDeclared contracts:\n${declared}\nEvery outgoing request of a chain that declares contracts must match one — add a contract for it (or raise its \`times\` when it is exhausted).`);
 	}
-	stateOf(index) {
-		const served = this.served[index];
-		const { times } = this.contracts[index];
-		if (times !== void 0 && served >= times) return ` (exhausted after ${times})`;
-		return served === 0 ? "" : ` (served ${served} time(s))`;
-	}
 };
 //#endregion
 export { isContract as a, defineContracts as i, contractsOf as n, isContracts as o, defineContract as r, ContractQueue as t };

package/dist/spec-document.js

@@ -1,7 +1,7 @@
 import { LineCounter, Scalar, Scalar as Scalar$1, isMap, isScalar, isSeq, parseDocument, visit } from "yaml";
 //#region src/integrations/yaml/document.ts
 /** A line that opens a mapping key — `  key:` or `  - key:`, never block-scalar text. */
-const KEY_LINE = /^(?<indent> +)(?:- )?[A-Za-z_$'"][^\n]*:/;
+const KEY_LINE = /^(?<indent> +)(?:- )?[A-Za-z_$'"][^\n]*:/u;
 /**
 * The indentation step the file was written with, read from the shallowest
 * mapping key it carries. A rewrite must come back in the author's style — a
@@ -11,8 +11,8 @@ const KEY_LINE = /^(?<indent> +)(?:- )?[A-Za-z_$'"][^\n]*:/;
 function detectIndent(text) {
 	let smallest = 0;
 	for (const line of text.split("\n")) {
-		const found = KEY_LINE.exec(line);
-		if (found?.groups && (smallest === 0 || found.groups.indent.length < smallest)) smallest = found.groups.indent.length;
+		const indent = KEY_LINE.exec(line)?.groups?.indent;
+		if (indent !== void 0 && (smallest === 0 || indent.length < smallest)) smallest = indent.length;
 	}
 	return smallest === 0 ? 2 : smallest;
 }
@@ -37,7 +37,7 @@ const DEEPEST_STATABLE_STEP = 9;
 * at the root, which YAML counts from -1.
 */
 function stateIndentation(written, ctx) {
-	if (!/^[|>][1-9]/.test(written)) return written;
+	if (!/^[|>][1-9]/u.test(written)) return written;
 	const step = ctx.indent === "" ? 1 : ctx.indentStep.length;
 	if (step > DEEPEST_STATABLE_STEP) throw new Error(`A block scalar indented by ${step} spaces cannot state its indentation: YAML writes that indicator as a single digit, so ${DEEPEST_STATABLE_STEP} spaces is the deepest step a document may be written with.`);
 	return `${written[0]}${step}${written.slice(2)}`;
@@ -96,13 +96,13 @@ function lineStart(text, offset) {
 /** Back over the whitespace before `offset`, to just past the `:` or `-` that owns it. */
 function afterOwner(text, offset) {
 	let at = offset;
-	while (at > 0 && /\s/.test(text[at - 1])) at -= 1;
+	while (at > 0 && /\s/u.test(text[at - 1] ?? "")) at -= 1;
 	return at;
 }
 /** How many spaces a line opens with. */
 function indentOf(text, offset) {
 	const start = lineStart(text, offset);
-	return /^ */.exec(text.slice(start))[0].length;
+	return /^ */u.exec(text.slice(start))[0].length;
 }
 /**
 * Every OUTERMOST flow collection of a document, in source order. A nested one
@@ -113,11 +113,13 @@ function flowCollections(text) {
 	const found = [];
 	const take = (node) => {
 		if (node.flow !== true || !node.range) return;
-		const from = afterOwner(text, node.range[0]);
+		const [start, end] = node.range;
+		if (start === void 0 || end === void 0) return;
+		const from = afterOwner(text, start);
 		found.push({
 			ownerIndent: indentOf(text, from === 0 ? 0 : from - 1),
-			range: [from, node.range[1]],
-			text: text.slice(from, node.range[1]),
+			range: [from, end],
+			text: text.slice(from, end),
 			value: JSON.stringify(node.toJSON())
 		});
 		return visit.SKIP;
@@ -154,10 +156,12 @@ function restoreUntouchedFlow(rendered, text) {
 	for (const target of flowCollections(rendered)) {
 		const at = sources.findIndex((candidate, index) => !taken.has(index) && candidate.value === target.value && candidate.ownerIndent === target.ownerIndent);
 		if (at === -1) continue;
+		const source = sources[at];
+		if (source === void 0) continue;
 		taken.add(at);
 		splices.push({
 			range: target.range,
-			text: sources[at].text
+			text: source.text
 		});
 	}
 	let out = rendered;
@@ -179,7 +183,7 @@ function renderYamlSource(source) {
 	}), source.text);
 }
 //#endregion
-//#region src/core/literate/spec-document.ts
+//#region src/specification/literate/spec-document.ts
 /**
 * The `<case>.spec.yaml` document — one scenario, written as data.
 *
@@ -256,7 +260,7 @@ function lineOf(context, node) {
 }
 function nodeRange(node) {
 	if ("range" in node && Array.isArray(node.range)) return node.range;
-	const key = node.key;
+	const { key } = node;
 	return key !== null && typeof key === "object" && "range" in key ? key.range ?? void 0 : void 0;
 }
 /** The line a scalar's CONTENT starts on — one past the `|` for a block scalar. */
@@ -423,8 +427,8 @@ function readRun(context, node, isLast) {
 */
 function readSpecFile(content, fileName) {
 	const source = parseYamlSource(content);
-	const syntax = yamlSyntaxErrors(source);
-	if (syntax.length > 0) throw new SpecSyntaxError(fileName, syntax[0].line, syntax[0].message);
+	const [syntax] = yamlSyntaxErrors(source);
+	if (syntax !== void 0) throw new SpecSyntaxError(fileName, syntax.line, syntax.message);
 	const context = {
 		fileName,
 		source
@@ -533,20 +537,10 @@ const STRING_OR_LIST = { oneOf: [{ type: "string" }, {
 	minItems: 1,
 	type: "array"
 }] };
-/**
-* The JSON Schema editors validate a `<case>.spec.yaml` against, built from the
-* constants above so it cannot describe a grammar the parser does not read. It
-* is committed as `schema/spec.schema.json` by `npm run docs` and published as
-* the `@jterrazz/test/schema` export.
-*
-* A schema states which keys exist, not which ORDER they come in — JSON Schema
-* has no vocabulary for the sequence of an object's members. The canonical
-* order is the `d4b-spec-key-order` lint pass's, which also rewrites it.
-*/
 const SPEC_SCHEMA = {
 	$defs: {
 		fileAssertion: { oneOf: [{
-			enum: [...FILE_STATES],
+			enum: FILE_STATES,
 			type: "string"
 		}, {
 			additionalProperties: false,

package/dist/vitest.d.ts

@@ -1,6 +1,6 @@
 import { ViteUserConfig } from "vitest/config";
 //#region src/vitest/literate-plugin.d.ts
-interface LiterateOptions {
+type LiterateOptions = {
   /**
    * Globs added to the project's test include. Default: every `.spec.yaml`
    * file. Narrow it when a tree holds documents that are INPUTS to other
@@ -17,13 +17,13 @@ interface LiterateOptions {
    * scenario to the wrong command.
    */
   specification: string;
-}
+};
 /**
  * The shape vite consumes. Declared structurally rather than imported from
  * `vite`, so the package's runner coupling stays the one dependency it already
  * has (CONVENTIONS I1) — the object is assignable to vite's `Plugin`.
  */
-interface LiteratePlugin {
+type LiteratePlugin = {
   config: () => {
     test: {
       include: string[];
@@ -36,7 +36,7 @@ interface LiteratePlugin {
   enforce: 'pre';
   load: (id: string) => null | string;
   name: string;
-}
+};
 declare function literate(options: LiterateOptions): LiteratePlugin;
 //#endregion
 //#region src/vitest/preset.d.ts
@@ -44,7 +44,7 @@ declare function literate(options: LiterateOptions): LiteratePlugin;
  * Options are a vite/vitest config plus one key of the framework's own.
  * Everything stated here wins over the preset's defaults.
  */
-interface SpecConfig extends ViteUserConfig {
+type SpecConfig = {
   /**
    * Turns every matching `<case>.spec.yaml` into a test file bound to the
    * named specification — the {@link literate} plugin, added to `plugins`.
@@ -54,7 +54,7 @@ interface SpecConfig extends ViteUserConfig {
    * so the plugin goes in that project's own `plugins` instead.
    */
   literate?: LiterateOptions;
-}
+} & ViteUserConfig;
 declare function defineSpecConfig(config?: SpecConfig): ViteUserConfig;
 //#endregion
 export { type LiterateOptions, type LiteratePlugin, type SpecConfig, defineSpecConfig, literate };

package/dist/vitest.js

@@ -24,7 +24,7 @@ import { configDefaults, mergeConfig } from "vitest/config";
 * ```
 */
 /** The `.spec.yaml` extension, matched on the id vite hands the plugin. */
-const SPEC_FILE = /\.spec\.yaml(?:\?.*)?$/;
+const SPEC_FILE = /\.spec\.yaml(?:\?.*)?$/u;
 /**
 * The module a `<case>.spec.yaml` becomes: one `test()` whose title is the
 * document's `description:` and whose body runs the whole file — its ground,
@@ -46,7 +46,7 @@ function literateModule(content, filePath, specificationPath) {
 }
 /** Strip vite's query suffix (`?v=…`) from a module id. */
 function cleanId(id) {
-	return id.split("?")[0];
+	return id.split("?")[0] ?? id;
 }
 function literate(options) {
 	const include = options.include ?? ["**/*.spec.yaml"];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jterrazz/test",
-    "version": "15.0.0",
+    "version": "15.1.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",
@@ -41,9 +41,14 @@
             "import": "./dist/vitest.js"
         },
         "./oxlint": {
-            "types": "./dist/oxlint.d.ts",
-            "import": "./dist/oxlint.js",
-            "require": "./dist/oxlint.cjs"
+            "import": {
+                "types": "./dist/oxlint.d.ts",
+                "default": "./dist/oxlint.js"
+            },
+            "require": {
+                "types": "./dist/oxlint.d.cts",
+                "default": "./dist/oxlint.cjs"
+            }
         },
         "./schema": "./schema/spec.schema.json"
     },
@@ -69,13 +74,11 @@
     },
     "devDependencies": {
         "@hono/node-server": "^2.0.8",
-        "@jterrazz/typescript": "^9.2.0",
+        "@jterrazz/typescript": "^10.0.0",
         "@types/better-sqlite3": "^7.6.13",
         "@types/node": "^26.1.1",
         "@types/pg": "^8.20.0",
         "hono": "^4.12.30",
-        "oxfmt": "^0.59.0",
-        "oxlint": "^1.74.0",
         "playwright": "^1.49.0",
         "tsdown": "^0.22.7",
         "vitest": "^4.1.10",