@isentinel/jest-roblox 0.1.0 → 0.1.2

package/README.md

@@ -1,27 +1,28 @@
-# jest-roblox-cli
+<h1 align="center">jest-roblox-cli</h1>
 
-[![npm version](https://img.shields.io/npm/v/@isentinel/jest-roblox)](https://www.npmx.dev/package/@isentinel/jest-roblox)
-[![CI](https://github.com/christopher-buss/jest-roblox-cli/actions/workflows/ci.yaml/badge.svg)](https://github.com/christopher-buss/jest-roblox-cli/actions/workflows/ci.yaml)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/christopher-buss/jest-roblox-cli/blob/main/LICENSE)
+<p align="center">
+  <a href="https://www.npmx.dev/package/@isentinel/jest-roblox"><img src="https://img.shields.io/npm/v/@isentinel/jest-roblox" alt="npm version"></a>
+  <a href="https://github.com/christopher-buss/jest-roblox-cli/actions/workflows/ci.yaml"><img src="https://github.com/christopher-buss/jest-roblox-cli/actions/workflows/ci.yaml/badge.svg" alt="CI"></a>
+  <a href="https://github.com/christopher-buss/jest-roblox-cli/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
+</p>
 
 
-Run your TypeScript and Luau tests inside Roblox, then see the results in your
-terminal.
+Run your roblox-ts and Luau tests inside Roblox, get results in your terminal.
 
-jest-roblox-cli builds a Roblox place from your test files, runs it in Roblox,
-and reports results in your terminal. It works with roblox-ts and pure Luau
-projects. For TypeScript, it maps Luau errors back to your `.ts` source.
-
-## Why?
-
-Roblox code can only run inside the Roblox engine. Standard test runners
-can't access the Roblox API. This tool bridges that gap by running tests in a
-real Roblox session and piping results back to your terminal.
+<p align="center">
+  <img src="assets/cli-example.png" alt="jest-roblox-cli output" width="700">
+</p>
 
 - roblox-ts and pure Luau
 - Source-mapped errors (Luau line numbers back to `.ts` files)
-- Code coverage
+- Code coverage (via [Lute](https://github.com/luau-lang/lute) instrumentation)
 - Two backends: Open Cloud (remote) and Studio (local)
+- Multiple output formatters (human, agent, JSON, GitHub Actions)
+
+> [!NOTE]
+> roblox-ts projects currently require
+> [@isentinel/roblox-ts](https://npmx.dev/package/@isentinel/roblox-ts) for
+> source maps and coverage support.
 
 ## Install
 
@@ -41,7 +42,7 @@ rokit add christopher-buss/jest-roblox-cli
 
 ```
 
-The standalone binary has a few limitations compared to the npm package:
+Limitations vs the npm package:
 
 - `--typecheck` and `--typecheckOnly` are not available
 - `.ts` config files are not supported (use `.json`, `.js`, or `.mjs`)
@@ -82,6 +83,7 @@ jest-roblox -t "should spawn"
 
 # Filter by file path
 jest-roblox --testPathPattern player
+jest-roblox --testPathPattern="modifiers|define\\.spec|triggers"
 
 # Use a specific backend
 jest-roblox --backend studio
@@ -90,12 +92,6 @@ jest-roblox --backend open-cloud
 # Collect coverage
 jest-roblox --coverage
 
-# Output JSON results
-jest-roblox --formatters json --outputFile results.json
-
-# Short output for AI tools
-jest-roblox --formatters agent
-
 # Save game output (print/warn/error) to file
 jest-roblox --gameOutput game-logs.txt
 
@@ -145,7 +141,7 @@ Precedence: CLI flags > config file > extended config > defaults.
 ### Coverage fields
 
 > [!IMPORTANT]
-> Coverage requires [Lute](https://github.com/4lve/lute) to be installed and
+> Coverage requires [Lute](https://github.com/luau-lang/lute) to be installed and
 > on your `PATH`. Lute parses Luau ASTs so the CLI can insert coverage probes.
 
 | Field | What it does | Default |
@@ -171,29 +167,23 @@ export default defineConfig({
 	projects: [
 		{
 			test: defineProject({
-				displayName: { name: "core", color: "magenta" },
-				include: ["src/**/*.spec.ts"],
+				displayName: { name: "client", color: "magenta" },
+				include: ["**/*.spec.ts"],
 				mockDataModel: true,
-				outDir: "out-test/src",
+				outDir: "out/src/client",
 			}),
 		},
 		{
 			test: defineProject({
-				displayName: { name: "core:integration", color: "white" },
-				include: ["test/**/*.spec.ts"],
-				mockDataModel: true,
-				outDir: "out-test/test",
+				displayName: { name: "server", color: "white" },
+				include: ["**/*.spec.ts"],
+				outDir: "out/src/server",
 			}),
 		},
 	],
 });
 ```
 
-Available per-project fields: `displayName`, `include`, `exclude`, `testMatch`,
-`testRegex`, `testPathIgnorePatterns`, `setupFiles`, `setupFilesAfterEnv`,
-`testTimeout`, `slowTestThreshold`, `testEnvironment`, `snapshotFormat`,
-`outDir`, `root`, and the Jest mock flags (`clearMocks`, `resetMocks`, etc.).
-
 ### Full example
 
 ```typescript
@@ -233,7 +223,18 @@ You need these environment variables:
 ### Studio (local)
 
 Connects to Roblox Studio over WebSocket. Faster than Open Cloud (no upload
-step), but Studio must be open with the plugin running.
+step), but Studio must be open with the plugin running. Studio doesn't expose which place is open, so
+multiple concurrent projects aren't supported yet.
+
+Install the plugin with [Drillbit](https://github.com/jacktabscode/drillbit):
+
+```bash
+drillbit install christopher-buss/jest-roblox-cli
+```
+
+Or download `JestRobloxRunner.rbxm` from the
+[latest release](https://github.com/christopher-buss/jest-roblox-cli/releases)
+and drop it into your Studio plugins folder.
 
 ## CLI flags
 
@@ -290,54 +291,9 @@ Default `testMatch` patterns (configurable):
 - Luau: `*.spec.lua`, `*.test.lua`, `*.spec.luau`, `*.test.luau`
 - Type tests: `*.spec-d.ts`, `*.test-d.ts`
 
-## Project structure
-
-```text
-jest-roblox-cli/
-├── bin/              CLI entry point
-├── src/
-│   ├── backends/     Open Cloud and Studio backends
-│   ├── config/       Config loading and validation
-│   ├── coverage/     Coverage instrumentation pipeline
-│   ├── formatters/   Output formatters (default, agent, JSON, GitHub Actions)
-│   ├── highlighter/  Luau syntax highlighting
-│   ├── reporter/     Result parsing and validation
-│   ├── source-mapper/ Luau-to-TypeScript error mapping
-│   ├── snapshot/     Snapshot file handling
-│   ├── typecheck/    Type test runner
-│   ├── types/        Shared type definitions
-│   └── utils/        Helpers (glob, hash, cache, paths)
-├── luau/             Luau code that runs inside Roblox
-├── plugin/           Roblox Studio WebSocket plugin
-└── test/             Test fixtures and mocks
-```
-
 ## Contributing
 
-### Build
-
-```bash
-pnpm build         # Full build
-pnpm watch         # Watch mode
-pnpm typecheck     # Check types
-```
-
-### Test
-
-```bash
-vitest run                    # All tests
-vitest run src/formatters     # One folder
-vitest run src/cli.spec.ts    # One file
-```
-
-### Lint
-
-```bash
-eslint .
-```
-
-> [!IMPORTANT]
-> 100% test coverage is enforced. Write tests first. Every PR must maintain full coverage.
+See [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## License
 

package/dist/cli.mjs

@@ -1,11 +1,11 @@
-import { D as createOpenCloudBackend, I as isValidBackend, L as LuauScriptError, M as ROOT_ONLY_KEYS, N as VALID_BACKENDS, O as hashBuffer, S as loadConfig$1, T as createStudioBackend, _ as formatResult, a as formatAnnotations, b as formatBanner, c as execute, d as findFormatterOptions, g as formatMultiProjectResult, i as runTypecheck, l as formatExecuteOutput, m as formatCompactMultiProject, n as parseGameOutput, o as formatJobSummary, p as writeJsonFile, r as writeGameOutput, s as resolveGitHubActionsOptions, t as formatGameOutputNotice, u as loadCoverageManifest, x as rojoProjectSchema, y as formatTypecheckSummary } from "./game-output-C0_-YIAY.mjs";
+import { D as createOpenCloudBackend, I as isValidBackend, L as LuauScriptError, M as ROOT_ONLY_KEYS, N as VALID_BACKENDS, O as hashBuffer, S as loadConfig$1, T as createStudioBackend, _ as formatResult, a as formatAnnotations, b as formatBanner, c as execute, d as findFormatterOptions, g as formatMultiProjectResult, i as runTypecheck, l as formatExecuteOutput, m as formatCompactMultiProject, n as parseGameOutput, o as formatJobSummary, p as writeJsonFile, r as writeGameOutput, s as resolveGitHubActionsOptions, t as formatGameOutputNotice, u as loadCoverageManifest, x as rojoProjectSchema, y as formatTypecheckSummary } from "./game-output-BMGxhjkE.mjs";
 import { createRequire } from "node:module";
 import { type } from "arktype";
 import assert from "node:assert";
 import * as fs$1 from "node:fs";
-import fs from "node:fs";
+import fs, { readFileSync } from "node:fs";
 import * as path$1 from "node:path";
-import path from "node:path";
+import path, { dirname, join } from "node:path";
 import process from "node:process";
 import { parseArgs as parseArgs$1 } from "node:util";
 import { isAgent } from "std-env";
@@ -23,7 +23,7 @@ import istanbulCoverage from "istanbul-lib-coverage";
 import istanbulReport from "istanbul-lib-report";
 import istanbulReports from "istanbul-reports";
 //#region package.json
-var version = "0.1.0";
+var version = "0.1.2";
 //#endregion
 //#region src/backends/auto.ts
 var StudioWithFallback = class {
@@ -116,10 +116,39 @@ function stripTsExtension(pattern) {
 }
 //#endregion
 //#region src/utils/rojo-tree.ts
+function resolveNestedProjects(tree, rootDirectory) {
+	return resolveTree(tree, rootDirectory, /* @__PURE__ */ new Set());
+}
 function collectPaths(node, result) {
 	for (const [key, value] of Object.entries(node)) if (key === "$path" && typeof value === "string") result.push(value.replaceAll("\\", "/"));
 	else if (typeof value === "object" && !Array.isArray(value) && !key.startsWith("$")) collectPaths(value, result);
 }
+function resolveTree(node, rootDirectory, visited) {
+	const resolved = {};
+	for (const [key, value] of Object.entries(node)) {
+		if (key === "$path" && typeof value === "string" && value.endsWith(".project.json")) {
+			const projectPath = join(rootDirectory, value);
+			if (visited.has(projectPath)) throw new Error(`Circular project reference: ${value}`);
+			const chain = new Set(visited);
+			chain.add(projectPath);
+			let content;
+			try {
+				content = readFileSync(projectPath, "utf-8");
+			} catch (err) {
+				throw new Error(`Could not read nested Rojo project: ${value}`, { cause: err });
+			}
+			const innerTree = resolveTree(JSON.parse(content).tree, dirname(projectPath), chain);
+			for (const [innerKey, innerValue] of Object.entries(innerTree)) resolved[innerKey] = innerValue;
+			continue;
+		}
+		if (key.startsWith("$") || typeof value !== "object" || Array.isArray(value)) {
+			resolved[key] = value;
+			continue;
+		}
+		resolved[key] = resolveTree(value, rootDirectory, visited);
+	}
+	return resolved;
+}
 //#endregion
 //#region src/config/projects.ts
 function extractStaticRoot(pattern) {
@@ -1653,8 +1682,12 @@ function writeManifest(manifestPath, allFiles, luauRoots, placeFile) {
 function buildRojoProject(rojoProjectPath, roots, placeFile) {
 	const rojoProjectRaw = rojoProjectSchema(JSON.parse(fs$1.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("\\", "/"),
+	const projectRelocation = path$1.relative(COVERAGE_DIR, path$1.dirname(rojoProjectPath)).replaceAll("\\", "/");
+	const rewritten = rewriteRojoProject({
+		...rojoProjectRaw,
+		tree: resolveNestedProjects(rojoProjectRaw.tree, path$1.dirname(rojoProjectPath))
+	}, {
+		projectRelocation,
 		roots
 	});
 	const rewrittenProjectPath = path$1.join(COVERAGE_DIR, path$1.basename(rojoProjectPath));
@@ -1798,7 +1831,7 @@ function globSync(pattern, options = {}) {
 	return walkDirectory(cwd, cwd).filter((file) => matchesGlobPattern(file, pattern));
 }
 function matchesGlobPattern(filePath, pattern) {
-	const regexPattern = pattern.replace(/\./g, "\\.").replace(/\*\*/g, "{{DOUBLESTAR}}").replace(/\*/g, "[^/]*").replace(/\{\{DOUBLESTAR\}\}/g, ".*");
+	const regexPattern = pattern.replace(/\./g, "\\.").replace(/\*\*\//g, "{{DOUBLESTAR_SLASH}}").replace(/\*\*/g, ".*").replace(/\*/g, "[^/]*").replace(/\{\{DOUBLESTAR_SLASH\}\}/g, "(.+/)?");
 	return new RegExp(`^${regexPattern}$`).test(filePath);
 }
 function walkDirectory(directoryPath, baseDirectory) {
@@ -2095,7 +2128,11 @@ function printFinalStatus(passed) {
 	process.stdout.write(`${badge}\n`);
 }
 function processCoverage(config, coverageData) {
-	if (!config.collectCoverage || coverageData === void 0) return true;
+	if (!config.collectCoverage) return true;
+	if (coverageData === void 0) {
+		if (!config.silent) process.stderr.write("Warning: coverage data was empty — the Rojo project may point at uninstrumented source\n");
+		return true;
+	}
 	const manifest = loadCoverageManifest(config.rootDir);
 	if (manifest === void 0) {
 		if (!config.silent) process.stderr.write("Warning: Coverage manifest not found, skipping TS mapping\n");
@@ -2277,7 +2314,7 @@ function loadRojoTree(config) {
 	const content = fs$1.readFileSync(rojoPath, "utf8");
 	const validated = rojoProjectSchema(JSON.parse(content));
 	if (validated instanceof type.errors) throw new Error(`Invalid Rojo project: ${validated.summary}`);
-	return validated.tree;
+	return resolveNestedProjects(validated.tree, path$1.dirname(rojoPath));
 }
 const STUB_SKIP_KEYS = new Set([
 	"outDir",

package/dist/{game-output-C0_-YIAY.mjs → game-output-BMGxhjkE.mjs}

@@ -2,7 +2,7 @@ import { createRequire } from "node:module";
 import { type } from "arktype";
 import assert from "node:assert";
 import * as fs$1 from "node:fs";
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import * as path$1 from "node:path";
 import path from "node:path";
 import process from "node:process";
@@ -780,6 +780,7 @@ async function loadConfig$1(configPath, cwd = process.cwd()) {
 			cwd,
 			dotenv: false,
 			globalRc: false,
+			import: isSea() ? seaImport : void 0,
 			merger,
 			omit$Keys: true,
 			packageJson: false,
@@ -799,6 +800,16 @@ async function loadConfig$1(configPath, cwd = process.cwd()) {
 	config.rootDir ??= cwd;
 	return resolveConfig(config);
 }
+function isSea() {
+	return process.env["JEST_ROBLOX_SEA"] === "true";
+}
+async function seaImport(id) {
+	if (id.endsWith(".json")) {
+		const content = readFileSync(id, "utf-8");
+		return JSON.parse(content);
+	}
+	return import(id);
+}
 function merger(...sources) {
 	return defuFn(...sources.filter(Boolean));
 }

package/dist/index.mjs

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

package/dist/sea-entry.cjs

@@ -7640,7 +7640,7 @@ function f$9() {
 var C$5 = f$9();
 //#endregion
 //#region package.json
-var version = "0.1.0";
+var version = "0.1.2";
 //#endregion
 //#region node_modules/.pnpm/ws@8.18.0/node_modules/ws/lib/stream.js
 var require_stream = /* @__PURE__ */ __commonJSMin(((exports, module) => {
@@ -11358,7 +11358,7 @@ function normalizeString(path, allowAboveRoot) {
 	}
 	return res;
 }
-var _DRIVE_LETTER_START_RE, _UNC_REGEX, _IS_ABSOLUTE_RE, _DRIVE_LETTER_RE, _ROOT_FOLDER_RE, _EXTNAME_RE, normalize, join, resolve$2, isAbsolute$1, extname$2, relative, dirname, basename;
+var _DRIVE_LETTER_START_RE, _UNC_REGEX, _IS_ABSOLUTE_RE, _DRIVE_LETTER_RE, _ROOT_FOLDER_RE, _EXTNAME_RE, normalize, join$2, resolve$2, isAbsolute$1, extname$2, relative, dirname$1, basename;
 var init_pathe_M_eThtNZ = __esmMin((() => {
 	_DRIVE_LETTER_START_RE = /^[A-Za-z]:\//;
 	_UNC_REGEX = /^[/\\]{2}/;
@@ -11385,7 +11385,7 @@ var init_pathe_M_eThtNZ = __esmMin((() => {
 		}
 		return isPathAbsolute && !isAbsolute$1(path) ? `/${path}` : path;
 	};
-	join = function(...segments) {
+	join$2 = function(...segments) {
 		let path = "";
 		for (const seg of segments) {
 			if (!seg) continue;
@@ -11432,7 +11432,7 @@ var init_pathe_M_eThtNZ = __esmMin((() => {
 		}
 		return [..._from.map(() => ".."), ..._to].join("/");
 	};
-	dirname = function(p) {
+	dirname$1 = function(p) {
 		const segments = normalizeWindowsPath$1(p).replace(/\/$/, "").split("/").slice(0, -1);
 		if (segments.length === 1 && _DRIVE_LETTER_RE.test(segments[0])) segments[0] += "/";
 		return segments.join("/") || (isAbsolute$1(p) ? "/" : ".");
@@ -13115,11 +13115,11 @@ async function findFile(filename, _options = {}) {
 	let root = segments.findIndex((r) => r.match(options.rootPattern));
 	if (root === -1) root = 0;
 	if (options.reverse) for (let index = root + 1; index <= segments.length; index++) for (const filename2 of filenames) {
-		const filePath = join(...segments.slice(0, index), filename2);
+		const filePath = join$2(...segments.slice(0, index), filename2);
 		if (await options.test(filePath)) return filePath;
 	}
 	else for (let index = segments.length; index > root; index--) for (const filename2 of filenames) {
-		const filePath = join(...segments.slice(0, index), filename2);
+		const filePath = join$2(...segments.slice(0, index), filename2);
 		if (await options.test(filePath)) return filePath;
 	}
 	throw new Error(`Cannot find matching ${filename} in ${options.startingFrom} or parent directories`);
@@ -13179,10 +13179,10 @@ async function resolvePackageJSON(id = process.cwd(), options = {}) {
 	});
 }
 const workspaceTests = {
-	workspaceFile: (opts) => findFile(workspaceFiles, opts).then((r) => dirname(r)),
+	workspaceFile: (opts) => findFile(workspaceFiles, opts).then((r) => dirname$1(r)),
 	gitConfig: (opts) => findFile(".git/config", opts).then((r) => resolve$2(r, "../..")),
-	lockFile: (opts) => findFile(lockFiles, opts).then((r) => dirname(r)),
-	packageJson: (opts) => findFile(packageFiles, opts).then((r) => dirname(r))
+	lockFile: (opts) => findFile(lockFiles, opts).then((r) => dirname$1(r)),
+	packageJson: (opts) => findFile(packageFiles, opts).then((r) => dirname$1(r))
 };
 async function findWorkspaceDir(id = process.cwd(), options = {}) {
 	const startingFrom = _resolvePath(id, options);
@@ -17263,7 +17263,7 @@ function parsePackageManagerField(packageManager) {
 async function detectPackageManager(cwd, options = {}) {
 	const detected = await findup(resolve$2(cwd || "."), async (path) => {
 		if (!options.ignorePackageJSON) {
-			const packageJSONPath = join(path, "package.json");
+			const packageJSONPath = join$2(path, "package.json");
 			if ((0, node_fs.existsSync)(packageJSONPath)) {
 				const packageJSON = JSON.parse(await (0, node_fs_promises.readFile)(packageJSONPath, "utf8"));
 				if (packageJSON?.packageManager) {
@@ -17284,7 +17284,7 @@ async function detectPackageManager(cwd, options = {}) {
 					}
 				}
 			}
-			if ((0, node_fs.existsSync)(join(path, "deno.json"))) return packageManagers.find((pm) => pm.name === "deno");
+			if ((0, node_fs.existsSync)(join$2(path, "deno.json"))) return packageManagers.find((pm) => pm.name === "deno");
 		}
 		if (!options.ignoreLockFile) {
 			for (const packageManager of packageManagers) if ([packageManager.lockFile, packageManager.files].flat().filter(Boolean).some((file) => (0, node_fs.existsSync)(resolve$2(path, file)))) return { ...packageManager };
@@ -35752,7 +35752,7 @@ async function downloadTemplate(input, options = {}) {
 	const tarPath = resolve$2(resolve$2(cacheDirectory(), providerName, template.name), (template.version || template.name) + ".tar.gz");
 	if (options.preferOffline && (0, node_fs.existsSync)(tarPath)) options.offline = true;
 	if (!options.offline) {
-		await (0, node_fs_promises.mkdir)(dirname(tarPath), { recursive: true });
+		await (0, node_fs_promises.mkdir)(dirname$1(tarPath), { recursive: true });
 		const s2 = Date.now();
 		await download(template.tar, tarPath, { headers: {
 			Authorization: options.auth ? `Bearer ${options.auth}` : void 0,
@@ -40894,9 +40894,9 @@ async function resolveConfig$1(source, options, sourceOptions = {}) {
 		const cloneName = source.replace(/\W+/g, "_").split("_").splice(0, 3).join("_") + "_" + digest(source).slice(0, 10).replace(/[-_]/g, "");
 		let cloneDir;
 		const localNodeModules = resolve$2(options.cwd, "node_modules");
-		const parentDir = dirname(options.cwd);
-		if (basename(parentDir) === ".c12") cloneDir = join(parentDir, cloneName);
-		else if ((0, node_fs.existsSync)(localNodeModules)) cloneDir = join(localNodeModules, ".c12", cloneName);
+		const parentDir = dirname$1(options.cwd);
+		if (basename(parentDir) === ".c12") cloneDir = join$2(parentDir, cloneName);
+		else if ((0, node_fs.existsSync)(localNodeModules)) cloneDir = join$2(localNodeModules, ".c12", cloneName);
 		else cloneDir = process.env.XDG_CACHE_HOME ? resolve$2(process.env.XDG_CACHE_HOME, "c12", cloneName) : resolve$2((0, node_os.homedir)(), ".cache/c12", cloneName);
 		if ((0, node_fs.existsSync)(cloneDir) && !sourceOptions.install) await (0, node_fs_promises.rm)(cloneDir, { recursive: true });
 		source = (await downloadTemplate(source, {
@@ -40911,7 +40911,7 @@ async function resolveConfig$1(source, options, sourceOptions = {}) {
 	if (NPM_PACKAGE_RE.test(source)) source = tryResolve(source, options) || source;
 	const ext = extname$2(source);
 	const isDir = _isDirectory(resolve$2(options.cwd, source)) ?? (!ext || ext === basename(source));
-	const cwd = resolve$2(options.cwd, isDir ? source : dirname(source));
+	const cwd = resolve$2(options.cwd, isDir ? source : dirname$1(source));
 	if (isDir) source = options.configFile;
 	const res = {
 		config: void 0,
@@ -40935,7 +40935,7 @@ async function resolveConfig$1(source, options, sourceOptions = {}) {
 				const { createJiti } = await Promise.resolve().then(() => (init_jiti(), jiti_exports)).catch(() => {
 					throw new Error(`Failed to load config file \`${res.configFile}\`: ${error?.message}.  Hint install \`jiti\` for compatibility.`, { cause: error });
 				});
-				const jiti = createJiti(join(options.cwd || ".", options.configFile || "/"), {
+				const jiti = createJiti(join$2(options.cwd || ".", options.configFile || "/"), {
 					interopDefault: true,
 					moduleCache: false,
 					extensions: [...SUPPORTED_EXTENSIONS]
@@ -40963,7 +40963,7 @@ async function resolveConfig$1(source, options, sourceOptions = {}) {
 function tryResolve(id, options) {
 	const res = resolveModulePath(id, {
 		try: true,
-		from: (0, node_url.pathToFileURL)(join(options.cwd || ".", options.configFile || "/")),
+		from: (0, node_url.pathToFileURL)(join$2(options.cwd || ".", options.configFile || "/")),
 		suffixes: ["", "/index"],
 		extensions: SUPPORTED_EXTENSIONS,
 		cache: false
@@ -41654,6 +41654,7 @@ async function loadConfig(configPath, cwd = node_process.default.cwd()) {
 			cwd,
 			dotenv: false,
 			globalRc: false,
+			import: isSea() ? seaImport : void 0,
 			merger,
 			omit$Keys: true,
 			packageJson: false,
@@ -41673,6 +41674,16 @@ async function loadConfig(configPath, cwd = node_process.default.cwd()) {
 	config.rootDir ??= cwd;
 	return resolveConfig(config);
 }
+function isSea() {
+	return node_process.default.env["JEST_ROBLOX_SEA"] === "true";
+}
+async function seaImport(id) {
+	if (id.endsWith(".json")) {
+		const content = (0, node_fs.readFileSync)(id, "utf-8");
+		return JSON.parse(content);
+	}
+	return import(id);
+}
 function merger(...sources) {
 	return defuFn(...sources.filter(Boolean));
 }
@@ -41691,10 +41702,39 @@ function stripTsExtension(pattern) {
 }
 //#endregion
 //#region src/utils/rojo-tree.ts
+function resolveNestedProjects(tree, rootDirectory) {
+	return resolveTree(tree, rootDirectory, /* @__PURE__ */ new Set());
+}
 function collectPaths(node, result) {
 	for (const [key, value] of Object.entries(node)) if (key === "$path" && typeof value === "string") result.push(value.replaceAll("\\", "/"));
 	else if (typeof value === "object" && !Array.isArray(value) && !key.startsWith("$")) collectPaths(value, result);
 }
+function resolveTree(node, rootDirectory, visited) {
+	const resolved = {};
+	for (const [key, value] of Object.entries(node)) {
+		if (key === "$path" && typeof value === "string" && value.endsWith(".project.json")) {
+			const projectPath = (0, node_path.join)(rootDirectory, value);
+			if (visited.has(projectPath)) throw new Error(`Circular project reference: ${value}`);
+			const chain = new Set(visited);
+			chain.add(projectPath);
+			let content;
+			try {
+				content = (0, node_fs.readFileSync)(projectPath, "utf-8");
+			} catch (err) {
+				throw new Error(`Could not read nested Rojo project: ${value}`, { cause: err });
+			}
+			const innerTree = resolveTree(JSON.parse(content).tree, (0, node_path.dirname)(projectPath), chain);
+			for (const [innerKey, innerValue] of Object.entries(innerTree)) resolved[innerKey] = innerValue;
+			continue;
+		}
+		if (key.startsWith("$") || typeof value !== "object" || Array.isArray(value)) {
+			resolved[key] = value;
+			continue;
+		}
+		resolved[key] = resolveTree(value, rootDirectory, visited);
+	}
+	return resolved;
+}
 //#endregion
 //#region src/config/projects.ts
 function extractStaticRoot(pattern) {
@@ -49643,8 +49683,8 @@ var import_RojoResolver = (/* @__PURE__ */ __commonJSMin(((exports) => {
 			this.value = value;
 		}
 	};
-	const SCHEMA_PATH = path_1.default.join(PACKAGE_ROOT, "rojo-schema.json");
-	const validateRojo = new Lazy(() => ajv.compile(JSON.parse(fs_extra_1.default.readFileSync(SCHEMA_PATH).toString())));
+	path_1.default.join(PACKAGE_ROOT, "rojo-schema.json");
+	const validateRojo = new Lazy(() => ajv.compile(JSON.parse("{\n	\"$schema\": \"http://json-schema.org/draft-07/schema#\",\n	\"required\": [\"name\", \"tree\"],\n	\"type\": \"object\",\n	\"properties\": {\n		\"name\": {\n			\"type\": \"string\"\n		},\n		\"servePort\": {\n			\"type\": \"integer\"\n		},\n		\"tree\": {\n			\"$id\": \"tree\",\n			\"type\": \"object\",\n			\"properties\": {\n				\"$className\": {\n					\"type\": \"string\"\n				},\n				\"$ignoreUnknownInstances\": {\n					\"type\": \"boolean\"\n				},\n				\"$path\": {\n					\"anyOf\": [\n						{\n							\"type\": \"string\"\n						},\n						{\n							\"type\": \"object\",\n							\"properties\": {\n								\"optional\": {\n									\"type\": \"string\"\n								}\n							}\n						}\n					]\n				},\n				\"$properties\": {\n					\"type\": \"object\"\n				}\n			},\n			\"patternProperties\": {\n				\"^[^\\\\$].*$\": { \"$ref\": \"tree\" }\n			}\n		}\n	}\n}\n")));
 	function isValidRojoConfig(value) {
 		return validateRojo.get()(value) === true;
 	}
@@ -54130,8 +54170,12 @@ function writeManifest(manifestPath, allFiles, luauRoots, placeFile) {
 function buildRojoProject(rojoProjectPath, roots, placeFile) {
 	const rojoProjectRaw = rojoProjectSchema(JSON.parse(node_fs.readFileSync(rojoProjectPath, "utf-8")));
 	if (rojoProjectRaw instanceof type.errors) throw new Error(`Malformed Rojo project JSON: ${rojoProjectRaw.toString()}`);
-	const rewritten = rewriteRojoProject(rojoProjectRaw, {
-		projectRelocation: node_path.relative(COVERAGE_DIR, node_path.dirname(rojoProjectPath)).replaceAll("\\", "/"),
+	const projectRelocation = node_path.relative(COVERAGE_DIR, node_path.dirname(rojoProjectPath)).replaceAll("\\", "/");
+	const rewritten = rewriteRojoProject({
+		...rojoProjectRaw,
+		tree: resolveNestedProjects(rojoProjectRaw.tree, node_path.dirname(rojoProjectPath))
+	}, {
+		projectRelocation,
 		roots
 	});
 	const rewrittenProjectPath = node_path.join(COVERAGE_DIR, node_path.basename(rojoProjectPath));
@@ -60807,7 +60851,7 @@ function globSync(pattern, options = {}) {
 	return walkDirectory(cwd, cwd).filter((file) => matchesGlobPattern(file, pattern));
 }
 function matchesGlobPattern(filePath, pattern) {
-	const regexPattern = pattern.replace(/\./g, "\\.").replace(/\*\*/g, "{{DOUBLESTAR}}").replace(/\*/g, "[^/]*").replace(/\{\{DOUBLESTAR\}\}/g, ".*");
+	const regexPattern = pattern.replace(/\./g, "\\.").replace(/\*\*\//g, "{{DOUBLESTAR_SLASH}}").replace(/\*\*/g, ".*").replace(/\*/g, "[^/]*").replace(/\{\{DOUBLESTAR_SLASH\}\}/g, "(.+/)?");
 	return new RegExp(`^${regexPattern}$`).test(filePath);
 }
 function walkDirectory(directoryPath, baseDirectory) {
@@ -61104,7 +61148,11 @@ function printFinalStatus(passed) {
 	node_process.default.stdout.write(`${badge}\n`);
 }
 function processCoverage(config, coverageData) {
-	if (!config.collectCoverage || coverageData === void 0) return true;
+	if (!config.collectCoverage) return true;
+	if (coverageData === void 0) {
+		if (!config.silent) node_process.default.stderr.write("Warning: coverage data was empty — the Rojo project may point at uninstrumented source\n");
+		return true;
+	}
 	const manifest = loadCoverageManifest(config.rootDir);
 	if (manifest === void 0) {
 		if (!config.silent) node_process.default.stderr.write("Warning: Coverage manifest not found, skipping TS mapping\n");
@@ -61286,7 +61334,7 @@ function loadRojoTree(config) {
 	const content = node_fs.readFileSync(rojoPath, "utf8");
 	const validated = rojoProjectSchema(JSON.parse(content));
 	if (validated instanceof type.errors) throw new Error(`Invalid Rojo project: ${validated.summary}`);
-	return validated.tree;
+	return resolveNestedProjects(validated.tree, node_path.dirname(rojoPath));
 }
 const STUB_SKIP_KEYS = new Set([
 	"outDir",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isentinel/jest-roblox",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Jest-compatible CLI for running roblox-ts tests via Roblox Open Cloud",
   "keywords": [
     "jest",