@isentinel/jest-roblox 0.2.4 → 0.2.6

package/bin/jest-roblox.js

@@ -10,8 +10,8 @@ register("../loaders/luau-raw.mjs", import.meta.url);
 
 if (existsSync(sourceEntry)) {
 	const { main } = await import("../src/cli.ts");
-	main();
+	await main();
 } else {
 	const { main } = await import("../dist/cli.mjs");
-	main();
+	await main();
 }

package/dist/cli.d.mts

@@ -1,4 +1,4 @@
-import { _ as ResolvedProjectConfig, n as ExecuteResult, v as CliOptions } from "./executor-B2IDh6bH.mjs";
+import { _ as ResolvedProjectConfig, n as ExecuteResult, v as CliOptions } from "./executor-COuwZJJX.mjs";
 
 //#region src/cli.d.ts
 declare function parseArgs(args: Array<string>): CliOptions;

package/dist/cli.mjs

@@ -1,4 +1,4 @@
-import { A as collectPaths, D as formatTypecheckSummary, H as ROOT_ONLY_KEYS, I as createStudioBackend, J as LuauScriptError, K as isValidBackend, M as resolveNestedProjects, N as loadConfig$1, O as formatBanner, R as createOpenCloudBackend, S as formatAgentMultiProject, T as formatResult, U as VALID_BACKENDS, _ as resolveTsconfigDirectories, a as formatAnnotations, c as visitBlock, d as buildProjectJob, f as execute, g as processProjectResult, h as loadCoverageManifest, i as runTypecheck, j as findInTree, k as combineSourceMappers, m as formatExecuteOutput, n as parseGameOutput, o as formatJobSummary, p as executeBackend, q as hashBuffer, r as writeGameOutput, s as resolveGitHubActionsOptions, t as formatGameOutputNotice, v as rojoProjectSchema, w as formatMultiProjectResult, x as writeJsonFile, y as findFormatterOptions } from "./game-output-BtWj32M8.mjs";
+import { A as collectMounts, B as createOpenCloudBackend, D as formatTypecheckSummary, F as loadConfig$1, G as VALID_BACKENDS, J as isValidBackend, M as findInTree, N as pruneAncestors, O as formatBanner, P as resolveNestedProjects, R as createStudioBackend, S as formatAgentMultiProject, T as formatResult, W as ROOT_ONLY_KEYS, X as LuauScriptError, Y as hashBuffer, _ as resolveTsconfigDirectories, a as formatAnnotations, c as visitBlock, d as buildProjectJob, f as execute, g as processProjectResult, h as loadCoverageManifest, i as runTypecheck, j as collectPaths, k as combineSourceMappers, m as formatExecuteOutput, n as parseGameOutput, o as formatJobSummary, p as executeBackend, r as writeGameOutput, s as resolveGitHubActionsOptions, t as formatGameOutputNotice, v as rojoProjectSchema, w as formatMultiProjectResult, x as writeJsonFile, y as findFormatterOptions } from "./game-output-CCPIQMWm.mjs";
 import { createRequire } from "node:module";
 import { type } from "arktype";
 import assert from "node:assert";
@@ -23,7 +23,7 @@ import istanbulCoverage from "istanbul-lib-coverage";
 import istanbulReport from "istanbul-lib-report";
 import istanbulReports from "istanbul-reports";
 //#region package.json
