@isentinel/jest-roblox 0.0.6 → 0.0.8

package/dist/cli.d.mts

@@ -1,4 +1,4 @@
-import { t as CliOptions } from "./schema-CG-f4OUB.mjs";
+import { t as CliOptions } from "./schema-DcDQmTyn.mjs";
 
 //#region src/cli.d.ts
 declare function parseArgs(args: Array<string>): CliOptions;

package/dist/cli.mjs

@@ -1,12 +1,12 @@
-import { _ as isValidBackend, a as execute, c as writeJsonFile, f as loadConfig, h as VALID_BACKENDS, i as runTypecheck, n as parseGameOutput, o as loadCoverageManifest, r as writeGameOutput, t as formatGameOutputNotice, w as LuauScriptError, x as createOpenCloudBackend, y as createStudioBackend } from "./game-output-lpY5mxJ_.mjs";
+import { C as createStudioBackend, O as LuauScriptError, T as createOpenCloudBackend, a as formatAnnotations, c as execute, d as writeJsonFile, g as loadConfig, h as rojoProjectSchema, i as runTypecheck, l as loadCoverageManifest, n as parseGameOutput, o as formatJobSummary, r as writeGameOutput, s as resolveGitHubActionsOptions, t as formatGameOutputNotice, x as isValidBackend, y as VALID_BACKENDS } from "./game-output-M8du29nj.mjs";
 import assert from "node:assert";
+import * as fs from "node:fs";
 import * as path$1 from "node:path";
 import process from "node:process";
 import { parseArgs as parseArgs$1 } from "node:util";
 import color from "tinyrainbow";
 import { WebSocketServer } from "ws";
 import { type } from "arktype";
-import * as fs from "node:fs";
 import * as os from "node:os";
 import { Buffer } from "node:buffer";
 import { TraceMap, originalPositionFor } from "@jridgewell/trace-mapping";
@@ -18,7 +18,7 @@ import istanbulReport from "istanbul-lib-report";
 import istanbulReports from "istanbul-reports";
 
 //#region package.json
-var version = "0.0.6";
+var version = "0.0.8";
 
 //#endregion
 //#region src/backends/auto.ts
