@jterrazz/test 17.0.0 → 18.0.1

package/dist/checker.js

@@ -1,214 +1,21 @@
-import { n as parsedJson, t as isRecord } from "./shared-json-shape.js";
+import { n as parsedJson } from "./shared-json-shape.js";
 import { t as CATALOGUE_CHAPTER } from "./shared-chapter.js";
 import { i as findUnknownTokens, n as findKnownTokens, r as findMalformedRefs, t as TOKEN_KINDS } from "./shared-tokens.js";
-import { a as scalarString, c as SPEC_EXTENSION, d as isRelativePath, i as readSpecFile, l as SpecSyntaxError, n as documentPaths, o as DOCUMENT_KEYS, r as parseSpecDocument, s as RUN_KEYS, t as assertedStreams, u as dedent } from "./shared-spec-document.js";
-import { a as literalOf, i as literalEnd, n as argumentsOf$1, o as openersAt, r as closingOf, s as skipString, t as argumentSpans } from "./shared-source-scan.js";
+import { a as RUN_KEYS, c as isRelativePath, o as SPEC_EXTENSION, s as SpecSyntaxError, t as DOCUMENT_KEYS } from "./shared-spec-grammar.js";
+import { i as literalEnd, n as argumentsOf, o as openersAt, r as closingOf, s as skipString, t as argumentSpans } from "./shared-source-scan.js";
+import { a as scalarString, i as readSpecFile, n as documentPaths, o as dedent, r as parseSpecDocument, t as assertedStreams } from "./shared-spec-document.js";
 import { c as nodeItems, d as renderYamlSource, l as nodePairs, o as isScalar, r as isMap, s as isSeq, t as Scalar } from "./shared-yaml-document.js";
 import { n as reachesRunner, t as SPECIFICATIONS } from "./shared-specifications.js";
 import { i as testSettingsAtSync, n as listsTestPreset, t as TEST_SECTION } from "./shared-test-section.js";
 import { i as writeBaseline } from "./shared-test-baseline.js";
 import { t as consumerRows } from "./shared-manifest.js";
-import { createRequire } from "node:module";
-import { BASELINE, GROUND_EXPECTED, GROUND_FIXTURES, GROUND_FOLDERS, GROUND_REQUESTS, GROUND_SEEDS, MEMBER_DEPTH, OXLINT_CONFIG_NAMES, OXLINT_SUPPRESSIONS, PRUNED, RENAMED_FOLDERS, RETIRED_SHARED_FOLDERS, SETUP_FOLDER, SPECIAL_FOLDERS, TESTS_FOLDER, blankComments, countsOf, defineCheck, folderChanged, forgetTree, holdsDirectives, holdsManifest, isFile, isGroundFolder, isProjectRoot, isSpecialFolder, keepsSection, labelOf, moveKeepingHistory, nearestRoot, quotedMask, readAt, readFileCached, readManifest, refusal, rowNamed, sectionOf, suppressionDirectives, treeEntries, treeKind, treeNames, workspaceMembers, workspacePatterns } from "@jterrazz/typescript/rules";
+import { $ as identifierName, A as removeIfEmpty, B as ambiguousSegment, C as lineAt, D as lowestCommonFolder, E as listReaders, F as literalPathVisitor, G as SUBJECT_SPECIFICATIONS, H as subjectFolder, K as doorsOf$1, M as specsRootOfPool, N as resolveSpecifier, O as readSource, P as parseProgram, R as visitProgram, S as isWithin, T as listFiles, U as subjectName, W as subjectsOf, X as childList, Y as child, _ as findPools, a as isRunnerName, at as nodeStart, b as isDir, c as modulesUnder, d as refusedReservedAbove, dt as isNodeTestFileName, et as isNode, f as renamedSpecialOf, ft as isTestFileName, g as decodeText, h as columnAt, ht as projectRootOf, i as isRetiredShared, j as reservedFolderOf, k as readText, l as placeOf, lt as stringValue, m as DISK_CALL, mt as packageRootOf, n as importsThroughAlias, o as isTestOrSpecName, p as setupFolderOf, q as declaredCommands, r as isModuleName, s as lowestPlaceOf, t as declaresTests, u as readersOf, ut as walk$1, v as findSpecsRoots, vt as specsAnchor, w as listDirs, x as isReferrer, y as isConventionalSubdir, yt as SETTINGS_FILE } from "./shared-specs-modules.js";
+import { BASELINE, GROUND_EXPECTED, GROUND_FIXTURES, GROUND_FOLDERS, GROUND_REQUESTS, GROUND_SEEDS, MEMBER_DEPTH, OXLINT_CONFIG_NAMES, OXLINT_SUPPRESSIONS, PRUNED, SETUP_FOLDER, SPECIAL_FOLDERS, TESTS_FOLDER, blankComments, countsOf, defineCheck, forgetTree, holdsDirectives, isGroundFolder, keepsSection, labelOf, moveKeepingHistory, quotedMask, readAt, readManifest, refusal, rowNamed, sectionOf, suppressionDirectives, treeEntries, treeKind, treeNames, workspaceMembers, workspacePatterns } from "@jterrazz/typescript/rules";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, extname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { spawnSync } from "node:child_process";
 import { createHash } from "node:crypto";
 import { runInNewContext } from "node:vm";
