@isentinel/jest-roblox 0.0.3 → 0.0.4

package/dist/{game-output--EpqHGEr.mjs → game-output-DO5fOpW3.mjs}

@@ -10,9 +10,13 @@ import * as crypto from "node:crypto";
 import { randomUUID } from "node:crypto";
 import buffer from "node:buffer";
 import { createJiti } from "jiti";
+import { getTsconfig } from "get-tsconfig";
+import { TraceMap, originalPositionFor, sourceContentFor } from "@jridgewell/trace-mapping";
 import color from "tinyrainbow";
 import hljs from "highlight.js/lib/core";
 import typescript from "highlight.js/lib/languages/typescript";
+import { execSync } from "node:child_process";
+import { Visitor, parseSync } from "oxc-parser";
 
 //#region src/reporter/parser.ts
 const TASK_SCRIPT_PREFIX = /^TaskScript:\d+:\s*/;
@@ -86,6 +90,14 @@ function countBraces(line) {
 	}
 	return count;
 }
+function isValidJson(text) {
+	try {
+		JSON.parse(text);
+		return true;
+	} catch {
+		return false;
+	}
+}
 function extractExecutionError(object) {
 	let current = object;
 	while (current["parent"] !== void 0 && typeof current["parent"] === "object") current = current["parent"];
@@ -105,16 +117,13 @@ function extractSnapshotWrites(parsed) {
 	for (const [key, value] of Object.entries(writes)) if (typeof value === "string") record[key] = value;
 	return Object.keys(record).length > 0 ? record : void 0;
 }
-function isValidJson(text) {
-	try {
-		JSON.parse(text);
-		return true;
-	} catch {
-		return false;
-	}
+function stringifyError(err) {
+	if (typeof err === "string") return err;
+	if (typeof err === "object" && err !== null && "message" in err && typeof err.message === "string") return err.message;
+	return JSON.stringify(err) ?? String(err);
 }
 function unwrapResult(parsed) {
-	if ("err" in parsed && parsed["success"] === false) throw new LuauScriptError(String(parsed["err"]));
+	if ("err" in parsed && parsed["success"] === false) throw new LuauScriptError(stringifyError(parsed["err"]));
 	if ("value" in parsed && parsed["success"] === true) return parsed["value"];
 	return parsed;
 }
@@ -125,8 +134,8 @@ function validateJestResult(value) {
 }
 
 //#endregion
-//#region src/test-runner.luau
-var test_runner_default = "local HttpService = game:GetService(\"HttpService\")\nlocal LogService = game:GetService(\"LogService\")\nlocal ReplicatedStorage = game:GetService(\"ReplicatedStorage\")\n\nlocal t0 = os.clock()\nlocal baseConfig = HttpService:JSONDecode([[__CONFIG_JSON__]])\nlocal t_configDecode = os.clock()\n\ntype Config = {\n	jestPath: string?,\n	projects: { string }?,\n	setupFiles: { string }?,\n	setupFilesAfterEnv: { string }?,\n	_timing: boolean?,\n}\n\nlocal function fail(err: string)\n	return {\n		success = false,\n		err = err,\n	}\nend\n\nlocal config = table.clone(baseConfig) :: Config\nlocal timingEnabled = config._timing\n\nlocal function findInstance(path: string, class: string?): Instance\n	local parts = string.split(path, \"/\")\n\n	local result, current: Instance? = pcall(function()\n		return game:FindService(parts[1])\n	end)\n	assert(result, `Failed to find service {parts[1]}: {current}`)\n\n	for i = 2, #parts do\n		assert(current, `Failed to find instance at {parts[i]}`)\n		current = current:FindFirstChild(parts[i])\n	end\n\n	assert(current, `Failed to find instance at path {path}: {current}`)\n\n	return current\nend\n\nlocal function getJest(): ModuleScript\n	local jestPath = config.jestPath\n	if jestPath then\n		local instance = findInstance(jestPath)\n		assert(instance, `Failed to find Jest instance at path ${jestPath}`)\n		assert(instance:IsA(\"ModuleScript\"), `Instance at path ${jestPath} is not a ModuleScript`)\n		return instance\n	end\n\n	local jestInstance = ReplicatedStorage:FindFirstChild(\"Jest\", true)\n	assert(jestInstance, \"Failed to find Jest instance in ReplicatedStorage\")\n	assert(\n		jestInstance:IsA(\"ModuleScript\"),\n		\"Jest instance in ReplicatedStorage is not a ModuleScript\"\n	)\n	return jestInstance\nend\n\nlocal t_findJest0 = os.clock()\nlocal findSuccess, findValue = pcall(getJest)\nlocal t_findJest = os.clock()\n\nif not findSuccess then\n	local logSuccess, logHistory = pcall(function()\n		return HttpService:JSONEncode(LogService:GetLogHistory())\n	end)\n\n	return HttpService:JSONEncode(fail(findValue :: any)), if logSuccess then logHistory else \"[]\"\nend\n\nLogService:ClearOutput()\n\n-- Snapshot support: patch jest-roblox-shared before requiring Jest\nlocal snapshotWrites: { [string]: string } = {}\n\nlocal function getInstancePath(instance: Instance): string\n	local parts = {} :: { string }\n	local curr: Instance? = instance\n	while curr and curr ~= game do\n		table.insert(parts, 1, curr.Name)\n		curr = curr.Parent\n	end\n\n	return table.concat(parts, \"/\")\nend\n\nlocal mockFileSystemService = {\n	WriteFile = function(self: any, path: string, contents: string)\n		-- Rewrite .snap.lua → .snap.luau\n		snapshotWrites[string.gsub(path, \"%.snap%.lua$\", \".snap.luau\")] = contents\n	end,\n	CreateDirectories = function(self: any, _path: string) end,\n	Exists = function(self: any, path: string): boolean\n		return snapshotWrites[string.gsub(path, \"%.snap%.lua$\", \".snap.luau\")] ~= nil\n	end,\n	Remove = function(self: any, path: string)\n		snapshotWrites[string.gsub(path, \"%.snap%.lua$\", \".snap.luau\")] = nil\n	end,\n	IsRegularFile = function(self: any, path: string): boolean\n		return snapshotWrites[string.gsub(path, \"%.snap%.lua$\", \".snap.luau\")] ~= nil\n	end,\n}\n\nlocal mockCoreScriptSyncService = {}\nfunction mockCoreScriptSyncService:GetScriptFilePath(script_: Instance): string\n	return getInstancePath(script_)\nend\n\n-- Use _G so the mock survives across Jest's separate module loader context.\n-- Requires getDataModelService.lua to be patched (jest-roblox patch).\n_G.__mockGetDataModelService = function(service: string): any\n	if service == \"FileSystemService\" then\n		return mockFileSystemService\n	elseif service == \"CoreScriptSyncService\" then\n		return mockCoreScriptSyncService\n	end\n\n	local success, result = pcall(function()\n		local svc = game:GetService(service)\n		local _ = svc.Name\n		return svc\n	end)\n\n	return if success then result else nil\nend\n\nlocal t_requireJest0 = os.clock()\nlocal Jest = (require :: any)(findValue)\nlocal t_requireJest = os.clock()\n\nlocal function runTests()\n	local t_resolveProjects0 = os.clock()\n	local projects = {}\n\n	assert(\n		config.projects and #config.projects > 0,\n		\"No projects configured. Set 'projects' in jest.config.ts or pass --projects.\"\n	)\n\n	for _, projectPath in config.projects do\n		table.insert(projects, findInstance(projectPath))\n	end\n\n	config.projects = {}\n	local t_resolveProjects = os.clock()\n\n	local t_resolveSetupFiles0 = os.clock()\n	if config.setupFiles and #config.setupFiles > 0 then\n		local resolved = {}\n\n		for _, setupPath in config.setupFiles do\n			table.insert(resolved, findInstance(setupPath))\n		end\n\n		config.setupFiles = resolved :: any\n	end\n	if config.setupFilesAfterEnv and #config.setupFilesAfterEnv > 0 then\n		local resolved = {}\n\n		for _, setupPath in config.setupFilesAfterEnv do\n			table.insert(resolved, findInstance(setupPath))\n		end\n\n		config.setupFilesAfterEnv = resolved :: any\n	end\n	local t_resolveSetupFiles = os.clock()\n\n	config._timing = nil :: any\n\n	local t_jestRunCLI0 = os.clock()\n	local jestResult = Jest.runCLI(script, config, projects):expect()\n	local t_jestRunCLI = os.clock()\n\n	local result: { [string]: any } = {\n		success = true,\n		value = jestResult,\n	}\n\n	if timingEnabled then\n		result._timing = {\n			configDecode = t_configDecode - t0,\n			findJest = t_findJest - t_findJest0,\n			requireJest = t_requireJest - t_requireJest0,\n			resolveProjects = t_resolveProjects - t_resolveProjects0,\n			resolveSetupFiles = t_resolveSetupFiles - t_resolveSetupFiles0,\n			jestRunCLI = t_jestRunCLI - t_jestRunCLI0,\n		}\n	end\n\n	if next(snapshotWrites) then\n		result._snapshotWrites = snapshotWrites\n	end\n\n	return result\nend\n\nlocal runSuccess, runValue = pcall(runTests)\n\n_G.__mockGetDataModelService = nil\n\nlocal jestResult\nif not runSuccess then\n	jestResult = HttpService:JSONEncode(fail(runValue :: any))\nelse\n	jestResult = HttpService:JSONEncode(runValue)\nend\n\nlocal logSuccess, logHistory = pcall(function()\n	return HttpService:JSONEncode(LogService:GetLogHistory())\nend)\n\nreturn jestResult, if logSuccess then logHistory else \"[]\"\n";
+//#region src/test-runner.bundled.luau
+var test_runner_bundled_default = "type PatchState__DARKLUA_TYPE_a = {\n	robloxSharedExports: any,\n	originalGetDataModelService: any,\n	Runtime: any,\n	originalRequireInternalModule: any,\n}\n\ntype Config__DARKLUA_TYPE_b = {\n	jestPath: string?,\n	projects: { string }?,\n	setupFiles: { string }?,\n	setupFilesAfterEnv: { string }?,\n	_timing: boolean?,\n}\nlocal __JEST_MODULES __JEST_MODULES={cache={}, load=function(m)if not __JEST_MODULES.cache[m]then __JEST_MODULES.cache[m]={c=__JEST_MODULES[m]()}end return __JEST_MODULES.cache[m].c end}do function __JEST_MODULES.a()--!strict\n\nlocal ReplicatedStorage = game:GetService(\"ReplicatedStorage\")\n\nlocal module = {}\n\nfunction module.findInstance(path: string): Instance\n	local parts = string.split(path, \"/\")\n\n	local success, current = pcall(function()\n		return game:FindService(parts[1])\n	end)\n	assert(success, `Failed to find service {parts[1]}: {current}`)\n\n	for i = 2, #parts do\n		assert(current, `Failed to find '{parts[i - 1]}' in path {path}`)\n		current = current:FindFirstChild(parts[i])\n	end\n\n	assert(current, `Failed to find instance at path {path}`)\n\n	return current\nend\n\nfunction module.getJest(config: { jestPath: string? }): ModuleScript\n	local jestPath = config.jestPath\n	if jestPath then\n		local instance = module.findInstance(jestPath)\n		assert(instance, `Failed to find Jest instance at path {jestPath}`)\n		assert(instance:IsA(\"ModuleScript\"), `Instance at path {jestPath} is not a ModuleScript`)\n		return instance :: ModuleScript\n	end\n\n	local jestInstance = ReplicatedStorage:FindFirstChild(\"Jest\", true)\n	assert(jestInstance, \"Failed to find Jest instance in ReplicatedStorage\")\n	assert(\n		jestInstance:IsA(\"ModuleScript\"),\n		\"Jest instance in ReplicatedStorage is not a ModuleScript\"\n	)\n	return jestInstance\nend\n\nfunction module.findRobloxShared(jestModule: ModuleScript): Instance?\n	local parent = jestModule.Parent\n	if parent then\n		local found = parent:FindFirstChild(\"RobloxShared\")\n			or parent:FindFirstChild(\"jest-roblox-shared\")\n		if found then\n			return found\n		end\n\n		if parent.Parent then\n			found = parent.Parent:FindFirstChild(\"RobloxShared\")\n				or parent.Parent:FindFirstChild(\"jest-roblox-shared\")\n			if found then\n				return found\n			end\n		end\n	end\n\n	return game:FindFirstChild(\"RobloxShared\", true)\nend\n\nfunction module.findSiblingPackage(jestModule: ModuleScript, ...: string): Instance?\n	local parent = jestModule.Parent\n	if parent then\n		for _, name in { ... } do\n			local found = parent:FindFirstChild(name)\n			if found then\n				return found\n			end\n		end\n\n		if parent.Parent then\n			for _, name in { ... } do\n				local found = parent.Parent:FindFirstChild(name)\n				if found then\n					return found\n				end\n			end\n		end\n	end\n\n	for _, name in { ... } do\n		local found = game:FindFirstChild(name, true)\n		if found then\n			return found\n		end\n	end\n\n	return nil\nend\n\nreturn module\nend function __JEST_MODULES.b()--!strict\n\nlocal function getInstancePath(instance: Instance): string\n	local parts = {} :: { string }\n	local current: Instance? = instance\n	while current and current ~= game do\n		table.insert(parts, 1, current.Name)\n		current = current.Parent\n	end\n\n	return table.concat(parts, \"/\")\nend\n\nlocal CoreScriptSyncService = {}\n\nfunction CoreScriptSyncService:GetScriptFilePath(instance: Instance): string\n	return getInstancePath(instance)\nend\n\nreturn CoreScriptSyncService\nend function __JEST_MODULES.c()--!strict\n\nlocal function normalizeSnapPath(path: string): string\n	return (string.gsub(path, \"%.snap%.lua$\", \".snap.luau\"))\nend\n\nlocal function create(snapshotWrites: { [string]: string })\n	local FileSystemService = {}\n\n	function FileSystemService:WriteFile(path: string, contents: string)\n		snapshotWrites[normalizeSnapPath(path)] = contents\n	end\n\n	function FileSystemService:CreateDirectories(_path: string) end\n\n	function FileSystemService:Exists(path: string): boolean\n		return snapshotWrites[normalizeSnapPath(path)] ~= nil\n	end\n\n	function FileSystemService:Remove(path: string)\n		snapshotWrites[normalizeSnapPath(path)] = nil\n	end\n\n	function FileSystemService:IsRegularFile(path: string): boolean\n		return snapshotWrites[normalizeSnapPath(path)] ~= nil\n	end\n\n	return FileSystemService\nend\n\nreturn create\nend function __JEST_MODULES.d()--!strict\n\nlocal CoreScriptSyncService = __JEST_MODULES.load('b')\nlocal InstanceResolver = __JEST_MODULES.load('a')\n\nlocal module = {}\n\nfunction module.createMockGetDataModelService(snapshotWrites: { [string]: string })\n	local FileSystemService = __JEST_MODULES.load('c')(snapshotWrites)\n\n	return function(service: string): any\n		if service == \"FileSystemService\" then\n			return FileSystemService\n		elseif service == \"CoreScriptSyncService\" then\n			return CoreScriptSyncService\n		end\n\n		local success, result = pcall(function()\n			local service_ = game:GetService(service)\n			local _ = service_.Name\n			return service_\n		end)\n\n		return if success then result else nil\n	end\nend\n\n\n\n\n\n\n\n\nfunction module.patch(jestModule: ModuleScript, snapshotWrites: { [string]: string }): PatchState__DARKLUA_TYPE_a?\n	local mockGetDataModelService = module.createMockGetDataModelService(snapshotWrites)\n\n	local robloxSharedInstance = InstanceResolver.findRobloxShared(jestModule)\n	if not robloxSharedInstance then\n		warn(\"Could not find RobloxShared; snapshot support unavailable\")\n		return nil\n	end\n\n	local robloxSharedExports = (require :: any)(robloxSharedInstance)\n	local originalGetDataModelService = robloxSharedExports.getDataModelService\n	robloxSharedExports.getDataModelService = mockGetDataModelService\n\n	local getDataModelServiceChild = robloxSharedInstance:FindFirstChild(\"getDataModelService\")\n\n	local jestRuntimeModule =\n		InstanceResolver.findSiblingPackage(jestModule, \"JestRuntime\", \"jest-runtime\")\n	if not jestRuntimeModule then\n		warn(\"Could not find JestRuntime; snapshot interception unavailable\")\n		return {\n			robloxSharedExports = robloxSharedExports,\n			originalGetDataModelService = originalGetDataModelService,\n			Runtime = nil,\n			originalRequireInternalModule = nil,\n		}\n	end\n\n	local Runtime = (require :: any)(jestRuntimeModule)\n	local originalRequireInternalModule = Runtime.requireInternalModule\n\n	Runtime.requireInternalModule = function(self: any, from: any, to: any, ...): any\n		local target = if to ~= nil then to else from\n		if\n			getDataModelServiceChild\n			and typeof(target) == \"Instance\"\n			and target == getDataModelServiceChild\n		then\n			return mockGetDataModelService\n		end\n\n		return originalRequireInternalModule(self, from, to, ...)\n	end\n\n	return {\n		robloxSharedExports = robloxSharedExports,\n		originalGetDataModelService = originalGetDataModelService,\n		Runtime = Runtime,\n		originalRequireInternalModule = originalRequireInternalModule,\n	}\nend\n\nfunction module.unpatch(state: PatchState__DARKLUA_TYPE_a?)\n	if not state then\n		return\n	end\n\n	if state.robloxSharedExports and state.originalGetDataModelService then\n		state.robloxSharedExports.getDataModelService = state.originalGetDataModelService\n	end\n\n	if state.Runtime and state.originalRequireInternalModule then\n		state.Runtime.requireInternalModule = state.originalRequireInternalModule\n	end\nend\n\nreturn module\nend function __JEST_MODULES.e()--!strict\n\nlocal HttpService = game:GetService(\"HttpService\")\nlocal LogService = game:GetService(\"LogService\")\n\nlocal InstanceResolver = __JEST_MODULES.load('a')\nlocal SnapshotPatch = __JEST_MODULES.load('d')\n\n\n\n\n\n\n\n\n\nlocal function fail(err: string)\n	return {\n		success = false,\n		err = err,\n	}\nend\n\nlocal module = {}\n\nfunction module.run(callingScript: LuaSourceContainer, config: Config__DARKLUA_TYPE_b): (string, string)\n	local t0 = os.clock()\n	local timingEnabled = config._timing\n\n	local t_findJest0 = os.clock()\n	local findSuccess, findValue = pcall(InstanceResolver.getJest, config)\n	local t_findJest = os.clock()\n\n	if not findSuccess then\n		local logSuccess, logHistory = pcall(function()\n			return HttpService:JSONEncode(LogService:GetLogHistory())\n		end)\n\n		return HttpService:JSONEncode(fail(findValue :: any)),\n			if logSuccess then logHistory else \"[]\"\n	end\n\n	LogService:ClearOutput()\n\n	local snapshotWrites: { [string]: string } = {}\n\n	local t_patchSnapshot0 = os.clock()\n	local patchState = SnapshotPatch.patch(findValue, snapshotWrites)\n	local t_patchSnapshot = os.clock()\n\n	local t_requireJest0 = os.clock()\n	local Jest = (require :: any)(findValue)\n	local t_requireJest = os.clock()\n\n	local function runTests()\n		local t_resolveProjects0 = os.clock()\n		local projects = {}\n\n		assert(\n			config.projects and #config.projects > 0,\n			\"No projects configured. Set 'projects' in jest.config.ts or pass --projects.\"\n		)\n\n		for _, projectPath in config.projects do\n			table.insert(projects, InstanceResolver.findInstance(projectPath))\n		end\n\n		config.projects = {}\n		local t_resolveProjects = os.clock()\n\n		local t_resolveSetupFiles0 = os.clock()\n		if config.setupFiles and #config.setupFiles > 0 then\n			local resolved = {}\n\n			for _, setupPath in config.setupFiles do\n				table.insert(resolved, InstanceResolver.findInstance(setupPath))\n			end\n\n			config.setupFiles = resolved :: any\n		end\n		if config.setupFilesAfterEnv and #config.setupFilesAfterEnv > 0 then\n			local resolved = {}\n\n			for _, setupPath in config.setupFilesAfterEnv do\n				table.insert(resolved, InstanceResolver.findInstance(setupPath))\n			end\n\n			config.setupFilesAfterEnv = resolved :: any\n		end\n		local t_resolveSetupFiles = os.clock()\n\n		config._timing = nil :: any\n\n		local t_jestRunCLI0 = os.clock()\n		local jestResult = Jest.runCLI(callingScript, config, projects):expect()\n		local t_jestRunCLI = os.clock()\n\n		local result: { [string]: any } = {\n			success = true,\n			value = jestResult,\n		}\n\n		if timingEnabled then\n			result._timing = {\n				findJest = t_findJest - t_findJest0,\n				patchSnapshot = t_patchSnapshot - t_patchSnapshot0,\n				requireJest = t_requireJest - t_requireJest0,\n				resolveProjects = t_resolveProjects - t_resolveProjects0,\n				resolveSetupFiles = t_resolveSetupFiles - t_resolveSetupFiles0,\n				jestRunCLI = t_jestRunCLI - t_jestRunCLI0,\n				total = os.clock() - t0,\n			}\n		end\n\n		if next(snapshotWrites) then\n			result._snapshotWrites = snapshotWrites\n		end\n\n		return result\n	end\n\n	local jestDone = false\n	local runSuccess = false\n	local runValue: any = nil\n\n	task.spawn(function()\n		local ok, val = pcall(runTests)\n		jestDone = true\n		runSuccess = ok\n		runValue = val\n	end)\n\n	local infiniteYieldMessage: string? = nil\n	local watchdogConnection = LogService.MessageOut:Connect(\n		function(message: string, messageType: Enum.MessageType)\n			if\n				messageType == Enum.MessageType.MessageWarning\n				and string.find(message, \"Infinite yield possible\")\n				and not infiniteYieldMessage\n			then\n				infiniteYieldMessage = message\n			end\n		end\n	)\n\n	while not jestDone and not infiniteYieldMessage do\n		task.wait(0.1)\n	end\n\n	watchdogConnection:Disconnect()\n\n	if not jestDone and infiniteYieldMessage then\n		runSuccess = false\n		runValue = \"Infinite yield detected, aborting tests: \" .. infiniteYieldMessage\n	end\n\n	SnapshotPatch.unpatch(patchState)\n\n	local jestResult\n	if not runSuccess then\n		jestResult = HttpService:JSONEncode(fail(runValue :: any))\n	else\n		jestResult = HttpService:JSONEncode(runValue)\n	end\n\n	local logSuccess, logHistory = pcall(function()\n		return HttpService:JSONEncode(LogService:GetLogHistory())\n	end)\n\n	return jestResult, if logSuccess then logHistory else \"[]\"\nend\n\nreturn module\nend end--!strict\n\nlocal HttpService = game:GetService(\"HttpService\")\n\nlocal Runner = __JEST_MODULES.load('e')\n\nlocal config = HttpService:JSONDecode([=[__CONFIG_JSON__]=])\n\nreturn Runner.run(script, config)\n";
 
 //#endregion
 //#region src/test-script.ts
@@ -158,7 +167,7 @@ function buildJestArgv(options) {
 }
 function generateTestScript(options) {
 	const config = buildJestArgv(options);
-	return test_runner_default.replace("__CONFIG_JSON__", JSON.stringify(config));
+	return test_runner_bundled_default.replace("__CONFIG_JSON__", () => JSON.stringify(config));
 }
 
 //#endregion
@@ -247,7 +256,11 @@ var OpenCloudBackend = class {
 		this.credentials = credentials;
 		this.http = options?.http ?? createFetchClient({ "x-api-key": credentials.apiKey });
 		this.readFile = options?.readFile ?? ((fp) => fs.readFileSync(fp));
-		this.sleepFn = options?.sleep ?? (async (ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+		this.sleepFn = options?.sleep ?? (async (ms) => {
+			return new Promise((resolve) => {
+				setTimeout(resolve, ms);
+			});
+		});
 	}
 	async runTests(options) {
 		const placeFilePath = path$1.resolve(options.config.rootDir, options.config.placeFile);
@@ -368,24 +381,28 @@ var StudioBackend = class {
 	createServer;
 	port;
 	timeout;
+	preConnected;
 	constructor(options) {
 		this.port = options.port;
 		this.timeout = options.timeout ?? 3e5;
 		this.createServer = options.createServer ?? ((port) => new WebSocketServer({ port }));
+		this.preConnected = options.preConnected;
 	}
 	async runTests(options) {
-		const wss = this.createServer(this.port);
+		const pre = this.preConnected;
+		this.preConnected = void 0;
+		const wss = pre?.server ?? this.createServer(this.port);
 		try {
-			return await this.executeViaPlugin(wss, options);
+			return await this.executeViaPlugin(wss, options, pre?.socket);
 		} finally {
 			wss.close();
 		}
 	}
-	async executeViaPlugin(wss, options) {
+	async executeViaPlugin(wss, options, existingSocket) {
 		const requestId = randomUUID();
 		const config = buildJestArgv(options);
 		const executionStart = Date.now();
-		const message = await this.waitForResult(wss, requestId, config);
+		const message = await this.waitForResult(wss, requestId, config, existingSocket);
 		const executionMs = Date.now() - executionStart;
 		const parsed = parseJestOutput(message.jestOutput);
 		return {
@@ -396,12 +413,12 @@ var StudioBackend = class {
 			timing: { executionMs }
 		};
 	}
-	async waitForResult(wss, requestId, config) {
+	async waitForResult(wss, requestId, config, existingSocket) {
 		return new Promise((resolve, reject) => {
 			const timer = setTimeout(() => {
 				reject(/* @__PURE__ */ new Error("Timed out waiting for Studio plugin connection"));
 			}, this.timeout);
-			wss.on("connection", (ws) => {
+			function attachSocket(ws) {
 				ws.send(JSON.stringify({
 					action: "run_tests",
 					config,
@@ -424,6 +441,10 @@ var StudioBackend = class {
 					clearTimeout(timer);
 					reject(err);
 				});
+			}
+			if (existingSocket) attachSocket(existingSocket);
+			wss.on("connection", (ws) => {
+				attachSocket(ws);
 			});
 			wss.on("error", (err) => {
 				clearTimeout(timer);
@@ -438,6 +459,14 @@ function createStudioBackend(options) {
 
 //#endregion
 //#region src/config/schema.ts
+const VALID_BACKENDS = new Set([
+	"auto",
+	"open-cloud",
+	"studio"
+]);
+function isValidBackend(value) {
+	return VALID_BACKENDS.has(value);
+}
 const DEFAULT_CONFIG = {
 	backend: "auto",
 	cache: true,
@@ -456,10 +485,14 @@ const DEFAULT_CONFIG = {
 		"**/*.spec.ts",
 		"**/*.spec.tsx",
 		"**/*.test.ts",
-		"**/*.test.tsx"
+		"**/*.test.tsx",
+		"**/*.spec-d.ts",
+		"**/*.test-d.ts"
 	],
 	testPathIgnorePatterns: ["/node_modules/", "/dist/"],
 	timeout: 3e5,
+	typecheck: false,
+	typecheckOnly: false,
 	verbose: false
 };
 
@@ -475,76 +508,54 @@ async function findConfigFile(cwd) {
 		if (fs.existsSync(configPath)) return configPath;
 	}
 }
-async function loadConfig(configPath, cwd = process.cwd()) {
-	let config = {};
-	const resolvedPath = configPath ?? await findConfigFile(cwd);
-	if (resolvedPath !== void 0) config = await loadConfigFile(resolvedPath);
-	config.rootDir ??= cwd;
-	return resolveConfig(config);
-}
 async function loadConfigFile(configPath) {
 	const absolutePath = path$1.resolve(configPath);
 	if (!fs.existsSync(absolutePath)) throw new Error(`Config file not found: ${absolutePath}`);
 	return createJiti(import.meta.url).import(absolutePath, { default: true });
 }
 function resolveConfig(config) {
+	if (config.backend !== void 0 && !isValidBackend(config.backend)) {
+		const valid = [...VALID_BACKENDS].join(", ");
+		throw new Error(`Invalid backend "${config.backend}" in config file. Must be one of: ${valid}`);
+	}
 	const defined = Object.fromEntries(Object.entries(config).filter(([, value]) => value !== void 0));
 	return Object.assign({}, DEFAULT_CONFIG, defined);
 }
+async function loadConfig(configPath, cwd = process.cwd()) {
+	let config = {};
+	const resolvedPath = configPath ?? await findConfigFile(cwd);
+	if (resolvedPath !== void 0) config = await loadConfigFile(resolvedPath);
+	config.rootDir ??= cwd;
+	return resolveConfig(config);
+}
+
+//#endregion
+//#region src/utils/normalize-windows-path.ts
+const DRIVE_LETTER_START_REGEX = /^[A-Za-z]:\//;
+function normalizeWindowsPath(input = "") {
+	if (!input) return input;
+	return input.replace(/\\/g, "/").replace(DRIVE_LETTER_START_REGEX, (driveLetterMatch) => driveLetterMatch.toUpperCase());
+}
 
 //#endregion
 //#region src/source-mapper/column-finder.ts
 /**
 * Finds the column position of the failing matcher in an expect() call. Returns
-* 1-indexed column position.
+* 1-indexed column position, or undefined if no expect is found.
 */
 function findExpectationColumn(lineText) {
-	if (!lineText) return 1;
-	const expectIndex = lineText.search(/\bexpect\s*\(/);
-	if (expectIndex === -1) return 1;
+	if (!lineText) return;
+	const expectIndex = lineText.search(/\bexpect\s*[.(]/);
+	if (expectIndex === -1) return;
 	const afterExpect = lineText.slice(expectIndex);
 	const matcherRegex = /[.:]\s*([A-Za-z_$][\w$]*)\s*(?=\()/g;
 	let lastMatcher = null;
 	for (const match of afterExpect.matchAll(matcherRegex)) lastMatcher = match;
 	const matcherName = lastMatcher?.[1];
-	if (lastMatcher === null || matcherName === void 0) return 1;
+	if (lastMatcher === null || matcherName === void 0) return;
 	return expectIndex + (lastMatcher.index + lastMatcher[0].indexOf(matcherName)) + 1;
 }
 
-//#endregion
-//#region src/source-mapper/line-mapper.ts
-function mapLine(luauLineNumber, luauLines, tsLines) {
-	const luauLine = normalize(luauLines[luauLineNumber - 1]);
-	if (luauLine === void 0 || luauLine === "") return;
-	for (const [index, tsLine] of tsLines.entries()) if (normalize(tsLine) === luauLine) return index + 1;
-	const stripped = luauLine.replace(/\s/g, "");
-	for (const [index, tsLine] of tsLines.entries()) {
-		const tsNormalized = normalize(tsLine);
-		if (tsNormalized === void 0 || tsNormalized === "") continue;
-		const tsStripped = tsNormalized.replace(/\s/g, "");
-		if (tsStripped.includes(stripped) || stripped.includes(tsStripped)) return index + 1;
-	}
-	const temporaryPattern = buildTemporaryVariablePattern(luauLine);
-	if (temporaryPattern !== void 0) for (const [index, tsLine] of tsLines.entries()) {
-		const normalized = normalize(tsLine);
-		if (normalized !== void 0 && temporaryPattern.test(normalized)) return index + 1;
-	}
-}
-const TEMP_VAR_RE = /_[a-z]\w*/g;
-function buildTemporaryVariablePattern(line) {
-	const parts = line.split(TEMP_VAR_RE);
-	if (parts.length < 2) return;
-	const pattern = parts.map(escapeRegExp).join(".+?");
-	return new RegExp(`^${pattern}$`);
-}
-function escapeRegExp(text) {
-	return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function normalize(line) {
-	if (line === void 0) return;
-	return line.trim().replace(/;$/, "").replace(/\s+/g, " ").replace(/\(\s+/g, "(").replace(/\s+\)/g, ")").replace(/\.(\w+)\(/g, ":$1(");
-}
-
 //#endregion
 //#region src/source-mapper/path-resolver.ts
 function createPathResolver(rojoProject, config) {
@@ -611,6 +622,34 @@ function parseStack(input) {
 	};
 }
 
+//#endregion
+//#region src/source-mapper/v3-mapper.ts
+const mapCache = /* @__PURE__ */ new Map();
+function getSourceContent(luauPath, source) {
+	const traced = getTraceMap(luauPath);
+	if (traced === void 0) return;
+	return sourceContentFor(traced, source);
+}
+function mapFromSourceMap(luauPath, luauLine, luauColumn = 0) {
+	const traced = getTraceMap(luauPath);
+	if (traced === void 0) return;
+	const result = originalPositionFor(traced, {
+		column: luauColumn,
+		line: luauLine
+	});
+	if (result.line === null) return;
+	return result;
+}
+function getTraceMap(luauPath) {
+	let traced = mapCache.get(luauPath);
+	if (traced !== void 0) return traced;
+	const mapPath = `${luauPath}.map`;
+	if (!fs.existsSync(mapPath)) return;
+	traced = new TraceMap(fs.readFileSync(mapPath, "utf-8"));
+	mapCache.set(luauPath, traced);
+	return traced;
+}
+
 //#endregion
 //#region src/source-mapper/index.ts
 function createSourceMapper(config) {
@@ -622,17 +661,26 @@ function createSourceMapper(config) {
 		const tsPath = pathResolver.resolve(frame.dataModelPath);
 		if (tsPath === void 0) return;
 		const luauPath = tsPath.replace(config.rootDir, config.outDir).replace(/\.ts$/, ".luau");
-		if (!fs.existsSync(luauPath) || !fs.existsSync(tsPath)) return;
-		const luauLines = fs.readFileSync(luauPath, "utf-8").split("\n");
-		const tsLines = fs.readFileSync(tsPath, "utf-8").split("\n");
-		const tsLine = mapLine(frame.line, luauLines, tsLines) ?? frame.line;
+		const v3Result = mapFromSourceMap(luauPath, frame.line, frame.column);
+		if (v3Result !== void 0 && v3Result.source !== null && v3Result.line !== null) {
+			const mapDirectory = path$1.dirname(luauPath);
+			const resolvedTsPath = normalizeWindowsPath(path$1.resolve(mapDirectory, v3Result.source));
+			const tsLine = v3Result.line;
+			const embeddedContent = getSourceContent(luauPath, v3Result.source) ?? void 0;
+			const tsContent = embeddedContent ?? (fs.existsSync(resolvedTsPath) ? fs.readFileSync(resolvedTsPath, "utf-8") : void 0);
+			return {
+				luauPath,
+				mapped: {
+					column: tsContent !== void 0 ? findExpectationColumn(tsContent.split("\n")[tsLine - 1] ?? "") : void 0,
+					line: tsLine,
+					path: resolvedTsPath,
+					sourceContent: embeddedContent
+				}
+			};
+		}
 		return {
 			luauPath,
-			mapped: {
-				column: findExpectationColumn(tsLines[tsLine - 1] ?? ""),
-				line: tsLine,
-				path: tsPath
-			}
+			mapped: void 0
 		};
 	}
 	return {
@@ -661,6 +709,7 @@ function createSourceMapper(config) {
 				locations.push({
 					luauLine: frame.line,
 					luauPath: frameResult.luauPath,
+					sourceContent: frameResult.mapped.sourceContent,
 					tsColumn: frameResult.mapped.column,
 					tsLine: frameResult.mapped.line,
 					tsPath: frameResult.mapped.path
@@ -670,12 +719,17 @@ function createSourceMapper(config) {
 				locations,
 				message: mappedMessage
 			};
+		},
+		resolveTestFilePath(testFilePath) {
+			const dataModelPath = testFilePath.replace(/^\//, "").replaceAll("/", ".");
+			return pathResolver.resolve(dataModelPath);
 		}
 	};
 }
-function getSourceSnippet(filePath, line, context = 2, column) {
-	if (!fs.existsSync(filePath)) return;
-	const allLines = fs.readFileSync(filePath, "utf-8").split("\n");
+function getSourceSnippet({ column, context = 2, filePath, line, sourceContent }) {
+	const content = sourceContent ?? (fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf-8") : void 0);
+	if (content === void 0) return;
+	const allLines = content.split("\n");
 	const startLine = Math.max(1, line - context);
 	const endLine = Math.min(allLines.length, line + context);
 	const lines = [];
@@ -691,6 +745,12 @@ function getSourceSnippet(filePath, line, context = 2, column) {
 	};
 }
 
+//#endregion
+//#region src/types/jest-result.ts
+function hasExecError(file) {
+	return file.failureMessage !== void 0 && file.failureMessage !== "" && file.testResults.length === 0;
+}
+
 //#endregion
 //#region src/highlighter/luau-grammar.ts
 const OPENING_LONG_BRACKET = "\\[=*\\[";
@@ -756,14 +816,6 @@ function luauGrammar(hljs) {
 	};
 }
 
-//#endregion
-//#region src/utils/normalize-windows-path.ts
-const DRIVE_LETTER_START_REGEX = /^[A-Za-z]:\//;
-function normalizeWindowsPath(input = "") {
-	if (!input) return input;
-	return input.replace(/\\/g, "/").replace(DRIVE_LETTER_START_REGEX, (driveLetterMatch) => driveLetterMatch.toUpperCase());
-}
-
 //#endregion
 //#region src/utils/colors.ts
 hljs.registerLanguage("luau", luauGrammar);
@@ -832,51 +884,59 @@ function highlightTypeScript(source) {
 //#region src/formatters/formatter.ts
 function formatFailedTestsHeader(failCount, styles) {
 	const st = styles ?? createStyles(true);
-	const line = "⎯".repeat(7);
-	const badge = st.failBadge(` Failed Tests ${failCount} `);
-	return `${st.status.fail(line)} ${badge} ${st.status.fail(line)}`;
+	const badgeText = ` Failed Tests ${failCount} `;
+	const badge = st.failBadge(badgeText);
+	const remaining = getTerminalWidth() - badgeText.length;
+	const leftWidth = Math.max(1, Math.floor(remaining / 2));
+	const rightWidth = Math.max(1, remaining - leftWidth);
+	return `${st.status.fail("⎯".repeat(leftWidth))}${badge}${st.status.fail("⎯".repeat(rightWidth))}`;
 }
-function formatFailure({ failureIndex, filePath, showLuau = false, sourceMapper, styles, test, totalFailures, useColor = true }) {
-	const st = styles ?? createStyles(useColor);
-	const lines = [];
-	const pathParts = filePath !== void 0 ? [filePath] : [];
-	pathParts.push(...test.ancestorTitles, test.title);
-	const testPath = pathParts.join(" > ");
-	lines.push(`${st.failBadge(" FAIL ")} ${st.status.fail(testPath)}`);
-	for (const originalMessage of test.failureMessages) lines.push(...formatFailureMessage(originalMessage, {
-		showLuau,
-		sourceMapper,
-		styles: st,
-		useColor
-	}));
-	if (failureIndex !== void 0 && totalFailures !== void 0) {
-		const separatorLine = "⎯".repeat(24);
-		const counter = `[${failureIndex}/${totalFailures}]`;
-		lines.push("", st.status.fail(`${separatorLine}${counter}⎯`));
+function parseErrorMessage(message) {
+	const lines = message.split("\n");
+	const snapshotHeaderIndex = lines.findIndex((line) => /^- Snapshot\s+- \d+/.test(line));
+	if (snapshotHeaderIndex !== -1) {
+		const diffLines = [];
+		for (let index = snapshotHeaderIndex; index < lines.length; index++) {
+			const line = lines[index];
+			if (line.startsWith("[string ")) break;
+			diffLines.push(line);
+		}
+		return {
+			message: lines[0] ?? message,
+			snapshotDiff: diffLines.join("\n").trimEnd()
+		};
 	}
-	return lines.map((line) => `  ${line}`).join("\n");
+	const expectedMatch = message.match(/Expected\b.*?:\s*(.+)/);
+	const receivedMatch = message.match(/Received\b.*?:\s*(.+)/);
+	return {
+		expected: expectedMatch?.[1],
+		message: lines[0] ?? message,
+		received: receivedMatch?.[1]
+	};
 }
-function formatResult(result, timing, options) {
-	const styles = createStyles(options.color);
-	const lines = [formatRunHeader(options, styles)];
-	for (const file of result.testResults) lines.push(formatFileSummary(file, options, styles));
-	if (result.numFailedTests > 0) {
-		lines.push("", formatFailedTestsHeader(result.numFailedTests, styles));
-		const failureCtx = {
-			currentIndex: 1,
-			totalFailures: result.numFailedTests
-		};
-		for (const file of result.testResults) {
-			const failures = formatFileFailures(file, options, styles, failureCtx);
-			if (failures !== "") lines.push(failures);
+/**
+* Extracts the meaningful error message from a Jest `failureMessage` string.
+* Strips the "● Test suite failed to run" header, Roblox DataModel path chains,
+* and stack trace lines.
+*/
+function cleanExecErrorMessage(raw) {
+	if (raw === "") return "";
+	const lines = raw.split("\n");
+	let contentLine;
+	let pastHeader = false;
+	for (const line of lines) {
+		const trimmed = line.trim();
+		if (trimmed.startsWith("●")) {
+			pastHeader = true;
+			continue;
+		}
+		if (pastHeader && trimmed !== "") {
+			contentLine = trimmed;
+			break;
 		}
 	}
-	lines.push("", formatTestSummary(result, timing, styles));
-	return lines.join("\n");
-}
-function formatRunHeader(options, styles) {
-	const st = styles ?? createStyles(options.color);
-	return `\n${st.runBadge(" RUN ")} ${st.location(`v${options.version}`)} ${st.lineNumber(options.rootDir)}\n`;
+	if (contentLine === void 0) return raw.trim();
+	return contentLine.replace(/^(?:[A-Za-z][\w.@-]*:\d+:\s*)+/, "");
 }
 function formatSourceSnippet(snippet, filePath, options) {
 	const useColor = options?.useColor ?? true;
@@ -891,45 +951,78 @@ function formatSourceSnippet(snippet, filePath, options) {
 	const padding = String(maxLineNumber).length;
 	for (const line of snippet.lines) {
 		const prefix = `${String(line.num).padStart(padding)}|`;
-		const highlighted = highlightSyntax(filePath, line.content, useColor);
+		const highlighted = highlightSyntax(filePath, expandTabs(line.content), useColor);
 		if (line.num === snippet.failureLine) {
 			lines.push(`${indent}${st.lineNumber(prefix)} ${highlighted}`);
 			if (snippet.column !== void 0) {
-				const visualPad = line.content.slice(0, snippet.column - 1).replace(/[^\t]/g, " ");
-				const gutterPad = " ".repeat(padding + 1);
-				lines.push(`${indent}${st.lineNumber("|")} ${gutterPad}${visualPad}${st.status.fail("^")}`);
+				const beforeColumn = expandTabs(line.content.slice(0, snippet.column - 1));
+				const caretGutter = `${" ".repeat(padding)}|`;
+				const gutterPrefix = st.lineNumber(caretGutter);
+				lines.push(`${indent}${gutterPrefix} ${" ".repeat(beforeColumn.length)}${st.status.fail("^")}`);
 			}
 		} else lines.push(`${indent}${st.lineNumber(prefix)} ${highlighted}`);
 	}
 	return lines.join("\n");
 }
+function parseSourceLocation(message) {
+	const match = message.match(/([^\s:]+\.tsx?):(\d+)(?::(\d+))?/);
+	if (match === null) return;
+	return {
+		column: match[3] !== void 0 ? Number.parseInt(match[3], 10) : void 0,
+		line: Number.parseInt(match[2] ?? "", 10),
+		path: match[1] ?? ""
+	};
+}
+function formatFailure({ failureIndex, filePath, showLuau = false, sourceMapper, styles, test, totalFailures, useColor = true }) {
+	const st = styles ?? createStyles(useColor);
+	const lines = [];
+	const pathParts = filePath !== void 0 ? [filePath] : [];
+	pathParts.push(...test.ancestorTitles, test.title);
+	const testPath = pathParts.join(" > ");
+	lines.push("", `${st.failBadge(" FAIL ")} ${st.status.fail(testPath)}`);
+	for (const originalMessage of test.failureMessages) lines.push(...formatFailureMessage(originalMessage, {
+		filePath,
+		showLuau,
+		sourceMapper,
+		styles: st,
+		useColor
+	}));
+	if (failureIndex !== void 0 && totalFailures !== void 0) {
+		const counter = `[${failureIndex}/${totalFailures}]`;
+		const termWidth = getTerminalWidth();
+		const fillWidth = Math.max(1, termWidth - counter.length - 3);
+		lines.push("", st.dim(st.status.fail(`${"⎯".repeat(fillWidth)}${counter}⎯`)));
+	}
+	return lines.map((line) => `  ${line}`).join("\n");
+}
+function formatRunHeader(options, styles) {
+	const st = styles ?? createStyles(options.color);
+	return `\n${st.runBadge(" RUN ")} ${st.location(`v${options.version}`)} ${st.lineNumber(options.rootDir)}\n`;
+}
 function formatTestSummary(result, timing, styles) {
 	const st = styles ?? createStyles(true);
 	const lines = [];
-	const hasFailed = result.numFailedTests > 0;
-	const labelStyle = hasFailed ? st.status.fail : st.dim;
+	const execErrorFiles = result.testResults.filter(hasExecError).length;
 	const totalFiles = result.testResults.length;
-	const failedFiles = result.testResults.filter((fr) => fr.numFailingTests > 0).length;
-	const skippedFiles = result.testResults.filter((fr) => fr.numFailingTests === 0 && fr.numPassingTests === 0).length;
+	const failedFiles = result.testResults.filter((fr) => fr.numFailingTests > 0).length + execErrorFiles;
+	const skippedFiles = result.testResults.filter((fr) => fr.numFailingTests === 0 && fr.numPassingTests === 0 && !hasExecError(fr)).length;
 	const passedFiles = totalFiles - failedFiles - skippedFiles;
 	const fileParts = [];
 	if (passedFiles > 0) fileParts.push(st.summary.passed(`${passedFiles} passed`));
 	if (failedFiles > 0) fileParts.push(st.summary.failed(`${failedFiles} failed`));
 	if (skippedFiles > 0) fileParts.push(st.summary.pending(`${skippedFiles} skipped`));
+	const snapshotLine = formatSnapshotLine(result.snapshot, st);
+	if (snapshotLine !== void 0) lines.push(snapshotLine);
 	const fileTotalLabel = st.dim(`(${totalFiles})`);
-	const fileLabel = labelStyle(" Test Files");
-	lines.push(`${fileLabel}  ${fileParts.join(" | ")} ${fileTotalLabel}`);
+	lines.push(`${st.dim(" Test Files")}  ${fileParts.join(" | ")} ${fileTotalLabel}`);
 	const testParts = [];
 	if (result.numPassedTests > 0) testParts.push(st.summary.passed(`${result.numPassedTests} passed`));
 	if (result.numFailedTests > 0) testParts.push(st.summary.failed(`${result.numFailedTests} failed`));
 	if (result.numPendingTests > 0) testParts.push(st.summary.pending(`${result.numPendingTests} skipped`));
 	const testTotalLabel = st.dim(`(${result.numTotalTests})`);
-	const testsLabel = labelStyle("      Tests");
-	lines.push(`${testsLabel}  ${testParts.join(" | ")} ${testTotalLabel}`);
+	lines.push(`${st.dim("      Tests")}  ${testParts.join(" | ")} ${testTotalLabel}`);
 	const startAtStr = new Date(timing.startTime).toLocaleTimeString("en-GB", { hour12: false });
-	const startAtLabel = labelStyle("   Start at");
-	const startAtValue = hasFailed ? st.status.fail(startAtStr) : startAtStr;
-	lines.push(`${startAtLabel}  ${startAtValue}`);
+	lines.push(`${st.dim("   Start at")}  ${startAtStr}`);
 	const environmentMs = timing.executionMs - timing.testsMs;
 	const uploadMs = timing.uploadMs ?? 0;
 	const cliMs = timing.totalMs - uploadMs - timing.executionMs;
@@ -937,29 +1030,39 @@ function formatTestSummary(result, timing, styles) {
 	if (timing.uploadMs !== void 0) breakdownParts.push(timing.uploadCached === true ? `upload ${timing.uploadMs}ms (cached)` : `upload ${timing.uploadMs}ms`);
 	breakdownParts.push(`environment ${environmentMs}ms`, `tests ${timing.testsMs}ms`, `cli ${cliMs}ms`);
 	const breakdown = st.dim(`(${breakdownParts.join(", ")})`);
-	const durationLabel = labelStyle("   Duration");
-	const durationValue = hasFailed ? st.status.fail(`${timing.totalMs}ms`) : `${timing.totalMs}ms`;
-	lines.push(`${durationLabel}  ${durationValue} ${breakdown}`);
+	lines.push(`${st.dim("   Duration")}  ${timing.totalMs}ms ${breakdown}`);
 	return lines.join("\n");
 }
-function parseErrorMessage(message) {
-	const lines = message.split("\n");
-	const expectedMatch = message.match(/Expected\b.*?:\s*(.+)/);
-	const receivedMatch = message.match(/Received\b.*?:\s*(.+)/);
-	return {
-		expected: expectedMatch?.[1],
-		message: lines[0] ?? message,
-		received: receivedMatch?.[1]
-	};
+function formatResult(result, timing, options) {
+	const styles = createStyles(options.color);
+	const lines = [formatRunHeader(options, styles)];
+	for (const file of result.testResults) lines.push(formatFileSummary(file, options, styles));
+	const execErrors = result.testResults.filter(hasExecError);
+	const totalDetailedFailures = result.numFailedTests + execErrors.length;
+	if (totalDetailedFailures > 0) {
+		lines.push("", formatFailedTestsHeader(totalDetailedFailures, styles));
+		const failureCtx = {
+			currentIndex: 1,
+			totalFailures: totalDetailedFailures
+		};
+		for (const file of result.testResults) {
+			const failures = formatFileFailures(file, options, styles, failureCtx);
+			if (failures !== "") lines.push(failures);
+		}
+		for (const file of execErrors) lines.push(formatExecErrorDetail(file, styles, failureCtx));
+	}
+	lines.push("", formatTestSummary(result, timing, styles));
+	if (!result.success) {
+		const hints = formatLogHints(options, styles);
+		if (hints !== "") lines.push("", hints);
+	}
+	return lines.join("\n");
 }
-function parseSourceLocation(message) {
-	const match = message.match(/([^\s:]+\.tsx?):(\d+)(?::(\d+))?/);
-	if (match === null) return;
-	return {
-		column: match[3] !== void 0 ? Number.parseInt(match[3], 10) : void 0,
-		line: Number.parseInt(match[2] ?? "", 10),
-		path: match[1] ?? ""
-	};
+function getTerminalWidth() {
+	return "columns" in process.stdout && process.stdout.columns || 80;
+}
+function identity(text) {
+	return text;
 }
 function createStyles(useColor) {
 	if (!useColor) return {
@@ -1013,59 +1116,139 @@ function createStyles(useColor) {
 		}
 	};
 }
-function formatDescribeGroup(describeName, tests, styles) {
-	const lines = [];
-	const groupHasFailure = tests.some((tc) => tc.status === "failed");
-	const groupTestCount = tests.length;
-	const groupDuration = tests.reduce((sum, tc) => sum + (tc.duration ?? 0), 0);
-	const groupDurationStr = styles.lineNumber(` ${groupDuration}ms`);
-	if (groupHasFailure) {
-		const failedCount = tests.filter((tc) => tc.status === "failed").length;
-		const groupMeta = styles.dim(`(${groupTestCount} tests | `) + styles.summary.failed(`${failedCount} failed`) + styles.dim(")");
-		const header = styles.status.fail(`   ❯ ${describeName}`);
-		lines.push(`${header} ${groupMeta}${groupDurationStr}`);
-		for (const tc of tests) lines.push(formatTestInGroup(tc, styles));
-	} else {
-		const groupMeta = styles.dim(`(${groupTestCount} tests)`);
-		const marker = styles.status.pass("   ✓");
-		const name = styles.status.fail(` ${describeName}`);
-		lines.push(`${marker}${name} ${groupMeta}${groupDurationStr}`);
-	}
-	return lines;
+function expandTabs(text, tabWidth = 4) {
+	let result = "";
+	for (const char of text) if (char === "	") {
+		const spaces = tabWidth - result.length % tabWidth;
+		result += " ".repeat(spaces);
+	} else result += char;
+	return result;
 }
-function formatFailedFileSummary(file, testCount, styles) {
-	const lines = [];
-	const failedMeta = styles.summary.failed(`${file.numFailingTests} failed`);
-	const meta = `${styles.dim(`(${testCount} tests | `)}${failedMeta}${styles.dim(")")}`;
-	const header = styles.status.fail(` ❯ ${file.testFilePath}`);
-	lines.push(`${header} ${meta}`);
-	const groups = groupByDescribe(file.testResults);
-	for (const [describeName, tests] of groups) lines.push(...formatDescribeGroup(describeName, tests, styles));
-	return lines;
+function highlightSyntax(filePath, code, useColor) {
+	if (!useColor) return code;
+	return highlightCode(filePath, code);
 }
-function formatFailureMessage(originalMessage, options) {
-	const { showLuau, sourceMapper, styles: st, useColor } = options;
-	const lines = [];
-	let mappedLocations = [];
-	let message = originalMessage;
-	if (sourceMapper !== void 0) ({locations: mappedLocations, message} = sourceMapper.mapFailureWithLocations(originalMessage));
-	const parsed = parseErrorMessage(message);
-	lines.push(st.status.fail(parsed.message));
-	if (parsed.expected !== void 0 && parsed.received !== void 0) lines.push("", st.diff.expected("- Expected"), st.diff.received("+ Received"), "", st.diff.expected(`- ${parsed.expected}`), st.diff.received(`+ ${parsed.received}`));
-	if (mappedLocations.length > 0) for (const loc of mappedLocations) lines.push(...formatMappedLocationSnippets(loc, showLuau, st, useColor));
-	else lines.push(...formatFallbackSnippet(message, st, useColor));
-	return lines;
+function formatDiffBlock(parsed, st) {
+	if (parsed.snapshotDiff !== void 0) {
+		const lines = [""];
+		for (const diffLine of parsed.snapshotDiff.split("\n")) if (diffLine.startsWith("- ")) lines.push(st.diff.expected(diffLine));
+		else if (diffLine.startsWith("+ ")) lines.push(st.diff.received(diffLine));
+		else lines.push(st.dim(diffLine));
+		return lines;
+	}
+	if (parsed.expected !== void 0 && parsed.received !== void 0) return [
+		"",
+		st.diff.expected("- Expected"),
+		st.diff.received("+ Received"),
+		"",
+		st.diff.expected(`- ${parsed.expected}`),
+		st.diff.received(`+ ${parsed.received}`)
+	];
+	return [];
+}
+function formatErrorLine(parsed, st, useColor) {
+	if (useColor && parsed.message.startsWith("Error:")) return st.status.fail(color.bold("Error:") + parsed.message.slice(6));
+	return st.status.fail(parsed.message);
 }
 function formatFallbackSnippet(message, styles, useColor) {
 	const location = parseSourceLocation(message);
 	if (location === void 0) return [];
-	const snippet = getSourceSnippet(location.path, location.line, 2, location.column);
+	const snippet = getSourceSnippet({
+		column: location.column,
+		context: 2,
+		filePath: location.path,
+		line: location.line
+	});
 	if (snippet === void 0) return [];
 	return ["", formatSourceSnippet(snippet, location.path, {
 		styles,
 		useColor
 	})];
 }
+function formatMappedLocationSnippets(loc, showLuau, st, useColor) {
+	const snippets = [];
+	const tsSnippet = getSourceSnippet({
+		column: loc.tsColumn,
+		context: 2,
+		filePath: loc.tsPath,
+		line: loc.tsLine,
+		sourceContent: loc.sourceContent
+	});
+	if (tsSnippet !== void 0) {
+		const label = showLuau ? "TypeScript" : void 0;
+		snippets.push("", formatSourceSnippet(tsSnippet, loc.tsPath, {
+			language: label,
+			styles: st,
+			useColor
+		}));
+	}
+	if (showLuau) {
+		const luauSnippet = getSourceSnippet({
+			context: 2,
+			filePath: loc.luauPath,
+			line: loc.luauLine
+		});
+		if (luauSnippet !== void 0) snippets.push("", formatSourceSnippet(luauSnippet, loc.luauPath, {
+			language: "Luau",
+			styles: st,
+			useColor
+		}));
+	}
+	return snippets;
+}
+function formatSnapshotCallSnippet(filePath, styles, useColor) {
+	if (!fs.existsSync(filePath)) return [];
+	const content = fs.readFileSync(filePath, "utf-8");
+	const snapshotIndices = content.split("\n").reduce((acc, fileLine, index) => {
+		if (fileLine.includes("toMatchSnapshot")) acc.push(index);
+		return acc;
+	}, []);
+	if (snapshotIndices.length !== 1) return [];
+	const snippet = getSourceSnippet({
+		context: 2,
+		filePath,
+		line: snapshotIndices[0] + 1,
+		sourceContent: content
+	});
+	if (snippet === void 0) return [];
+	return ["", formatSourceSnippet(snippet, filePath, {
+		styles,
+		useColor
+	})];
+}
+function resolveSourceSnippets(options) {
+	const { filePath, hasSnapshotDiff, mappedLocations, message, showLuau, sourceMapper, styles: st, useColor } = options;
+	if (mappedLocations.length > 0) return mappedLocations.flatMap((loc) => formatMappedLocationSnippets(loc, showLuau, st, useColor));
+	const fallback = formatFallbackSnippet(message, st, useColor);
+	if (fallback.length > 0) return fallback;
+	if (hasSnapshotDiff && filePath !== void 0) return formatSnapshotCallSnippet(sourceMapper?.resolveTestFilePath(filePath) ?? filePath, st, useColor);
+	return [];
+}
+function formatFailureMessage(originalMessage, options) {
+	const { filePath, showLuau, sourceMapper, styles: st, useColor } = options;
+	let mappedLocations = [];
+	let message = originalMessage;
+	if (sourceMapper !== void 0) ({locations: mappedLocations, message} = sourceMapper.mapFailureWithLocations(originalMessage));
+	const parsed = parseErrorMessage(originalMessage);
+	return [
+		formatErrorLine(parsed, st, useColor),
+		...formatDiffBlock(parsed, st),
+		...resolveSourceSnippets({
+			filePath,
+			hasSnapshotDiff: parsed.snapshotDiff !== void 0,
+			mappedLocations,
+			message,
+			showLuau,
+			sourceMapper,
+			styles: st,
+			useColor
+		})
+	];
+}
+function formatSnapshotLine(snapshot, st) {
+	if (snapshot === void 0 || snapshot.unmatched === 0) return;
+	return `${st.dim("  Snapshots")}  ${st.summary.failed(`${snapshot.unmatched} failed`)}`;
+}
 function formatFileFailures(file, options, styles, failureCtx) {
 	const lines = [];
 	for (const tc of file.testResults) if (tc.status === "failed") {
@@ -1084,58 +1267,23 @@ function formatFileFailures(file, options, styles, failureCtx) {
 	}
 	return lines.join("\n");
 }
-function formatFilePath(filePath, styles) {
-	const directory = path.dirname(filePath);
-	const base = path.basename(filePath);
-	const directoryWithSlash = styles.path.dir(`${directory}/`);
-	const fileName = styles.path.file(base);
-	return directory && directory !== "." ? directoryWithSlash + fileName : fileName;
-}
-function formatFileSummary(file, options, styles) {
+function formatExecErrorDetail(file, styles, failureCtx) {
 	const lines = [];
-	const formattedPath = formatFilePath(file.testFilePath, styles);
-	const testCount = file.numPassingTests + file.numFailingTests + file.numPendingTests;
-	if (file.numFailingTests > 0) lines.push(...formatFailedFileSummary(file, testCount, styles));
-	else if (file.numPassingTests === 0 && file.numPendingTests > 0) {
-		const symbol = styles.status.pending("↓");
-		const meta = styles.dim(`(${testCount} tests)`);
-		lines.push(` ${symbol} ${formattedPath} ${meta}`);
-	} else {
-		const fileMs = sumFileDuration(file);
-		const symbol = styles.status.pass("✓");
-		const duration = fileMs > 0 ? ` - ${fileMs}ms` : "";
-		const meta = styles.dim(`(${testCount} tests${duration})`);
-		lines.push(` ${symbol} ${formattedPath} ${meta}`);
-		if (options.verbose) {
-			for (const tc of file.testResults) if (tc.status === "passed") lines.push(formatPass(tc, styles));
-		}
-	}
+	const index = failureCtx.currentIndex;
+	failureCtx.currentIndex++;
+	const errorMessage = cleanExecErrorMessage(file.failureMessage ?? "");
+	const counter = `[${index}/${failureCtx.totalFailures}]`;
+	const termWidth = getTerminalWidth();
+	const fillWidth = Math.max(1, termWidth - counter.length - 3);
+	const separator = styles.dim(styles.status.fail(`${"⎯".repeat(fillWidth)}${counter}\u23af`));
+	lines.push(`  ${styles.failBadge(" FAIL ")} ${styles.status.fail(file.testFilePath)}`, `  ${styles.status.fail("Test suite failed to run")}`, "", `  ${styles.status.fail(errorMessage)}`, "", `  ${separator}`);
 	return lines.join("\n");
 }
-function formatMappedLocationSnippets(loc, showLuau, st, useColor) {
-	const snippets = [];
-	const tsSnippet = getSourceSnippet(loc.tsPath, loc.tsLine, 2, loc.tsColumn);
-	if (tsSnippet !== void 0) {
-		const label = showLuau ? "TypeScript" : void 0;
-		snippets.push("", formatSourceSnippet(tsSnippet, loc.tsPath, {
-			language: label,
-			styles: st,
-			useColor
-		}));
-	}
-	if (showLuau) {
-		const luauSnippet = getSourceSnippet(loc.luauPath, loc.luauLine, 2);
-		if (luauSnippet !== void 0) snippets.push("", formatSourceSnippet(luauSnippet, loc.luauPath, {
-			language: "Luau",
-			styles: st,
-			useColor
-		}));
-	}
-	return snippets;
-}
-function formatPass(test, styles) {
-	const duration = test.duration !== void 0 ? styles.dim(` ${test.duration}ms`) : "";
-	return styles.status.pass(`  ✓ ${test.fullName}`) + duration;
+function formatLogHints(options, styles) {
+	const lines = [];
+	if (options.outputFile !== void 0) lines.push(styles.dim(`  View ${options.outputFile} for full Jest output`));
+	if (options.gameOutput !== void 0) lines.push(styles.dim(`  View ${options.gameOutput} for Roblox game logs`));
+	return lines.join("\n");
 }
 function formatTestInGroup(tc, styles) {
 	const duration = tc.duration !== void 0 ? styles.lineNumber(` ${tc.duration}ms`) : "";
@@ -1143,6 +1291,26 @@ function formatTestInGroup(tc, styles) {
 	const failedText = `     × ${tc.title}`;
 	return `${styles.status.fail(failedText)}${duration}`;
 }
+function formatDescribeGroup(describeName, tests, styles) {
+	const lines = [];
+	const groupHasFailure = tests.some((tc) => tc.status === "failed");
+	const groupTestCount = tests.length;
+	const groupDuration = tests.reduce((sum, tc) => sum + (tc.duration ?? 0), 0);
+	const groupDurationStr = styles.lineNumber(` ${groupDuration}ms`);
+	if (groupHasFailure) {
+		const failedCount = tests.filter((tc) => tc.status === "failed").length;
+		const groupMeta = styles.dim(`(${groupTestCount} tests | `) + styles.summary.failed(`${failedCount} failed`) + styles.dim(")");
+		const header = styles.status.fail(`   ❯ ${describeName}`);
+		lines.push(`${header} ${groupMeta}${groupDurationStr}`);
+		for (const tc of tests) lines.push(formatTestInGroup(tc, styles));
+	} else {
+		const groupMeta = styles.dim(`(${groupTestCount} tests)`);
+		const marker = styles.status.pass("   ✓");
+		const name = styles.status.fail(` ${describeName}`);
+		lines.push(`${marker}${name} ${groupMeta}${groupDurationStr}`);
+	}
+	return lines;
+}
 function groupByDescribe(tests) {
 	const groups = /* @__PURE__ */ new Map();
 	for (const test of tests) {
@@ -1153,36 +1321,102 @@ function groupByDescribe(tests) {
 	}
 	return groups;
 }
-function highlightSyntax(filePath, code, useColor) {
-	if (!useColor) return code;
-	return highlightCode(filePath, code);
+function formatFailedFileSummary(file, testCount, styles) {
+	const lines = [];
+	const failedMeta = styles.summary.failed(`${file.numFailingTests} failed`);
+	const meta = `${styles.dim(`(${testCount} tests | `)}${failedMeta}${styles.dim(")")}`;
+	const header = styles.status.fail(` ❯ ${file.testFilePath}`);
+	lines.push(`${header} ${meta}`);
+	const groups = groupByDescribe(file.testResults);
+	for (const [describeName, tests] of groups) lines.push(...formatDescribeGroup(describeName, tests, styles));
+	return lines;
 }
-function identity(text) {
-	return text;
+function formatFilePath(filePath, styles) {
+	const directory = path.dirname(filePath);
+	const base = path.basename(filePath);
+	const directoryWithSlash = styles.path.dir(`${directory}/`);
+	const fileName = styles.path.file(base);
+	return directory && directory !== "." ? directoryWithSlash + fileName : fileName;
+}
+function formatExecErrorFileSummary(file, formattedPath, styles) {
+	const symbol = styles.status.fail("✗");
+	const errorMessage = cleanExecErrorMessage(file.failureMessage ?? "");
+	return [` ${symbol} ${formattedPath}`, `   ${styles.status.fail(errorMessage)}`];
+}
+function formatPass(test, styles) {
+	const duration = test.duration !== void 0 ? styles.dim(` ${test.duration}ms`) : "";
+	return styles.status.pass(`  ✓ ${test.fullName}`) + duration;
 }
 function sumFileDuration(file) {
 	let total = 0;
 	for (const test of file.testResults) if (test.duration !== void 0) total += test.duration;
 	return total;
 }
+function formatPassedFileSummary(file, ctx) {
+	const lines = [];
+	const fileMs = sumFileDuration(file);
+	const symbol = ctx.styles.status.pass("✓");
+	const duration = fileMs > 0 ? ` - ${fileMs}ms` : "";
+	const meta = ctx.styles.dim(`(${ctx.testCount} tests${duration})`);
+	lines.push(` ${symbol} ${ctx.formattedPath} ${meta}`);
+	if (ctx.verbose) {
+		for (const tc of file.testResults) if (tc.status === "passed") lines.push(formatPass(tc, ctx.styles));
+	}
+	return lines;
+}
+function formatFileSummary(file, options, styles) {
+	const formattedPath = formatFilePath(file.testFilePath, styles);
+	const testCount = file.numPassingTests + file.numFailingTests + file.numPendingTests;
+	if (file.numFailingTests > 0) return formatFailedFileSummary(file, testCount, styles).join("\n");
+	if (hasExecError(file)) return formatExecErrorFileSummary(file, formattedPath, styles).join("\n");
+	if (file.numPassingTests === 0 && file.numPendingTests > 0) return ` ${styles.status.pending("↓")} ${formattedPath} ${styles.dim(`(${testCount} tests)`)}`;
+	return formatPassedFileSummary(file, {
+		formattedPath,
+		styles,
+		testCount,
+		verbose: options.verbose
+	}).join("\n");
+}
 
 //#endregion
 //#region src/formatters/compact.ts
+function formatCompactSummary(result) {
+	const parts = [];
+	const execErrorCount = result.testResults.filter(hasExecError).length;
+	const failCount = result.numFailedTests + execErrorCount;
+	if (result.numPassedTests > 0) parts.push(`PASS ${result.numPassedTests}`);
+	if (failCount > 0) parts.push(`FAIL ${failCount}`);
+	if (result.numPendingTests > 0) parts.push(`SKIP ${result.numPendingTests}`);
+	return parts.join(" | ");
+}
 function formatCompact(result, options) {
 	const lines = [formatCompactSummary(result)];
-	if (result.numFailedTests > 0) {
+	const execErrors = result.testResults.filter(hasExecError);
+	if (result.numFailedTests > 0 || execErrors.length > 0) {
 		lines.push("");
-		const failureLines = formatFailures(result, options);
-		lines.push(...failureLines);
+		if (result.numFailedTests > 0) {
+			const failureLines = formatFailures(result, options);
+			lines.push(...failureLines);
+		}
+		for (const file of execErrors) {
+			const relativePath = makeRelative(file.testFilePath, options.rootDir);
+			const errorMessage = cleanExecErrorMessage(file.failureMessage ?? "");
+			lines.push(`[FAIL] ${relativePath} - suite failed to run`, errorMessage, "");
+		}
+		const hints = formatCompactLogHints(options);
+		if (hints !== "") lines.push(hints);
 	}
 	return lines.join("\n");
 }
-function formatCompactSummary(result) {
-	const parts = [];
-	if (result.numPassedTests > 0) parts.push(`PASS ${result.numPassedTests}`);
-	if (result.numFailedTests > 0) parts.push(`FAIL ${result.numFailedTests}`);
-	if (result.numPendingTests > 0) parts.push(`SKIP ${result.numPendingTests}`);
-	return parts.join(" | ");
+function formatCompactLogHints(options) {
+	const lines = [];
+	if (options.outputFile !== void 0) lines.push(`View ${options.outputFile} for full Jest output`);
+	if (options.gameOutput !== void 0) lines.push(`View ${options.gameOutput} for Roblox game logs`);
+	return lines.join("\n");
+}
+function makeRelative(filePath, rootDirectory) {
+	if (filePath.startsWith(rootDirectory)) return path.relative(rootDirectory, filePath);
+	return filePath;
 }
 function collectFailedTests(result) {
 	const failures = [];
@@ -1202,18 +1436,43 @@ function findFailureLocation(mappedLocations, message) {
 	}
 	return parseSourceLocation(message);
 }
+function getFailureSnippet(mappedLocations, location) {
+	let snippet;
+	if (mappedLocations.length > 0) {
+		const loc = mappedLocations[0];
+		if (loc !== void 0) snippet = getSourceSnippet({
+			column: loc.tsColumn,
+			context: 1,
+			filePath: loc.tsPath,
+			line: loc.tsLine,
+			sourceContent: loc.sourceContent
+		});
+	} else if (location !== void 0) snippet = getSourceSnippet({
+		context: 1,
+		filePath: location.path,
+		line: location.line
+	});
+	if (snippet === void 0) return;
+	const snippetLines = [];
+	for (const line of snippet.lines) {
+		const prefix = line.num === snippet.failureLine ? ">" : " ";
+		snippetLines.push(`${prefix} ${line.num}| ${line.content}`);
+	}
+	return snippetLines.join("\n");
+}
 function formatCompactFailure(test, filePath, options) {
 	const lines = [];
 	for (const originalMessage of test.failureMessages) {
 		let mappedLocations = [];
 		let message = originalMessage;
 		if (options.sourceMapper !== void 0) ({locations: mappedLocations, message} = options.sourceMapper.mapFailureWithLocations(originalMessage));
-		const parsed = parseErrorMessage(message);
+		const parsed = parseErrorMessage(originalMessage);
 		const location = findFailureLocation(mappedLocations, message);
 		const relativePath = makeRelative(location?.path ?? filePath, options.rootDir);
 		const lineInfo = location?.line !== void 0 ? `:${location.line}` : "";
 		lines.push(`[FAIL] ${relativePath}${lineInfo} - ${test.title}`);
-		if (parsed.expected !== void 0 && parsed.received !== void 0) lines.push(`expect: ${parsed.expected}`, `actual: ${parsed.received}`);
+		if (parsed.snapshotDiff !== void 0) lines.push(parsed.snapshotDiff);
+		else if (parsed.expected !== void 0 && parsed.received !== void 0) lines.push(`expect: ${parsed.expected}`, `actual: ${parsed.received}`);
 		const snippet = getFailureSnippet(mappedLocations, location);
 		if (snippet !== void 0) lines.push(snippet);
 		lines.push("");
@@ -1232,24 +1491,6 @@ function formatFailures(result, options) {
 	}
 	return lines;
 }
-function getFailureSnippet(mappedLocations, location) {
-	let snippet;
-	if (mappedLocations.length > 0) {
-		const loc = mappedLocations[0];
-		if (loc !== void 0) snippet = getSourceSnippet(loc.tsPath, loc.tsLine, 1, loc.tsColumn);
-	} else if (location !== void 0) snippet = getSourceSnippet(location.path, location.line, 1);
-	if (snippet === void 0) return;
-	const snippetLines = [];
-	for (const line of snippet.lines) {
-		const prefix = line.num === snippet.failureLine ? ">" : " ";
-		snippetLines.push(`${prefix} ${line.num}| ${line.content}`);
-	}
-	return snippetLines.join("\n");
-}
-function makeRelative(filePath, rootDirectory) {
-	if (filePath.startsWith(rootDirectory)) return path.relative(rootDirectory, filePath);
-	return filePath;
-}
 
 //#endregion
 //#region src/formatters/json.ts
@@ -1292,19 +1533,16 @@ function buildMappings(tree, prefix) {
 //#endregion
 //#region src/executor.ts
 const rojoProjectSchema = type({ tree: "object" });
-const tsconfigSchema = type({ "compilerOptions?": {
-	"outDir?": "string",
-	"rootDir?": "string"
-} });
 async function execute(options) {
 	const startTime = Date.now();
 	const { gameOutput, luauTiming, result, snapshotWrites, timing: backendTiming } = await options.backend.runTests({
 		config: options.config,
 		testFiles: options.testFiles
 	});
-	if (snapshotWrites !== void 0) writeSnapshots(snapshotWrites, options.config);
+	const tsconfigDirectories = resolveTsconfigDirectories(options.config.rootDir);
+	if (snapshotWrites !== void 0) writeSnapshots(snapshotWrites, options.config, tsconfigDirectories);
 	const testsMs = calculateTestsMs(result.testResults);
-	const sourceMapper = options.config.sourceMap ? buildSourceMapper(options.config) : void 0;
+	const sourceMapper = options.config.sourceMap ? buildSourceMapper(options.config, tsconfigDirectories) : void 0;
 	const totalMs = Date.now() - startTime;
 	const timing = {
 		executionMs: backendTiming.executionMs,
@@ -1314,15 +1552,21 @@ async function execute(options) {
 		uploadCached: backendTiming.uploadCached,
 		uploadMs: backendTiming.uploadMs
 	};
+	const resolvedOutputFile = options.config.outputFile !== void 0 ? path$1.resolve(options.config.outputFile) : void 0;
+	const resolvedGameOutput = options.config.gameOutput !== void 0 ? path$1.resolve(options.config.gameOutput) : void 0;
 	let output = "";
-	if (!options.config.silent) if (options.config.compact) output = formatCompact(result, {
+	if (!options.config.silent) if (options.config.compact && !options.config.verbose) output = formatCompact(result, {
+		gameOutput: resolvedGameOutput,
 		maxFailures: options.config.compactMaxFailures,
+		outputFile: resolvedOutputFile,
 		rootDir: options.config.rootDir,
 		sourceMapper
 	});
 	else if (options.config.json) output = formatJson(result);
 	else output = formatResult(result, timing, {
 		color: options.config.color,
+		gameOutput: resolvedGameOutput,
+		outputFile: resolvedOutputFile,
 		rootDir: options.config.rootDir,
 		showLuau: options.config.showLuau,
 		sourceMapper,
@@ -1337,19 +1581,34 @@ async function execute(options) {
 		result
 	};
 }
-function buildSourceMapper(config) {
+function normalizeDirectoryPath(directory) {
+	return path$1.normalize(directory).replaceAll("\\", "/");
+}
+function resolveTsconfigDirectories(projectRoot) {
+	const tsconfig = getTsconfig(projectRoot);
+	const outDirectory = tsconfig?.config.compilerOptions?.outDir ?? "out";
+	const rootDirectory = tsconfig?.config.compilerOptions?.rootDir ?? "src";
+	return {
+		outDir: normalizeDirectoryPath(outDirectory),
+		rootDir: normalizeDirectoryPath(rootDirectory)
+	};
+}
+function findRojoProject(rootDirectory) {
+	const defaultPath = path$1.join(rootDirectory, "default.project.json");
+	if (fs.existsSync(defaultPath)) return defaultPath;
+	const projectFile = fs.readdirSync(rootDirectory).find((file) => file.endsWith(".project.json"));
+	return projectFile !== void 0 ? path$1.join(rootDirectory, projectFile) : void 0;
+}
+function buildSourceMapper(config, tsconfigDirectories) {
 	const rojoProjectPath = config.rojoProject ?? findRojoProject(config.rootDir);
-	if (rojoProjectPath === void 0) return;
-	const tsconfigPath = path$1.join(config.rootDir, "tsconfig.json");
-	if (!fs.existsSync(rojoProjectPath) || !fs.existsSync(tsconfigPath)) return;
+	if (rojoProjectPath === void 0 || !fs.existsSync(rojoProjectPath)) return;
 	try {
 		const rojoResult = rojoProjectSchema(JSON.parse(fs.readFileSync(rojoProjectPath, "utf-8")));
 		if (rojoResult instanceof type.errors) return;
-		const tsconfigResult = tsconfigSchema(JSON.parse(fs.readFileSync(tsconfigPath, "utf-8")));
 		return createSourceMapper({
-			outDir: tsconfigResult instanceof type.errors ? "out" : tsconfigResult.compilerOptions?.outDir ?? "out",
+			outDir: tsconfigDirectories.outDir,
 			rojoProject: rojoResult,
-			rootDir: tsconfigResult instanceof type.errors ? "src" : tsconfigResult.compilerOptions?.rootDir ?? "src"
+			rootDir: tsconfigDirectories.rootDir
 		});
 	} catch {
 		return;
@@ -1360,12 +1619,6 @@ function calculateTestsMs(testResults) {
 	for (const file of testResults) for (const test of file.testResults) if (test.duration !== void 0) total += test.duration;
 	return total;
 }
-function findRojoProject(rootDirectory) {
-	const defaultPath = path$1.join(rootDirectory, "default.project.json");
-	if (fs.existsSync(defaultPath)) return defaultPath;
-	const projectFile = fs.readdirSync(rootDirectory).find((file) => file.endsWith(".project.json"));
-	return projectFile !== void 0 ? path$1.join(rootDirectory, projectFile) : void 0;
-}
 function printLuauTiming(timing) {
 	let total = 0;
 	for (const [phase, seconds] of Object.entries(timing)) {
@@ -1375,7 +1628,7 @@ function printLuauTiming(timing) {
 	}
 	process.stderr.write(`[TIMING] total: ${String(total)}ms\n`);
 }
-function writeSnapshots(snapshotWrites, config) {
+function writeSnapshots(snapshotWrites, config, tsconfigDirectories) {
 	const rojoProjectPath = config.rojoProject ?? findRojoProject(config.rootDir);
 	if (rojoProjectPath === void 0 || !fs.existsSync(rojoProjectPath)) {
 		process.stderr.write("Warning: Cannot write snapshots - no rojo project found\n");
@@ -1387,16 +1640,7 @@ function writeSnapshots(snapshotWrites, config) {
 			process.stderr.write("Warning: Cannot write snapshots - invalid rojo project\n");
 			return;
 		}
-		const tsconfigPath = path$1.join(config.rootDir, "tsconfig.json");
-		let outDirectory;
-		let rootDirectory;
-		if (fs.existsSync(tsconfigPath)) {
-			const tsconfigResult = tsconfigSchema(JSON.parse(fs.readFileSync(tsconfigPath, "utf-8")));
-			if (!(tsconfigResult instanceof type.errors)) {
-				outDirectory = tsconfigResult.compilerOptions?.outDir ?? "out";
-				rootDirectory = tsconfigResult.compilerOptions?.rootDir ?? "src";
-			}
-		}
+		const { outDir: outDirectory, rootDir: rootDirectory } = tsconfigDirectories;
 		const resolver = createSnapshotPathResolver({
 			outDir: outDirectory,
 			rojoProject: rojoResult,
@@ -1412,6 +1656,12 @@ function writeSnapshots(snapshotWrites, config) {
 			const absolutePath = path$1.resolve(config.rootDir, fsPath);
 			fs.mkdirSync(path$1.dirname(absolutePath), { recursive: true });
 			fs.writeFileSync(absolutePath, content);
+			if (fsPath.startsWith(`${rootDirectory}/`)) {
+				const outPath = outDirectory + fsPath.slice(rootDirectory.length);
+				const absoluteOutPath = path$1.resolve(config.rootDir, outPath);
+				fs.mkdirSync(path$1.dirname(absoluteOutPath), { recursive: true });
+				fs.writeFileSync(absoluteOutPath, content);
+			}
 			written++;
 		}
 		if (written > 0) process.stderr.write(`Wrote ${String(written)} snapshot file${written === 1 ? "" : "s"}\n`);
@@ -1420,6 +1670,240 @@ function writeSnapshots(snapshotWrites, config) {
 	}
 }
 
+//#endregion
+//#region src/typecheck/collect.ts
+const TEST_FUNCTIONS = new Set(["it", "test"]);
+const SUITE_FUNCTIONS = new Set(["describe", "suite"]);
+const ALL_FUNCTIONS = new Set([...SUITE_FUNCTIONS, ...TEST_FUNCTIONS]);
+function collectTestDefinitions(source) {
+	const result = parseSync("test.ts", source);
+	const raw = [];
+	new Visitor({ CallExpression(node) {
+		const definition = extractDefinition(node, source);
+		if (definition) raw.push(definition);
+	} }).visit(result.program);
+	raw.sort((a, b) => a.start - b.start);
+	return buildAncestorChain(raw);
+}
+function buildAncestorChain(sorted) {
+	const result = [];
+	const suiteStack = [];
+	for (const definition of sorted) {
+		while (suiteStack.length > 0 && suiteStack.at(-1).end <= definition.start) suiteStack.pop();
+		result.push({
+			...definition,
+			ancestorNames: suiteStack.map((suite) => suite.name)
+		});
+		if (definition.type === "suite") suiteStack.push({
+			name: definition.name,
+			end: definition.end
+		});
+	}
+	return result;
+}
+function isStringLiteral(node) {
+	return node.type === "Literal" && typeof node.value === "string";
+}
+function isTemplateLiteral(node) {
+	return node.type === "TemplateLiteral";
+}
+function extractStringArgument(node, source) {
+	if (isStringLiteral(node)) return node.value;
+	if (isTemplateLiteral(node)) {
+		if (node.quasis.length === 1 && node.quasis[0] !== void 0) return node.quasis[0].value.raw;
+		return source.slice(node.start + 1, node.end - 1);
+	}
+	return source.slice(node.start, node.end);
+}
+function isIdentifier(node) {
+	return node.type === "Identifier";
+}
+function isStaticMemberExpression(node) {
+	return node.type === "MemberExpression" && "computed" in node && !node.computed;
+}
+function getCalleeName(callee) {
+	if (isIdentifier(callee)) return callee.name;
+	if (isStaticMemberExpression(callee) && isIdentifier(callee.object) && ALL_FUNCTIONS.has(callee.object.name)) return callee.object.name;
+}
+function extractDefinition(node, source) {
+	const name = getCalleeName(node.callee);
+	if (name === void 0 || !ALL_FUNCTIONS.has(name)) return;
+	const firstArgument = node.arguments[0];
+	if (firstArgument === void 0 || firstArgument.type === "SpreadElement") return;
+	return {
+		name: extractStringArgument(firstArgument, source),
+		end: node.end,
+		start: node.start,
+		type: TEST_FUNCTIONS.has(name) ? "test" : "suite"
+	};
+}
+
+//#endregion
+//#region src/typecheck/parse.ts
+const errCodeRegExp = /error TS(?<errCode>\d+)/;
+function parseTscErrorLine(line) {
+	const parenIndex = line.lastIndexOf("(", line.indexOf("): error TS"));
+	if (parenIndex === -1) return ["", null];
+	const filePath = line.slice(0, parenIndex);
+	const rest = line.slice(parenIndex);
+	const closeParenIndex = rest.indexOf(")");
+	const [lineStr, colStr] = rest.slice(1, closeParenIndex).split(",");
+	if (lineStr === void 0 || lineStr === "" || colStr === void 0 || colStr === "") return [filePath, null];
+	const afterParen = rest.slice(closeParenIndex + 1);
+	const errCodeStr = errCodeRegExp.exec(afterParen)?.groups?.["errCode"];
+	if (errCodeStr === void 0) return [filePath, null];
+	const errCode = Number(errCodeStr);
+	const marker = `error TS${String(errCode)}: `;
+	const markerIndex = afterParen.indexOf(marker);
+	const errMessage = afterParen.slice(markerIndex + marker.length).trim();
+	return [filePath, {
+		column: Number(colStr),
+		errCode,
+		errMsg: errMessage,
+		filePath,
+		line: Number(lineStr)
+	}];
+}
+function parseTscOutput(stdout) {
+	const map = /* @__PURE__ */ new Map();
+	const merged = stdout.split(/\r?\n/).reduce((lines, next) => {
+		if (!next) return lines;
+		if (next[0] !== " ") lines.push(next);
+		else if (lines.length > 0) lines[lines.length - 1] += `\n${next}`;
+		return lines;
+	}, []);
+	for (const line of merged) {
+		const [filePath, info] = parseTscErrorLine(line);
+		if (!info) continue;
+		const existing = map.get(filePath);
+		if (existing) existing.push(info);
+		else map.set(filePath, [info]);
+	}
+	return map;
+}
+
+//#endregion
+//#region src/typecheck/runner.ts
+function createLocationsIndexMap(source) {
+	const map = /* @__PURE__ */ new Map();
+	let index = 0;
+	let line = 1;
+	let column = 1;
+	for (const char of source) {
+		map.set(`${String(line)}:${String(column)}`, index);
+		index++;
+		if (char === "\n") {
+			line++;
+			column = 1;
+		} else column++;
+	}
+	return map;
+}
+function mapErrorsToTests(errors, files) {
+	const testResults = [];
+	let numberFailed = 0;
+	let numberPassed = 0;
+	for (const [filePath, fileInfo] of files) {
+		const fileResult = buildFileResult(filePath, fileInfo, errors.get(filePath) ?? []);
+		testResults.push(fileResult);
+		numberFailed += fileResult.numFailingTests;
+		numberPassed += fileResult.numPassingTests;
+	}
+	return {
+		numFailedTests: numberFailed,
+		numPassedTests: numberPassed,
+		numPendingTests: 0,
+		numTotalTests: numberFailed + numberPassed,
+		startTime: Date.now(),
+		success: numberFailed === 0,
+		testResults
+	};
+}
+function runTypecheck(options) {
+	const errors = parseTscOutput(spawnTsgo(options));
+	const files = /* @__PURE__ */ new Map();
+	for (const filePath of options.files) {
+		const source = fs.readFileSync(filePath, "utf-8");
+		const definitions = collectTestDefinitions(source);
+		const resolvedPath = path$1.resolve(filePath);
+		files.set(resolvedPath, {
+			definitions,
+			source
+		});
+	}
+	const resolvedErrors = /* @__PURE__ */ new Map();
+	for (const [errorPath, errorList] of errors) {
+		const resolved = path$1.resolve(options.rootDir, errorPath);
+		resolvedErrors.set(resolved, errorList);
+	}
+	return mapErrorsToTests(resolvedErrors, files);
+}
+function buildFileResult(filePath, fileInfo, errors) {
+	const indexMap = createLocationsIndexMap(fileInfo.source);
+	const testDefinitions = fileInfo.definitions.filter((definition) => definition.type === "test");
+	const sortedDefinitions = [...testDefinitions].sort((a, b) => b.start - a.start);
+	const errorsByTest = /* @__PURE__ */ new Map();
+	const fileErrors = [];
+	for (const error of errors) {
+		const charIndex = indexMap.get(`${String(error.line)}:${String(error.column)}`);
+		const definition = charIndex !== void 0 ? sortedDefinitions.find((td) => td.start <= charIndex && td.end >= charIndex) : void 0;
+		const message = `TS${String(error.errCode)}: ${error.errMsg}`;
+		if (definition) {
+			const existing = errorsByTest.get(definition.name) ?? [];
+			existing.push(message);
+			errorsByTest.set(definition.name, existing);
+		} else fileErrors.push(message);
+	}
+	const testCases = testDefinitions.map((definition) => {
+		const failures = errorsByTest.get(definition.name) ?? [];
+		return {
+			ancestorTitles: definition.ancestorNames,
+			failureMessages: failures,
+			fullName: [...definition.ancestorNames, definition.name].join(" > "),
+			status: failures.length > 0 ? "failed" : "passed",
+			title: definition.name
+		};
+	});
+	if (fileErrors.length > 0) testCases.unshift({
+		ancestorTitles: [],
+		failureMessages: fileErrors,
+		fullName: "<file-level type error>",
+		status: "failed",
+		title: "<file-level type error>"
+	});
+	const numberFailing = testCases.filter((tc) => tc.status === "failed").length;
+	return {
+		numFailingTests: numberFailing,
+		numPassingTests: testCases.length - numberFailing,
+		numPendingTests: 0,
+		testFilePath: filePath,
+		testResults: testCases
+	};
+}
+function spawnTsgo(options) {
+	const args = [
+		"tsgo",
+		"--noEmit",
+		"--pretty",
+		"false"
+	];
+	if (options.tsconfig !== void 0) args.push("-p", path$1.resolve(options.rootDir, options.tsconfig));
+	try {
+		return execSync(args.join(" "), {
+			cwd: options.rootDir,
+			encoding: "utf-8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		});
+	} catch (err) {
+		const execError = err;
+		return execError.stdout ?? execError.stderr ?? "";
+	}
+}
+
 //#endregion
 //#region src/utils/game-output.ts
 function formatGameOutputNotice(filePath, entryCount) {
@@ -1442,4 +1926,4 @@ function writeGameOutput(filePath, entries) {
 }
 
 //#endregion
-export { buildJestArgv as _, formatJson as a, extractJsonFromOutput as b, formatResult as c, resolveConfig as d, DEFAULT_CONFIG as f, createOpenCloudBackend as g, OpenCloudBackend as h, execute as i, formatTestSummary as l, createStudioBackend as m, parseGameOutput as n, writeJsonFile as o, StudioBackend as p, writeGameOutput as r, formatFailure as s, formatGameOutputNotice as t, loadConfig as u, generateTestScript as v, parseJestOutput as x, LuauScriptError as y };
+export { extractJsonFromOutput as C, LuauScriptError as S, createStudioBackend as _, execute as a, buildJestArgv as b, formatFailure as c, loadConfig as d, resolveConfig as f, StudioBackend as g, isValidBackend as h, runTypecheck as i, formatResult as l, VALID_BACKENDS as m, parseGameOutput as n, formatJson as o, DEFAULT_CONFIG as p, writeGameOutput as r, writeJsonFile as s, formatGameOutputNotice as t, formatTestSummary as u, OpenCloudBackend as v, parseJestOutput as w, generateTestScript as x, createOpenCloudBackend as y };