@@ -41,7 +41,7 @@ var StudioWithFallback = class {
 };
 function isStudioBusyError(error) {
 	if (error instanceof LuauScriptError) return /previous call to start play session/i.test(error.message);
-	return error.code === "EADDRINUSE";
+	return typeof error === "object" && error !== null && "code" in error && error.code === "EADDRINUSE";
 }
 async function probeStudioPlugin(port, timeoutMs, createServer = (wsPort) => {
 	return new WebSocketServer({ port: wsPort });
@@ -139,15 +139,15 @@ function mapCoverageToTypeScript(coverageData, manifest) {
 	return buildResult(pendingStatements, pendingFunctions, pendingBranches);
 }
 function loadFileResources(record) {
-	let covMapRaw;
+	let coverageMapRaw;
 	let sourceMapRaw;
 	try {
-		covMapRaw = fs.readFileSync(record.coverageMapPath, "utf-8");
+		coverageMapRaw = fs.readFileSync(record.coverageMapPath, "utf-8");
 		sourceMapRaw = fs.readFileSync(record.sourceMapPath, "utf-8");
 	} catch {
 		return;
 	}
-	const parsed = coverageMapSchema(JSON.parse(covMapRaw));
+	const parsed = coverageMapSchema(JSON.parse(coverageMapRaw));
 	if (parsed instanceof type.errors) return;
 	return {
 		coverageMap: parsed,
@@ -278,10 +278,10 @@ function mapFileFunctions(resources, fileCoverage, pendingFunctions, resolvedTsP
 function mapBranchArmLocations(traceMap, rawLocations) {
 	const mappedLocations = [];
 	let tsPath;
-	for (const rawLoc of rawLocations) {
-		const loc = spanSchema(rawLoc);
-		if (loc instanceof type.errors) return;
-		const mapped = mapStatement(traceMap, loc);
+	for (const rawLocation of rawLocations) {
+		const location = spanSchema(rawLocation);
+		if (location instanceof type.errors) return;
+		const mapped = mapStatement(traceMap, location);
 		if (mapped === void 0) return;
 		if (tsPath === void 0) tsPath = mapped.start.source;
 		else if (tsPath !== mapped.start.source) return;
@@ -315,14 +315,14 @@ function mapFileBranches(resources, fileCoverage, pendingBranches) {
 			fileBranches = [];
 			pendingBranches.set(result.tsPath, fileBranches);
 		}
-		const firstLoc = result.locations[0];
-		const lastLoc = result.locations[result.locations.length - 1];
-		assert(firstLoc !== void 0 && lastLoc !== void 0, "Branch locations must not be empty after successful mapping");
+		const firstLocation = result.locations[0];
+		const lastLocation = result.locations[result.locations.length - 1];
+		assert(firstLocation !== void 0 && lastLocation !== void 0, "Branch locations must not be empty after successful mapping");
 		fileBranches.push({
 			armHitCounts: entry.locations.map((_, index) => armHitCounts[index] ?? 0),
 			loc: {
-				end: lastLoc.end,
-				start: firstLoc.start
+				end: lastLocation.end,
+				start: firstLocation.start
 			},
 			locations: result.locations,
 			type: entry.type
@@ -877,17 +877,17 @@ function extractFunctionName(node) {
 }
 
 //#endregion
-//#region src/coverage/covmap-builder.ts
+//#region src/coverage/coverage-map-builder.ts
 function buildCoverageMap$1(result) {
 	const statementMap = {};
-	for (const stmt of result.statements) statementMap[String(stmt.index)] = {
+	for (const statement of result.statements) statementMap[String(statement.index)] = {
 		end: {
-			column: stmt.location.endcolumn,
-			line: stmt.location.endline
+			column: statement.location.endcolumn,
+			line: statement.location.endline
 		},
 		start: {
-			column: stmt.location.begincolumn,
-			line: stmt.location.beginline
+			column: statement.location.begincolumn,
+			line: statement.location.beginline
 		}
 	};
 	const functionMap = {};
@@ -980,14 +980,13 @@ function collectProbes(result) {
 }
 /** Mutates `mutableLines` in place, inserting probe text at each probe's position. */
 function applyProbes(mutableLines, probes) {
-	for (const probe of probes) {
-		const lineIndex = probe.line - 1;
+	for (const { column, line: probeLine, text } of probes) {
+		const lineIndex = probeLine - 1;
 		const line = mutableLines[lineIndex];
-		assert(line !== void 0, `Invalid probe line number: ${probe.line}`);
-		const col = probe.column;
-		const before = line.slice(0, col - 1);
-		const after = line.slice(col - 1);
-		mutableLines[lineIndex] = before + probe.text + after;
+		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;
 	}
 }
 function extractModeDirective(lines) {
@@ -1100,9 +1099,9 @@ function instrumentRoot(options) {
 		const source = fs.readFileSync(path$1.resolve(originalLuauPath), "utf-8");
 		const collectorResult = collectCoverage(ast);
 		const instrumentedSource = insertProbes(source, collectorResult, fileKey);
-		const covmap = buildCoverageMap$1(collectorResult);
+		const coverageMap = buildCoverageMap$1(collectorResult);
 		fs.writeFileSync(path$1.join(shadowDir, relativePath), instrumentedSource);
-		fs.writeFileSync(coverageMapOutputPath, JSON.stringify(covmap, void 0, "	"));
+		fs.writeFileSync(coverageMapOutputPath, JSON.stringify(coverageMap, void 0, "	"));
 		files[fileKey] = {
 			key: fileKey,
 			branchCount: collectorResult.branches.length,
@@ -1232,7 +1231,9 @@ function prepareCoverage(config) {
 	};
 	fs.mkdirSync(path$1.dirname(manifestPath), { recursive: true });
 	fs.writeFileSync(manifestPath, JSON.stringify(manifest, void 0, "	"));
-	const rewritten = rewriteRojoProject(JSON.parse(fs.readFileSync(rojoProjectPath, "utf-8")), {
+	const rojoProjectRaw = rojoProjectSchema(JSON.parse(fs.readFileSync(rojoProjectPath, "utf-8")));
+	if (rojoProjectRaw instanceof type.errors) throw new Error(`Malformed Rojo project JSON: ${rojoProjectRaw.toString()}`);
+	const rewritten = rewriteRojoProject(rojoProjectRaw, {
 		projectRelocation: path$1.relative(COVERAGE_DIR, path$1.dirname(rojoProjectPath)).replaceAll("\\", "/"),
 		roots
 	});
@@ -1433,6 +1434,7 @@ Options:
   --coverage                Enable coverage collection
   --coverageDirectory <path>  Directory for coverage output (default: coverage)
   --coverageReporters <r...>  Coverage reporters (default: text, lcov)
+  --formatters <name...>    Output formatters (default: default; auto: github-actions)
   --no-cache                Force re-upload place file (skip cache)
   --pollInterval <ms>       Open Cloud poll interval in ms (default: 500)
   --projects <path...>      DataModel paths to search for tests
@@ -1475,6 +1477,10 @@ function parseArgs(args) {
 				multiple: true,
 				type: "string"
 			},
+			"formatters": {
+				multiple: true,
+				type: "string"
+			},
 			"gameOutput": { type: "string" },
 			"help": {
 				default: false,
@@ -1539,6 +1545,7 @@ function parseArgs(args) {
 		coverageDirectory: values.coverageDirectory,
 		coverageReporters: values.coverageReporters,
 		files: positionals.length > 0 ? positionals : void 0,
+		formatters: values.formatters,
 		gameOutput: values.gameOutput,
 		help: values.help,
 		json: values.json,
@@ -1630,6 +1637,30 @@ function processCoverage(config, coverageData) {
 	}
 	return true;
 }
+function findFormatterOptions(formatters, name) {
+	for (const entry of formatters) {
+		if (entry === name) return {};
+		if (Array.isArray(entry) && entry[0] === name) return entry[1];
+	}
+}
+function runGitHubActionsFormatter(config, result, sourceMapper) {
+	const userOptions = findFormatterOptions(config.formatters, "github-actions");
+	if (userOptions === void 0) return;
+	const typedOptions = userOptions;
+	const options = resolveGitHubActionsOptions(typedOptions, sourceMapper);
+	if (typedOptions.displayAnnotations !== false) {
+		const annotations = formatAnnotations(result, options);
+		if (annotations !== "") process.stderr.write(`${annotations}\n`);
+	}
+	const { jobSummary } = typedOptions;
+	if (jobSummary?.enabled !== false) {
+		const outputPath = jobSummary?.outputPath ?? process.env["GITHUB_STEP_SUMMARY"];
+		if (outputPath !== void 0) {
+			const summary = formatJobSummary(result, options);
+			fs.appendFileSync(outputPath, summary);
+		}
+	}
+}
 async function outputResults(config, typecheckResult, runtimeResult) {
 	const mergedResult = mergeResults(typecheckResult, runtimeResult?.result);
 	if (runtimeResult !== void 0 && runtimeResult.output !== "") console.log(runtimeResult.output);
@@ -1637,6 +1668,7 @@ async function outputResults(config, typecheckResult, runtimeResult) {
 	if (typecheckResult !== void 0 && !config.silent) printTypecheckSummary(typecheckResult);
 	if (config.outputFile !== void 0) await writeJsonFile(mergedResult, config.outputFile);
 	if (runtimeResult !== void 0) writeGameOutputIfConfigured(config, runtimeResult.gameOutput, { hintsShown: !mergedResult.success });
+	runGitHubActionsFormatter(config, mergedResult, runtimeResult?.sourceMapper);
 	const passed = mergedResult.success && coveragePassed;
 	if (!config.silent && config.collectCoverage) printFinalStatus(passed);
 	return passed ? 0 : 1;
@@ -1725,6 +1757,11 @@ function validateBackend(value) {
 function getLuauErrorHint(message) {
 	for (const [pattern, hint] of LUAU_ERROR_HINTS) if (pattern.test(message)) return hint;
 }
+function resolveFormatters(cli, config) {
+	const explicit = cli.formatters ?? config.formatters;
+	if (explicit !== void 0) return explicit;
+	return process.env["GITHUB_ACTIONS"] === "true" ? ["default", "github-actions"] : ["default"];
+}
 function mergeCliWithConfig(cli, config) {
 	return {
 		...config,
@@ -1736,6 +1773,7 @@ function mergeCliWithConfig(cli, config) {
 		compactMaxFailures: cli.compactMaxFailures ?? config.compactMaxFailures,
 		coverageDirectory: cli.coverageDirectory ?? config.coverageDirectory,
 		coverageReporters: cli.coverageReporters ?? config.coverageReporters,
+		formatters: resolveFormatters(cli, config),
 		gameOutput: cli.gameOutput ?? config.gameOutput,
 		json: cli.json ?? config.json,
 		outputFile: cli.outputFile ?? config.outputFile,
@@ -1763,6 +1801,7 @@ function mergeResults(typecheck, runtime) {
 		numFailedTests: typecheck.numFailedTests + runtime.numFailedTests,
 		numPassedTests: typecheck.numPassedTests + runtime.numPassedTests,
 		numPendingTests: typecheck.numPendingTests + runtime.numPendingTests,
+		numTodoTests: (typecheck.numTodoTests ?? 0) + (runtime.numTodoTests ?? 0),
 		numTotalTests: typecheck.numTotalTests + runtime.numTotalTests,
 		startTime: Math.min(typecheck.startTime, runtime.startTime),
 		success: typecheck.success && runtime.success,

package/dist/{game-output-lpY5mxJ_.mjs → game-output-M8du29nj.mjs}

@@ -1,12 +1,12 @@
 import assert from "node:assert";
+import * as fs from "node:fs";
+import { existsSync } from "node:fs";
 import * as path$1 from "node:path";
 import path from "node:path";
 import process from "node:process";
 import color from "tinyrainbow";
 import { WebSocketServer } from "ws";
 import { type } from "arktype";
-import * as fs from "node:fs";
-import { existsSync } from "node:fs";
 import { homedir, tmpdir } from "node:os";
 import * as crypto from "node:crypto";
 import { randomUUID } from "node:crypto";
@@ -82,15 +82,15 @@ function parseJestOutput(output) {
 			};
 		} catch {}
 	}
-	const jsonStr = extractJsonFromOutput(output);
-	if (jsonStr === void 0) throw new Error(`No valid Jest result JSON found in output, output was:\n${output}`);
-	return { result: validateJestResult(JSON.parse(jsonStr)) };
+	const jsonString = extractJsonFromOutput(output);
+	if (jsonString === void 0) throw new Error(`No valid Jest result JSON found in output, output was:\n${output}`);
+	return { result: validateJestResult(JSON.parse(jsonString)) };
 }
 function countBraces(line) {
 	let count = 0;
-	for (const char of line) {
-		if (char === "{") count++;
-		if (char === "}") count--;
+	for (const character of line) {
+		if (character === "{") count++;
+		if (character === "}") count--;
 	}
 	return count;
 }
@@ -311,6 +311,12 @@ function createFetchClient(defaultHeaders) {
 const OPEN_CLOUD_BASE_URL = "https://apis.roblox.com";
 const RATE_LIMIT_DEFAULT_WAIT_MS = 5e3;
 const MAX_RATE_LIMIT_RETRIES = 5;
+const taskResponse = type({ path: "string" });
+const taskStatusResponse = type({
+	"error?": { "message?": "string" },
+	"output?": { "results?": "string[]" },
+	"state": "'CANCELLED' | 'COMPLETE' | 'FAILED' | 'PROCESSING'"
+});
 var OpenCloudBackend = class {
 	credentials;
 	http;
@@ -319,7 +325,7 @@ var OpenCloudBackend = class {
 	constructor(credentials, options) {
 		this.credentials = credentials;
 		this.http = options?.http ?? createFetchClient({ "x-api-key": credentials.apiKey });
-		this.readFile = options?.readFile ?? ((fp) => fs.readFileSync(fp));
+		this.readFile = options?.readFile ?? ((filePath) => fs.readFileSync(filePath));
 		this.sleepFn = options?.sleep ?? (async (ms) => {
 			return new Promise((resolve) => {
 				setTimeout(resolve, ms);
@@ -334,14 +340,15 @@ var OpenCloudBackend = class {
 		const placeData = this.readFile(placeFilePath);
 		const fileHash = hashBuffer(placeData);
 		const cacheKey = getCacheKey(this.credentials.universeId, this.credentials.placeId);
-		let uploadCached = false;
 		const cache = readCache(cacheFilePath);
-		if (options.config.cache && isUploaded(cache, cacheKey, fileHash)) uploadCached = true;
-		else {
-			await this.uploadPlaceData(placeData);
-			markUploaded(cache, cacheKey, fileHash);
-			writeCache(cacheFilePath, cache);
-		}
+		const uploadCached = await this.uploadOrReuseCached({
+			cache,
+			cacheEnabled: options.config.cache,
+			cacheFilePath,
+			cacheKey,
+			fileHash,
+			placeData
+		});
 		const uploadMs = Date.now() - uploadStart;
 		const executionStart = Date.now();
 		const taskPath = await this.createExecutionTask(options);
@@ -369,7 +376,7 @@ var OpenCloudBackend = class {
 			timeout: `${Math.floor(options.config.timeout / 1e3)}s`
 		} });
 		if (!response.ok) throw new Error(`Failed to create execution task: ${response.status}`);
-		return response.body.path;
+		return taskResponse.assert(response.body).path;
 	}
 	async pollForCompletion(taskPath, timeoutMs, pollIntervalMs) {
 		const url = `${OPEN_CLOUD_BASE_URL}/cloud/v2/${taskPath}`;
@@ -385,7 +392,7 @@ var OpenCloudBackend = class {
 				continue;
 			}
 			if (!response.ok) throw new Error(`Failed to poll task: ${response.status}`);
-			const body = response.body;
+			const body = taskStatusResponse.assert(response.body);
 			switch (body.state) {
 				case "COMPLETE": {
 					const value = body.output?.results?.[0];
@@ -404,6 +411,13 @@ var OpenCloudBackend = class {
 		}
 		throw new Error("Execution timed out");
 	}
+	async uploadOrReuseCached({ cache, cacheEnabled, cacheFilePath, cacheKey, fileHash, placeData }) {
+		if (cacheEnabled && isUploaded(cache, cacheKey, fileHash)) return true;
+		await this.uploadPlaceData(placeData);
+		markUploaded(cache, cacheKey, fileHash);
+		writeCache(cacheFilePath, cache);
+		return false;
+	}
 	async uploadPlaceData(placeData) {
 		const url = `${OPEN_CLOUD_BASE_URL}/universes/v1/${this.credentials.universeId}/places/${this.credentials.placeId}/versions?versionType=Saved`;
 		const response = await this.http.request("POST", url, {
@@ -415,10 +429,10 @@ var OpenCloudBackend = class {
 };
 function createOpenCloudBackend() {
 	const apiKey = process.env["ROBLOX_OPEN_CLOUD_API_KEY"];
-	const universeId = process.env["ROBLOX_UNIVERSE_ID"];
-	const placeId = process.env["ROBLOX_PLACE_ID"];
 	if (apiKey === void 0) throw new Error("ROBLOX_OPEN_CLOUD_API_KEY environment variable is required");
+	const universeId = process.env["ROBLOX_UNIVERSE_ID"];
 	if (universeId === void 0) throw new Error("ROBLOX_UNIVERSE_ID environment variable is required");
+	const placeId = process.env["ROBLOX_PLACE_ID"];
 	if (placeId === void 0) throw new Error("ROBLOX_PLACE_ID environment variable is required");
 	return new OpenCloudBackend({
 		apiKey,
@@ -436,6 +450,7 @@ function parseRetryAfter(headers) {
 
 //#endregion
 //#region src/backends/studio.ts
+const DEFAULT_STUDIO_TIMEOUT = 3e5;
 const pluginMessageSchema = type({
 	"gameOutput?": "string",
 	"jestOutput": "string",
@@ -449,7 +464,7 @@ var StudioBackend = class {
 	preConnected;
 	constructor(options) {
 		this.port = options.port;
-		this.timeout = options.timeout ?? 3e5;
+		this.timeout = options.timeout ?? DEFAULT_STUDIO_TIMEOUT;
 		this.createServer = options.createServer ?? ((port) => new WebSocketServer({ port }));
 		this.preConnected = options.preConnected;
 	}
@@ -573,7 +588,11 @@ const DEFAULT_CONFIG = {
 		"**/*.test.lua",
 		"**/*.test.luau"
 	],
-	testPathIgnorePatterns: ["/node_modules/", "/dist/"],
+	testPathIgnorePatterns: [
+		"/node_modules/",
+		"/dist/",
+		"/out/"
+	],
 	timeout: 3e5,
 	typecheck: false,
 	typecheckOnly: false,
@@ -630,6 +649,14 @@ async function loadConfig$1(configPath, cwd = process.cwd()) {
 	return resolveConfig(result.config);
 }
 
+//#endregion
+//#region src/types/rojo.ts
+const rojoProjectSchema = type({
+	"name": "string",
+	"servePort?": "number.integer",
+	"tree": "object"
+}).as();
+
 //#endregion
 //#region src/utils/normalize-windows-path.ts
 const DRIVE_LETTER_START_REGEX = /^[A-Za-z]:\//;
@@ -666,7 +693,7 @@ function createPathResolver(rojoProject, config) {
 			if (key.startsWith("$") || typeof value !== "object") continue;
 			const dataModelPath = prefix ? `${prefix}.${key}` : key;
 			const node = value;
-			if (typeof node["$path"] === "string") mappings.set(dataModelPath, node["$path"]);
+			if (typeof node.$path === "string") mappings.set(dataModelPath, node.$path);
 			walkTree(node, dataModelPath);
 		}
 	}
@@ -876,7 +903,7 @@ function hasExecError(file) {
 
 //#endregion
 //#region src/utils/banner.ts
-const SEPARATOR = "⎯";
+const SEPARATOR$1 = "⎯";
 const levelStyles = {
 	error: {
 		badge: (text) => color.bgRed(color.white(color.bold(text))),
@@ -895,7 +922,7 @@ function formatBannerBar({ level, termWidth, title }) {
 	const remaining = width - badgeText.length;
 	const leftWidth = Math.max(1, Math.floor(remaining / 2));
 	const rightWidth = Math.max(1, remaining - leftWidth);
-	return `${styles.separator(SEPARATOR.repeat(leftWidth))}${badge}${styles.separator(SEPARATOR.repeat(rightWidth))}`;
+	return `${styles.separator(SEPARATOR$1.repeat(leftWidth))}${badge}${styles.separator(SEPARATOR$1.repeat(rightWidth))}`;
 }
 function formatBanner({ body, level, termWidth, title }) {
 	const width = termWidth ?? getDefaultWidth();
@@ -905,7 +932,7 @@ function formatBanner({ body, level, termWidth, title }) {
 		termWidth: width,
 		title
 	});
-	const closing = styles.separator(SEPARATOR.repeat(width));
+	const closing = styles.separator(SEPARATOR$1.repeat(width));
 	return `\n${header}\n${body.length > 0 ? `\n${body.join("\n")}\n` : ""}\n${closing}\n\n`;
 }
 function getDefaultWidth() {
@@ -1106,27 +1133,27 @@ function cleanExecErrorMessage(raw) {
 }
 function formatSourceSnippet(snippet, filePath, options) {
 	const useColor = options?.useColor ?? true;
-	const st = options?.styles ?? createStyles(useColor);
+	const styles = options?.styles ?? createStyles(useColor);
 	const language = options?.language;
 	const lines = [];
 	const indent = "	";
 	const location = snippet.column !== void 0 ? `${filePath}:${snippet.failureLine}:${snippet.column}` : `${filePath}:${snippet.failureLine}`;
-	const langSuffix = language !== void 0 ? st.dim(`  (${language})`) : "";
-	lines.push(st.location(` ❯ ${location}`) + langSuffix);
+	const langSuffix = language !== void 0 ? styles.dim(`  (${language})`) : "";
+	lines.push(styles.location(` ❯ ${location}`) + langSuffix);
 	const maxLineNumber = Math.max(...snippet.lines.map((line) => line.num));
 	const padding = String(maxLineNumber).length;
 	for (const line of snippet.lines) {
 		const prefix = `${String(line.num).padStart(padding)}|`;
 		const highlighted = highlightSyntax(filePath, expandTabs(line.content), useColor);
 		if (line.num === snippet.failureLine) {
-			lines.push(`${indent}${st.lineNumber(prefix)} ${highlighted}`);
+			lines.push(`${indent}${styles.lineNumber(prefix)} ${highlighted}`);
 			if (snippet.column !== void 0) {
 				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("^")}`);
+				const gutterPrefix = styles.lineNumber(caretGutter);
+				lines.push(`${indent}${gutterPrefix} ${" ".repeat(beforeColumn.length)}${styles.status.fail("^")}`);
 			}
-		} else lines.push(`${indent}${st.lineNumber(prefix)} ${highlighted}`);
+		} else lines.push(`${indent}${styles.lineNumber(prefix)} ${highlighted}`);
 	}
 	return lines.join("\n");
 }
@@ -1305,27 +1332,27 @@ function highlightSyntax(filePath, code, useColor) {
 	if (!useColor) return code;
 	return highlightCode(filePath, code);
 }
-function formatDiffBlock(parsed, st) {
+function formatDiffBlock(parsed, styles) {
 	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));
+		for (const diffLine of parsed.snapshotDiff.split("\n")) if (diffLine.startsWith("- ")) lines.push(styles.diff.expected(diffLine));
+		else if (diffLine.startsWith("+ ")) lines.push(styles.diff.received(diffLine));
+		else lines.push(styles.dim(diffLine));
 		return lines;
 	}
 	if (parsed.expected !== void 0 && parsed.received !== void 0) return [
 		"",
-		st.diff.expected("- Expected"),
-		st.diff.received("+ Received"),
+		styles.diff.expected("- Expected"),
+		styles.diff.received("+ Received"),
 		"",
-		st.diff.expected(`- ${parsed.expected}`),
-		st.diff.received(`+ ${parsed.received}`)
+		styles.diff.expected(`- ${parsed.expected}`),
+		styles.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 formatErrorLine(parsed, styles, useColor) {
+	if (useColor && parsed.message.startsWith("Error:")) return styles.status.fail(color.bold("Error:") + parsed.message.slice(6));
+	return styles.status.fail(parsed.message);
 }
 function formatFallbackSnippet(message, styles, useColor) {
 	const location = parseSourceLocation(message);
@@ -1342,7 +1369,7 @@ function formatFallbackSnippet(message, styles, useColor) {
 		useColor
 	})];
 }
-function formatMappedLocationSnippets(loc, showLuau, st, useColor) {
+function formatMappedLocationSnippets(loc, showLuau, styles, useColor) {
 	const snippets = [];
 	if (loc.tsPath !== void 0 && loc.tsLine !== void 0) {
 		const tsSnippet = getSourceSnippet({
@@ -1356,7 +1383,7 @@ function formatMappedLocationSnippets(loc, showLuau, st, useColor) {
 			const label = showLuau ? "TypeScript" : void 0;
 			snippets.push("", formatSourceSnippet(tsSnippet, loc.tsPath, {
 				language: label,
-				styles: st,
+				styles,
 				useColor
 			}));
 		}
@@ -1368,7 +1395,7 @@ function formatMappedLocationSnippets(loc, showLuau, st, useColor) {
 			});
 			if (luauSnippet !== void 0) snippets.push("", formatSourceSnippet(luauSnippet, loc.luauPath, {
 				language: "Luau",
-				styles: st,
+				styles,
 				useColor
 			}));
 		}
@@ -1379,7 +1406,7 @@ function formatMappedLocationSnippets(loc, showLuau, st, useColor) {
 			line: loc.luauLine
 		});
 		if (luauSnippet !== void 0) snippets.push("", formatSourceSnippet(luauSnippet, loc.luauPath, {
-			styles: st,
+			styles,
 			useColor
 		}));
 	}
@@ -1406,22 +1433,24 @@ function formatSnapshotCallSnippet(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);
+	const { filePath, hasSnapshotDiff, mappedLocations, message, showLuau, sourceMapper, styles, useColor } = options;
+	if (mappedLocations.length > 0) return mappedLocations.flatMap((loc) => {
+		return formatMappedLocationSnippets(loc, showLuau, styles, useColor);
+	});
+	const fallback = formatFallbackSnippet(message, styles, useColor);
 	if (fallback.length > 0) return fallback;
-	if (hasSnapshotDiff && filePath !== void 0) return formatSnapshotCallSnippet(resolveDisplayPath(filePath, sourceMapper), st, useColor);
+	if (hasSnapshotDiff && filePath !== void 0) return formatSnapshotCallSnippet(resolveDisplayPath(filePath, sourceMapper), styles, useColor);
 	return [];
 }
 function formatFailureMessage(originalMessage, options) {
-	const { filePath, showLuau, sourceMapper, styles: st, useColor } = options;
+	const { filePath, showLuau, sourceMapper, styles, 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),
+		formatErrorLine(parsed, styles, useColor),
+		...formatDiffBlock(parsed, styles),
 		...resolveSourceSnippets({
 			filePath,
 			hasSnapshotDiff: parsed.snapshotDiff !== void 0,
@@ -1429,19 +1458,19 @@ function formatFailureMessage(originalMessage, options) {
 			message,
 			showLuau,
 			sourceMapper,
-			styles: st,
+			styles,
 			useColor
 		})
 	];
 }
-function formatSnapshotLine(snapshot, st) {
+function formatSnapshotLine(snapshot, styles) {
 	if (snapshot === void 0 || snapshot.unmatched === 0) return;
-	return `${st.dim("  Snapshots")}  ${st.summary.failed(`${snapshot.unmatched} failed`)}`;
+	return `${styles.dim("  Snapshots")}  ${styles.summary.failed(`${snapshot.unmatched} failed`)}`;
 }
 function formatFileFailures(file, options, styles, failureCtx) {
 	const lines = [];
 	const displayPath = resolveDisplayPath(file.testFilePath, options.sourceMapper);
-	for (const tc of file.testResults) if (tc.status === "failed") {
+	for (const testCase of file.testResults) if (testCase.status === "failed") {
 		const index = failureCtx.currentIndex;
 		failureCtx.currentIndex++;
 		lines.push(formatFailure({
@@ -1450,7 +1479,7 @@ function formatFileFailures(file, options, styles, failureCtx) {
 			showLuau: options.showLuau,
 			sourceMapper: options.sourceMapper,
 			styles,
-			test: tc,
+			test: testCase,
 			totalFailures: failureCtx.totalFailures,
 			useColor: options.color
 		}));
@@ -1480,24 +1509,24 @@ function formatLogHints(options, styles) {
 	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`) : "";
-	if (tc.status === "passed") return `${styles.status.pass("     ✓")}${styles.status.fail(` ${tc.title}`)}${duration}`;
-	const failedText = `     × ${tc.title}`;
+function formatTestInGroup(testCase, styles) {
+	const duration = testCase.duration !== void 0 ? styles.lineNumber(` ${testCase.duration}ms`) : "";
+	if (testCase.status === "passed") return `${styles.status.pass("     ✓")}${styles.status.fail(` ${testCase.title}`)}${duration}`;
+	const failedText = `     × ${testCase.title}`;
 	return `${styles.status.fail(failedText)}${duration}`;
 }
 function formatDescribeGroup(describeName, tests, styles) {
 	const lines = [];
-	const groupHasFailure = tests.some((tc) => tc.status === "failed");
+	const groupHasFailure = tests.some((testCase) => testCase.status === "failed");
 	const groupTestCount = tests.length;
-	const groupDuration = tests.reduce((sum, tc) => sum + (tc.duration ?? 0), 0);
+	const groupDuration = tests.reduce((sum, testCase) => sum + (testCase.duration ?? 0), 0);
 	const groupDurationStr = styles.lineNumber(` ${groupDuration}ms`);
 	if (groupHasFailure) {
-		const failedCount = tests.filter((tc) => tc.status === "failed").length;
+		const failedCount = tests.filter((testCase) => testCase.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));
+		for (const testCase of tests) lines.push(formatTestInGroup(testCase, styles));
 	} else {
 		const groupMeta = styles.dim(`(${groupTestCount} tests)`);
 		const marker = styles.status.pass("   ✓");
@@ -1556,7 +1585,7 @@ function formatPassedFileSummary(file, ctx) {
 	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));
+		for (const testCase of file.testResults) if (testCase.status === "passed") lines.push(formatPass(testCase, ctx.styles));
 	}
 	return lines;
 }
@@ -1596,7 +1625,7 @@ function formatCompact(result, options) {
 			lines.push(...failureLines);
 		}
 		for (const file of execErrors) {
-			const relativePath = makeRelative(resolveDisplayPath(file.testFilePath, options.sourceMapper), options.rootDir);
+			const relativePath = makeRelative$1(resolveDisplayPath(file.testFilePath, options.sourceMapper), options.rootDir);
 			assert(file.failureMessage !== void 0, "exec error files have failureMessage");
 			const errorMessage = cleanExecErrorMessage(file.failureMessage);
 			lines.push(`[FAIL] ${relativePath} - suite failed to run`, errorMessage);
@@ -1615,7 +1644,7 @@ function formatCompactLogHints(options) {
 	if (options.gameOutput !== void 0) lines.push(`View ${options.gameOutput} for Roblox game logs`);
 	return lines.join("\n");
 }
-function makeRelative(filePath, rootDirectory) {
+function makeRelative$1(filePath, rootDirectory) {
 	if (filePath.startsWith(rootDirectory)) return path.relative(rootDirectory, filePath);
 	return filePath;
 }
@@ -1683,7 +1712,7 @@ function formatCompactFailure(test, filePath, options) {
 		if (options.sourceMapper !== void 0) ({locations: mappedLocations, message} = options.sourceMapper.mapFailureWithLocations(originalMessage));
 		const parsed = parseErrorMessage(originalMessage);
 		const location = findFailureLocation(mappedLocations, message);
-		const relativePath = makeRelative(location?.path ?? filePath, options.rootDir);
+		const relativePath = makeRelative$1(location?.path ?? filePath, options.rootDir);
 		const lineInfo = location?.line !== void 0 ? `:${location.line}` : "";
 		lines.push(`[FAIL] ${relativePath}${lineInfo} - ${test.title}`);
 		if (parsed.snapshotDiff !== void 0) lines.push(parsed.snapshotDiff);
@@ -1739,7 +1768,7 @@ function buildMappings(tree, prefix) {
 		if (key.startsWith("$") || typeof value !== "object") continue;
 		const dataModelPath = prefix ? `${prefix}/${key}` : key;
 		const node = value;
-		if (typeof node["$path"] === "string") mappings.push([dataModelPath, node["$path"]]);
+		if (typeof node.$path === "string") mappings.push([dataModelPath, node.$path]);
 		mappings.push(...buildMappings(node, dataModelPath));
 	}
 	mappings.sort((a, b) => b[0].length - a[0].length);
@@ -1748,7 +1777,6 @@ function buildMappings(tree, prefix) {
 
 //#endregion
 //#region src/executor.ts
-const rojoProjectSchema = type({ tree: "object" });
 function isLuauProject(testFiles, tsconfigDirectories) {
 	if (tsconfigDirectories.outDir !== void 0) return false;
 	if (testFiles.some((file) => /\.tsx?$/.test(file))) return false;
@@ -1820,7 +1848,8 @@ async function execute(options) {
 		exitCode: result.success ? 0 : 1,
 		gameOutput,
 		output,
-		result
+		result,
+		sourceMapper
 	};
 }
 function normalizeDirectoryPath(directory) {
@@ -1878,10 +1907,13 @@ const instrumentedFileRecordSchema = type({
 const coverageManifestSchema = type({
 	files: type("Record<string, unknown>").pipe((files) => {
 		const validated = {};
+		const skipped = [];
 		for (const [key, value] of Object.entries(files)) {
 			const parsed = instrumentedFileRecordSchema(value);
-			if (!(parsed instanceof type.errors)) validated[key] = parsed;
+			if (parsed instanceof type.errors) skipped.push(key);
+			else validated[key] = parsed;
 		}
+		if (skipped.length > 0) process.stderr.write(`Warning: ${skipped.length} file record(s) in coverage manifest failed validation and were skipped: ${skipped.join(", ")}\n`);
 		return validated;
 	}),
 	generatedAt: "string",
@@ -1951,6 +1983,154 @@ function writeSnapshots(snapshotWrites, config, tsconfigDirectories) {
 	}
 }
 
+//#endregion
+//#region src/formatters/github-actions.ts
+const SEPARATOR = " · ";
+function escapeData(value) {
+	return value.replace(/%/g, "%25").replace(/\r/g, "%0D").replace(/\n/g, "%0A");
+}
+function escapeProperty(value) {
+	return value.replace(/%/g, "%25").replace(/\r/g, "%0D").replace(/\n/g, "%0A").replace(/:/g, "%3A").replace(/,/g, "%2C");
+}
+function formatAnnotation(annotation) {
+	const properties = [`file=${escapeProperty(annotation.file)}`];
+	if (annotation.line !== void 0) properties.push(`line=${String(annotation.line)}`);
+	if (annotation.col !== void 0) properties.push(`col=${String(annotation.col)}`);
+	if (annotation.title !== void 0) properties.push(`title=${escapeProperty(annotation.title)}`);
+	return `::error ${properties.join(",")}::${escapeData(annotation.message)}`;
+}
+function collectAnnotations(result, options) {
+	const annotations = [];
+	for (const file of result.testResults) {
+		if (hasExecError(file)) {
+			collectExecErrorAnnotation(annotations, file, options);
+			continue;
+		}
+		collectTestFailureAnnotations(annotations, file, options);
+	}
+	return annotations;
+}
+function formatAnnotations(result, options) {
+	const annotations = collectAnnotations(result, options);
+	if (annotations.length === 0) return "";
+	return annotations.map(formatAnnotation).join("\n");
+}
+function formatJobSummary(result, options) {
+	const fileLink = createFileLink(options);
+	const lines = ["## Test Results\n", renderStats(result)];
+	const failures = [];
+	for (const file of result.testResults) {
+		if (hasExecError(file)) {
+			failures.push({
+				file: makeRelative(file.testFilePath, options.workspace),
+				title: "Test suite failed to run"
+			});
+			continue;
+		}
+		for (const test of file.testResults) {
+			if (test.status !== "failed") continue;
+			failures.push({
+				file: makeRelative(file.testFilePath, options.workspace),
+				title: test.fullName
+			});
+		}
+	}
+	if (failures.length > 0) {
+		lines.push("### Failures\n");
+		for (const failure of failures) {
+			const link = fileLink(failure.file);
+			const fileRef = link !== void 0 ? `[${failure.file}](${link})` : failure.file;
+			lines.push(`- **${failure.title}** in ${fileRef}`);
+		}
+		lines.push("");
+	}
+	return lines.join("\n");
+}
+function resolveGitHubActionsOptions(userOptions, sourceMapper, environment = process.env) {
+	return {
+		repository: userOptions.jobSummary?.fileLinks?.repository ?? environment["GITHUB_REPOSITORY"],
+		serverUrl: environment["GITHUB_SERVER_URL"],
+		sha: userOptions.jobSummary?.fileLinks?.commitHash ?? environment["GITHUB_SHA"],
+		sourceMapper,
+		workspace: userOptions.jobSummary?.fileLinks?.workspacePath ?? environment["GITHUB_WORKSPACE"]
+	};
+}
+function makeRelative(filePath, workspace) {
+	if (workspace === void 0) return filePath;
+	const normalized = filePath.replace(/\\/g, "/");
+	const normalizedWorkspace = workspace.replace(/\\/g, "/").replace(/\/$/, "");
+	if (normalized.startsWith(`${normalizedWorkspace}/`)) return normalized.slice(normalizedWorkspace.length + 1);
+	return filePath;
+}
+function collectExecErrorAnnotation(annotations, file, options) {
+	annotations.push({
+		file: makeRelative(file.testFilePath, options.workspace),
+		message: file.failureMessage,
+		title: "Test suite failed to run"
+	});
+}
+function collectTestFailureAnnotations(annotations, file, options) {
+	for (const test of file.testResults) {
+		if (test.status !== "failed") continue;
+		const firstFailure = test.failureMessages[0] ?? "";
+		let annotationFile = file.testFilePath;
+		let line;
+		let column;
+		if (options.sourceMapper !== void 0 && firstFailure !== "") {
+			const location = options.sourceMapper.mapFailureWithLocations(firstFailure).locations[0];
+			if (location?.tsPath !== void 0) {
+				annotationFile = location.tsPath;
+				line = location.tsLine;
+				column = location.tsColumn;
+			} else if (location !== void 0) {
+				annotationFile = location.luauPath;
+				line = location.luauLine;
+			}
+		}
+		annotations.push({
+			col: column,
+			file: makeRelative(annotationFile, options.workspace),
+			line,
+			message: firstFailure,
+			title: test.fullName
+		});
+	}
+}
+function noun(count, singular, plural) {
+	return count === 1 ? singular : plural;
+}
+function renderStats(result) {
+	const failedFiles = result.testResults.filter((file) => file.numFailingTests > 0 || hasExecError(file)).length;
+	const passedFiles = result.testResults.filter((file) => file.numFailingTests === 0 && !hasExecError(file)).length;
+	const totalFiles = failedFiles + passedFiles;
+	const fileInfo = [];
+	if (failedFiles > 0) fileInfo.push(`❌ **${String(failedFiles)} ${noun(failedFiles, "failure", "failures")}**`);
+	if (passedFiles > 0) fileInfo.push(`✅ **${String(passedFiles)} ${noun(passedFiles, "pass", "passes")}**`);
+	fileInfo.push(`${String(totalFiles)} total`);
+	const testInfo = [];
+	if (result.numFailedTests > 0) testInfo.push(`❌ **${String(result.numFailedTests)} ${noun(result.numFailedTests, "failure", "failures")}**`);
+	if (result.numPassedTests > 0) testInfo.push(`✅ **${String(result.numPassedTests)} ${noun(result.numPassedTests, "pass", "passes")}**`);
+	const primaryTotal = result.numFailedTests + result.numPassedTests;
+	testInfo.push(`${String(primaryTotal)} total`);
+	let output = "### Summary\n\n";
+	output += `- **Test Files**: ${fileInfo.join(SEPARATOR)}\n`;
+	output += `- **Test Results**: ${testInfo.join(SEPARATOR)}\n`;
+	const otherInfo = [];
+	if (result.numPendingTests > 0) otherInfo.push(`${String(result.numPendingTests)} ${noun(result.numPendingTests, "skip", "skips")}`);
+	if (result.numTodoTests !== void 0 && result.numTodoTests > 0) otherInfo.push(`${String(result.numTodoTests)} ${noun(result.numTodoTests, "todo", "todos")}`);
+	if (otherInfo.length > 0) {
+		const otherTotal = result.numPendingTests + (result.numTodoTests ?? 0);
+		otherInfo.push(`${String(otherTotal)} total`);
+		output += `- **Other**: ${otherInfo.join(SEPARATOR)}\n`;
+	}
+	return output;
+}
+function createFileLink(options) {
+	const { repository, serverUrl, sha } = options;
+	if (serverUrl === void 0 || repository === void 0 || sha === void 0) return (_filePath) => {};
+	return (filePath) => `${serverUrl}/${repository}/blob/${sha}/${filePath}`;
+}
+
 //#endregion
 //#region src/typecheck/collect.ts
 const TEST_FUNCTIONS = new Set(["it", "test"]);
@@ -2021,28 +2201,28 @@ function extractDefinition(node, source) {
 
 //#endregion
 //#region src/typecheck/parse.ts
-const errCodeRegExp = /error TS(?<errCode>\d+)/;
+const errorCodeRegExp = /error TS(?<errorCode>\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 [lineString, columnString] = rest.slice(1, closeParenIndex).split(",");
+	if (lineString === void 0 || lineString === "" || columnString === void 0 || columnString === "") 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 errorCodeString = errorCodeRegExp.exec(afterParen)?.groups?.["errorCode"];
+	if (errorCodeString === void 0) return [filePath, null];
+	const errorCode = Number(errorCodeString);
+	const marker = `error TS${String(errorCode)}: `;
 	const markerIndex = afterParen.indexOf(marker);
-	const errMessage = afterParen.slice(markerIndex + marker.length).trim();
+	const errorMessage = afterParen.slice(markerIndex + marker.length).trim();
 	return [filePath, {
-		column: Number(colStr),
-		errCode,
-		errMsg: errMessage,
+		column: Number(columnString),
+		errorCode,
+		errorMessage,
 		filePath,
-		line: Number(lineStr)
+		line: Number(lineString)
 	}];
 }
 function parseTscOutput(stdout) {
@@ -2128,7 +2308,7 @@ function buildFileResult(filePath, fileInfo, errors) {
 	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}`;
+		const message = `TS${String(error.errorCode)}: ${error.errorMessage}`;
 		if (definition) {
 			const existing = errorsByTest.get(definition.name) ?? [];
 			existing.push(message);
@@ -2152,7 +2332,7 @@ function buildFileResult(filePath, fileInfo, errors) {
 		status: "failed",
 		title: "<file-level type error>"
 	});
-	const numberFailing = testCases.filter((tc) => tc.status === "failed").length;
+	const numberFailing = testCases.filter((testCase) => testCase.status === "failed").length;
 	return {
 		numFailingTests: numberFailing,
 		numPassingTests: testCases.length - numberFailing,
@@ -2209,4 +2389,4 @@ function writeGameOutput(filePath, entries) {
 }
 
 //#endregion
-export { generateTestScript as C, parseJestOutput as E, buildJestArgv as S, extractJsonFromOutput as T, isValidBackend as _, execute as a, OpenCloudBackend as b, writeJsonFile as c, formatTestSummary as d, loadConfig$1 as f, defineConfig as g, VALID_BACKENDS as h, runTypecheck as i, formatFailure as l, DEFAULT_CONFIG as m, parseGameOutput as n, loadCoverageManifest as o, resolveConfig as p, writeGameOutput as r, formatJson as s, formatGameOutputNotice as t, formatResult as u, StudioBackend as v, LuauScriptError as w, createOpenCloudBackend as x, createStudioBackend as y };
+export { parseJestOutput as A, createStudioBackend as C, generateTestScript as D, buildJestArgv as E, LuauScriptError as O, StudioBackend as S, createOpenCloudBackend as T, resolveConfig as _, formatAnnotations as a, defineConfig as b, execute as c, writeJsonFile as d, formatFailure as f, loadConfig$1 as g, rojoProjectSchema as h, runTypecheck as i, extractJsonFromOutput as k, loadCoverageManifest as l, formatTestSummary as m, parseGameOutput as n, formatJobSummary as o, formatResult as p, writeGameOutput as r, resolveGitHubActionsOptions as s, formatGameOutputNotice as t, formatJson as u, DEFAULT_CONFIG as v, OpenCloudBackend as w, isValidBackend as x, VALID_BACKENDS as y };

package/dist/index.d.mts

@@ -1,5 +1,6 @@
-import { a as SnapshotFormatOptions, i as ResolvedConfig, n as Config, o as defineConfig, r as DEFAULT_CONFIG, s as Argv, t as CliOptions } from "./schema-CG-f4OUB.mjs";
+import { a as ResolvedConfig, c as Argv, i as FormatterEntry, n as Config, o as SnapshotFormatOptions, r as DEFAULT_CONFIG, s as defineConfig, t as CliOptions } from "./schema-DcDQmTyn.mjs";
 import { WebSocket, WebSocketServer } from "ws";
+import "arktype";
 import buffer from "node:buffer";
 
 //#region src/coverage/types.d.ts
@@ -17,12 +18,18 @@ interface RawFileCoverage {
 type RawCoverageData = Record<string, RawFileCoverage>;
 //#endregion
 //#region src/types/jest-result.d.ts
-type TestStatus = "failed" | "passed" | "pending" | "skipped";
+type TestStatus = "disabled" | "failed" | "passed" | "pending" | "skipped" | "todo";
 interface TestCaseResult {
   ancestorTitles: Array<string>;
   duration?: number;
   failureMessages: Array<string>;
   fullName: string;
+  location?: {
+    column: number;
+    line: number;
+  };
+  numPassingAsserts?: number;
+  retryReasons?: Array<string>;
   status: TestStatus;
   title: string;
 }
@@ -45,6 +52,7 @@ interface JestResult {
   numFailedTests: number;
   numPassedTests: number;
   numPendingTests: number;
+  numTodoTests?: number;
   numTotalTests: number;
   snapshot?: SnapshotSummary;
   startTime: number;
@@ -121,6 +129,7 @@ declare class OpenCloudBackend implements Backend {
   runTests(options: BackendOptions): Promise<BackendResult>;
   private createExecutionTask;
   private pollForCompletion;
+  private uploadOrReuseCached;
   private uploadPlaceData;
 }
 declare function createOpenCloudBackend(): OpenCloudBackend;
@@ -157,22 +166,6 @@ declare function createStudioBackend(options: StudioOptions): StudioBackend;
 declare function resolveConfig(config: Config): ResolvedConfig;
 declare function loadConfig(configPath?: string, cwd?: string): Promise<ResolvedConfig>;
 //#endregion
-//#region src/executor.d.ts
-interface ExecuteOptions {
-  backend: Backend;
-  config: ResolvedConfig;
-  testFiles: Array<string>;
-  version: string;
-}
-interface ExecuteResult {
-  coverageData?: RawCoverageData;
-  exitCode: number;
-  gameOutput?: string;
-  output: string;
-  result: JestResult;
-}
-declare function execute(options: ExecuteOptions): Promise<ExecuteResult>;
-//#endregion
 //#region src/source-mapper/index.d.ts
 interface MappedLocation {
   luauLine: number;
@@ -192,6 +185,23 @@ interface SourceMapper {
   resolveTestFilePath(testFilePath: string): string | undefined;
 }
 //#endregion
+//#region src/executor.d.ts
+interface ExecuteOptions {
+  backend: Backend;
+  config: ResolvedConfig;
+  testFiles: Array<string>;
+  version: string;
+}
+interface ExecuteResult {
+  coverageData?: RawCoverageData;
+  exitCode: number;
+  gameOutput?: string;
+  output: string;
+  result: JestResult;
+  sourceMapper?: SourceMapper;
+}
+declare function execute(options: ExecuteOptions): Promise<ExecuteResult>;
+//#endregion
 //#region src/types/timing.d.ts
 interface TimingResult {
   executionMs: number;
@@ -263,6 +273,76 @@ declare function formatFailure({
 declare function formatTestSummary(result: JestResult, timing: TimingResult, styles?: Styles): string;
 declare function formatResult(result: JestResult, timing: TimingResult, options: FormatOptions): string;
 //#endregion
+//#region src/formatters/github-actions.d.ts
+interface GitHubActionsOptions {
+  repository?: string;
+  serverUrl?: string;
+  sha?: string;
+  sourceMapper?: SourceMapper;
+  workspace?: string;
+}
+interface GitHubActionsFormatterOptions {
+  /**
+  * Whether to emit `::error` workflow commands for test failures.
+  *
+  * @default true
+  */
+  displayAnnotations?: boolean;
+  /**
+  * Configuration for the GitHub Actions Job Summary.
+  *
+  * When enabled, a markdown summary of test results is written to the path
+  * specified by `outputPath`.
+  */
+  jobSummary?: Partial<JobSummaryOptions>;
+}
+interface JobSummaryOptions {
+  /**
+  * Whether to generate the summary.
+  *
+  * @default true
+  */
+  enabled: boolean;
+  /**
+  * Configuration for generating permalink URLs to source files in the
+  * GitHub repository.
+  *
+  * When all three values are available (either from this config or the
+  * defaults picked from environment variables), test names in the summary
+  * will link to the relevant source lines.
+  */
+  fileLinks: {
+    /**
+    * The commit SHA to use in permalink URLs.
+    *
+    * @default process.env.GITHUB_SHA
+    */
+    commitHash?: string;
+    /**
+    * The GitHub repository in `owner/repo` format.
+    *
+    * @default process.env.GITHUB_REPOSITORY
+    */
+    repository?: string;
+    /**
+    * The absolute path to the root of the repository on disk.
+    *
+    * Used to compute relative file paths for the permalink URLs.
+    *
+    * @default process.env.GITHUB_WORKSPACE
+    */
+    workspacePath?: string;
+  };
+  /**
+  * File path to write the summary to.
+  *
+  * @default process.env.GITHUB_STEP_SUMMARY
+  */
+  outputPath: string | undefined;
+}
+declare function formatAnnotations(result: JestResult, options: GitHubActionsOptions): string;
+declare function formatJobSummary(result: JestResult, options: GitHubActionsOptions): string;
+//#endregion
 //#region src/formatters/json.d.ts
 declare function formatJson(result: JestResult): string;
 declare function writeJsonFile(result: JestResult, filePath: string): Promise<void>;
@@ -278,8 +358,8 @@ declare function generateTestScript(options: BackendOptions): string;
 //#region src/typecheck/types.d.ts
 interface TscErrorInfo {
   column: number;
-  errCode: number;
-  errMsg: string;
+  errorCode: number;
+  errorMessage: string;
   filePath: string;
   line: number;
 }
@@ -311,4 +391,4 @@ declare function formatGameOutputNotice(filePath: string, entryCount: number): s
 declare function parseGameOutput(raw: string | undefined): Array<GameOutputEntry>;
 declare function writeGameOutput(filePath: string, entries: Array<GameOutputEntry>): void;
 //#endregion
-export { type Backend, type BackendOptions, type CliOptions, type Config, DEFAULT_CONFIG, type ExecuteOptions, type ExecuteResult, type GameOutputEntry, type JestArgv, type JestResult, OpenCloudBackend, type ResolvedConfig, StudioBackend, type TestCaseResult, type TestDefinition, type TestFileResult, type TestStatus, type TscErrorInfo, type TypecheckOptions, buildJestArgv, createOpenCloudBackend, createStudioBackend, defineConfig, execute, extractJsonFromOutput, formatFailure, formatGameOutputNotice, formatJson, formatResult, formatTestSummary, generateTestScript, loadConfig, parseGameOutput, parseJestOutput, resolveConfig, runTypecheck, writeGameOutput, writeJsonFile };
+export { type Backend, type BackendOptions, type CliOptions, type Config, DEFAULT_CONFIG, type ExecuteOptions, type ExecuteResult, type FormatterEntry, type GameOutputEntry, type GitHubActionsFormatterOptions, type JestArgv, type JestResult, OpenCloudBackend, type ResolvedConfig, StudioBackend, type TestCaseResult, type TestDefinition, type TestFileResult, type TestStatus, type TscErrorInfo, type TypecheckOptions, buildJestArgv, createOpenCloudBackend, createStudioBackend, defineConfig, execute, extractJsonFromOutput, formatAnnotations, formatFailure, formatGameOutputNotice, formatJobSummary, formatJson, formatResult, formatTestSummary, generateTestScript, loadConfig, parseGameOutput, parseJestOutput, resolveConfig, runTypecheck, writeGameOutput, writeJsonFile };

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { C as generateTestScript, E as parseJestOutput, S as buildJestArgv, T as extractJsonFromOutput, a as execute, b as OpenCloudBackend, c as writeJsonFile, d as formatTestSummary, f as loadConfig, g as defineConfig, i as runTypecheck, l as formatFailure, m as DEFAULT_CONFIG, n as parseGameOutput, p as resolveConfig, r as writeGameOutput, s as formatJson, t as formatGameOutputNotice, u as formatResult, v as StudioBackend, x as createOpenCloudBackend, y as createStudioBackend } from "./game-output-lpY5mxJ_.mjs";
+import { A as parseJestOutput, C as createStudioBackend, D as generateTestScript, E as buildJestArgv, S as StudioBackend, T as createOpenCloudBackend, _ as resolveConfig, a as formatAnnotations, b as defineConfig, c as execute, d as writeJsonFile, f as formatFailure, g as loadConfig, i as runTypecheck, k as extractJsonFromOutput, m as formatTestSummary, n as parseGameOutput, o as formatJobSummary, p as formatResult, r as writeGameOutput, t as formatGameOutputNotice, u as formatJson, v as DEFAULT_CONFIG, w as OpenCloudBackend } from "./game-output-M8du29nj.mjs";
 
-export { DEFAULT_CONFIG, OpenCloudBackend, StudioBackend, buildJestArgv, createOpenCloudBackend, createStudioBackend, defineConfig, execute, extractJsonFromOutput, formatFailure, formatGameOutputNotice, formatJson, formatResult, formatTestSummary, generateTestScript, loadConfig, parseGameOutput, parseJestOutput, resolveConfig, runTypecheck, writeGameOutput, writeJsonFile };
+export { DEFAULT_CONFIG, OpenCloudBackend, StudioBackend, buildJestArgv, createOpenCloudBackend, createStudioBackend, defineConfig, execute, extractJsonFromOutput, formatAnnotations, formatFailure, formatGameOutputNotice, formatJobSummary, formatJson, formatResult, formatTestSummary, generateTestScript, loadConfig, parseGameOutput, parseJestOutput, resolveConfig, runTypecheck, writeGameOutput, writeJsonFile };

package/dist/{schema-CG-f4OUB.d.mts → schema-DcDQmTyn.d.mts}

@@ -1,4 +1,4 @@
-import { DefineConfig } from "c12";
+import { ReportOptions } from "istanbul-reports";
 
 //#region ../../node_modules/.pnpm/@rbxts+jest@3.13.3-ts.1/node_modules/@rbxts/jest/src/config.d.ts
 interface ReporterConfig {
@@ -760,6 +760,8 @@ type _Except<ObjectType, KeysType extends keyof ObjectType, Options extends Requ
 //#endregion
 //#region src/config/schema.d.ts
 type Backend = "auto" | "open-cloud" | "studio";
+type CoverageReporter = keyof ReportOptions;
+type FormatterEntry = [string, Record<string, unknown>] | string;
 interface SnapshotFormatOptions {
   callToJSON?: boolean;
   escapeRegex?: boolean;
@@ -779,19 +781,21 @@ interface Config extends Except<Argv, "rootDir" | "setupFiles" | "setupFilesAfte
   compactMaxFailures?: number;
   coverageDirectory?: string;
   coveragePathIgnorePatterns?: Array<string>;
-  coverageReporters?: Array<string>;
+  coverageReporters?: Array<CoverageReporter>;
   coverageThreshold?: {
     branches?: number;
     functions?: number;
     lines?: number;
     statements?: number;
   };
+  formatters?: Array<FormatterEntry>;
   gameOutput?: string;
   jestPath?: string;
   luauRoots?: Array<string>;
   placeFile?: string;
   pollInterval?: number;
   port?: number;
+  reporters?: Array<string>;
   rojoProject?: string;
   rootDir?: string;
   setupFiles?: Array<string>;
@@ -815,7 +819,7 @@ interface ResolvedConfig extends Config {
   compactMaxFailures: number;
   coverageDirectory: string;
   coveragePathIgnorePatterns: Array<string>;
-  coverageReporters: Array<string>;
+  coverageReporters: Array<CoverageReporter>;
   json: boolean;
   placeFile: string;
   pollInterval: number;
@@ -843,8 +847,9 @@ interface CliOptions {
   compactMaxFailures?: number;
   config?: string;
   coverageDirectory?: string;
-  coverageReporters?: Array<string>;
+  coverageReporters?: Array<CoverageReporter>;
   files?: Array<string>;
+  formatters?: Array<string>;
   gameOutput?: string;
   help?: boolean;
   json?: boolean;
@@ -852,6 +857,7 @@ interface CliOptions {
   pollInterval?: number;
   port?: number;
   projects?: Array<string>;
+  reporters?: Array<string>;
   rojoProject?: string;
   setupFiles?: Array<string>;
   setupFilesAfterEnv?: Array<string>;
@@ -868,6 +874,6 @@ interface CliOptions {
   verbose?: boolean;
   version?: boolean;
 }
-declare const defineConfig: DefineConfig<Config>;
+declare const defineConfig: (input: Config) => Config;
 //#endregion
-export { SnapshotFormatOptions as a, ResolvedConfig as i, Config as n, defineConfig as o, DEFAULT_CONFIG as r, Argv as s, CliOptions as t };
+export { ResolvedConfig as a, Argv as c, FormatterEntry as i, Config as n, SnapshotFormatOptions as o, DEFAULT_CONFIG as r, defineConfig as s, CliOptions as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isentinel/jest-roblox",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "Jest-compatible CLI for running roblox-ts tests via Roblox Open Cloud",
   "keywords": [
     "jest",
@@ -52,7 +52,7 @@
     "ws": "8.18.0"
   },
   "devDependencies": {
-    "@isentinel/eslint-config": "5.0.0-beta.8",
+    "@isentinel/eslint-config": "5.0.0-beta.9",
     "@oxc-project/types": "0.120.0",
     "@rbxts/jest": "3.13.3-ts.1",
     "@rbxts/types": "1.0.911",
@@ -68,6 +68,8 @@
     "better-typescript-lib": "2.12.0",
     "bumpp": "10.4.1",
     "eslint": "9.39.2",
+    "eslint-plugin-jest-extended": "3.0.1",
+    "jest-extended": "7.0.0",
     "memfs": "4.56.11",
     "publint": "0.3.15",
     "tsdown": "0.20.1",