@isentinel/jest-roblox 0.1.2 → 0.1.3

package/dist/cli.d.mts

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

package/dist/cli.mjs

@@ -1,11 +1,11 @@
-import { D as createOpenCloudBackend, I as isValidBackend, L as LuauScriptError, M as ROOT_ONLY_KEYS, N as VALID_BACKENDS, O as hashBuffer, S as loadConfig$1, T as createStudioBackend, _ as formatResult, a as formatAnnotations, b as formatBanner, c as execute, d as findFormatterOptions, g as formatMultiProjectResult, i as runTypecheck, l as formatExecuteOutput, m as formatCompactMultiProject, n as parseGameOutput, o as formatJobSummary, p as writeJsonFile, r as writeGameOutput, s as resolveGitHubActionsOptions, t as formatGameOutputNotice, u as loadCoverageManifest, x as rojoProjectSchema, y as formatTypecheckSummary } from "./game-output-BMGxhjkE.mjs";
+import { A as hashBuffer, C as resolveNestedProjects, D as createStudioBackend, F as VALID_BACKENDS, P as ROOT_ONLY_KEYS, R as isValidBackend, S as collectPaths, _ as formatResult, a as formatAnnotations, b as formatBanner, c as execute, d as findFormatterOptions, g as formatMultiProjectResult, i as runTypecheck, k as createOpenCloudBackend, l as formatExecuteOutput, m as formatCompactMultiProject, n as parseGameOutput, o as formatJobSummary, p as writeJsonFile, r as writeGameOutput, s as resolveGitHubActionsOptions, t as formatGameOutputNotice, u as loadCoverageManifest, w as loadConfig$1, x as rojoProjectSchema, y as formatTypecheckSummary, z as LuauScriptError } from "./game-output-BU-9pJ93.mjs";
 import { createRequire } from "node:module";
 import { type } from "arktype";
 import assert from "node:assert";
 import * as fs$1 from "node:fs";
-import fs, { readFileSync } from "node:fs";
+import fs from "node:fs";
 import * as path$1 from "node:path";
-import path, { dirname, join } from "node:path";
+import path from "node:path";
 import process from "node:process";
 import { parseArgs as parseArgs$1 } from "node:util";
 import { isAgent } from "std-env";
@@ -14,16 +14,16 @@ import { WebSocketServer } from "ws";
 import { loadConfig } from "c12";
 import * as os from "node:os";
 import { Buffer } from "node:buffer";
+import * as cp from "node:child_process";
 import { RojoResolver } from "@roblox-ts/rojo-resolver";
 import { TraceMap, originalPositionFor } from "@jridgewell/trace-mapping";
 import { getTsconfig } from "get-tsconfig";
 import picomatch from "picomatch";
-import * as cp from "node:child_process";
 import istanbulCoverage from "istanbul-lib-coverage";
 import istanbulReport from "istanbul-lib-report";
 import istanbulReports from "istanbul-reports";
 //#region package.json