-var version = "0.2.4";
+var version = "0.2.6";
 //#endregion
 //#region src/backends/auto.ts
 var StudioWithFallback = class {
@@ -160,7 +160,7 @@ function evalTable(entries) {
 }
 //#endregion
 //#region src/luau/parse-ast.luau
-var parse_ast_default = "local fs = require(\"@std/fs\")\nlocal json = require(\"@std/json\")\nlocal process = require(\"@std/process\")\nlocal syntax = require(\"@std/syntax\")\n\nlocal rawArgs = process.args\nlocal userArgs: { string } = {}\nlocal pastSeparator = false\n\nfor _, arg in rawArgs do\n	if pastSeparator then\n		table.insert(userArgs, arg)\n	elseif arg == \"--\" then\n		pastSeparator = true\n	end\nend\n\nlocal luauRoot = userArgs[1]\nif not luauRoot then\n	error(\"Usage: lute run parse-ast.luau -- <file.luau | luau-root> [output-dir]\")\nend\n\nluauRoot = string.gsub(luauRoot, \"\\\\\", \"/\")\n\n-- Fields to keep per AST tag (beyond tag/kind/location which are always kept).\n-- Tags shared by stat/expr variants are merged — nil fields are harmless.\nlocal KEEP: { [string]: { string } } = {\n	assign = { \"values\", \"variables\" },\n	binary = { \"lhsOperand\", \"rhsOperand\" },\n	block = { \"statements\" },\n	boolean = { \"value\" },\n	call = { \"arguments\", \"func\" },\n	cast = { \"operand\" },\n	compoundassign = { \"value\", \"variable\" },\n	conditional = { \"condition\", \"thenBlock\", \"elseifs\", \"elseBlock\", \"thenExpr\", \"elseExpr\" },\n	[\"do\"] = { \"body\" },\n	expression = { \"expression\" },\n	[\"for\"] = { \"body\", \"from\", \"to\", \"step\" },\n	forin = { \"body\", \"values\" },\n	[\"function\"] = { \"body\", \"name\", \"func\" },\n	global = { \"name\" },\n	group = { \"expression\" },\n	index = { \"expression\", \"index\" },\n	indexname = { \"expression\", \"accessor\", \"index\" },\n	instantiate = { \"expr\" },\n	interpolatedstring = { \"expressions\" },\n	[\"local\"] = { \"values\", \"variables\" },\n	localfunction = { \"name\", \"func\" },\n	number = { \"value\" },\n	[\"repeat\"] = { \"body\", \"condition\" },\n	[\"return\"] = { \"expressions\" },\n	string = { \"text\" },\n	table = { \"entries\" },\n	unary = { \"operand\" },\n	[\"while\"] = { \"body\", \"condition\" },\n}\n\nlocal function strip(value: any): any\n	if type(value) ~= \"table\" then\n		return value\n	end\n\n	-- LuauSpan — has beginLine, no tag\n	if value.beginLine ~= nil then\n		return value\n	end\n\n	-- Token — has text but no tag, reduce to {text}\n	if value.text ~= nil and value.tag == nil then\n		return { text = value.text }\n	end\n\n	-- AST node — has tag, keep only allowlisted fields\n	if value.tag ~= nil then\n		local result = { tag = value.tag, kind = value.kind, location = value.location }\n		local fields = KEEP[value.tag :: string]\n		if fields then\n			for _, field in fields do\n				if value[field] ~= nil then\n					result[field] = strip(value[field])\n				end\n			end\n		end\n\n		return result\n	end\n\n	-- Other tables (arrays, Pairs, ElseIf structs) — recurse all fields\n	local result: any = {}\n	for k, v in value do\n		result[k] = strip(v)\n	end\n\n	return result\nend\n\n-- Single-file mode: parse one file, print stripped AST to stdout\nif string.sub(luauRoot, -5) == \".luau\" or string.sub(luauRoot, -4) == \".lua\" then\n	local source = fs.readfiletostring(luauRoot)\n	local parseResult = syntax.parse(source)\n	print(json.serialize(strip(parseResult.root)))\n	return\nend\n\nlocal outputDir = userArgs[2]\nif not outputDir then\n	error(\"Usage: lute run parse-ast.luau -- <luau-root> <output-dir>\")\nend\n\noutputDir = string.gsub(outputDir, \"\\\\\", \"/\")\n\n-- Discover .luau files recursively, skipping node_modules, dot dirs, spec/test files\nlocal function discoverFiles(directory: string, relativeTo: string, results: { string })\n	local entries = fs.listdirectory(directory)\n	for _, entry in entries do\n		local fullPath = directory .. \"/\" .. entry.name\n		if entry.type == \"dir\" then\n			if entry.name == \"node_modules\" or entry.name == \".jest-roblox-coverage\" then\n				continue\n			end\n\n			if string.sub(entry.name, 1, 1) == \".\" then\n				continue\n			end\n\n			discoverFiles(fullPath, relativeTo, results)\n		elseif\n			entry.type == \"file\"\n			and (string.sub(entry.name, -5) == \".luau\" or string.sub(entry.name, -4) == \".lua\")\n		then\n			if\n				string.sub(entry.name, -10) == \".spec.luau\"\n				or string.sub(entry.name, -10) == \".test.luau\"\n				or string.sub(entry.name, -9) == \".spec.lua\"\n				or string.sub(entry.name, -9) == \".test.lua\"\n				or string.sub(entry.name, -10) == \".snap.luau\"\n				or string.sub(entry.name, -9) == \".snap.lua\"\n			then\n				continue\n			end\n\n			-- Compute relative path\n			local relative = string.sub(fullPath, #relativeTo + 2)\n			table.insert(results, relative)\n		end\n	end\nend\n\nlocal function dirname(filepath: string): string\n	local pos = string.find(filepath, \"/[^/]*$\")\n	if pos then\n		return string.sub(filepath, 1, pos - 1)\n	end\n\n	return \"\"\nend\n\n-- Optional 3rd arg: path to skip list JSON file.\n-- Skipped files are still included in the file list but not parsed.\nlocal skipListPath = userArgs[3]\nlocal skipSet: { [string]: boolean } = {}\nif skipListPath then\n	local skipJson = fs.readfiletostring(skipListPath)\n	local skipList = json.deserialize(skipJson) :: { string }\n	for _, entry in skipList do\n		skipSet[entry] = true\n	end\nend\n\nlocal files: { string } = {}\ndiscoverFiles(luauRoot, luauRoot, files)\n\n-- Parse, strip, and write per-file AST JSON\nfor _, relativePath in files do\n	if skipSet[relativePath] then\n		continue\n	end\n\n	local fullPath = luauRoot .. \"/\" .. relativePath\n	local source = fs.readfiletostring(fullPath)\n	local parseResult = syntax.parse(source)\n	local stripped = strip(parseResult.root)\n\n	local outPath = outputDir .. \"/\" .. relativePath .. \".json\"\n	local dir = dirname(outPath)\n	if dir ~= \"\" then\n		fs.createdirectory(dir, { makeparents = true })\n	end\n\n	fs.writestringtofile(outPath, json.serialize(stripped))\nend\n\n-- Print file list to stdout (tiny — just paths)\nprint(json.serialize(files :: json.array))\n";
+var parse_ast_default = "local fs = require(\"@std/fs\")\nlocal json = require(\"@std/json\")\nlocal process = require(\"@std/process\")\nlocal syntax = require(\"@std/syntax\")\n\nlocal rawArgs = process.args\nlocal userArgs: { string } = {}\nlocal pastSeparator = false\n\nfor _, arg in rawArgs do\n	if pastSeparator then\n		table.insert(userArgs, arg)\n	elseif arg == \"--\" then\n		pastSeparator = true\n	end\nend\n\nlocal luauRoot = userArgs[1]\nif not luauRoot then\n	error(\"Usage: lute run parse-ast.luau -- <file.luau | luau-root> [output-dir]\")\nend\n\nluauRoot = string.gsub(luauRoot, \"\\\\\", \"/\")\n\n-- Fields to keep per AST tag (beyond tag/kind/location which are always kept).\n-- Tags shared by stat/expr variants are merged — nil fields are harmless.\nlocal KEEP: { [string]: { string } } = {\n	assign = { \"values\", \"variables\" },\n	binary = { \"lhsOperand\", \"rhsOperand\" },\n	block = { \"statements\" },\n	boolean = { \"value\" },\n	call = { \"arguments\", \"func\" },\n	cast = { \"operand\" },\n	compoundassign = { \"value\", \"variable\" },\n	conditional = { \"condition\", \"thenBlock\", \"elseifs\", \"elseBlock\", \"thenExpr\", \"elseExpr\" },\n	[\"do\"] = { \"body\" },\n	expression = { \"expression\" },\n	[\"for\"] = { \"body\", \"from\", \"to\", \"step\" },\n	forin = { \"body\", \"values\" },\n	[\"function\"] = { \"body\", \"name\", \"func\" },\n	global = { \"name\" },\n	group = { \"expression\" },\n	index = { \"expression\", \"index\" },\n	indexname = { \"expression\", \"accessor\", \"index\" },\n	instantiate = { \"expr\" },\n	interpolatedstring = { \"expressions\" },\n	[\"local\"] = { \"values\", \"variables\" },\n	localfunction = { \"name\", \"func\" },\n	number = { \"value\" },\n	[\"repeat\"] = { \"body\", \"condition\" },\n	[\"return\"] = { \"expressions\" },\n	string = { \"text\" },\n	table = { \"entries\" },\n	unary = { \"operand\" },\n	[\"while\"] = { \"body\", \"condition\" },\n}\n\nlocal function strip(value: any): any\n	if type(value) ~= \"table\" then\n		return value\n	end\n\n	-- LuauSpan — has beginLine, no tag\n	if value.beginLine ~= nil then\n		return value\n	end\n\n	-- Token — has text but no tag, reduce to {text}\n	if value.text ~= nil and value.tag == nil then\n		return { text = value.text }\n	end\n\n	-- AST node — has tag, keep only allowlisted fields\n	if value.tag ~= nil then\n		local result = { tag = value.tag, kind = value.kind, location = value.location }\n		local fields = KEEP[value.tag :: string]\n		if fields then\n			for _, field in fields do\n				if value[field] ~= nil then\n					result[field] = strip(value[field])\n				end\n			end\n		end\n\n		return result\n	end\n\n	-- Other tables (arrays, Pairs, ElseIf structs) — recurse all fields\n	local result: any = {}\n	for k, v in value do\n		result[k] = strip(v)\n	end\n\n	return result\nend\n\n-- Single-file mode: parse one file, print stripped AST to stdout\nif string.sub(luauRoot, -5) == \".luau\" or string.sub(luauRoot, -4) == \".lua\" then\n	local source = fs.readFileToString(luauRoot)\n	local parseResult = syntax.parse(source)\n	print(json.serialize(strip(parseResult.root)))\n	return\nend\n\nlocal outputDir = userArgs[2]\nif not outputDir then\n	error(\"Usage: lute run parse-ast.luau -- <luau-root> <output-dir>\")\nend\n\noutputDir = string.gsub(outputDir, \"\\\\\", \"/\")\n\n-- Discover .luau files recursively, skipping node_modules, dot dirs, spec/test files\nlocal function discoverFiles(directory: string, relativeTo: string, results: { string })\n	local entries = fs.listDirectory(directory)\n	for _, entry in entries do\n		local fullPath = directory .. \"/\" .. entry.name\n		if entry.type == \"dir\" then\n			if entry.name == \"node_modules\" or entry.name == \".jest-roblox-coverage\" then\n				continue\n			end\n\n			if string.sub(entry.name, 1, 1) == \".\" then\n				continue\n			end\n\n			discoverFiles(fullPath, relativeTo, results)\n		elseif\n			entry.type == \"file\"\n			and (string.sub(entry.name, -5) == \".luau\" or string.sub(entry.name, -4) == \".lua\")\n		then\n			if\n				string.sub(entry.name, -10) == \".spec.luau\"\n				or string.sub(entry.name, -10) == \".test.luau\"\n				or string.sub(entry.name, -9) == \".spec.lua\"\n				or string.sub(entry.name, -9) == \".test.lua\"\n				or string.sub(entry.name, -10) == \".snap.luau\"\n				or string.sub(entry.name, -9) == \".snap.lua\"\n			then\n				continue\n			end\n\n			-- Compute relative path\n			local relative = string.sub(fullPath, #relativeTo + 2)\n			table.insert(results, relative)\n		end\n	end\nend\n\nlocal function dirname(filepath: string): string\n	local pos = string.find(filepath, \"/[^/]*$\")\n	if pos then\n		return string.sub(filepath, 1, pos - 1)\n	end\n\n	return \"\"\nend\n\n-- Optional 3rd arg: path to skip list JSON file.\n-- Skipped files are still included in the file list but not parsed.\nlocal skipListPath = userArgs[3]\nlocal skipSet: { [string]: boolean } = {}\nif skipListPath then\n	local skipJson = fs.readFileToString(skipListPath)\n	local skipList = json.deserialize(skipJson) :: { string }\n	for _, entry in skipList do\n		skipSet[entry] = true\n	end\nend\n\nlocal files: { string } = {}\ndiscoverFiles(luauRoot, luauRoot, files)\n\n-- Parse, strip, and write per-file AST JSON\nfor _, relativePath in files do\n	if skipSet[relativePath] then\n		continue\n	end\n\n	local fullPath = luauRoot .. \"/\" .. relativePath\n	local source = fs.readFileToString(fullPath)\n	local parseResult = syntax.parse(source)\n	local stripped = strip(parseResult.root)\n\n	local outPath = outputDir .. \"/\" .. relativePath .. \".json\"\n	local dir = dirname(outPath)\n	if dir ~= \"\" then\n		fs.createDirectory(dir, { makeParents = true })\n	end\n\n	fs.writeStringToFile(outPath, json.serialize(stripped))\nend\n\n-- Print file list to stdout (tiny — just paths)\nprint(json.serialize(files :: json.Array))\n";
 //#endregion
 //#region src/config/luau-config-loader.ts
 let cachedTemporaryDirectory$1;
@@ -237,6 +237,19 @@ function extractStaticRoot(pattern) {
 		root: pattern.slice(0, lastSlash)
 	};
 }