-//#region lint/kit/project/settings-file.ts
-const SETTINGS_FILE = "jterrazz.config.ts";
-//#endregion
-//#region lint/kit/project/specs-anchor.ts
-/** The NEAREST `specs` ancestor, never above the project root: a checkout living under `~/specs/` must not read as one whole specs tree. */
-function specsAnchor(filename) {
-	const relative = [basename(filename)];
-	let directory = dirname(filename);
-	for (;;) {
-		if (basename(directory) === "specs") return {
-			directory,
-			relative
-		};
-		if (isProjectRoot(directory)) return;
-		const parent = dirname(directory);
-		if (parent === directory) return;
-		relative.unshift(basename(directory));
-		directory = parent;
-	}
-}
-new Set(GROUND_FOLDERS);
-/** For the passes that walk a tree and hold only a name: one vocabulary with `roleOf`. */
-function isTestFileName(name) {
-	return name.endsWith(".test.ts") || name.endsWith(".test.tsx") || name.endsWith(".spec.ts");
-}
-/** A `.test.tsx` renders and is not one. */
-function isNodeTestFileName(name) {
-	return name.endsWith(".test.ts") || name.endsWith(".spec.ts");
-}
-function packageRootOf(directory) {
-	return nearestRoot(directory, holdsManifest);
-}
-const projectRoots = /* @__PURE__ */ new Map();
-/** Remembered per folder, and forgotten for one directory once its own tree listing changes: a `package.json` written or removed there is what the memo must see. */
-function projectRootOf(directory) {
-	if (!folderChanged(directory) && projectRoots.has(directory)) return projectRoots.get(directory);
-	const root = nearestRoot(directory, isProjectRoot);
-	projectRoots.set(directory, root);
-	return root;
-}
-//#endregion
-//#region lint/kit/project/tree.ts
-function isPool(dir) {
-	return isGroundFolder(basename(dir)) && basename(dirname(dir)) === "specs";
-}
-function specsRootOfPool(pool) {
-	return dirname(pool);
-}
-function isPruned(dir) {
-	return PRUNED.has(basename(dir)) || isGroundFolder(basename(dir));
-}
-function listFiles(dir, predicate) {
-	const out = [];
-	const visit = (current) => {
-		let entries;
-		try {
-			entries = treeEntries(current);
-		} catch {
-			return;
-		}
-		for (const entry of entries) {
-			const path = join(current, entry.name);
-			if (entry.isDirectory()) {
-				if (!isPruned(path)) visit(path);
-			} else if (predicate(path)) out.push(path);
-		}
-	};
-	visit(dir);
-	return out;
-}
-function listDirs(dir) {
-	const out = [];
-	const visit = (current) => {
-		out.push(current);
-		let entries;
-		try {
-			entries = treeEntries(current);
-		} catch {
-			return;
-		}
-		for (const entry of entries) {
-			const path = join(current, entry.name);
-			if (entry.isDirectory() && !isPruned(path)) visit(path);
-		}
-	};
-	visit(dir);
-	return out;
-}
-function findSpecsRoots(dir) {
-	const roots = [];
-	const visit = (current) => {
-		if (basename(current) === "specs") {
-			roots.push(current);
-			return;
-		}
-		let entries;
-		try {
-			entries = treeEntries(current);
-		} catch {
-			return;
-		}
-		for (const entry of entries) if (entry.isDirectory() && !PRUNED.has(entry.name)) visit(join(current, entry.name));
-	};
-	visit(dir);
-	return roots;
-}
-function findPools(dir) {
-	const pools = [];
-	const visit = (current) => {
-		let entries;
-		try {
-			entries = treeEntries(current);
-		} catch {
-			return;
-		}
-		for (const entry of entries) {
-			if (!entry.isDirectory() || PRUNED.has(entry.name)) continue;
-			const path = join(current, entry.name);
-			if (isPool(path)) pools.push(path);
-			else if (!isGroundFolder(entry.name)) visit(path);
-		}
-	};
-	visit(dir);
-	return pools;
-}
-function readText(path) {
-	try {
-		return readFileSync(path, "utf8");
-	} catch {
-		return "";
-	}
-}
-function readSource(path) {
-	return blankComments(readText(path));
-}
-/** A document counts: a rendered unit's ARIA golden sits in the same `__expected__/` as a spec's. */
-function isReferrer(name) {
-	return isTestFileName(name) || name.endsWith(".spec.yaml");
-}
-function isDir(path) {
-	return treeKind(path) === "directory";
-}
-function columnAt(text, index) {
-	return index - text.lastIndexOf("\n", index - 1);
-}
-function lineAt(text, index) {
-	return text.slice(0, index).split("\n").length;
-}
-const DISK_CALL = /(?<![.\w])(?<kind>file|directory)\(\s*(?<quote>['"`])(?<path>(?:[^'"`\\]|\\.)*)\k<quote>/gu;
-/** A path that is no folder holds no tests and lists no children: it is none. */
-function isConventionalSubdir(path) {
-	if (listFiles(path, isTestFileName).length > 0) return false;
-	let children;
-	try {
-		children = treeEntries(path);
-	} catch {
-		return false;
-	}
-	return !children.some((child) => child.isDirectory() && isGroundFolder(child.name));
-}
-function listReaders(specsRoot) {
-	return listFiles(specsRoot, (path) => path.endsWith(".ts") || path.endsWith(".spec.yaml"));
-}
-function removeIfEmpty(folder) {
-	if (existsSync(folder) && readdirSync(folder).length === 0) rmSync(folder, { recursive: true });
-}
-function isWithin(directory, path) {
-	const rest = relative(directory, path);
-	return rest !== "" && !rest.startsWith("..") && !isAbsolute(rest);
-}
-function lowestCommonFolder(folders) {
-	const [first, ...others] = folders;
-	if (first === void 0) return;
-	let common = first;
-	while (!others.every((folder) => folder === common || isWithin(common, folder))) {
-		const parent = dirname(common);
-		if (parent === common) return;
-		common = parent;
-	}
-	return common;
-}
-function reservedFolderOf(owner, reserved) {
-	return join(owner, reserved);
-}
-function decodeText(path) {
-	let text;
-	try {
-		text = readFileSync(path, "utf8");
-	} catch {
-		return null;
-	}
-	return text.includes("\0") || text.includes("�") ? null : text;
-}
-//#endregion
 //#region lint/kit/project/document-model.ts
 function finding$1(rule, line, { fix, found }) {
 	return {
@@ -469,362 +276,6 @@ function isTestsFolderGround(path) {
 	return segments.some((segment, index) => segment === TESTS_FOLDER && isGroundFolder(segments[index + 1] ?? ""));
 }
 //#endregion
-//#region lint/kit/project/ast.ts
-function fieldOf(value, key) {
-	return typeof value === "object" && value !== null ? Reflect.get(value, key) : void 0;
-}
-function stringValue(node) {
-	if (node === void 0) return;
-	if (node.type === "Literal" && typeof node.value === "string") return node.value;
-	if (node.type !== "TemplateLiteral" || childList(node, "expressions").length > 0) return;
-	const [text] = childList(node, "quasis");
-	return cookedText(text);
-}
-function cookedText(quasi) {
-	const cooked = fieldOf(quasi?.value, "cooked");
-	return typeof cooked === "string" ? cooked : void 0;
-}
-function memberPropertyName(node) {
-	if (node?.type !== "MemberExpression" || node.computed === true) return;
-	const property = child(node, "property");
-	return property?.type === "Identifier" ? stringField(property, "name") ?? "" : void 0;
-}
-function walk$1(root, visit) {
-	visit(root);
-	for (const key of Object.keys(root)) {
-		if (key === "parent") continue;
-		const value = root[key];
-		if (Array.isArray(value)) {
-			for (const item of value) if (isNode(item)) walk$1(item, visit);
-		} else if (isNode(value)) walk$1(value, visit);
-	}
-}
-function nodeStart(node) {
-	return typeof node?.start === "number" ? node.start : -1;
-}
-function isNode(value) {
-	return typeof value === "object" && value !== null && "type" in value && typeof value.type === "string";
-}
-function child(node, key) {
-	const value = node?.[key];
-	return isNode(value) ? value : void 0;
-}
-function childList(node, key) {
-	const value = node?.[key];
-	return Array.isArray(value) ? value.filter((item) => isNode(item)) : [];
-}
-function stringField(node, key) {
-	const value = node?.[key];
-	return typeof value === "string" ? value : void 0;
-}
-function identifierName(node) {
-	if (node?.type !== "Identifier") return;
-	const { name } = node;
-	return typeof name === "string" ? name : void 0;
-}
-//#endregion
-//#region lint/kit/project/module-parser.ts
-let parse;
-function parsedModule(filename, source) {
-	if (parse === void 0) parse = createRequire(import.meta.url)("oxc-parser").parseSync;
-	return parse(filename, source);
-}
-function parseProgram(filename, source) {
-	const { errors, program } = parsedModule(filename, source);
-	return errors.length === 0 ? program : void 0;
-}
-//#endregion
-//#region lint/kit/project/specifiers.ts
-const EXTENSIONS = [
-	".ts",
-	".tsx",
-	".mts",
-	".cts",
-	".js",
-	".jsx",
-	".mjs",
-	".cjs",
-	".json"
-];
-const COMPILED = {
-	".cjs": [".cts"],
-	".js": [".ts", ".tsx"],
-	".jsx": [".tsx"],
-	".mjs": [".mts"]
-};
-function onDisk(path) {
-	if (isFile(path)) return path;
-	const extension = /\.[cm]?jsx?$/u.exec(path)?.[0] ?? "";
-	return [
-		...(COMPILED[extension] ?? []).map((swap) => path.slice(0, -extension.length) + swap),
-		...EXTENSIONS.map((added) => path + added),
-		...EXTENSIONS.map((added) => join(path, `index${added}`))
-	].find((candidate) => isFile(candidate)) ?? path;
-}
-function readJsonc(path) {
-	const text = readFileCached(path);
-	if (text === null) return;
-	return parsedJson(blankComments(text).replaceAll(/,(?=\s*[\]}])/gu, ""), null);
-}
-function recordOf(value) {
-	return isRecord(value) ? value : void 0;
-}
-function targetsOf(value) {
-	if (typeof value === "string") return [value];
-	if (Array.isArray(value)) return value.flatMap((entry) => targetsOf(entry));
-	return Object.values(recordOf(value) ?? {}).flatMap((entry) => targetsOf(entry));
-}
-function substitution(key, specifier) {
-	const star = key.indexOf("*");
-	if (star === -1) return key === specifier ? "" : void 0;
-	const head = key.slice(0, star);
-	const tail = key.slice(star + 1);
-	return specifier.startsWith(head) && specifier.endsWith(tail) && specifier.length >= head.length + tail.length ? specifier.slice(head.length, specifier.length - tail.length) : void 0;
-}
-function mapped(map, specifier, base) {
-	for (const [key, value] of Object.entries(map)) {
-		const star = substitution(key, specifier);
-		if (star !== void 0) return targetsOf(value).map((target) => resolve(base, target.replace("*", star)));
-	}
-	return [];
-}
-function tsconfigOf(directory) {
-	const root = projectRootOf(directory);
-	let current = directory;
-	for (;;) {
-		const candidate = join(current, "tsconfig.json");
-		if (isFile(candidate)) return candidate;
-		const parent = dirname(current);
-		if (current === root || parent === current) return;
-		current = parent;
-	}
-}
-function configCandidates(base) {
-	return [
-		base,
-		`${base}.json`,
-		join(base, "tsconfig.json")
-	];
-}
-function extendedConfig(from, entry) {
-	const directory = dirname(from);
-	if (entry.startsWith(".") || entry.startsWith("/")) return configCandidates(resolve(directory, entry)).find((path) => isFile(path));
-	for (let current = directory;; current = dirname(current)) {
-		const found = configCandidates(join(current, "node_modules", entry)).find((path) => isFile(path));
-		if (found !== void 0 || dirname(current) === current) return found;
-	}
-}
-function resolutionOf(tsconfig, seen) {
-	if (seen.has(tsconfig)) return {};
-	seen.add(tsconfig);
-	const config = recordOf(readJsonc(tsconfig));
-	const bases = targetsOf(config?.extends);
-	const resolution = {};
-	for (const entry of bases) {
-		const base = extendedConfig(tsconfig, entry);
-		if (base !== void 0) Object.assign(resolution, resolutionOf(base, seen));
-	}
-	const options = recordOf(config?.compilerOptions);
-	const directory = dirname(tsconfig);
-	if (typeof options?.baseUrl === "string") resolution.baseUrl = resolve(directory, options.baseUrl);
-	const paths = recordOf(options?.paths);
-	if (paths !== void 0) resolution.paths = {
-		base: directory,
-		paths
-	};
-	return resolution;
-}
-function throughPaths(directory, specifier) {
-	const tsconfig = tsconfigOf(directory);
-	if (tsconfig === void 0) return [];
-	const { baseUrl, paths } = resolutionOf(tsconfig, /* @__PURE__ */ new Set());
-	if (paths === void 0) return [];
-	return mapped(paths.paths, specifier, baseUrl ?? paths.base);
-}
-function throughImports(directory, specifier) {
-	const root = packageRootOf(directory);
-	if (root === void 0) return [];
-	const imports = recordOf(recordOf(readJsonc(join(root, "package.json")))?.imports);
-	return imports === void 0 ? [] : mapped(imports, specifier, root);
-}
-function resolveSpecifier(from, specifier) {
-	const directory = dirname(from);
-	if (specifier === "." || specifier === ".." || /^\.\.?\//u.test(specifier)) return [onDisk(resolve(directory, specifier))];
-	if (specifier.startsWith("/") || specifier.startsWith("node:")) return [];
-	return (specifier.startsWith("#") ? throughImports(directory, specifier) : throughPaths(directory, specifier)).map((target) => onDisk(target));
-}
-//#endregion
-//#region lint/kit/project/import-sources.ts
-function attributeText(node) {
-	return stringValue(node) ?? (node?.type === "Identifier" ? String(node.name) : void 0);
-}
-function isJsonImport(declaration) {
-	return childList(declaration, "attributes").some((attribute) => attributeText(child(attribute, "key")) === "type" && stringValue(child(attribute, "value")) === "json");
-}
-function importSourceVisitor(onSource) {
-	const fromSourceField = (node) => {
-		const source = child(node, "source");
-		const value = stringValue(source);
-		if (value !== void 0) onSource({
-			json: isJsonImport(node),
-			node: source ?? node,
-			source: value
-		});
-	};
-	return {
-		ExportAllDeclaration: fromSourceField,
-		ExportNamedDeclaration: fromSourceField,
-		ImportDeclaration: fromSourceField,
-		ImportExpression: fromSourceField
-	};
-}
-//#endregion
-//#region lint/kit/project/path-references.ts
-const PATH_BUILDERS = /* @__PURE__ */ new Set(["join", "resolve"]);
-function isMetaMember(node, name) {
-	return child(node, "object")?.type === "MetaProperty" && memberPropertyName(node) === name;
-}
-function isOwnDirectory(node) {
-	return identifierName(node) === "__dirname" || isMetaMember(node, "dirname");
-}
-function calleeName(node) {
-	const callee = child(node, "callee");
-	return identifierName(callee) ?? memberPropertyName(callee);
-}
-function argumentsOf(node) {
-	return childList(node, "arguments");
-}
-function literalArguments(node) {
-	return argumentsOf(node).map((target) => {
-		const literal = stringValue(target);
-		return literal === void 0 ? void 0 : {
-			literal,
-			target
-		};
-	});
-}
-function literalTail(pieces) {
-	const tail = [];
-	for (const piece of pieces) {
-		const value = stringValue(piece);
-		if (value === void 0) break;
-		tail.push(value);
-	}
-	return tail;
-}
-function urlLiteral(node) {
-	const [first] = literalArguments(node);
-	const [, base] = argumentsOf(node);
-	return identifierName(child(node, "callee")) === "URL" && isMetaMember(base, "url") ? first : void 0;
-}
-/** A piece that is not a literal leaves the call out. */
-function literalPathVisitor(onPath) {
-	return {
-		CallExpression(node) {
-			if (!PATH_BUILDERS.has(calleeName(node))) return;
-			const [anchor, ...rest] = argumentsOf(node);
-			const pieces = literalTail(rest);
-			const [head] = rest;
-			if (isOwnDirectory(anchor) && head !== void 0 && pieces.length === rest.length) onPath({
-				node: head,
-				pieces
-			});
-		},
-		NewExpression(node) {
-			const url = urlLiteral(node);
-			if (url !== void 0) onPath({
-				node: url.target,
-				pieces: [url.literal]
-			});
-		}
-	};
-}
-function visitProgram(program, visitor) {
-	walk$1(program, (node) => {
-		visitor[node.type]?.(node);
-	});
-}
-//#endregion
-//#region lint/kit/project/specs-modules.ts
-const MODULE = /\.(?:[cm]?[jt]sx?)$/u;
-const TEST_OR_SPEC = /\.(?:test|test-d|spec)\.[cm]?[jt]sx?$/u;
-const RUNNER = /\.specification\.[cm]?[jt]sx?$/u;
-function isModuleName(name) {
-	return MODULE.test(name) && !name.endsWith(".d.ts");
-}
-function isTestOrSpecName(name) {
-	return TEST_OR_SPEC.test(name);
-}
-function isRunnerName(name) {
-	return RUNNER.test(name);
-}
-function modulesUnder(specsRoot) {
-	return listFiles(specsRoot, (path) => isModuleName(basename(path)));
-}
-function setupFolderOf(specsRoot, file) {
-	for (let folder = dirname(file); isWithin(specsRoot, folder); folder = dirname(folder)) if (basename(folder) === SETUP_FOLDER) return folder;
-}
-function placeOf(specsRoot, reader) {
-	const setup = setupFolderOf(specsRoot, reader);
-	return setup === void 0 ? dirname(reader) : dirname(setup);
-}
-function importsOf$2(file) {
-	const program = parseProgram(file, readText(file));
-	if (!isNode(program)) return [];
-	const imported = [];
-	visitProgram(program, importSourceVisitor(({ source }) => {
-		imported.push({
-			relative: isRelativePath(source),
-			targets: resolveSpecifier(file, source)
-		});
-	}));
-	return imported;
-}
-function importedModulesOf(file) {
-	return importsOf$2(file).flatMap(({ targets }) => targets);
-}
-function importsThroughAlias(file, module) {
-	return importsOf$2(file).some(({ relative, targets }) => !relative && targets.includes(module));
-}
-function readersOf(modules) {
-	const known = new Set(modules);
-	const readers = /* @__PURE__ */ new Map();
-	for (const file of modules) for (const target of new Set(importedModulesOf(file))) if (target !== file && known.has(target)) readers.set(target, [...readers.get(target) ?? [], file]);
-	return readers;
-}
-function lowestPlaceOf(specsRoot, readers) {
-	return lowestCommonFolder(readers.map((reader) => placeOf(specsRoot, reader)));
-}
-function declaresTests(name) {
-	return isTestOrSpecName(name) || name.endsWith(".spec.yaml");
-}
-function holdsASpec(folder) {
-	let entries;
-	try {
-		entries = treeEntries(folder);
-	} catch {
-		return false;
-	}
-	return entries.some((entry) => entry.isDirectory() ? !PRUNED.has(entry.name) && !isSpecialFolder(entry.name) && holdsASpec(join(folder, entry.name)) : declaresTests(entry.name));
-}
-/** The special folder a bare earlier spelling names (a `setup/` at the specs root or holding no spec), or `undefined`; a `_` name is refused before it is asked. */
-function renamedSpecialOf(specsRoot, folder) {
-	const renamed = RENAMED_FOLDERS[basename(folder)];
-	if (renamed === void 0) return;
-	return dirname(folder) === specsRoot || !holdsASpec(folder) ? renamed : void 0;
-}
-/** A bare `shared/` at the specs root or holding no spec: what specifications share sits at the specs root now; a `_` name is refused before it is asked. */
-function isRetiredShared(specsRoot, folder) {
-	return RETIRED_SHARED_FOLDERS.includes(basename(folder)) && (dirname(folder) === specsRoot || !holdsASpec(folder));
-}
-function isRefusedReserved(specsRoot, folder) {
-	const name = basename(folder);
-	return name.startsWith("_") && !isSpecialFolder(name) || renamedSpecialOf(specsRoot, folder) !== void 0 || isRetiredShared(specsRoot, folder);
-}
-function refusedReservedAbove(specsRoot, file) {
-	for (let folder = dirname(file); isWithin(specsRoot, folder); folder = dirname(folder)) if (isRefusedReserved(specsRoot, folder)) return folder;
-}
-//#endregion
 //#region lint/consumer/checks/adapter-named-for-its-port.ts
 const ADAPTER_SUFFIX = ".adapter.ts";
 const WORD_START = /(?<=[a-z0-9])(?=[A-Z])|(?<=[A-Z])(?=[A-Z][a-z])/gu;
@@ -843,7 +294,8 @@ function portsImported(specsRoot, file, program) {
 	};
 	for (const statement of childList(program, "body")) {
 		if (statement.type !== "ImportDeclaration") continue;
-		const targets = resolveSpecifier(file, String(stringValue(child(statement, "source"))));
+		const source = String(stringValue(child(statement, "source")));
+		const targets = resolveSpecifier(file, source);
 		if (targets.length === 0 || targets.some((target) => isWithin(specsRoot, target))) continue;
 		for (const specifier of childList(statement, "specifiers")) {
 			const local = String(identifierName(child(specifier, "local")));
@@ -960,7 +412,7 @@ function argumentsAt(text, open) {
 function runnerBindings(text) {
 	return [...text.matchAll(RUNNER_DECLARATION)].flatMap((match) => {
 		const { names = "" } = match.groups ?? {};
-		return argumentsOf$1(names).flatMap((part) => {
+		return argumentsOf(names).flatMap((part) => {
 			const [key = "", local = key] = part.split(":").map((token) => token.trim());
 			return NON_RUNNER_BINDINGS.has(key) ? [] : [{
 				key,
@@ -976,7 +428,7 @@ function sqlDatabaseCount(text) {
 	const close = closingOf(text, open);
 	if (close === text.length) return null;
 	let count = 0;
-	for (const pair of argumentsOf$1(text.slice(open + 1, close))) {
+	for (const pair of argumentsOf(text.slice(open + 1, close))) {
 		const service = SERVICE_CALL.exec(pair)?.groups?.callee;
 		if (service === void 0) return null;
 		count += SQL_SERVICES.has(service) ? 1 : 0;
@@ -1003,7 +455,7 @@ function namedImports(text) {
 	const bindings = [];
 	for (const match of text.matchAll(NAMED_IMPORT$1)) {
 		const { names = "", source = "" } = match.groups ?? {};
-		for (const part of argumentsOf$1(names)) {
+		for (const part of argumentsOf(names)) {
 			const [name = "", local = name] = part.split(RENAMED);
 			bindings.push({
 				local,
@@ -2006,7 +1458,8 @@ function misplacedGround(rootDir) {
 		const readOutside = new Set([...pathsModuleTestsName(dirname(specsRoot)), ...pathsMemberConfigsName(dirname(specsRoot))].map((path) => entryOf(specsRoot, path)).filter((found) => found !== void 0).map(({ entry, ground }) => join(ground, entry)));
 		for (const [key, { entry, ground, leaves, referrers }] of usageUnder(specsRoot)) {
 			const lowest = lowestCommonFolder([...leaves]) ?? specsRoot;
-			if (!isWithin(dirname(ground), lowest) || readOutside.has(key) || treeKind(key) === void 0) continue;
+			const owner = dirname(ground);
+			if (!isWithin(owner, lowest) || readOutside.has(key) || treeKind(key) === void 0) continue;
 			misplaced.push({
 				entry,
 				ground,
@@ -2914,115 +2367,6 @@ function noVolatileLiteralsInGround(file, text) {
 	});
 }
 //#endregion
-//#region lint/kit/project/command-words.ts
-const COMMAND_WORD = /^[a-z][a-z0-9-]*$/u;
-/** Without the runner's declared list, the first word alone: a positional argument is never read as a subcommand. */
-function commandWords(line, commands) {
-	const words = line.trim().split(/\s+/u);
-	if (commands === void 0) {
-		const [first = ""] = words;
-		return COMMAND_WORD.test(first) ? [first] : [];
-	}
-	const named = [];
-	for (const word of words) {
-		if (!commands.includes(word)) break;
-		named.push(word);
-	}
-	return named;
-}
-const CLI_CONSTRUCTOR = /\bspecification\s*\.\s*cli\s*\(/u;
-function wordsOf(text, open) {
-	return argumentsOf$1(text.slice(open + 1, closingOf(text, open))).flatMap((entry) => {
-		const word = literalOf(entry);
-		return word === void 0 ? [] : [word];
-	});
-}
-function constantWords(text, name) {
-	const escaped = name.replaceAll("$", String.raw`\$`);
-	const pattern = String.raw`\bconst\s+${escaped}\s*(?::[^=]+)?=\s*\[`;
-	const binding = new RegExp(pattern, "u").exec(text);
-	return binding === null ? void 0 : wordsOf(text, binding.index + binding[0].length - 1);
-}
-/** Written as an array or bound to a `const` of the same file (`commands: COMMANDS`, `{ commands }`). */
-function declaredCommands(door) {
-	const text = blankComments(door);
-	const call = CLI_CONSTRUCTOR.exec(text);
-	if (call === null) return;
-	const open = call.index + call[0].length - 1;
-	const [, options = ""] = argumentsOf$1(text.slice(open + 1, closingOf(text, open)));
-	const list = /[{,\s]commands\s*:\s*\[/u.exec(options);
-	if (list !== null) return wordsOf(options, list.index + list[0].length - 1);
-	const named = /[{,\s]commands\s*:\s*(?<name>[A-Za-z_$][\w$]*)/u.exec(options)?.groups?.name ?? (/[{,\s]commands\s*(?=[,}])/u.test(options) ? "commands" : void 0);
-	return named === void 0 ? void 0 : constantWords(text, named);
-}
-//#endregion
-//#region lint/kit/project/spec-chains.ts
-const SUBJECT_SPECIFICATIONS = [
-	"api",
-	"cli",
-	"job",
-	"mobile",
-	"website"
-];
-function chainAt(text, handle, start) {
-	const calls = [];
-	let index = start + handle.length;
-	for (;;) {
-		const member = /^\s*\.\s*(?<name>[A-Za-z_$][\w$]*)\s*\(/u.exec(text.slice(index));
-		if (member === null) return {
-			calls,
-			end: index,
-			handle,
-			index: start
-		};
-		const { name = "" } = member.groups ?? {};
-		const open = index + member[0].length - 1;
-		const close = closingOf(text, open);
-		calls.push({
-			args: text.slice(open + 1, close),
-			name
-		});
-		index = close + 1;
-	}
-}
-const SPECIFICATION_DOOR = /import\s*\{(?<names>[^}]*)\}\s*from\s*['"](?<from>[^'"]*\.specification(?:\.[jt]s)?)['"]/gu;
-const VIEW = /const\s+(?<view>[A-Za-z_$][\w$]*)\s*=\s*(?<from>[A-Za-z_$][\w$]*)\s*\.\s*with\s*\(/gu;
-function importedDoors(text, wanted) {
-	const doors = /* @__PURE__ */ new Map();
-	for (const found of text.matchAll(SPECIFICATION_DOOR)) {
-		const { from = "", names = "" } = found.groups ?? {};
-		for (const name of names.split(",")) {
-			const [imported = "", local = imported] = name.trim().split(/\s+as\s+/u);
-			if (wanted(imported)) doors.set(local, from);
-		}
-	}
-	return doors;
-}
-function doorsWanted(text, wanted) {
-	const doors = importedDoors(text, wanted);
-	const views = [...text.matchAll(VIEW)];
-	for (let size = -1; size !== doors.size;) {
-		({size} = doors);
-		for (const found of views) {
-			const { from = "", view = "" } = found.groups ?? {};
-			const door = doors.get(from);
-			if (door !== void 0) doors.set(view, door);
-		}
-	}
-	return doors;
-}
-function handlesOf(text) {
-	return [...doorsWanted(text, (imported) => SUBJECT_SPECIFICATIONS.includes(imported)).keys()];
-}
-function chainsOf(text, handles) {
-	if (handles.length === 0) return [];
-	const pattern = new RegExp(String.raw`(?<![.\w$])(?:${handles.join("|")})(?=\s*\.)`, "gu");
-	return [...text.matchAll(pattern)].map((found) => chainAt(text, found[0], found.index));
-}
-function doorsOf$1(text, specification) {
-	return Object.fromEntries(doorsWanted(text, (imported) => imported === specification));
-}
-//#endregion
 //#region lint/kit/project/specimen.ts
 const INTO_FIXTURES = new RegExp(String.raw`(?:^|[/'"\x60\s])${GROUND_FIXTURES}/(?<name>[\w.-]+)(?<inside>/[\w.-])?`, "u");
 const SPECIFICATION_FROM = /\bfrom\s*['"](?<from>[^'"]*\.specification(?:\.[jt]s)?)['"]/gu;
@@ -3112,160 +2456,6 @@ function specimenOf(file, text, specification) {
 	}
 }
 //#endregion
-//#region lint/kit/project/subject.ts
-const NO_READING = Object.freeze({
-	collections: [],
-	methodless: []
-});
-const LITERAL_SEGMENT = /^[a-z][a-z._-]*$/u;
-function segmentsOf(path) {
-	return (path.split(/[?#]/u)[0] ?? "").split("/").filter((segment) => segment !== "");
-}
-function isLiteral(segment) {
-	return LITERAL_SEGMENT.test(segment) && !segment.includes("\0");
-}
-/** Every segment that is a value (a hole, a number, an id, a symbol) is written `:id`. */
-function pathTemplate(path) {
-	return `/${segmentsOf(path).map((segment) => isLiteral(segment) ? segment : ":id").join("/")}`;
-}
-function isCollection(word, collections) {
-	return collections.includes(word) || word.endsWith("s") && !/(?:ss|us|is)$/u.test(word);
-}
-function actionOf(method, resource, item, collections) {
-	if (method === "GET") return !item && isCollection(resource, collections) ? "list" : "get";
-	if (method === "POST") return "create";
-	if (method === "PUT" || method === "PATCH") return "update";
-	return method.toLowerCase();
-}
-function followsACollection(segments, index, collections) {
-	return isCollection(segments[index - 1] ?? "", collections);
-}
-/** `btc` in `/indicators/btc/chart`. The last segment is read as the route's: after a collection it names a sub-route far more often than an item. */
-function ambiguousSegment(subject, reading = NO_READING) {
-	if (subject.specification !== "api" || subject.template === true) return;
-	const segments = segmentsOf(subject.path);
-	const { collections } = reading;
-	return segments.find((segment, index) => index < segments.length - 1 && isLiteral(segment) && followsACollection(segments, index, collections));
-}
-function routeFolder(method, path, collections) {
-	const segments = segmentsOf(pathTemplate(path));
-	const literals = segments.filter((segment) => segment !== ":id");
-	if (literals.length === 0) return;
-	if (method === "ALL" || literals.length > 1) return literals.join("/");
-	const [resource = ""] = literals;
-	return `${resource}/${actionOf(method, resource, segments.at(-1) === ":id", collections)}`;
-}
-function underBase(path, basePath) {
-	if (basePath === void 0) return path;
-	if (path === basePath) return "/";
-	return path.startsWith(`${basePath}/`) ? path.slice(basePath.length) : path;
-}
-/** Nothing for a subject with no standard name: the root route, a cli run with no command word, a page, a journey. */
-function subjectFolder(subject, reading = NO_READING) {
-	if (subject.specification === "api") {
-		const mounted = {
-			...subject,
-			path: underBase(subject.path, reading.basePath)
-		};
-		return ambiguousSegment(mounted, reading) === void 0 ? routeFolder(subject.method, mounted.path, reading.collections) : void 0;
-	}
-	if (subject.specification === "cli") return subject.command.length === 0 ? void 0 : subject.command.join("/");
-	return subject.specification === "job" ? subject.job : void 0;
-}
-/** `GET /events/:id`, `trigger digest`, ... */
-function subjectName(subject) {
-	if (subject.specification === "api") return `${subject.method} ${pathTemplate(subject.path)}`;
-	if (subject.specification === "cli") return subject.command.length === 0 ? "exec (no command)" : `exec ${subject.command.join(" ")}`;
-	if (subject.specification === "job") return `trigger ${subject.job}`;
-	return subject.specification === "mobile" ? `open ${subject.journey}` : `visit ${subject.page}`;
-}
-const HTTP_VERBS = {
-	delete: "DELETE",
-	get: "GET",
-	patch: "PATCH",
-	post: "POST",
-	put: "PUT"
-};
-const REQUEST_LINE = /^\s*(?<method>DELETE|GET|HEAD|OPTIONS|PATCH|POST|PUT)\s+(?<path>\S+)/u;
-const REQUEST_FILE = /^file\(\s*(?<quote>['"])(?<path>[^'"]*)\k<quote>\s*\)$/u;
-function requestLineOf(text) {
-	const { method = "", path = "/" } = REQUEST_LINE.exec(text)?.groups ?? {};
-	const verb = HTTP_VERBS[method.toLowerCase()];
-	return verb === void 0 ? [] : [{
-		specification: "api",
-		method: verb,
-		path,
-		template: true
-	}];
-}
-const pageOf = (first) => {
-	const literal = literalOf(first);
-	return literal?.startsWith("/") === true ? [{
-		specification: "website",
-		page: pathTemplate(literal)
-	}] : [];
-};
-const TERMINALS = {
-	exec: (first, _readRequest, commands) => {
-		const line = first?.startsWith("[") === true ? literalOf(argumentsOf$1(first.slice(1, -1)).at(-1)) : literalOf(first);
-		return line === void 0 ? [] : [{
-			command: commandWords(line, commands),
-			specification: "cli"
-		}];
-	},
-	fetch: pageOf,
-	open: (first) => [{
-		specification: "mobile",
-		journey: literalOf(first) ?? "(launch)"
-	}],
-	request: (first, readRequest) => {
-		const path = REQUEST_FILE.exec(first ?? "")?.groups?.path;
-		return path === void 0 ? [] : requestLineOf(readRequest(path) ?? "");
-	},
-	trigger: (first) => {
-		const job = literalOf(first);
-		return job === void 0 ? [] : [{
-			specification: "job",
-			job
-		}];
-	},
-	visit: pageOf
-};
-function routeOf(method, args) {
-	const path = literalOf(args[0]);
-	if (path?.startsWith("/") !== true) return [];
-	const options = args[method === "POST" || method === "PUT" ? 2 : 1] ?? "";
-	return [{
-		specification: "api",
-		method,
-		path,
-		template: /\/:[A-Za-z_$]/u.test(path) || /(?<![\w$])params(?![\w$])/u.test(options)
-	}];
-}
-function declaredMethod(subject, methodless) {
-	if (subject.specification !== "api") return subject;
-	const template = pathTemplate(subject.path);
-	return methodless.some((path) => pathTemplate(path) === template) ? {
-		...subject,
-		method: "ALL"
-	} : subject;
-}
-function subjectsOfChain(chain, readRequest = () => "", reading = NO_READING) {
-	const terminal = chain.calls.at(-1);
-	if (terminal === void 0) return [];
-	const args = argumentsOf$1(terminal.args);
-	const [first] = args;
-	const method = HTTP_VERBS[terminal.name];
-	return (method === void 0 ? TERMINALS[terminal.name]?.(first, readRequest, reading.commands?.[chain.handle]) ?? [] : routeOf(method, args)).map((subject) => declaredMethod(subject, reading.methodless));
-}
-function subjectsOf(source, readRequest, reading = NO_READING) {
-	const text = blankComments(source);
-	return chainsOf(text, handlesOf(text)).flatMap((chain) => subjectsOfChain(chain, readRequest, reading).map((subject) => ({
-		index: chain.index,
-		subject
-	})));
-}
-//#endregion
 //#region lint/kit/project/spec-subjects.ts
 const TEST_CALL = String.raw`(?<![.\w$])(?:test|it)(?:\.\w+(?:\([^()]*\))?)*\s*\(`;
 function holdsTestCall(text) {
@@ -4085,7 +3275,8 @@ function subjectOf(specsRoot, file) {
 }
 function setupTargetOf(specsRoot, file, readers) {
 	const subject = subjectOf(specsRoot, file);
-	const home = reservedFolderOf(lowestPlaceOf(specsRoot, readers) ?? subject, SETUP_FOLDER);
+	const owner = lowestPlaceOf(specsRoot, readers) ?? subject;
+	const home = reservedFolderOf(owner, SETUP_FOLDER);
 	return relative(specsRoot, join(home, relative(subject, file)));
 }
 function codeOutsideSetup(rootDir, specsRoot) {