-var version = "0.1.2";
+var version = "0.1.3";
 //#endregion
 //#region src/backends/auto.ts
 var StudioWithFallback = class {
@@ -115,39 +115,95 @@ function stripTsExtension(pattern) {
 	return pattern.replace(/\.(tsx?|luau?)$/, "");
 }
 //#endregion
-//#region src/utils/rojo-tree.ts
-function resolveNestedProjects(tree, rootDirectory) {
-	return resolveTree(tree, rootDirectory, /* @__PURE__ */ new Set());
-}
-function collectPaths(node, result) {
-	for (const [key, value] of Object.entries(node)) if (key === "$path" && typeof value === "string") result.push(value.replaceAll("\\", "/"));
-	else if (typeof value === "object" && !Array.isArray(value) && !key.startsWith("$")) collectPaths(value, result);
+//#region src/luau/eval-literals.ts
+/**
+* Evaluate the first return expression in a Lute-stripped AST root block,
+* supporting only literal values (string, boolean, number, nil, table, cast).
+*
+* Accepts `unknown` and narrows safely — no type casts on JSON.parse needed.
+*/
+function evalLuauReturnLiterals(root) {
+	if (!isObject(root) || !Array.isArray(root["statements"])) throw new Error("Config file has no return statement");
+	const returnStat = root["statements"].find((stat) => isObject(stat) && stat["tag"] === "return");
+	if (!isObject(returnStat) || !Array.isArray(returnStat["expressions"])) throw new Error("Config file has no return statement");
+	const first = returnStat["expressions"][0];
+	if (!isObject(first) || !("node" in first)) throw new Error("Return statement has no expressions");
+	return evalExpr(first["node"]);
+}
+function isObject(value) {
+	return typeof value === "object" && value !== null;
+}
+function evalExpr(node) {
+	if (!isObject(node)) return;
+	let current = node;
+	while (current["tag"] === "cast" && isObject(current["operand"])) current = current["operand"];
+	const { tag } = current;
+	if (tag === "boolean" || tag === "number") return current["value"];
+	if (tag === "string") return current["text"];
+	if (tag === "table" && Array.isArray(current["entries"])) return evalTable(current["entries"]);
+}
+function evalTable(entries) {
+	if (entries.length === 0) return {};
+	const first = entries[0];
+	if (isObject(first) && first["kind"] === "list") return entries.map((entry) => isObject(entry) ? evalExpr(entry["value"]) : void 0);
+	const result = {};
+	for (const entry of entries) {
+		if (!isObject(entry) || entry["kind"] !== "record") continue;
+		const { key, value } = entry;
+		if (isObject(key) && typeof key["text"] === "string") result[key["text"]] = evalExpr(value);
+	}
+	return result;
 }
-function resolveTree(node, rootDirectory, visited) {
-	const resolved = {};
-	for (const [key, value] of Object.entries(node)) {
-		if (key === "$path" && typeof value === "string" && value.endsWith(".project.json")) {
-			const projectPath = join(rootDirectory, value);
-			if (visited.has(projectPath)) throw new Error(`Circular project reference: ${value}`);
-			const chain = new Set(visited);
-			chain.add(projectPath);
-			let content;
-			try {
-				content = readFileSync(projectPath, "utf-8");
-			} catch (err) {
-				throw new Error(`Could not read nested Rojo project: ${value}`, { cause: err });
-			}
-			const innerTree = resolveTree(JSON.parse(content).tree, dirname(projectPath), chain);
-			for (const [innerKey, innerValue] of Object.entries(innerTree)) resolved[innerKey] = innerValue;
-			continue;
-		}
-		if (key.startsWith("$") || typeof value !== "object" || Array.isArray(value)) {
-			resolved[key] = value;
-			continue;
-		}
-		resolved[key] = resolveTree(value, rootDirectory, visited);
+//#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\nlocal files: { string } = {}\ndiscoverFiles(luauRoot, luauRoot, files)\n\n-- Parse, strip, and write per-file AST JSON\nfor _, relativePath in files do\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;
+/**
+* Parse a .luau config file via Lute and evaluate its return expression.
+*/
+function loadLuauConfig(filePath) {
+	const temporaryDirectory = getTemporaryDirectory$1();
+	const scriptPath = path$1.join(temporaryDirectory, "parse-ast.luau");
+	fs$1.writeFileSync(scriptPath, parse_ast_default);
+	let stdout;
+	try {
+		stdout = cp.execFileSync("lute", [
+			"run",
+			scriptPath,
+			"--",
+			path$1.resolve(filePath)
+		], {
+			encoding: "utf-8",
+			maxBuffer: 1024 * 1024
+		});
+	} catch (err) {
+		if (err instanceof Error && "code" in err && err.code === "ENOENT") throw new Error("lute is required to load .luau config files but was not found on PATH");
+		throw new Error(`Failed to evaluate Luau config ${filePath}`, { cause: err });
+	}
+	let ast;
+	try {
+		ast = JSON.parse(stdout);
+	} catch (err) {
+		throw new Error(`Failed to parse AST JSON from Luau config ${filePath}`, { cause: err });
 	}
-	return resolved;
+	const result = evalLuauReturnLiterals(ast);
+	if (typeof result !== "object" || result === null) throw new Error(`Luau config ${filePath} must return a table`);
+	return result;
+}
+/**
+* Check if `<cwd>/<directoryOrFile>/jest.config.luau` exists. Returns the
+* resolved path if found, undefined otherwise.
+*/
+function findLuauConfigFile(directoryOrFile, cwd) {
+	const resolved = path$1.resolve(cwd, directoryOrFile, "jest.config.luau");
+	if (fs$1.existsSync(resolved)) return resolved;
+}
+function getTemporaryDirectory$1() {
+	if (cachedTemporaryDirectory$1 !== void 0 && fs$1.existsSync(cachedTemporaryDirectory$1)) return cachedTemporaryDirectory$1;
+	cachedTemporaryDirectory$1 = fs$1.mkdtempSync(path$1.join(os.tmpdir(), "jest-roblox-luau-config-"));
+	return cachedTemporaryDirectory$1;
 }
 //#endregion
 //#region src/config/projects.ts
@@ -249,6 +305,8 @@ function resolveProjectConfig(project, rootConfig, rojoTree) {
 	};
 }
 async function loadProjectConfigFile(filePath, cwd) {
+	const luauConfigPath = findLuauConfigFile(filePath, cwd);
+	if (luauConfigPath !== void 0) return buildProjectConfigFromLuau(luauConfigPath, filePath);
 	let result;
 	try {
 		result = await loadConfig({
@@ -290,6 +348,38 @@ function mergeProjectConfig(rootConfig, project) {
 	for (const [key, value] of Object.entries(project)) if (!PROJECT_ONLY_KEYS.has(key) && value !== void 0) merged[key] = value;
 	return merged;
 }
+const LUAU_BOOLEAN_KEYS = [
+	"automock",
+	"clearMocks",
+	"injectGlobals",
+	"mockDataModel",
+	"resetMocks",
+	"resetModules",
+	"restoreMocks"
+];
+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;
+}
 function matchNodePath(childNode, targetPath, childDataModelPath) {
 	const nodePath = childNode.$path;
 	if (typeof nodePath !== "string") return;
@@ -365,6 +455,8 @@ 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);
 		fs.mkdirSync(directory, { recursive: true });
@@ -470,27 +562,133 @@ function mapCoverageToTypeScript(coverageData, manifest) {
 		if (record === void 0) continue;
 		const resources = loadFileResources(record);
 		if (resources === void 0) continue;
-		mapFileFunctions(resources, fileCoverage, pendingFunctions, mapFileStatements(resources, fileCoverage, pendingStatements));
-		mapFileBranches(resources, fileCoverage, pendingBranches);
+		if (resources.traceMap === void 0) {
+			passthroughFileStatements(resources, fileCoverage, pendingStatements);
+			passthroughFileFunctions(resources, fileCoverage, pendingFunctions);
+			passthroughFileBranches(resources, fileCoverage, pendingBranches);
+		} else {
+			const mapped = {
+				coverageMap: resources.coverageMap,
+				traceMap: resources.traceMap
+			};
+			mapFileFunctions(mapped, fileCoverage, pendingFunctions, mapFileStatements(mapped, fileCoverage, pendingStatements));
+			mapFileBranches(mapped, fileCoverage, pendingBranches);
+		}
 	}
 	return buildResult(pendingStatements, pendingFunctions, pendingBranches);
 }
 function loadFileResources(record) {
 	let coverageMapRaw;
-	let sourceMapRaw;
 	try {
 		coverageMapRaw = fs$1.readFileSync(record.coverageMapPath, "utf-8");
-		sourceMapRaw = fs$1.readFileSync(record.sourceMapPath, "utf-8");
 	} catch {
 		return;
 	}
 	const parsed = coverageMapSchema(JSON.parse(coverageMapRaw));
 	if (parsed instanceof type.errors) return;
+	let traceMap;
+	try {
+		traceMap = new TraceMap(fs$1.readFileSync(record.sourceMapPath, "utf-8"));
+	} catch {}
 	return {
 		coverageMap: parsed,
-		traceMap: new TraceMap(sourceMapRaw)
+		sourceKey: record.key,
+		traceMap
 	};
 }
+function toIstanbulColumn(luauColumn) {
+	return Math.max(0, luauColumn - 1);
+}
+function passthroughFileStatements(resources, fileCoverage, pending) {
+	let fileStatements = pending.get(resources.sourceKey);
+	if (fileStatements === void 0) {
+		fileStatements = /* @__PURE__ */ new Map();
+		pending.set(resources.sourceKey, fileStatements);
+	}
+	for (const [statementId, rawSpan] of Object.entries(resources.coverageMap.statementMap)) {
+		const span = spanSchema(rawSpan);
+		if (span instanceof type.errors) continue;
+		const hitCount = fileCoverage.s[statementId] ?? 0;
+		fileStatements.set(statementId, {
+			end: {
+				column: toIstanbulColumn(span.end.column),
+				line: span.end.line
+			},
+			hitCount,
+			start: {
+				column: toIstanbulColumn(span.start.column),
+				line: span.start.line
+			}
+		});
+	}
+}
+function passthroughFileFunctions(resources, fileCoverage, pendingFunctions) {
+	if (resources.coverageMap.functionMap === void 0) return;
+	let fileFunctions = pendingFunctions.get(resources.sourceKey);
+	if (fileFunctions === void 0) {
+		fileFunctions = [];
+		pendingFunctions.set(resources.sourceKey, fileFunctions);
+	}
+	for (const [functionId, rawEntry] of Object.entries(resources.coverageMap.functionMap)) {
+		const entry = functionEntrySchema(rawEntry);
+		if (entry instanceof type.errors) continue;
+		fileFunctions.push({
+			name: entry.name,
+			hitCount: fileCoverage.f?.[functionId] ?? 0,
+			loc: {
+				end: {
+					column: toIstanbulColumn(entry.location.end.column),
+					line: entry.location.end.line
+				},
+				start: {
+					column: toIstanbulColumn(entry.location.start.column),
+					line: entry.location.start.line
+				}
+			}
+		});
+	}
+}
+function passthroughFileBranches(resources, fileCoverage, pendingBranches) {
+	if (resources.coverageMap.branchMap === void 0) return;
+	let fileBranches = pendingBranches.get(resources.sourceKey);
+	if (fileBranches === void 0) {
+		fileBranches = [];
+		pendingBranches.set(resources.sourceKey, fileBranches);
+	}
+	for (const [branchId, rawEntry] of Object.entries(resources.coverageMap.branchMap)) {
+		const entry = branchEntrySchema(rawEntry);
+		if (entry instanceof type.errors) continue;
+		const armHitCounts = fileCoverage.b?.[branchId] ?? [];
+		const locations = [];
+		for (const rawLocation of entry.locations) {
+			const location = spanSchema(rawLocation);
+			if (location instanceof type.errors) continue;
+			locations.push({
+				end: {
+					column: toIstanbulColumn(location.end.column),
+					line: location.end.line
+				},
+				start: {
+					column: toIstanbulColumn(location.start.column),
+					line: location.start.line
+				}
+			});
+		}
+		if (locations.length === 0) continue;
+		const firstLocation = locations[0];
+		const lastLocation = locations[locations.length - 1];
+		assert(firstLocation !== void 0 && lastLocation !== void 0, "Branch locations must not be empty after filtering");
+		fileBranches.push({
+			armHitCounts: entry.locations.map((_, index) => armHitCounts[index] ?? 0),
+			loc: {
+				end: lastLocation.end,
+				start: firstLocation.start
+			},
+			locations,
+			type: entry.type
+		});
+	}
+}
 function mapStatement(traceMap, span) {
 	const mappedStart = originalPositionFor(traceMap, {
 		column: Math.max(0, span.start.column - 1),
@@ -731,26 +929,7 @@ function buildResult(pending, pendingFunctions, pendingBranches) {
 	return { files };
 }
 //#endregion
-//#region src/types/luau-ast.ts
-const INSTRUMENTABLE_STATEMENT_TAGS = new Set([
-	"assign",
-	"break",
-	"compoundassign",
-	"conditional",
-	"continue",
-	"do",
-	"expression",
-	"for",
-	"forin",
-	"function",
-	"local",
-	"localfunction",
-	"repeat",
-	"return",
-	"while"
-]);
-//#endregion
-//#region src/coverage/luau-visitor.ts
+//#region src/luau/visitor.ts
 function visitExpression(expression, visitor) {
 	if (visitor.visitExpr?.(expression) === false) return;
 	const { tag } = expression;
@@ -1021,6 +1200,23 @@ function visitExprInstantiate(node, visitor) {
 }
 //#endregion
 //#region src/coverage/coverage-collector.ts
+const INSTRUMENTABLE_STATEMENT_TAGS = new Set([
+	"assign",
+	"break",
+	"compoundassign",
+	"conditional",
+	"continue",
+	"do",
+	"expression",
+	"for",
+	"forin",
+	"function",
+	"local",
+	"localfunction",
+	"repeat",
+	"return",
+	"while"
+]);
 const END_KEYWORD_LENGTH = 3;
 function collectCoverage(root) {
 	let statementIndex = 1;
@@ -1260,9 +1456,6 @@ function buildCoverageMap$1(result) {
 	};
 }
 //#endregion
-//#region src/coverage/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]\nlocal outputDir = userArgs[2]\nif not luauRoot or not outputDir then\n	error(\"Usage: lute run parse-ast.luau -- <luau-root> <output-dir>\")\nend\n\nluauRoot = string.gsub(luauRoot, \"\\\\\", \"/\")\noutputDir = string.gsub(outputDir, \"\\\\\", \"/\")\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	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	[\"repeat\"] = { \"body\", \"condition\" },\n	[\"return\"] = { \"expressions\" },\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-- 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\nlocal files: { string } = {}\ndiscoverFiles(luauRoot, luauRoot, files)\n\n-- Parse, strip, and write per-file AST JSON\nfor _, relativePath in files do\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/coverage/probe-inserter.ts
 function insertProbes(source, result, fileKey) {
 	const lines = splitLines(source);
@@ -1317,7 +1510,7 @@ function applyProbes(mutableLines, probes) {
 		assert(line !== void 0, `Invalid probe line number: ${probeLine}`);
 		const before = line.slice(0, column - 1);
 		const after = line.slice(column - 1);
-		mutableLines[lineIndex] = before + text + after;
+		mutableLines[lineIndex] = before + (before.length > 0 && !/\s$/.test(before) && /^[a-zA-Z_]/.test(text) ? " " : "") + text + after;
 	}
 }
 function extractModeDirective(lines) {
@@ -1866,6 +2059,7 @@ Options:
   --gameOutput <path>               Write game output (print/warn/error) to file
   --sourceMap                       Map Luau stack traces to TypeScript source
   --rojoProject <path>              Path to rojo project file (auto-detected if not set)
+  --passWithNoTests                 Exit with 0 when no test files are found
   --verbose                         Show individual test results
   --silent                          Suppress output
   --no-color                        Disable colored output
@@ -1927,6 +2121,7 @@ function parseArgs(args) {
 			"no-color": { type: "boolean" },
 			"no-show-luau": { type: "boolean" },
 			"outputFile": { type: "string" },
+			"passWithNoTests": { type: "boolean" },
 			"pollInterval": { type: "string" },
 			"port": { type: "string" },
 			"project": {
@@ -1982,6 +2177,7 @@ function parseArgs(args) {
 		gameOutput: values.gameOutput,
 		help: values.help,
 		outputFile: values.outputFile,
+		passWithNoTests: values.passWithNoTests,
 		pollInterval,
 		port,
 		project: values.project,
@@ -2423,6 +2619,7 @@ async function runMultiProject(cli, rootConfig, projectEntries) {
 		tsconfig: rootConfig.typecheckTsconfig
 	}) : void 0;
 	if (projectResults.length === 0 && typecheckResult === void 0) {
+		if (rootConfig.passWithNoTests) return 0;
 		console.error("No test files found in any project");
 		return 2;
 	}
@@ -2451,12 +2648,14 @@ async function runSingleProject(config, cliFiles) {
 	resolveSetupFilePaths(config);
 	const discovery = discoverTestFiles(config, cliFiles);
 	if (discovery.files.length === 0) {
+		if (config.passWithNoTests) return 0;
 		console.error("No test files found");
 		return 2;
 	}
 	const typeTestFiles = config.typecheck ? discovery.files.filter((file) => TYPE_TEST_PATTERN.test(file)) : [];
 	const runtimeTestFiles = config.typecheckOnly ? [] : discovery.files.filter((file) => !TYPE_TEST_PATTERN.test(file));
 	if (typeTestFiles.length === 0 && runtimeTestFiles.length === 0) {
+		if (config.passWithNoTests) return 0;
 		console.error("No test files found for the selected mode");
 		return 2;
 	}
@@ -2568,6 +2767,7 @@ function mergeCliWithConfig(cli, config) {
 		formatters: resolveFormatters(cli, config),
 		gameOutput: cli.gameOutput ?? config.gameOutput,
 		outputFile: cli.outputFile ?? config.outputFile,
+		passWithNoTests: cli.passWithNoTests ?? config.passWithNoTests,
 		pollInterval: cli.pollInterval ?? config.pollInterval,
 		port: cli.port ?? config.port,
 		rojoProject: cli.rojoProject ?? config.rojoProject,

package/dist/{executor-DqZE3wME.d.mts → executor-D6BzDfQ_.d.mts}

@@ -825,6 +825,7 @@ interface Config extends Except<Argv, "projects" | "rootDir" | "setupFiles" | "s
   gameOutput?: string;
   jestPath?: string;
   luauRoots?: Array<string>;
+  passWithNoTests?: boolean;
   placeFile?: string;
   pollInterval?: number;
   port?: number;
@@ -852,6 +853,7 @@ interface ResolvedConfig extends Except<Config, "projects"> {
   coverageDirectory: string;
   coveragePathIgnorePatterns: Array<string>;
   coverageReporters: Array<CoverageReporter>;
+  passWithNoTests: boolean;
   placeFile: string;
   pollInterval: number;
   port: number;
@@ -884,6 +886,7 @@ interface CliOptions {
   gameOutput?: string;
   help?: boolean;
   outputFile?: string;
+  passWithNoTests?: boolean;
   pollInterval?: number;
   port?: number;
   project?: Array<string>;

package/dist/{game-output-BMGxhjkE.mjs → game-output-BU-9pJ93.mjs}

@@ -4,7 +4,7 @@ import assert from "node:assert";
 import * as fs$1 from "node:fs";
 import { existsSync, readFileSync } from "node:fs";
 import * as path$1 from "node:path";
-import path from "node:path";
+import path, { dirname, join, relative } from "node:path";
 import process from "node:process";
 import color from "tinyrainbow";
 import { WebSocketServer } from "ws";
@@ -14,9 +14,9 @@ import * as crypto from "node:crypto";
 import { randomUUID } from "node:crypto";
 import buffer from "node:buffer";
 import { defuFn } from "defu";
+import { execFileSync } from "node:child_process";
 import { TraceMap, originalPositionFor, sourceContentFor } from "@jridgewell/trace-mapping";
 import { getTsconfig } from "get-tsconfig";
-import { execFileSync } from "node:child_process";
 import hljs from "highlight.js/lib/core";
 import typescript from "highlight.js/lib/languages/typescript";
 import { parseJSONC } from "confbox";
@@ -243,6 +243,7 @@ const DEFAULT_CONFIG = {
 		"**/rbxts_include/**"
 	],
 	coverageReporters: ["text", "lcov"],
+	passWithNoTests: false,
 	placeFile: "./game.rbxl",
 	pollInterval: 500,
 	port: 3001,
@@ -361,6 +362,7 @@ const configSchema = type({
 	"maxWorkers?": type("number").or(type("string")),
 	"noStackTrace?": "boolean",
 	"outputFile?": "string",
+	"passWithNoTests?": "boolean",
 	"placeFile?": "string",
 	"pollInterval?": "number",
 	"port?": "number",
@@ -822,6 +824,52 @@ function resolveFunctionValues(config) {
 	return resolved;
 }
 //#endregion
+//#region src/utils/rojo-tree.ts
+function resolveNestedProjects(tree, rootDirectory) {
+	return resolveTree(tree, rootDirectory, rootDirectory, /* @__PURE__ */ new Set());
+}
+function collectPaths(node, result) {
+	for (const [key, value] of Object.entries(node)) if (key === "$path" && typeof value === "string") result.push(value.replaceAll("\\", "/"));
+	else if (typeof value === "object" && !Array.isArray(value) && !key.startsWith("$")) collectPaths(value, result);
+}
+function inlineNestedProject(projectPath, currentDirectory, originalRoot, visited) {
+	const chain = new Set(visited);
+	chain.add(projectPath);
+	let content;
+	try {
+		content = readFileSync(projectPath, "utf-8");
+	} catch (err) {
+		const relativePath = relative(currentDirectory, projectPath);
+		throw new Error(`Could not read nested Rojo project: ${relativePath}`, { cause: err });
+	}
+	return resolveTree(JSON.parse(content).tree, dirname(projectPath), originalRoot, chain);
+}
+function resolveRootRelativePath(currentDirectory, value, originalRoot) {
+	return relative(originalRoot, join(currentDirectory, value)).replaceAll("\\", "/");
+}
+function resolveTree(node, currentDirectory, originalRoot, visited) {
+	const resolved = {};
+	for (const [key, value] of Object.entries(node)) {
+		if (key === "$path" && typeof value === "string" && value.endsWith(".project.json")) {
+			const projectPath = join(currentDirectory, value);
+			if (visited.has(projectPath)) throw new Error(`Circular project reference: ${value}`);
+			const innerTree = inlineNestedProject(projectPath, currentDirectory, originalRoot, visited);
+			for (const [innerKey, innerValue] of Object.entries(innerTree)) resolved[innerKey] = innerValue;
+			continue;
+		}
+		if (key === "$path" && typeof value === "string") {
+			resolved[key] = resolveRootRelativePath(currentDirectory, value, originalRoot);
+			continue;
+		}
+		if (key.startsWith("$") || typeof value !== "object" || Array.isArray(value)) {
+			resolved[key] = value;
+			continue;
+		}
+		resolved[key] = resolveTree(value, currentDirectory, originalRoot, visited);
+	}
+	return resolved;
+}
+//#endregion
 //#region src/types/rojo.ts
 const rojoProjectSchema = type({
 	"name": "string",
@@ -2487,9 +2535,13 @@ function buildSourceMapper(config, tsconfigMappings) {
 	try {
 		const rojoResult = rojoProjectSchema(JSON.parse(fs$1.readFileSync(rojoProjectPath, "utf-8")));
 		if (rojoResult instanceof type.errors) return;
+		const resolvedTree = resolveNestedProjects(rojoResult.tree, path$1.dirname(rojoProjectPath));
 		return createSourceMapper({
 			mappings: tsconfigMappings,
-			rojoProject: rojoResult
+			rojoProject: {
+				...rojoResult,
+				tree: resolvedTree
+			}
 		});
 	} catch {
 		return;
@@ -2567,9 +2619,13 @@ function writeSnapshots(snapshotWrites, config, tsconfigMappings) {
 			process.stderr.write("Warning: Cannot write snapshots - invalid rojo project\n");
 			return;
 		}
+		const resolvedTree = resolveNestedProjects(rojoResult.tree, path$1.dirname(rojoProjectPath));
 		const resolver = createSnapshotPathResolver({
 			mappings: tsconfigMappings,
-			rojoProject: rojoResult
+			rojoProject: {
+				...rojoResult,
+				tree: resolvedTree
+			}
 		});
 		let written = 0;
 		for (const [virtualPath, content] of Object.entries(snapshotWrites)) {
@@ -3027,4 +3083,4 @@ function writeGameOutput(filePath, entries) {
 	fs$1.writeFileSync(absolutePath, JSON.stringify(entries, null, 2));
 }
 //#endregion
-export { generateTestScript as A, resolveConfig as C, createOpenCloudBackend as D, OpenCloudBackend as E, defineProject as F, isValidBackend as I, LuauScriptError as L, ROOT_ONLY_KEYS as M, VALID_BACKENDS as N, hashBuffer as O, defineConfig as P, extractJsonFromOutput as R, loadConfig$1 as S, createStudioBackend as T, formatResult as _, formatAnnotations as a, formatBanner as b, execute as c, findFormatterOptions as d, formatJson as f, formatMultiProjectResult as g, formatFailure as h, runTypecheck as i, DEFAULT_CONFIG as j, buildJestArgv as k, formatExecuteOutput as l, formatCompactMultiProject as m, parseGameOutput as n, formatJobSummary as o, writeJsonFile as p, writeGameOutput as r, resolveGitHubActionsOptions as s, formatGameOutputNotice as t, loadCoverageManifest as u, formatTestSummary as v, StudioBackend as w, rojoProjectSchema as x, formatTypecheckSummary as y, parseJestOutput as z };
+export { hashBuffer as A, extractJsonFromOutput as B, resolveNestedProjects as C, createStudioBackend as D, StudioBackend as E, VALID_BACKENDS as F, defineConfig as I, defineProject as L, generateTestScript as M, DEFAULT_CONFIG as N, OpenCloudBackend as O, ROOT_ONLY_KEYS as P, isValidBackend as R, collectPaths as S, resolveConfig as T, parseJestOutput as V, formatResult as _, formatAnnotations as a, formatBanner as b, execute as c, findFormatterOptions as d, formatJson as f, formatMultiProjectResult as g, formatFailure as h, runTypecheck as i, buildJestArgv as j, createOpenCloudBackend as k, formatExecuteOutput as l, formatCompactMultiProject as m, parseGameOutput as n, formatJobSummary as o, writeJsonFile as p, writeGameOutput as r, resolveGitHubActionsOptions as s, formatGameOutputNotice as t, loadCoverageManifest as u, formatTestSummary as v, loadConfig$1 as w, rojoProjectSchema as x, formatTypecheckSummary as y, LuauScriptError as z };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { A as defineConfig, C as FormatterEntry, D as ROOT_ONLY_KEYS, E as ProjectTestConfig, M as Argv, O as ResolvedConfig, S as DisplayName, T as ProjectEntry, _ as ResolvedProjectConfig, a as formatExecuteOutput, b as ConfigInput, c as Backend, d as extractJsonFromOutput, f as parseJestOutput, g as TestStatus, h as TestFileResult, i as execute, j as defineProject, k as SnapshotFormatOptions, l as BackendOptions, m as TestCaseResult, n as ExecuteResult, o as TimingResult, p as JestResult, r as FormatOutputOptions, s as SourceMapper, t as ExecuteOptions, u as BackendResult, v as CliOptions, w as InlineProjectConfig, x as DEFAULT_CONFIG, y as Config } from "./executor-DqZE3wME.mjs";
+import { A as defineConfig, C as FormatterEntry, D as ROOT_ONLY_KEYS, E as ProjectTestConfig, M as Argv, O as ResolvedConfig, S as DisplayName, T as ProjectEntry, _ as ResolvedProjectConfig, a as formatExecuteOutput, b as ConfigInput, c as Backend, d as extractJsonFromOutput, f as parseJestOutput, g as TestStatus, h as TestFileResult, i as execute, j as defineProject, k as SnapshotFormatOptions, l as BackendOptions, m as TestCaseResult, n as ExecuteResult, o as TimingResult, p as JestResult, r as FormatOutputOptions, s as SourceMapper, t as ExecuteOptions, u as BackendResult, v as CliOptions, w as InlineProjectConfig, x as DEFAULT_CONFIG, y as Config } from "./executor-D6BzDfQ_.mjs";
 import { WebSocket, WebSocketServer } from "ws";
 import buffer from "node:buffer";
 

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { A as generateTestScript, C as resolveConfig, D as createOpenCloudBackend, E as OpenCloudBackend, F as defineProject, M as ROOT_ONLY_KEYS, P as defineConfig, R as extractJsonFromOutput, S as loadConfig, T as createStudioBackend, _ as formatResult, a as formatAnnotations, c as execute, f as formatJson, h as formatFailure, i as runTypecheck, j as DEFAULT_CONFIG, k as buildJestArgv, l as formatExecuteOutput, n as parseGameOutput, o as formatJobSummary, p as writeJsonFile, r as writeGameOutput, t as formatGameOutputNotice, v as formatTestSummary, w as StudioBackend, z as parseJestOutput } from "./game-output-BMGxhjkE.mjs";
+import { B as extractJsonFromOutput, D as createStudioBackend, E as StudioBackend, I as defineConfig, L as defineProject, M as generateTestScript, N as DEFAULT_CONFIG, O as OpenCloudBackend, P as ROOT_ONLY_KEYS, T as resolveConfig, V as parseJestOutput, _ as formatResult, a as formatAnnotations, c as execute, f as formatJson, h as formatFailure, i as runTypecheck, j as buildJestArgv, k as createOpenCloudBackend, l as formatExecuteOutput, n as parseGameOutput, o as formatJobSummary, p as writeJsonFile, r as writeGameOutput, t as formatGameOutputNotice, v as formatTestSummary, w as loadConfig } from "./game-output-BU-9pJ93.mjs";
 export { DEFAULT_CONFIG, OpenCloudBackend, ROOT_ONLY_KEYS, StudioBackend, buildJestArgv, createOpenCloudBackend, createStudioBackend, defineConfig, defineProject, execute, extractJsonFromOutput, formatAnnotations, formatExecuteOutput, formatFailure, formatGameOutputNotice, formatJobSummary, formatJson, formatResult, formatTestSummary, generateTestScript, loadConfig, parseGameOutput, parseJestOutput, resolveConfig, runTypecheck, writeGameOutput, writeJsonFile };

package/dist/sea-entry.cjs

@@ -7640,7 +7640,7 @@ function f$9() {
 var C$5 = f$9();
 //#endregion
 //#region package.json
-var version = "0.1.2";
+var version = "0.1.3";
 //#endregion
 //#region node_modules/.pnpm/ws@8.18.0/node_modules/ws/lib/stream.js
 var require_stream = /* @__PURE__ */ __commonJSMin(((exports, module) => {
@@ -11358,7 +11358,7 @@ function normalizeString(path, allowAboveRoot) {
 	}
 	return res;
 }
-var _DRIVE_LETTER_START_RE, _UNC_REGEX, _IS_ABSOLUTE_RE, _DRIVE_LETTER_RE, _ROOT_FOLDER_RE, _EXTNAME_RE, normalize, join$2, resolve$2, isAbsolute$1, extname$2, relative, dirname$1, basename;
+var _DRIVE_LETTER_START_RE, _UNC_REGEX, _IS_ABSOLUTE_RE, _DRIVE_LETTER_RE, _ROOT_FOLDER_RE, _EXTNAME_RE, normalize, join$2, resolve$2, isAbsolute$1, extname$2, relative$1, dirname$1, basename;
 var init_pathe_M_eThtNZ = __esmMin((() => {
 	_DRIVE_LETTER_START_RE = /^[A-Za-z]:\//;
 	_UNC_REGEX = /^[/\\]{2}/;
@@ -11420,7 +11420,7 @@ var init_pathe_M_eThtNZ = __esmMin((() => {
 		const match = _EXTNAME_RE.exec(normalizeWindowsPath$1(p));
 		return match && match[1] || "";
 	};
-	relative = function(from, to) {
+	relative$1 = function(from, to) {
 		const _from = resolve$2(from).replace(_ROOT_FOLDER_RE, "$1").split("/");
 		const _to = resolve$2(to).replace(_ROOT_FOLDER_RE, "$1").split("/");
 		if (_to[0][1] === ":" && _from[0][1] === ":" && _from[0] !== _to[0]) return _to.join("/");
@@ -35720,7 +35720,7 @@ function currentShell() {
 function startShell(cwd) {
 	cwd = resolve$2(cwd);
 	const shell = currentShell();
-	console.info(`(experimental) Opening shell in ${relative(process.cwd(), cwd)}...`);
+	console.info(`(experimental) Opening shell in ${relative$1(process.cwd(), cwd)}...`);
 	(0, node_child_process.spawnSync)(shell, [], {
 		cwd,
 		shell: true,
@@ -41031,6 +41031,7 @@ const DEFAULT_CONFIG = {
 		"**/rbxts_include/**"
 	],
 	coverageReporters: ["text", "lcov"],
+	passWithNoTests: false,
 	placeFile: "./game.rbxl",
 	pollInterval: 500,
 	port: 3001,
@@ -41149,6 +41150,7 @@ const configSchema = type({
 	"maxWorkers?": type("number").or(type("string")),
 	"noStackTrace?": "boolean",
 	"outputFile?": "string",
+	"passWithNoTests?": "boolean",
 	"placeFile?": "string",
 	"pollInterval?": "number",
 	"port?": "number",
@@ -41703,39 +41705,141 @@ function stripTsExtension(pattern) {
 //#endregion
 //#region src/utils/rojo-tree.ts
 function resolveNestedProjects(tree, rootDirectory) {
-	return resolveTree(tree, rootDirectory, /* @__PURE__ */ new Set());
+	return resolveTree(tree, rootDirectory, rootDirectory, /* @__PURE__ */ new Set());
 }
 function collectPaths(node, result) {
 	for (const [key, value] of Object.entries(node)) if (key === "$path" && typeof value === "string") result.push(value.replaceAll("\\", "/"));
 	else if (typeof value === "object" && !Array.isArray(value) && !key.startsWith("$")) collectPaths(value, result);
 }
-function resolveTree(node, rootDirectory, visited) {
+function inlineNestedProject(projectPath, currentDirectory, originalRoot, visited) {
+	const chain = new Set(visited);
+	chain.add(projectPath);
+	let content;
+	try {
+		content = (0, node_fs.readFileSync)(projectPath, "utf-8");
+	} catch (err) {
+		const relativePath = (0, node_path.relative)(currentDirectory, projectPath);
+		throw new Error(`Could not read nested Rojo project: ${relativePath}`, { cause: err });
+	}
+	return resolveTree(JSON.parse(content).tree, (0, node_path.dirname)(projectPath), originalRoot, chain);
+}
+function resolveRootRelativePath(currentDirectory, value, originalRoot) {
+	return (0, node_path.relative)(originalRoot, (0, node_path.join)(currentDirectory, value)).replaceAll("\\", "/");
+}
+function resolveTree(node, currentDirectory, originalRoot, visited) {
 	const resolved = {};
 	for (const [key, value] of Object.entries(node)) {
 		if (key === "$path" && typeof value === "string" && value.endsWith(".project.json")) {
-			const projectPath = (0, node_path.join)(rootDirectory, value);
+			const projectPath = (0, node_path.join)(currentDirectory, value);
 			if (visited.has(projectPath)) throw new Error(`Circular project reference: ${value}`);
-			const chain = new Set(visited);
-			chain.add(projectPath);
-			let content;
-			try {
-				content = (0, node_fs.readFileSync)(projectPath, "utf-8");
-			} catch (err) {
-				throw new Error(`Could not read nested Rojo project: ${value}`, { cause: err });
-			}
-			const innerTree = resolveTree(JSON.parse(content).tree, (0, node_path.dirname)(projectPath), chain);
+			const innerTree = inlineNestedProject(projectPath, currentDirectory, originalRoot, visited);
 			for (const [innerKey, innerValue] of Object.entries(innerTree)) resolved[innerKey] = innerValue;
 			continue;
 		}
+		if (key === "$path" && typeof value === "string") {
+			resolved[key] = resolveRootRelativePath(currentDirectory, value, originalRoot);
+			continue;
+		}
 		if (key.startsWith("$") || typeof value !== "object" || Array.isArray(value)) {
 			resolved[key] = value;
 			continue;
 		}
-		resolved[key] = resolveTree(value, rootDirectory, visited);
+		resolved[key] = resolveTree(value, currentDirectory, originalRoot, visited);
 	}
 	return resolved;
 }
 //#endregion
+//#region src/luau/eval-literals.ts
+/**
+* Evaluate the first return expression in a Lute-stripped AST root block,
+* supporting only literal values (string, boolean, number, nil, table, cast).
+*
+* Accepts `unknown` and narrows safely — no type casts on JSON.parse needed.
+*/
+function evalLuauReturnLiterals(root) {
+	if (!isObject(root) || !Array.isArray(root["statements"])) throw new Error("Config file has no return statement");
+	const returnStat = root["statements"].find((stat) => isObject(stat) && stat["tag"] === "return");
+	if (!isObject(returnStat) || !Array.isArray(returnStat["expressions"])) throw new Error("Config file has no return statement");
+	const first = returnStat["expressions"][0];
+	if (!isObject(first) || !("node" in first)) throw new Error("Return statement has no expressions");
+	return evalExpr(first["node"]);
+}
+function isObject(value) {
+	return typeof value === "object" && value !== null;
+}
+function evalExpr(node) {
+	if (!isObject(node)) return;
+	let current = node;
+	while (current["tag"] === "cast" && isObject(current["operand"])) current = current["operand"];
+	const { tag } = current;
+	if (tag === "boolean" || tag === "number") return current["value"];
+	if (tag === "string") return current["text"];
+	if (tag === "table" && Array.isArray(current["entries"])) return evalTable(current["entries"]);
+}
+function evalTable(entries) {
+	if (entries.length === 0) return {};
+	const first = entries[0];
+	if (isObject(first) && first["kind"] === "list") return entries.map((entry) => isObject(entry) ? evalExpr(entry["value"]) : void 0);
+	const result = {};
+	for (const entry of entries) {
+		if (!isObject(entry) || entry["kind"] !== "record") continue;
+		const { key, value } = entry;
+		if (isObject(key) && typeof key["text"] === "string") result[key["text"]] = evalExpr(value);
+	}
+	return result;
+}
+//#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\nlocal files: { string } = {}\ndiscoverFiles(luauRoot, luauRoot, files)\n\n-- Parse, strip, and write per-file AST JSON\nfor _, relativePath in files do\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;
+/**
+* Parse a .luau config file via Lute and evaluate its return expression.
+*/
+function loadLuauConfig(filePath) {
+	const temporaryDirectory = getTemporaryDirectory$1();
+	const scriptPath = node_path.join(temporaryDirectory, "parse-ast.luau");
+	node_fs.writeFileSync(scriptPath, parse_ast_default);
+	let stdout;
+	try {
+		stdout = node_child_process.execFileSync("lute", [
+			"run",
+			scriptPath,
+			"--",
+			node_path.resolve(filePath)
+		], {
+			encoding: "utf-8",
+			maxBuffer: 1024 * 1024
+		});
+	} catch (err) {
+		if (err instanceof Error && "code" in err && err.code === "ENOENT") throw new Error("lute is required to load .luau config files but was not found on PATH");
+		throw new Error(`Failed to evaluate Luau config ${filePath}`, { cause: err });
+	}
+	let ast;
+	try {
+		ast = JSON.parse(stdout);
+	} catch (err) {
+		throw new Error(`Failed to parse AST JSON from Luau config ${filePath}`, { cause: err });
+	}
+	const result = evalLuauReturnLiterals(ast);
+	if (typeof result !== "object" || result === null) throw new Error(`Luau config ${filePath} must return a table`);
+	return result;
+}
+/**
+* Check if `<cwd>/<directoryOrFile>/jest.config.luau` exists. Returns the
+* resolved path if found, undefined otherwise.
+*/
+function findLuauConfigFile(directoryOrFile, cwd) {
+	const resolved = node_path.resolve(cwd, directoryOrFile, "jest.config.luau");
+	if (node_fs.existsSync(resolved)) return resolved;
+}
+function getTemporaryDirectory$1() {
+	if (cachedTemporaryDirectory$1 !== void 0 && node_fs.existsSync(cachedTemporaryDirectory$1)) return cachedTemporaryDirectory$1;
+	cachedTemporaryDirectory$1 = node_fs.mkdtempSync(node_path.join(node_os.tmpdir(), "jest-roblox-luau-config-"));
+	return cachedTemporaryDirectory$1;
+}
+//#endregion
 //#region src/config/projects.ts
 function extractStaticRoot(pattern) {
 	const globChars = new Set([
@@ -41835,6 +41939,8 @@ function resolveProjectConfig(project, rootConfig, rojoTree) {
 	};
 }
 async function loadProjectConfigFile(filePath, cwd) {
+	const luauConfigPath = findLuauConfigFile(filePath, cwd);
+	if (luauConfigPath !== void 0) return buildProjectConfigFromLuau(luauConfigPath, filePath);
 	let result;
 	try {
 		result = await loadConfig$1({
@@ -41876,6 +41982,38 @@ function mergeProjectConfig(rootConfig, project) {
 	for (const [key, value] of Object.entries(project)) if (!PROJECT_ONLY_KEYS.has(key) && value !== void 0) merged[key] = value;
 	return merged;
 }
+const LUAU_BOOLEAN_KEYS = [
+	"automock",
+	"clearMocks",
+	"injectGlobals",
+	"mockDataModel",
+	"resetMocks",
+	"resetModules",
+	"restoreMocks"
+];
+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) => node_path.posix.join(directoryPath, `${pattern}.luau`)) : [node_path.posix.join(directoryPath, "**/*.spec.luau")]
+	};
+	if (testMatch !== void 0) config.testMatch = testMatch;
+	copyLuauOptionalFields(raw, config);
+	return config;
+}
 function matchNodePath(childNode, targetPath, childDataModelPath) {
 	const nodePath = childNode.$path;
 	if (typeof nodePath !== "string") return;
@@ -49913,6 +50051,8 @@ function serializeToLuau(config) {
 }
 function generateProjectConfigs(projects) {
 	for (const project of projects) {
+		const luauConfigPath = project.outputPath.replace(/\.lua$/, ".luau");
+		if (node_fs.default.existsSync(luauConfigPath)) continue;
 		const content = serializeToLuau(project.config);
 		const directory = node_path.default.dirname(project.outputPath);
 		node_fs.default.mkdirSync(directory, { recursive: true });
@@ -50452,27 +50592,133 @@ function mapCoverageToTypeScript(coverageData, manifest) {
 		if (record === void 0) continue;
 		const resources = loadFileResources(record);
 		if (resources === void 0) continue;
-		mapFileFunctions(resources, fileCoverage, pendingFunctions, mapFileStatements(resources, fileCoverage, pendingStatements));
-		mapFileBranches(resources, fileCoverage, pendingBranches);
+		if (resources.traceMap === void 0) {
+			passthroughFileStatements(resources, fileCoverage, pendingStatements);
+			passthroughFileFunctions(resources, fileCoverage, pendingFunctions);
+			passthroughFileBranches(resources, fileCoverage, pendingBranches);
+		} else {
+			const mapped = {
+				coverageMap: resources.coverageMap,
+				traceMap: resources.traceMap
+			};
+			mapFileFunctions(mapped, fileCoverage, pendingFunctions, mapFileStatements(mapped, fileCoverage, pendingStatements));
+			mapFileBranches(mapped, fileCoverage, pendingBranches);
+		}
 	}
 	return buildResult(pendingStatements, pendingFunctions, pendingBranches);
 }
 function loadFileResources(record) {
 	let coverageMapRaw;
-	let sourceMapRaw;
 	try {
 		coverageMapRaw = node_fs.readFileSync(record.coverageMapPath, "utf-8");
-		sourceMapRaw = node_fs.readFileSync(record.sourceMapPath, "utf-8");
 	} catch {
 		return;
 	}
 	const parsed = coverageMapSchema(JSON.parse(coverageMapRaw));
 	if (parsed instanceof type.errors) return;
+	let traceMap;
+	try {
+		traceMap = new TraceMap(node_fs.readFileSync(record.sourceMapPath, "utf-8"));
+	} catch {}
 	return {
 		coverageMap: parsed,
-		traceMap: new TraceMap(sourceMapRaw)
+		sourceKey: record.key,
+		traceMap
 	};
 }
+function toIstanbulColumn(luauColumn) {
+	return Math.max(0, luauColumn - 1);
+}
+function passthroughFileStatements(resources, fileCoverage, pending) {
+	let fileStatements = pending.get(resources.sourceKey);
+	if (fileStatements === void 0) {
+		fileStatements = /* @__PURE__ */ new Map();
+		pending.set(resources.sourceKey, fileStatements);
+	}
+	for (const [statementId, rawSpan] of Object.entries(resources.coverageMap.statementMap)) {
+		const span = spanSchema(rawSpan);
+		if (span instanceof type.errors) continue;
+		const hitCount = fileCoverage.s[statementId] ?? 0;
+		fileStatements.set(statementId, {
+			end: {
+				column: toIstanbulColumn(span.end.column),
+				line: span.end.line
+			},
+			hitCount,
+			start: {
+				column: toIstanbulColumn(span.start.column),
+				line: span.start.line
+			}
+		});
+	}
+}
+function passthroughFileFunctions(resources, fileCoverage, pendingFunctions) {
+	if (resources.coverageMap.functionMap === void 0) return;
+	let fileFunctions = pendingFunctions.get(resources.sourceKey);
+	if (fileFunctions === void 0) {
+		fileFunctions = [];
+		pendingFunctions.set(resources.sourceKey, fileFunctions);
+	}
+	for (const [functionId, rawEntry] of Object.entries(resources.coverageMap.functionMap)) {
+		const entry = functionEntrySchema(rawEntry);
+		if (entry instanceof type.errors) continue;
+		fileFunctions.push({
+			name: entry.name,
+			hitCount: fileCoverage.f?.[functionId] ?? 0,
+			loc: {
+				end: {
+					column: toIstanbulColumn(entry.location.end.column),
+					line: entry.location.end.line
+				},
+				start: {
+					column: toIstanbulColumn(entry.location.start.column),
+					line: entry.location.start.line
+				}
+			}
+		});
+	}
+}
+function passthroughFileBranches(resources, fileCoverage, pendingBranches) {
+	if (resources.coverageMap.branchMap === void 0) return;
+	let fileBranches = pendingBranches.get(resources.sourceKey);
+	if (fileBranches === void 0) {
+		fileBranches = [];
+		pendingBranches.set(resources.sourceKey, fileBranches);
+	}
+	for (const [branchId, rawEntry] of Object.entries(resources.coverageMap.branchMap)) {
+		const entry = branchEntrySchema(rawEntry);
+		if (entry instanceof type.errors) continue;
+		const armHitCounts = fileCoverage.b?.[branchId] ?? [];
+		const locations = [];
+		for (const rawLocation of entry.locations) {
+			const location = spanSchema(rawLocation);
+			if (location instanceof type.errors) continue;
+			locations.push({
+				end: {
+					column: toIstanbulColumn(location.end.column),
+					line: location.end.line
+				},
+				start: {
+					column: toIstanbulColumn(location.start.column),
+					line: location.start.line
+				}
+			});
+		}
+		if (locations.length === 0) continue;
+		const firstLocation = locations[0];
+		const lastLocation = locations[locations.length - 1];
+		(0, node_assert.default)(firstLocation !== void 0 && lastLocation !== void 0, "Branch locations must not be empty after filtering");
+		fileBranches.push({
+			armHitCounts: entry.locations.map((_, index) => armHitCounts[index] ?? 0),
+			loc: {
+				end: lastLocation.end,
+				start: firstLocation.start
+			},
+			locations,
+			type: entry.type
+		});
+	}
+}
 function mapStatement(traceMap, span) {
 	const mappedStart = originalPositionFor(traceMap, {
 		column: Math.max(0, span.start.column - 1),
@@ -53219,26 +53465,7 @@ const rojoProjectSchema = type({
 	"tree": "object"
 }).as();
 //#endregion
-//#region src/types/luau-ast.ts
-const INSTRUMENTABLE_STATEMENT_TAGS = new Set([
-	"assign",
-	"break",
-	"compoundassign",
-	"conditional",
-	"continue",
-	"do",
-	"expression",
-	"for",
-	"forin",
-	"function",
-	"local",
-	"localfunction",
-	"repeat",
-	"return",
-	"while"
-]);
-//#endregion
-//#region src/coverage/luau-visitor.ts
+//#region src/luau/visitor.ts
 function visitExpression(expression, visitor) {
 	if (visitor.visitExpr?.(expression) === false) return;
 	const { tag } = expression;
@@ -53509,6 +53736,23 @@ function visitExprInstantiate(node, visitor) {
 }
 //#endregion
 //#region src/coverage/coverage-collector.ts
+const INSTRUMENTABLE_STATEMENT_TAGS = new Set([
+	"assign",
+	"break",
+	"compoundassign",
+	"conditional",
+	"continue",
+	"do",
+	"expression",
+	"for",
+	"forin",
+	"function",
+	"local",
+	"localfunction",
+	"repeat",
+	"return",
+	"while"
+]);
 const END_KEYWORD_LENGTH = 3;
 function collectCoverage(root) {
 	let statementIndex = 1;
@@ -53748,9 +53992,6 @@ function buildCoverageMap$1(result) {
 	};
 }
 //#endregion
-//#region src/coverage/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]\nlocal outputDir = userArgs[2]\nif not luauRoot or not outputDir then\n	error(\"Usage: lute run parse-ast.luau -- <luau-root> <output-dir>\")\nend\n\nluauRoot = string.gsub(luauRoot, \"\\\\\", \"/\")\noutputDir = string.gsub(outputDir, \"\\\\\", \"/\")\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	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	[\"repeat\"] = { \"body\", \"condition\" },\n	[\"return\"] = { \"expressions\" },\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-- 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\nlocal files: { string } = {}\ndiscoverFiles(luauRoot, luauRoot, files)\n\n-- Parse, strip, and write per-file AST JSON\nfor _, relativePath in files do\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/coverage/probe-inserter.ts
 function insertProbes(source, result, fileKey) {
 	const lines = splitLines(source);
@@ -53805,7 +54046,7 @@ function applyProbes(mutableLines, probes) {
 		(0, node_assert.default)(line !== void 0, `Invalid probe line number: ${probeLine}`);
 		const before = line.slice(0, column - 1);
 		const after = line.slice(column - 1);
-		mutableLines[lineIndex] = before + text + after;
+		mutableLines[lineIndex] = before + (before.length > 0 && !/\s$/.test(before) && /^[a-zA-Z_]/.test(text) ? " " : "") + text + after;
 	}
 }
 function extractModeDirective(lines) {
@@ -60302,9 +60543,13 @@ function buildSourceMapper(config, tsconfigMappings) {
 	try {
 		const rojoResult = rojoProjectSchema(JSON.parse(node_fs.readFileSync(rojoProjectPath, "utf-8")));
 		if (rojoResult instanceof type.errors) return;
+		const resolvedTree = resolveNestedProjects(rojoResult.tree, node_path.dirname(rojoProjectPath));
 		return createSourceMapper({
 			mappings: tsconfigMappings,
-			rojoProject: rojoResult
+			rojoProject: {
+				...rojoResult,
+				tree: resolvedTree
+			}
 		});
 	} catch {
 		return;
@@ -60382,9 +60627,13 @@ function writeSnapshots(snapshotWrites, config, tsconfigMappings) {
 			node_process.default.stderr.write("Warning: Cannot write snapshots - invalid rojo project\n");
 			return;
 		}
+		const resolvedTree = resolveNestedProjects(rojoResult.tree, node_path.dirname(rojoProjectPath));
 		const resolver = createSnapshotPathResolver({
 			mappings: tsconfigMappings,
-			rojoProject: rojoResult
+			rojoProject: {
+				...rojoResult,
+				tree: resolvedTree
+			}
 		});
 		let written = 0;
 		for (const [virtualPath, content] of Object.entries(snapshotWrites)) {
@@ -60886,6 +61135,7 @@ Options:
   --gameOutput <path>               Write game output (print/warn/error) to file
   --sourceMap                       Map Luau stack traces to TypeScript source
   --rojoProject <path>              Path to rojo project file (auto-detected if not set)
+  --passWithNoTests                 Exit with 0 when no test files are found
   --verbose                         Show individual test results
   --silent                          Suppress output
   --no-color                        Disable colored output
@@ -60947,6 +61197,7 @@ function parseArgs(args) {
 			"no-color": { type: "boolean" },
 			"no-show-luau": { type: "boolean" },
 			"outputFile": { type: "string" },
+			"passWithNoTests": { type: "boolean" },
 			"pollInterval": { type: "string" },
 			"port": { type: "string" },
 			"project": {
@@ -61002,6 +61253,7 @@ function parseArgs(args) {
 		gameOutput: values.gameOutput,
 		help: values.help,
 		outputFile: values.outputFile,
+		passWithNoTests: values.passWithNoTests,
 		pollInterval,
 		port,
 		project: values.project,
@@ -61443,6 +61695,7 @@ async function runMultiProject(cli, rootConfig, projectEntries) {
 		tsconfig: rootConfig.typecheckTsconfig
 	}) : void 0;
 	if (projectResults.length === 0 && typecheckResult === void 0) {
+		if (rootConfig.passWithNoTests) return 0;
 		console.error("No test files found in any project");
 		return 2;
 	}
@@ -61471,12 +61724,14 @@ async function runSingleProject(config, cliFiles) {
 	resolveSetupFilePaths(config);
 	const discovery = discoverTestFiles(config, cliFiles);
 	if (discovery.files.length === 0) {
+		if (config.passWithNoTests) return 0;
 		console.error("No test files found");
 		return 2;
 	}
 	const typeTestFiles = config.typecheck ? discovery.files.filter((file) => TYPE_TEST_PATTERN.test(file)) : [];
 	const runtimeTestFiles = config.typecheckOnly ? [] : discovery.files.filter((file) => !TYPE_TEST_PATTERN.test(file));
 	if (typeTestFiles.length === 0 && runtimeTestFiles.length === 0) {
+		if (config.passWithNoTests) return 0;
 		console.error("No test files found for the selected mode");
 		return 2;
 	}
@@ -61588,6 +61843,7 @@ function mergeCliWithConfig(cli, config) {
 		formatters: resolveFormatters(cli, config),
 		gameOutput: cli.gameOutput ?? config.gameOutput,
 		outputFile: cli.outputFile ?? config.outputFile,
+		passWithNoTests: cli.passWithNoTests ?? config.passWithNoTests,
 		pollInterval: cli.pollInterval ?? config.pollInterval,
 		port: cli.port ?? config.port,
 		rojoProject: cli.rojoProject ?? config.rojoProject,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isentinel/jest-roblox",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Jest-compatible CLI for running roblox-ts tests via Roblox Open Cloud",
   "keywords": [
     "jest",
@@ -60,7 +60,7 @@
     "@isentinel/tsconfig": "1.2.0",
     "@oxc-project/types": "0.120.0",
     "@rbxts/jest": "3.13.3-ts.1",
-    "@rbxts/types": "1.0.911",
+    "@rbxts/types": "1.0.912",
     "@total-typescript/shoehorn": "0.1.2",
     "@tsdown/exe": "0.21.4",
     "@types/istanbul-lib-coverage": "2.0.6",