@jterrazz/test 16.1.1 → 18.0.0

package/dist/appium.adapter.js

@@ -1,489 +0,0 @@
-import { i as AmbiguousElementError, n as warnSubstringOnly, o as formatElement } from "./substring-warning.js";
-import { mkdtempSync, writeFileSync } from "node:fs";
-import { resolve } from "node:path";
-import { tmpdir } from "node:os";
-//#region src/facets/mobile/ambiguity.ts
-/**
-* The ambiguity refusal, mobile edition — CONVENTIONS W3.
-*
-* A mobile 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 taps something else, and nothing ever
-* reports it. So when a descriptor matches several elements the framework
-* refuses, and the refusal carries everything needed to fix it without
-* opening the simulator — the descriptor in the caller's own vocabulary,
-* every candidate, and the concrete rewrites that would resolve it.
-*
-* The element vocabulary is shared with the website facet, so the source
-* rendering (`formatElement`) is too; only the evidence differs — XCUITest
-* types, labels and accessibility identifiers instead of tags and landmarks.
-* Pure string building: the appium integration stays a thin adapter.
-*/
-/** `1. Button "Bookmark"  [testId: event-42]` — one evidence line per candidate. */
-function formatMatch(match, index) {
-	const label = match.label === void 0 ? "" : ` ${JSON.stringify(match.label)}`;
-	const value = match.value === void 0 ? "" : `  value=${JSON.stringify(match.value)}`;
-	const identifier = match.identifier === void 0 ? "" : `  [testId: ${match.identifier}]`;
-	return `  ${index + 1}. ${match.type}${label}${value}${identifier}`;
-}
-/**
-* The rewrites worth offering, in the order they should be tried. Scoping is
-* always available; `exact` only to a descriptor that opted OUT of it (exact
-* is the default), and the count it would leave is stated so a
-* still-ambiguous suggestion never reads as a fix; distinct identifiers make
-* `testId()` a concrete rewrite rather than a guess.
-*/
-function formatFixes(element, matches) {
-	const fixes = [];
-	if (!element.scope) fixes.push(`scope it       within(testId('…'), ${formatElement(element)}) — a screen has no landmarks; any descriptor works as the scope`);
-	if (element.exact === false && element.name !== void 0) {
-		const remaining = matches.filter((match) => match.label === element.name).length;
-		if (remaining > 0 && remaining < matches.length) fixes.push(`exact name     ${formatElement({
-			exact: true,
-			kind: element.kind,
-			name: element.name
-		})}   [leaves ${remaining} of ${matches.length}]`);
-	}
-	const identifiers = [...new Set(matches.map((match) => match.identifier).filter((identifier) => identifier !== void 0))];
-	if (identifiers.length > 1 && element.kind !== "testId") fixes.push(`test id        testId(${JSON.stringify(identifiers[0])})   [also here: ${identifiers.slice(1).join(", ")}]`);
-	fixes.push("other element  a button() or field() may name one thing where this does not");
-	return fixes;
-}
-/**
-* Build the refusal thrown when a descriptor matches more than one element
-* on the screen.
-*
-* @param options.element The descriptor as the caller wrote it.
-* @param options.matches Every candidate, in screen order (already truncated).
-*/
-function describeMobileAmbiguity(options) {
-	const { element, matches } = options;
-	const fixes = formatFixes(element, matches).map((fix) => `  • ${fix}`);
-	return [
-		`Ambiguous element: ${formatElement(element)} matched ${matches.length} elements on the screen.`,
-		"",
-		"A spec must designate exactly one element. Acting on the first match would let",
-		"this test keep passing while the visitor taps 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
-//#region src/facets/mobile/projection.ts
-const TAG_PATTERN = /<(?<openTag>[A-Za-z][\w.]*)(?<rawAttributes>(?:\s+[\w:.-]+="[^"]*")*)\s*(?<selfClosing>\/?)>|<\/(?<closeTag>[\w.]*)\s*>/gu;
-const ATTRIBUTE_PATTERN = /(?<key>[\w:.-]+)="(?<value>[^"]*)"/gu;
-const NAMED_ENTITIES = {
-	"&amp;": "&",
-	"&apos;": "'",
-	"&gt;": ">",
-	"&lt;": "<",
-	"&quot;": "\""
-};
-/** Decode the XML entities an attribute value can carry. */
-function decodeEntities(value) {
-	return value.replaceAll(/&(?:#x(?<hex>[\dA-Fa-f]+)|#(?<decimal>\d+)|(?<named>amp|apos|gt|lt|quot));/gu, (entity, hex, decimal) => {
-		if (hex) return String.fromCodePoint(Number.parseInt(hex, 16));
-		if (decimal) return String.fromCodePoint(Number(decimal));
-		return NAMED_ENTITIES[entity] ?? entity;
-	});
-}
-/** Parse the page source into a raw element tree (strict, attribute-only XML). */
-function parsePageSource(xml) {
-	const stack = [];
-	let root = null;
-	for (const match of xml.matchAll(TAG_PATTERN)) {
-		const { closeTag, openTag, rawAttributes, selfClosing } = match.groups ?? {};
-		if (closeTag !== void 0 || openTag === void 0) {
-			stack.pop();
-			continue;
-		}
-		const attributes = {};
-		for (const attribute of (rawAttributes ?? "").matchAll(ATTRIBUTE_PATTERN)) {
-			const { key, value } = attribute.groups ?? {};
-			if (key !== void 0 && value !== void 0) attributes[key] = decodeEntities(value);
-		}
-		const node = {
-			attributes,
-			children: [],
-			tag: openTag
-		};
-		const parent = stack.at(-1);
-		if (parent === void 0) root = node;
-		else parent.children.push(node);
-		if (!selfClosing) stack.push(node);
-	}
-	if (!root) throw new Error("projectScreen(): the page source contains no XML element");
-	return root;
-}
-/** The substance of a node — what survives projection, or nothing. */
-function substance(node) {
-	const label = node.attributes.label || void 0;
-	const value = node.attributes.value || void 0;
-	const identifier = node.attributes.name || void 0;
-	return {
-		type: node.tag.replace(/^XCUIElementType/u, ""),
-		...label === void 0 ? {} : { label },
-		...value === void 0 || value === label ? {} : { value },
-		...identifier === void 0 || identifier === label ? {} : { identifier }
-	};
-}
-function hasSubstance(node) {
-	return node.label !== void 0 || node.value !== void 0 || node.identifier !== void 0;
-}
-/** A childless child that repeats its parent is the same accessibility element twice. */
-function repeatsParent(child, parent) {
-	return child.children === void 0 && child.type === parent.type && child.label === parent.label && child.value === parent.value && child.identifier === parent.identifier;
-}
-/** Project one raw node: a kept node, or (hoisting) the projections of its children. */
-function projectNode(node) {
-	const own = substance(node);
-	const children = node.children.flatMap((child) => projectNode(child)).filter((child) => !repeatsParent(child, own));
-	if (!hasSubstance(own)) return children;
-	return [{
-		...own,
-		...children.length > 0 ? { children } : {}
-	}];
-}
-/** Collect the visible texts in document order, collapsing consecutive repeats. */
-function collectTexts(node, texts) {
-	if (node.attributes.visible === "true") {
-		const text = node.attributes.label || node.attributes.value || void 0;
-		if (text !== void 0 && texts.at(-1) !== text) texts.push(text);
-	}
-	for (const child of node.children) collectTexts(child, texts);
-}
-/**
-* Project a raw XCUITest page source into the captured screen: the collapsed
-* tree (rooted at the application node, which is always kept) and the
-* visible texts in document order.
-*/
-function projectScreen(xml) {
-	let root = parsePageSource(xml);
-	const [onlyChild] = root.children;
-	if (root.tag === "AppiumAUT" && root.children.length === 1 && onlyChild !== void 0) root = onlyChild;
-	const texts = [];
-	for (const child of root.children) collectTexts(child, texts);
-	const own = substance(root);
-	const children = root.children.flatMap((child) => projectNode(child)).filter((child) => !repeatsParent(child, own));
-	return {
-		texts,
-		tree: {
-			...own,
-			...children.length > 0 ? { children } : {}
-		}
-	};
-}
-//#endregion
-//#region src/seams/appium/appium.adapter.ts
-const DEFAULT_ACTION_TIMEOUT_MS = 3e4;
-const POLL_INTERVAL_MS = 500;
-/** How many candidates the ambiguity error enumerates before truncating. */
-const MAX_REPORTED_MATCHES = 10;
-/** WebDriverAgent builds once per simulator — the first session is the slow one. */
-const DEFAULT_WDA_LAUNCH_TIMEOUT_MS = 24e4;
-const delay = async (ms) => {
-	await new Promise((resolveDelay) => setTimeout(resolveDelay, ms));
-};
-/** Escape a name for an NSPredicate single-quoted string literal. */
-function escapePredicate(value) {
-	return value.replaceAll("\\", String.raw`\\`).replaceAll("'", String.raw`\'`);
-}
-/**
-* Translate a user-facing descriptor into an iOS predicate string. Landmarks
-* have no XCUITest analog — the shared vocabulary is wider than a screen,
-* and the boundary is named rather than silently approximated.
-*/
-function compilePredicate(element, options) {
-	const name = escapePredicate(element.name ?? "");
-	const contains = (attribute) => element.exact === false ? `${attribute} CONTAINS '${name}'` : `${attribute} == '${name}'`;
-	const visible = options?.anyVisibility ? "1 == 1" : "visible == 1";
-	switch (element.kind) {
-		case "button": return `type == 'XCUIElementTypeButton' AND ${contains("label")} AND ${visible}`;
-		case "field": return `type IN {'XCUIElementTypeTextField','XCUIElementTypeSecureTextField'} AND (${contains("label")} OR ${contains("value")}) AND ${visible}`;
-		case "testId": return `name == '${name}' AND ${visible}`;
-		case "text": return `(${contains("label")} OR ${contains("value")}) AND ${visible}`;
-		default: throw new Error(`${formatElement(element)}: landmarks are a website concept — an iOS screen has no '${element.kind}' region. Scope with within(testId('…'), …) instead.`);
-	}
-}
-/**
-* Every element a predicate designates under `scope`.
-*
-* ONE place awaits webdriverio's query: `$$` answers a chainable typed as the
-* array it resolves to, so the await that makes the array real reads to the
-* typechecker as an await of a non-promise.
-*/
-async function matching(scope, element, options) {
-	return await scope.$$(`-ios predicate string:${compilePredicate(element, options)}`);
-}
-/** The outside-in scope chain of a descriptor, ending on the target itself. */
-function scopeChain(element) {
-	const chain = [];
-	for (let current = element; current; current = current.scope) chain.unshift(current);
-	return chain;
-}
-/**
-* Load webdriverio's session factory, naming the install when the optional
-* peer dependency is absent. Lazy: the dependency is only required by a spec
-* that actually opens the app.
-*/
-async function loadRemote() {
-	try {
-		const { remote: remoteFn } = await import("webdriverio");
-		return remoteFn;
-	} catch {
-		throw new Error(".open() requires webdriverio (optional peer dependency): npm install -D appium webdriverio && npx appium driver install xcuitest");
-	}
-}
-/** Capture one candidate's evidence for the ambiguity refusal. */
-async function captureMatch(element) {
-	const [type, label, value, identifier] = await Promise.all([
-		element.getAttribute("type"),
-		element.getAttribute("label"),
-		element.getAttribute("value"),
-		element.getAttribute("name")
-	]);
-	const shortLabel = label ? label.replaceAll(/\s+/gu, " ").trim().slice(0, 80) : void 0;
-	return {
-		type: (type ?? "Unknown").replace(/^XCUIElementType/u, ""),
-		...shortLabel === void 0 ? {} : { label: shortLabel },
-		...value && value !== label ? { value } : {},
-		...identifier && identifier !== label ? { identifier } : {}
-	};
-}
-/**
-* Device adapter backed by appium's XCUITest driver over webdriverio.
-*
-* ONE driver session per adapter (= per runner = per vitest worker), created
-* lazily on the first `open()` and reused — WebDriverAgent startup is the
-* expensive part, not the app relaunch. Every `open()` terminates and
-* relaunches the app, so each spec starts from a deterministic fresh state.
-*
-* Webdriverio is an optional peer dependency: it is only imported here, and
-* this module is only loaded when a spec calls `.open()`.
-*/
-var AppiumAdapter = class {
-	/** The verb poll budget — the runner's `timeouts.action`, or the default. */
-	actionTimeoutMs;
-	driver = null;
-	/** The WebDriverAgent launch budget — the runner's `timeouts.launch`, or the default. */
-	launchTimeoutMs;
-	options;
-	/**
-	* The session factory. Absent in production — webdriverio is then loaded
-	* lazily on the first `open()`. Injected by this module's own unit test,
-	* which drives the waits over a stub driver with no simulator in reach
-	* (mocks are CODE here, CONVENTIONS I4).
-	*/
-	remote;
-	constructor(options) {
-		this.options = {
-			serverUrl: options.serverUrl,
-			udid: options.udid
-		};
-		this.remote = options.remote;
-		this.actionTimeoutMs = options.timeouts?.action ?? DEFAULT_ACTION_TIMEOUT_MS;
-		this.launchTimeoutMs = options.timeouts?.launch ?? DEFAULT_WDA_LAUNCH_TIMEOUT_MS;
-	}
-	async close() {
-		if (this.driver) {
-			await this.driver.deleteSession();
-			this.driver = null;
-		}
-	}
-	async open(options) {
-		const driver = await this.session(options.bundleId);
-		try {
-			await driver.executeScript("mobile: terminateApp", [{ bundleId: options.bundleId }]);
-		} catch {}
-		await (options.deepLink === void 0 ? driver.executeScript("mobile: activateApp", [{ bundleId: options.bundleId }]) : driver.executeScript("mobile: deepLink", [{
-			bundleId: options.bundleId,
-			url: options.deepLink
-		}]));
-		if (options.scenario) try {
-			await options.scenario(this.createVisitor(driver));
-		} catch (error) {
-			const evidence = await this.captureEvidence(driver);
-			const suffix = evidence ? `\nEvidence: ${evidence}` : "";
-			if (error instanceof AmbiguousElementError) {
-				error.message += suffix;
-				throw error;
-			}
-			throw new Error(`open scenario failed: ${error instanceof Error ? error.message : String(error)}${suffix}`, { cause: error });
-		}
-		return projectScreen(await driver.getPageSource());
-	}
-	/**
-	* The visitor implementation. Acting verbs (tap/fill) poll until exactly
-	* one visible match exists (CONVENTIONS W3); `see()` acts on nothing, so
-	* ANY visible match satisfies it — XCUITest trees legitimately expose the
-	* same text more than once (container/child label duplication), and a
-	* synchronization primitive refusing on that would punish honest screens.
-	*/
-	createVisitor(driver) {
-		return {
-			fill: async (element, value) => {
-				await (await this.resolveOne(driver, element, "fill", "one")).setValue(value);
-			},
-			see: async (element) => {
-				await this.resolveOne(driver, element, "see", "any");
-			},
-			tap: async (element) => {
-				await (await this.resolveOne(driver, element, "tap", "one")).click();
-			}
-		};
-	}
-	/**
-	* Resolve a descriptor: poll until at least one visible match exists,
-	* then enforce the verb's cardinality — `'one'` refuses ambiguity
-	* (CONVENTIONS W3), `'any'` settles for the first match. Scopes stay
-	* strict in BOTH modes: "within one of several containers" designates
-	* nothing, whatever the verb. The chain resolves outside-in, so an
-	* ambiguous scope names ITSELF as the fault rather than sending the
-	* author to fix the target.
-	*/
-	async resolveOne(driver, element, verb, cardinality) {
-		const chain = scopeChain(element);
-		const deadline = Date.now() + this.actionTimeoutMs;
-		let scrollAttempted = false;
-		let windowAsked = false;
-		let looking = chain;
-		for (;;) {
-			const resolved = await this.resolveChain(driver, looking, cardinality, { tryScroll: !scrollAttempted });
-			scrollAttempted = true;
-			if (resolved) return resolved;
-			if (!windowAsked) {
-				windowAsked = true;
-				looking = await this.widenedChain(driver, chain) ?? chain;
-			}
-			if (Date.now() > deadline) throw await this.timeoutError(driver, element, verb);
-			await delay(POLL_INTERVAL_MS);
-		}
-	}
-	/** One resolution pass over the chain — `null` means "nothing yet, keep polling". */
-	async resolveChain(driver, chain, cardinality, options) {
-		let scope = driver;
-		for (const [index, level] of chain.entries()) {
-			const matches = await matching(scope, level);
-			const count = await matches.length;
-			if (count === 0) {
-				if (options?.tryScroll) {
-					const first = (await matching(scope, level, { anyVisibility: true }))[0];
-					if (first !== void 0) try {
-						await driver.executeScript("mobile: scroll", [{
-							elementId: first.elementId,
-							toVisible: true
-						}]);
-					} catch {}
-				}
-				return null;
-			}
-			const isTarget = index === chain.length - 1;
-			if (count > 1 && (cardinality === "one" || !isTarget)) throw new AmbiguousElementError(describeMobileAmbiguity({
-				element: level,
-				matches: await this.captureMatches(matches)
-			}));
-			const next = matches[0];
-			if (next === void 0) return null;
-			scope = next;
-		}
-		return scope;
-	}
-	/**
-	* The chain to keep polling with, level by level: a descriptor that
-	* designated nothing as a whole label but designates exactly one thing as a
-	* SUBSTRING is widened, with the warning that names the label to write. The
-	* window is the vocabulary's, not one surface's — chapter 13 — so the
-	* screen answers it exactly as a page does.
-	*
-	* `null` when nothing would change, which is the ordinary wait.
-	*/
-	async widenedChain(driver, chain) {
-		let scope = driver;
-		const widened = [];
-		let changed = false;
-		for (const level of chain) {
-			const found = await this.widenedLevel(scope, level);
-			changed ||= found !== null;
-			const candidate = found ?? level;
-			const next = (await matching(scope, candidate))[0];
-			if (next === void 0) return null;
-			scope = next;
-			widened.push(candidate);
-		}
-		return changed ? widened : null;
-	}
-	/** One level of the chain, widened and warned about, or `null`. */
-	async widenedLevel(scope, level) {
-		if (level.exact !== void 0 || level.name === void 0) return null;
-		if (await (await matching(scope, level)).length > 0) return null;
-		const loose = {
-			...level,
-			exact: false
-		};
-		const matches = await matching(scope, loose);
-		const first = matches[0];
-		if (first === void 0 || await matches.length !== 1) return null;
-		const evidence = await captureMatch(first);
-		await warnSubstringOnly(level, this.options.udid, evidence.label);
-		return loose;
-	}
-	/** Enumerate the candidates' evidence, truncated. */
-	async captureMatches(matches) {
-		const count = Math.min(await matches.length, MAX_REPORTED_MATCHES);
-		const evidence = [];
-		for (let index = 0; index < count; index++) {
-			const match = matches[index];
-			if (match !== void 0) evidence.push(await captureMatch(match));
-		}
-		return evidence;
-	}
-	/** Screenshot the failing state into a temp file; never masks the original error. */
-	async captureEvidence(driver) {
-		try {
-			const dir = mkdtempSync(resolve(tmpdir(), "spec-mobile-"));
-			const path = resolve(dir, "failure.png");
-			writeFileSync(path, Buffer.from(await driver.takeScreenshot(), "base64"));
-			return path;
-		} catch {
-			return null;
-		}
-	}
-	/** The timeout refusal, with a compact excerpt of what IS on screen to aid diagnosis. */
-	async timeoutError(driver, element, verb) {
-		let excerpt = "";
-		try {
-			const source = await driver.getPageSource();
-			const labels = [...new Set([...source.matchAll(/label="(?<label>[^"]{2,60})"/gu)].map((match) => match.groups?.label ?? ""))].slice(0, 15);
-			if (labels.length > 0) excerpt = `\nCurrently on screen: ${labels.join(" | ")}`;
-		} catch {}
-		return /* @__PURE__ */ new Error(`${verb}(${formatElement(element)}) timed out after ${this.actionTimeoutMs}ms — no visible match.${excerpt}`);
-	}
-	/** Create the shared driver session (once), with an actionable error when webdriverio is absent. */
-	async session(bundleId) {
-		if (this.driver) return this.driver;
-		const remoteFn = this.remote ?? await loadRemote();
-		const url = new URL(this.options.serverUrl);
-		this.driver = await remoteFn({
-			capabilities: {
-				"appium:automationName": "XCUITest",
-				"appium:bundleId": bundleId,
-				"appium:noReset": true,
-				"appium:udid": this.options.udid,
-				"appium:wdaLaunchTimeout": this.launchTimeoutMs,
-				platformName: "iOS"
-			},
-			hostname: url.hostname,
-			logLevel: "error",
-			port: Number(url.port)
-		});
-		return this.driver;
-	}
-};
-//#endregion
-export { AppiumAdapter };

package/dist/artifacts.js

@@ -1,32 +0,0 @@
-/** Everything a vitest run generates. */
-const VITEST_ARTIFACTS_DIR = `.artifacts/vitest`;
-/** Where the coverage provider writes its report. */
-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`;
-/**
-* Where `context.annotate()` puts what a test attaches, and where Browser Mode
-* drops a failure screenshot. Vitest 5 defaults both to `.vitest/` at the
-* repository ROOT — a second artefact folder beside the one the estate declares,
-* and one no `.gitignore` rule of ours covers.
-*/
-const ATTACHMENTS_DIR = `${VITEST_ARTIFACTS_DIR}/attachments`;
-/** Where the browser provider drops a screenshot of a failing test. */
-const SCREENSHOTS_DIR = `${VITEST_ARTIFACTS_DIR}/screenshots`;
-/**
-* What each file-writing reporter writes, by reporter name.
-*
-* Vitest 5 turned the json and junit reporters into FILE writers (they printed
-* to stdout before) and gave the html and blob ones a `.vitest/` home. Each one
-* is a path the tool pins and a consumer never states, so the preset moves all
-* four at once rather than leaving a repository to discover them one CI run at
-* a time.
-*/
-const REPORTER_OUTPUT_FILES = {
-	blob: `${VITEST_ARTIFACTS_DIR}/blob`,
-	html: `${VITEST_ARTIFACTS_DIR}/html/index.html`,
-	json: `${VITEST_ARTIFACTS_DIR}/json/output.json`,
-	junit: `${VITEST_ARTIFACTS_DIR}/junit/output.xml`
-};
-//#endregion
-export { SQLITE_TEMPLATE_DIR as a, SCREENSHOTS_DIR as i, COVERAGE_DIR as n, VITEST_ARTIFACTS_DIR as o, REPORTER_OUTPUT_FILES as r, ATTACHMENTS_DIR as t };

package/dist/fixtures.js

@@ -1,110 +0,0 @@
-import { basename, dirname, resolve } from "node:path";
-//#region src/model/chain/ground.ts
-/**
-* The GROUND a row of specs stands on — the naming law of a spec tree.
-*
-* In a row of specs, a MEMBER is a spec: `<aspect>.test.ts`, `<case>.spec.yaml`,
-* `<name>.specification.ts`, and the facet/domain folders that hold them.
-* Everything else in that row is what the members STAND ON — inert material the
-* framework resolves BY PATH, never imported, never executed — and it carries a
-* LEADING UNDERSCORE. A spec's own folder never does.
-*
-* Four names, and only four: `_fixtures/` (file state), `_expected/` (goldens),
-* `_requests/` (inputs), `_seeds/` (database state). `contracts/` is NOT ground —
-* a contract is TypeScript a spec imports, behaviour composed with the spec's own,
-* so it stays a member. `docker/` is not ground either: it sits at the PROJECT
-* root beside `package.json`, outside any row of specs.
-*
-* This module is the single home of those names. Every resolver, matcher, lint
-* rule and checker pass reads them from here, so the runtime and the static
-* channels cannot disagree about where a spec's ground lives.
-*/
-/** Goldens: every expected fixture, flat, extension included. */
-const GROUND_EXPECTED = "_expected";
-/** File state copied into a working directory by `.fixture()`. */
-const GROUND_FIXTURES = "_fixtures";
-/** Inputs: complete `.http` request documents. */
-const GROUND_REQUESTS = "_requests";
-/** Database state: `.sql` fragments loaded by `.seed()`. */
-const GROUND_SEEDS = "_seeds";
-/** The four ground directory names, in the order they read. */
-const GROUND_DIRS = [
-	GROUND_EXPECTED,
-	GROUND_FIXTURES,
-	GROUND_REQUESTS,
-	GROUND_SEEDS
-];
-//#endregion
-//#region src/model/chain/fixtures.ts
-/**
-* Fixture path resolution + copy semantics for the `cli` facet's `.fixture()`.
-*
-* A fixture path is one of two shapes:
-*
-*  - `$FIXTURES/<rest>` — the shared pool at `<specs-root>/_fixtures/<rest>`,
-*    where `<specs-root>` is the nearest ancestor directory named `specs`.
-*  - `<path>` (no marker) — feature-local, at `<test-dir>/_fixtures/<path>`.
-*
-* The leading underscore is the ground rule of a spec tree ({@link GROUND_FIXTURES}).
-* Any other `$`-prefixed marker is a usage error (listed against the known
-* markers). Copy semantics mirror rsync's trailing-slash rule (see
-* {@link copyPlan}).
-*/
-/**
-* Markers understood in a `.fixture()` path. Extend here + in
-* {@link resolveFixtureSource}. Exported so the lint layer (rule
-* `jterrazz/b2-known-fixture-marker`) validates literals against the same list.
-*/
-const KNOWN_FIXTURE_MARKERS = ["$FIXTURES"];
-/**
-* Walk up from `startDir` to the nearest ancestor directory named `specs`.
-* Throws with guidance if none is found up to the filesystem root — the
-* `$FIXTURES` marker is meaningless without a specs root.
-*/
-function discoverSpecsRoot(startDir) {
-	let dir = startDir;
-	for (;;) {
-		if (basename(dir) === "specs") return dir;
-		const parent = dirname(dir);
-		if (parent === dir) break;
-		dir = parent;
-	}
-	throw new Error(`.fixture(): the $FIXTURES marker resolves to <specs-root>/${GROUND_FIXTURES}, but no directory named "specs" was found walking up from ${startDir}. Move the specification under a specs/ directory, or use a feature-local ${GROUND_FIXTURES}/ path (no $FIXTURES marker).`);
-}
-/**
-* Resolve the absolute source path of a fixture, applying marker resolution.
-* The trailing slash (spread semantics) is preserved by callers via
-* {@link copyPlan} — it is irrelevant to source resolution.
-*/
-function resolveFixtureSource(path, testDir) {
-	const clean = path.replace(/\/+$/u, "");
-	if (clean === "$FIXTURES" || path.startsWith("$FIXTURES/")) {
-		const rest = clean.slice(9).replace(/^\/+/u, "");
-		return resolve(discoverSpecsRoot(testDir), GROUND_FIXTURES, rest);
-	}
-	if (path.startsWith("$")) {
-		const marker = clean.split("/")[0];
-		throw new Error(`.fixture("${path}"): unknown marker "${marker}". Known markers: ${KNOWN_FIXTURE_MARKERS.join(", ")}. A path without a marker is feature-local (resolved under <test-dir>/${GROUND_FIXTURES}/).`);
-	}
-	return resolve(testDir, GROUND_FIXTURES, clean);
-}
-/**
-* Compute the source + destination for copying a fixture into the working
-* directory. Copy semantics follow rsync's trailing-slash rule:
-*
-*  - `dir/` (trailing slash) — the CONTENTS are spread into the cwd.
-*  - `dir`  (no slash, a directory) — the directory is copied as `<cwd>/<basename>`.
-*  - `file` — copied as `<cwd>/<basename>`.
-*
-* Chained `.fixture()` calls layer in order: a later fixture overwrites files
-* written by an earlier one.
-*/
-function copyPlan(path, testDir, workDir) {
-	const src = resolveFixtureSource(path, testDir);
-	return {
-		dest: /\/+$/u.test(path) ? workDir : resolve(workDir, basename(src)),
-		src
-	};
-}
-//#endregion
-export { GROUND_FIXTURES as a, GROUND_EXPECTED as i, resolveFixtureSource as n, GROUND_REQUESTS as o, GROUND_DIRS as r, GROUND_SEEDS as s, copyPlan as t };