+function mapFsRootToDataModel(outDirectory, rojoTree) {
+	const normalized = outDirectory.replace(/\/$/, "");
+	const result = findInTree(rojoTree, normalized, "");
+	if (result === void 0) {
+		const available = [];
+		collectPaths(rojoTree, available);
+		let message = `No Rojo tree mapping found for path: ${normalized}`;
+		if (available.length > 0) message += `\n\nAvailable $path entries: ${available.join(", ")}`;
+		const hint = normalized.startsWith("src/") ? "Path starts with \"src/\" — if using roblox-ts, set \"outDir\" in your project config to the compiled output directory (e.g. \"out/client\")" : void 0;
+		throw new ConfigError(message, hint);
+	}
+	return result;
+}
 function extractProjectRoots(include) {
 	const rootMap = /* @__PURE__ */ new Map();
 	for (const pattern of include) {
@@ -255,23 +268,22 @@ function extractProjectRoots(include) {
 		testMatch
 	}));
 }
-function mapFsRootToDataModel(outDirectory, rojoTree) {
-	const normalized = outDirectory.replace(/\/$/, "");
-	const result = findInTree(rojoTree, normalized, "");
-	if (result === void 0) {
-		const available = [];
-		collectPaths(rojoTree, available);
-		let message = `No Rojo tree mapping found for path: ${normalized}`;
-		if (available.length > 0) message += `\n\nAvailable $path entries: ${available.join(", ")}`;
-		const hint = normalized.startsWith("src/") ? "Path starts with \"src/\" — if using roblox-ts, set \"outDir\" in your project config to the compiled output directory (e.g. \"out/client\")" : void 0;
-		throw new ConfigError(message, hint);
-	}
-	return result;
+function applyProjectRoot(include, projectRoot) {
+	if (projectRoot === void 0) return include;
+	return include.map((pattern) => path$1.posix.join(projectRoot, pattern));
+}
+function createFsClassifier(rootDirectory) {
+	return function classify(fsPath) {
+		const absolute = path$1.isAbsolute(fsPath) ? fsPath : path$1.resolve(rootDirectory, fsPath);
+		const stat = fs.statSync(absolute, { throwIfNoEntry: false });
+		if (stat === void 0) return "missing";
+		return stat.isDirectory() ? "directory" : "file";
+	};
 }
 function validateProjects(projects) {
 	const names = /* @__PURE__ */ new Set();
 	for (const project of projects) {
-		const name = typeof project.displayName === "string" ? project.displayName : project.displayName.name;
+		const name = displayNameOf(project);
 		if (name === "") throw new Error("Project must have a non-empty displayName");
 		if (names.has(name)) throw new Error(`Duplicate project displayName: ${name}`);
 		names.add(name);
@@ -285,26 +297,23 @@ const PROJECT_ONLY_KEYS = new Set([
 	"outDir",
 	"root"
 ]);
-function resolveProjectConfig(project, rootConfig, rojoTree) {
-	const roots = extractProjectRoots(project.include);
+function resolveProjectConfig(project, rootConfig, rojoTree, classify) {
+	const rootPrefixedInclude = applyProjectRoot(project.include, project.root);
+	const roots = extractProjectRoots(rootPrefixedInclude);
 	const testMatch = roots.flatMap((entry) => entry.testMatch);
-	const projectRoot = project.root;
-	if (roots.length > 1 && project.outDir === void 0) {
-		const name = typeof project.displayName === "string" ? project.displayName : project.displayName.name;
-		throw new Error(`Project "${name}" has multiple include roots but no outDir. Set outDir or split into separate projects.`);
-	}
-	const resolvedOutDirectory = resolveOutDirectory(project.outDir, projectRoot, roots[0]?.root);
-	const dataModelPath = resolvedOutDirectory !== void 0 ? mapFsRootToDataModel(resolvedOutDirectory, rojoTree) : void 0;
-	const resolvedInclude = projectRoot === void 0 ? project.include : project.include.map((pattern) => path$1.posix.join(projectRoot, pattern));
+	const rojoMounts = resolveMounts(project, roots, rojoTree, classify);
+	const projects = rojoMounts.map((mount) => mount.dataModelPath);
+	const singleMount = rojoMounts.length === 1 ? rojoMounts[0] : void 0;
 	const config = mergeProjectConfig(rootConfig, project);
-	const displayName = typeof project.displayName === "string" ? project.displayName : project.displayName.name;
+	const displayName = displayNameOf(project);
 	return {
 		config,
 		displayColor: typeof project.displayName === "string" ? void 0 : project.displayName.color,
 		displayName,
-		include: resolvedInclude,
-		outDir: resolvedOutDirectory,
-		projects: dataModelPath !== void 0 ? [dataModelPath] : [],
+		include: rootPrefixedInclude,
+		outDir: singleMount?.fsPath,
+		projects,
+		rojoMounts,
 		testMatch
 	};
 }
@@ -340,19 +349,92 @@ async function resolveAllProjects(entries, rootConfig, rojoTree, cwd) {
 		projects.push(loaded);
 	} else projects.push(entry.test);
 	validateProjects(projects);
-	return projects.map((project) => resolveProjectConfig(project, rootConfig, rojoTree));
+	const classify = createFsClassifier(cwd);
+	return projects.map((project) => resolveProjectConfig(project, rootConfig, rojoTree, classify));
 }
-/** When outDir is omitted (pure Luau), falls back to include pattern's static root. */
-function resolveOutDirectory(projectOutDirectory, projectRoot, fallbackRoot) {
-	const base = projectOutDirectory ?? fallbackRoot;
-	if (base === void 0) return;
-	return projectRoot !== void 0 ? path$1.posix.join(projectRoot, base) : base;
+function displayNameOf(project) {
+	return typeof project.displayName === "string" ? project.displayName : project.displayName.name;
 }
 function mergeProjectConfig(rootConfig, project) {
 	const merged = { ...rootConfig };
 	for (const [key, value] of Object.entries(project)) if (!PROJECT_ONLY_KEYS.has(key) && value !== void 0) merged[key] = value;
 	return merged;
 }
+function dedupeMounts(mounts) {
+	const seen = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const mount of mounts) if (!seen.has(mount.dataModelPath)) {
+		seen.add(mount.dataModelPath);
+		result.push(mount);
+	}
+	return result;
+}
+function joinProjectRoot(relativePath, projectRoot) {
+	return projectRoot !== void 0 ? path$1.posix.join(projectRoot, relativePath) : relativePath;
+}
+function pruneAncestorMounts(mounts) {
+	const dataModelPaths = mounts.map((mount) => mount.dataModelPath);
+	const surviving = new Set(pruneAncestors(dataModelPaths));
+	return mounts.filter((mount) => surviving.has(mount.dataModelPath));
+}
+function unmappableRootError(project, root, rojoTree) {
+	const name = displayNameOf(project);
+	const available = [];
+	collectPaths(rojoTree, available);
+	let message = `Project "${name}": include root "${root}" did not match any Rojo $path entry or subdirectory.`;
+	if (available.length > 0) message += `\n\nAvailable $path entries: ${available.join(", ")}`;
+	const hint = root.startsWith("src/") ? "Path starts with \"src/\" — if using roblox-ts, set \"outDir\" in your project config to the compiled output directory (e.g. \"out/client\")" : void 0;
+	return new ConfigError(message, hint);
+}
+function filterMountsForRoot(allMounts, root) {
+	return allMounts.filter((mount) => mount.fsPath === root || mount.fsPath.startsWith(`${root}/`));
+}
+function resolveMounts(project, roots, rojoTree, classify) {
+	if (project.outDir !== void 0) {
+		const resolvedOutDirectory = joinProjectRoot(project.outDir, project.root);
+		return [{
+			dataModelPath: mapFsRootToDataModel(resolvedOutDirectory, rojoTree),
+			fsPath: resolvedOutDirectory
+		}];
+	}
+	let collectedMounts;
+	const allMounts = [];
+	for (const { root } of roots) {
+		const exact = findInTree(rojoTree, root, "");
+		if (exact !== void 0) {
+			allMounts.push({
+				dataModelPath: exact,
+				fsPath: root
+			});
+			continue;
+		}
+		collectedMounts ??= collectMounts(rojoTree, "", classify);
+		const expanded = filterMountsForRoot(collectedMounts, root);
+		if (expanded.length === 0) throw unmappableRootError(project, root, rojoTree);
+		allMounts.push(...expanded);
+	}
+	return pruneAncestorMounts(dedupeMounts(allMounts));
+}
+function copyLuauOptionalFields(raw, config) {
+	const record = config;
+	for (const key of LUAU_BOOLEAN_KEYS) if (typeof raw[key] === "boolean") record[key] = raw[key];
+	for (const key of LUAU_NUMBER_KEYS) if (typeof raw[key] === "number") record[key] = raw[key];
+	for (const key of LUAU_STRING_KEYS) if (typeof raw[key] === "string") record[key] = raw[key];
+	for (const key of LUAU_STRING_ARRAY_KEYS) if (Array.isArray(raw[key])) record[key] = raw[key];
+}
+function buildProjectConfigFromLuau(luauConfigPath, directoryPath) {
+	const raw = loadLuauConfig(luauConfigPath);
+	const { displayName } = raw;
+	if (typeof displayName !== "string" || displayName === "") throw new Error(`Luau config file "${luauConfigPath}" must have a displayName string`);
+	const testMatch = Array.isArray(raw["testMatch"]) ? raw["testMatch"] : void 0;
+	const config = {
+		displayName,
+		include: testMatch !== void 0 ? testMatch.map((pattern) => path$1.posix.join(directoryPath, `${pattern}.luau`)) : [path$1.posix.join(directoryPath, "**/*.spec.luau")]
+	};
+	if (testMatch !== void 0) config.testMatch = testMatch;
+	copyLuauOptionalFields(raw, config);
+	return config;
+}
 /**
 * When a project config provides `testMatch` but not `include`, derive
 * `include` by appending `.ts` and `.tsx` extensions.  This lets users
@@ -384,26 +466,6 @@ const LUAU_BOOLEAN_KEYS = [
 const LUAU_NUMBER_KEYS = ["slowTestThreshold", "testTimeout"];
 const LUAU_STRING_KEYS = ["testEnvironment"];
 const LUAU_STRING_ARRAY_KEYS = ["setupFiles", "setupFilesAfterEnv"];
-function copyLuauOptionalFields(raw, config) {
-	const record = config;
-	for (const key of LUAU_BOOLEAN_KEYS) if (typeof raw[key] === "boolean") record[key] = raw[key];
-	for (const key of LUAU_NUMBER_KEYS) if (typeof raw[key] === "number") record[key] = raw[key];
-	for (const key of LUAU_STRING_KEYS) if (typeof raw[key] === "string") record[key] = raw[key];
-	for (const key of LUAU_STRING_ARRAY_KEYS) if (Array.isArray(raw[key])) record[key] = raw[key];
-}
-function buildProjectConfigFromLuau(luauConfigPath, directoryPath) {
-	const raw = loadLuauConfig(luauConfigPath);
-	const { displayName } = raw;
-	if (typeof displayName !== "string" || displayName === "") throw new Error(`Luau config file "${luauConfigPath}" must have a displayName string`);
-	const testMatch = Array.isArray(raw["testMatch"]) ? raw["testMatch"] : void 0;
-	const config = {
-		displayName,
-		include: testMatch !== void 0 ? testMatch.map((pattern) => path$1.posix.join(directoryPath, `${pattern}.luau`)) : [path$1.posix.join(directoryPath, "**/*.spec.luau")]
-	};
-	if (testMatch !== void 0) config.testMatch = testMatch;
-	copyLuauOptionalFields(raw, config);
-	return config;
-}
 //#endregion
 //#region src/config/setup-resolver.ts
 const PROBE_EXTENSIONS = [
@@ -445,6 +507,8 @@ function resolvePackageSpecifier(resolve, input) {
 //#endregion
 //#region src/config/stubs.ts
 const HEADER = "-- Auto-generated by jest-roblox (do not edit)\n";
+const STUB_FILENAME = "jest.config.lua";
+const USER_LUAU_FILENAME = "jest.config.luau";
 const SKIP_FIELDS = new Set(["exclude", "include"]);
 function serializeToLuau(config) {
 	let output = `${HEADER}return {\n`;
@@ -461,33 +525,52 @@ function serializeToLuau(config) {
 }
 function generateProjectConfigs(projects) {
 	for (const project of projects) {
-		const luauConfigPath = project.outputPath.replace(/\.lua$/, ".luau");
-		if (fs.existsSync(luauConfigPath)) continue;
-		const content = serializeToLuau(project.config);
 		const directory = path.dirname(project.outputPath);
+		if (hasUserAuthoredConfig(directory)) continue;
+		const content = serializeToLuau(project.config);
 		fs.mkdirSync(directory, { recursive: true });
 		fs.writeFileSync(project.outputPath, content, "utf8");
 	}
 }
+/**
+* Refuse to let any downstream write land outside `rootDirectory`. Mount
+* fsPaths originate from the rojo tree and `resolveNestedProjects` can emit
+* values with `..` segments (nested projects relocate paths); combined with
+* `path.resolve` on Windows, a permissive fsPath could send stub writes to
+* `D:\outside\...`. Guard at every write-site.
+*/
+function assertMountContained(project, fsPath, rootDirectory) {
+	if (path.isAbsolute(fsPath)) throw new Error(`Project "${project.displayName}" mount fsPath must be relative, got: ${fsPath}`);
+	const rootResolved = path.resolve(rootDirectory);
+	const mountResolved = path.resolve(rootDirectory, fsPath);
+	if (mountResolved !== rootResolved && !mountResolved.startsWith(rootResolved + path.sep)) throw new Error(`Project "${project.displayName}" mount fsPath escapes root directory: ${fsPath}`);
+}
+/**
+* For a multi-mount project, the stubs-per-mount rule requires that a
+* user-authored config at any tracked FS path must appear at every tracked
+* FS path (or none). Throws `ConfigError` when the project has partial
+* coverage — some mounts have a user config and others don't.
+*/
+function assertStubCollisionRule(project, rootDirectory) {
+	const withUser = [];
+	const withoutUser = [];
+	for (const mount of project.rojoMounts) {
+		assertMountContained(project, mount.fsPath, rootDirectory);
+		if (hasUserAuthoredConfig(path.resolve(rootDirectory, mount.fsPath))) withUser.push(mount.fsPath);
+		else withoutUser.push(mount.fsPath);
+	}
+	if (withUser.length === 0 || withoutUser.length === 0) return;
+	const withUserList = withUser.join(", ");
+	const withoutUserList = withoutUser.join(", ");
+	throw new ConfigError(`Project "${project.displayName}": user-authored jest config present at some mounts but not others.\n\nWith user config: ${withUserList}\nWithout user config: ${withoutUserList}\n\nFor multi-mount projects, either every tracked mount must have a user config, or none.`);
+}
 function syncStubsToShadowDirectory(projects, rootDirectory, shadowDirectory) {
 	let changed = false;
 	const expectedPaths = /* @__PURE__ */ new Set();
-	for (const project of projects) {
-		if (project.outDir === void 0) continue;
-		if (path.isAbsolute(project.outDir)) throw new Error(`Project "${project.displayName}" outDir must be a relative path, got: ${project.outDir}`);
-		const stubName = "jest.config.lua";
-		const sourcePath = path.resolve(rootDirectory, project.outDir, stubName);
-		if (!fs.existsSync(sourcePath)) continue;
-		const targetPath = path.resolve(shadowDirectory, project.outDir, stubName);
-		expectedPaths.add(targetPath);
-		const sourceContent = fs.readFileSync(sourcePath);
-		if (fs.existsSync(targetPath)) {
-			const targetContent = fs.readFileSync(targetPath);
-			if (Buffer.compare(sourceContent, targetContent) === 0) continue;
-		}
-		fs.mkdirSync(path.dirname(targetPath), { recursive: true });
-		fs.copyFileSync(sourcePath, targetPath);
-		changed = true;
+	for (const project of projects) for (const mount of project.rojoMounts) {
+		const result = syncMountStub(project, mount.fsPath, rootDirectory, shadowDirectory);
+		if (result.targetPath !== void 0) expectedPaths.add(result.targetPath);
+		changed ||= result.changed;
 	}
 	for (const existing of findShadowStubs(shadowDirectory)) if (!expectedPaths.has(existing)) {
 		fs.unlinkSync(existing);
@@ -497,7 +580,7 @@ function syncStubsToShadowDirectory(projects, rootDirectory, shadowDirectory) {
 	return changed;
 }
 function escapeString(value) {
-	return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+	return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"").replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t");
 }
 function serializeLuauValue(value, indent) {
 	if (typeof value === "string") return `"${escapeString(value)}"`;
@@ -510,16 +593,35 @@ function serializeLuauValue(value, indent) {
 	}
 	return String(value);
 }
-function removeEmptyParents(directory, stopAt) {
-	const resolved = path.resolve(directory);
-	const resolvedStop = path.resolve(stopAt);
-	if (resolved === resolvedStop || !resolved.startsWith(resolvedStop)) return;
-	try {
-		if (fs.readdirSync(resolved).length === 0) {
-			fs.rmdirSync(resolved);
-			removeEmptyParents(path.dirname(resolved), stopAt);
-		}
-	} catch {}
+function hasUserAuthoredConfig(directoryPath) {
+	const luauPath = path.join(directoryPath, USER_LUAU_FILENAME);
+	if (fs.existsSync(luauPath)) return true;
+	const luaPath = path.join(directoryPath, STUB_FILENAME);
+	if (!fs.existsSync(luaPath)) return false;
+	return !fs.readFileSync(luaPath, "utf8").startsWith(HEADER);
+}
+function syncMountStub(project, fsPath, rootDirectory, shadowDirectory) {
+	assertMountContained(project, fsPath, rootDirectory);
+	const sourcePath = path.resolve(rootDirectory, fsPath, STUB_FILENAME);
+	if (!fs.existsSync(sourcePath)) return {
+		changed: false,
+		targetPath: void 0
+	};
+	const targetPath = path.resolve(shadowDirectory, fsPath, STUB_FILENAME);
+	const sourceContent = fs.readFileSync(sourcePath);
+	if (fs.existsSync(targetPath)) {
+		const targetContent = fs.readFileSync(targetPath);
+		if (Buffer.compare(sourceContent, targetContent) === 0) return {
+			changed: false,
+			targetPath
+		};
+	}
+	fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+	fs.copyFileSync(sourcePath, targetPath);
+	return {
+		changed: true,
+		targetPath
+	};
 }
 function findShadowStubs(directory) {
 	const results = [];
@@ -528,10 +630,21 @@ function findShadowStubs(directory) {
 	for (const entry of entries) {
 		const fullPath = path.resolve(directory, entry.name);
 		if (entry.isDirectory()) results.push(...findShadowStubs(fullPath));
-		else if (entry.name === "jest.config.lua") results.push(fullPath);
+		else if (entry.name === STUB_FILENAME) results.push(fullPath);
 	}
 	return results;
 }
+function removeEmptyParents(directory, stopAt) {
+	const resolved = path.resolve(directory);
+	const resolvedStop = path.resolve(stopAt);
+	if (resolved === resolvedStop || !resolved.startsWith(resolvedStop)) return;
+	try {
+		if (fs.readdirSync(resolved).length === 0) {
+			fs.rmdirSync(resolved);
+			removeEmptyParents(path.dirname(resolved), stopAt);
+		}
+	} catch {}
+}
 //#endregion
 //#region src/coverage/derive-coverage-from.ts
 /**
@@ -2328,8 +2441,7 @@ async function run(args) {
 	}
 }
 async function main() {
-	const exitCode = await run(process.argv.slice(2));
-	process.exit(exitCode);
+	process.exitCode = await run(process.argv.slice(2));
 }
 /**
 * `--parallel` with no value means `"auto"`. Node's `parseArgs` can't express
@@ -2623,18 +2735,20 @@ function buildStubConfig(config) {
 function generateProjectStubs(projects, rootDirectory) {
 	const entries = [];
 	for (const project of projects) {
-		if (project.outDir === void 0) continue;
-		const outputPath = path$1.resolve(rootDirectory, project.outDir, "jest.config.lua");
+		assertStubCollisionRule(project, rootDirectory);
 		const stubConfig = {
 			...buildStubConfig(project.config),
 			displayName: project.displayName,
 			include: [],
 			testMatch: project.testMatch
 		};
-		entries.push({
-			config: stubConfig,
-			outputPath
-		});
+		for (const mount of project.rojoMounts) {
+			const outputPath = path$1.resolve(rootDirectory, mount.fsPath, "jest.config.lua");
+			entries.push({
+				config: stubConfig,
+				outputPath
+			});
+		}
 	}
 	generateProjectConfigs(entries);
 }

package/dist/{executor-B2IDh6bH.d.mts → executor-COuwZJJX.d.mts}

@@ -1,5 +1,11 @@
 import { ReportOptions } from "istanbul-reports";
 
+//#region packages/rojo-utils/dist/index.d.mts
+interface Mount {
+  dataModelPath: string;
+  fsPath: string;
+}
+//#endregion
 //#region node_modules/.pnpm/@rbxts+jest@3.13.3-ts.1/node_modules/@rbxts/jest/src/config.d.ts
 interface ReporterConfig {
   reporter: string | ModuleScript;
@@ -987,10 +993,17 @@ interface ResolvedProjectConfig {
   displayName: string;
   /** Original include patterns (with TS extensions) for filesystem discovery. */
   include: Array<string>;
-  /** Resolved output directory (workspace-relative) for stub generation. */
+  /**
+  * Single resolved output directory (workspace-relative). Set only when
+  * resolution produced exactly one mount; undefined when the project spans
+  * multiple rojo mounts. Kept for back-compat; new code should consume
+  * `rojoMounts` instead.
+  */
   outDir?: string;
-  /** DataModel paths for Jest execution. */
+  /** DataModel paths Jest walks up from to discover test configs. */
   projects: Array<string>;
+  /** Internal: FS↔DataModel pairs for stub generation and shadow sync. */
+  rojoMounts: Array<Mount>;
   /** Luau-side testMatch patterns (extensions stripped). */
   testMatch: Array<string>;
 }