@isentinel/jest-roblox 0.0.2 → 0.0.4

package/dist/index.d.mts

@@ -1,17 +1,9 @@
-import { a as Argv, i as ResolvedConfig, n as Config, r as DEFAULT_CONFIG, t as CliOptions } from "./schema-CEsyg-FX.mjs";
-import { WebSocketServer } from "ws";
+import { a as SnapshotFormatOptions, i as ResolvedConfig, n as Config, o as Argv, r as DEFAULT_CONFIG, t as CliOptions } from "./schema-ua9HqdbX.mjs";
+import { WebSocket, WebSocketServer } from "ws";
 import buffer from "node:buffer";
 
 //#region src/types/jest-result.d.ts
-interface JestResult {
-  numFailedTests: number;
-  numPassedTests: number;
-  numPendingTests: number;
-  numTotalTests: number;
-  startTime: number;
-  success: boolean;
-  testResults: Array<TestFileResult>;
-}
+type TestStatus = "failed" | "passed" | "pending" | "skipped";
 interface TestCaseResult {
   ancestorTitles: Array<string>;
   duration?: number;
@@ -21,32 +13,51 @@ interface TestCaseResult {
   title: string;
 }
 interface TestFileResult {
+  failureMessage?: string;
   numFailingTests: number;
   numPassingTests: number;
   numPendingTests: number;
   testFilePath: string;
   testResults: Array<TestCaseResult>;
 }
-type TestStatus = "failed" | "passed" | "pending" | "skipped";
+interface SnapshotSummary {
+  added: number;
+  matched: number;
+  total: number;
+  unmatched: number;
+  updated: number;
+}
+interface JestResult {
+  numFailedTests: number;
+  numPassedTests: number;
+  numPendingTests: number;
+  numTotalTests: number;
+  snapshot?: SnapshotSummary;
+  startTime: number;
+  success: boolean;
+  testResults: Array<TestFileResult>;
+}
 //#endregion
 //#region src/reporter/parser.d.ts
+type SnapshotWrites = Record<string, string>;
 interface ParseResult {
   luauTiming?: Record<string, number>;
   result: JestResult;
   snapshotWrites?: SnapshotWrites;
 }
-type SnapshotWrites = Record<string, string>;
 declare function extractJsonFromOutput(output: string): string | undefined;
 declare function parseJestOutput(output: string): ParseResult;
 //#endregion
 //#region src/backends/interface.d.ts
-interface Backend {
-  runTests(options: BackendOptions): Promise<BackendResult>;
-}
 interface BackendOptions {
   config: ResolvedConfig;
   testFiles: Array<string>;
 }
+interface BackendTiming {
+  executionMs: number;
+  uploadCached?: boolean;
+  uploadMs?: number;
+}
 interface BackendResult {
   gameOutput?: string;
   luauTiming?: Record<string, number>;
@@ -54,16 +65,11 @@ interface BackendResult {
   snapshotWrites?: SnapshotWrites;
   timing: BackendTiming;
 }
-interface BackendTiming {
-  executionMs: number;
-  uploadCached?: boolean;
-  uploadMs?: number;
+interface Backend {
+  runTests(options: BackendOptions): Promise<BackendResult>;
 }
 //#endregion
 //#region src/backends/http-client.d.ts
-interface HttpClient {
-  request(method: string, url: string, options?: RequestOptions): Promise<HttpResponse>;
-}
 interface HttpResponse {
   body: unknown;
   headers?: Record<string, string | undefined>;
@@ -74,6 +80,9 @@ interface RequestOptions {
   body?: unknown;
   headers?: Record<string, string>;
 }
+interface HttpClient {
+  request(method: string, url: string, options?: RequestOptions): Promise<HttpResponse>;
+}
 //#endregion
 //#region src/backends/open-cloud.d.ts
 interface OpenCloudCredentials {
@@ -101,15 +110,21 @@ declare class OpenCloudBackend implements Backend {
 declare function createOpenCloudBackend(): OpenCloudBackend;
 //#endregion
 //#region src/backends/studio.d.ts
+interface PreConnected {
+  server: WebSocketServer;
+  socket: WebSocket;
+}
 interface StudioOptions {
   createServer?: (port: number) => WebSocketServer;
   port: number;
+  preConnected?: PreConnected;
   timeout?: number;
 }
 declare class StudioBackend implements Backend {
   private readonly createServer;
   private readonly port;
   private readonly timeout;
+  private preConnected?;
   constructor(options: StudioOptions);
   runTests(options: BackendOptions): Promise<BackendResult>;
   private executeViaPlugin;
@@ -118,8 +133,8 @@ declare class StudioBackend implements Backend {
 declare function createStudioBackend(options: StudioOptions): StudioBackend;
 //#endregion
 //#region src/config/loader.d.ts
-declare function loadConfig(configPath?: string, cwd?: string): Promise<ResolvedConfig>;
 declare function resolveConfig(config: Config): ResolvedConfig;
+declare function loadConfig(configPath?: string, cwd?: string): Promise<ResolvedConfig>;
 //#endregion
 //#region src/executor.d.ts
 interface ExecuteOptions {
@@ -137,20 +152,22 @@ interface ExecuteResult {
 declare function execute(options: ExecuteOptions): Promise<ExecuteResult>;
 //#endregion
 //#region src/source-mapper/index.d.ts
-interface MappedFailure {
-  locations: Array<MappedLocation>;
-  message: string;
-}
 interface MappedLocation {
   luauLine: number;
   luauPath: string;
+  sourceContent?: string;
   tsColumn?: number;
   tsLine: number;
   tsPath: string;
 }
+interface MappedFailure {
+  locations: Array<MappedLocation>;
+  message: string;
+}
 interface SourceMapper {
   mapFailureMessage(message: string): string;
   mapFailureWithLocations(message: string): MappedFailure;
+  resolveTestFilePath(testFilePath: string): string | undefined;
 }
 //#endregion
 //#region src/types/timing.d.ts
@@ -166,6 +183,8 @@ interface TimingResult {
 //#region src/formatters/formatter.d.ts
 interface FormatOptions {
   color: boolean;
+  gameOutput?: string;
+  outputFile?: string;
   rootDir: string;
   showLuau?: boolean;
   sourceMapper?: SourceMapper;
@@ -217,8 +236,8 @@ declare function formatFailure({
   totalFailures?: number;
   useColor?: boolean;
 }): string;
-declare function formatResult(result: JestResult, timing: TimingResult, options: FormatOptions): string;
 declare function formatTestSummary(result: JestResult, timing: TimingResult, styles?: Styles): string;
+declare function formatResult(result: JestResult, timing: TimingResult, options: FormatOptions): string;
 //#endregion
 //#region src/formatters/json.d.ts
 declare function formatJson(result: JestResult): string;
@@ -226,11 +245,36 @@ declare function writeJsonFile(result: JestResult, filePath: string): Promise<vo
 //#endregion
 //#region src/test-script.d.ts
 type JestArgv = Argv & {
+  snapshotFormat?: SnapshotFormatOptions;
   testMatch: Array<string>;
 };
 declare function buildJestArgv(options: BackendOptions): JestArgv;
 declare function generateTestScript(options: BackendOptions): string;
 //#endregion
+//#region src/typecheck/types.d.ts
+interface TscErrorInfo {
+  column: number;
+  errCode: number;
+  errMsg: string;
+  filePath: string;
+  line: number;
+}
+interface TestDefinition {
+  name: string;
+  ancestorNames: Array<string>;
+  end: number;
+  start: number;
+  type: "suite" | "test";
+}
+//#endregion
+//#region src/typecheck/runner.d.ts
+interface TypecheckOptions {
+  files: Array<string>;
+  rootDir: string;
+  tsconfig?: string;
+}
+declare function runTypecheck(options: TypecheckOptions): JestResult;
+//#endregion
 //#region src/types/game-output.d.ts
 interface GameOutputEntry {
   message: string;
@@ -243,4 +287,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 TestFileResult, type TestStatus, buildJestArgv, createOpenCloudBackend, createStudioBackend, execute, extractJsonFromOutput, formatFailure, formatGameOutputNotice, formatJson, formatResult, formatTestSummary, generateTestScript, loadConfig, parseGameOutput, parseJestOutput, resolveConfig, writeGameOutput, writeJsonFile };
+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, execute, extractJsonFromOutput, formatFailure, formatGameOutputNotice, formatJson, formatResult, formatTestSummary, generateTestScript, loadConfig, parseGameOutput, parseJestOutput, resolveConfig, runTypecheck, writeGameOutput, writeJsonFile };

package/dist/index.mjs

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

package/dist/{schema-CEsyg-FX.d.mts → schema-ua9HqdbX.d.mts}

@@ -757,7 +757,18 @@ type Except<ObjectType, KeysType extends keyof ObjectType, Options extends Excep
 type _Except<ObjectType, KeysType extends keyof ObjectType, Options extends Required<ExceptOptions>> = { [KeyType in keyof ObjectType as Filter<KeyType, KeysType>]: ObjectType[KeyType] } & (Options['requireExactProps'] extends true ? Partial<Record<KeysType, never>> : {});
 //#endregion
 //#region src/config/schema.d.ts
-interface Config extends Except<Argv, "rootDir" | "setupFiles" | "testPathPattern"> {
+type Backend = "auto" | "open-cloud" | "studio";
+interface SnapshotFormatOptions {
+  callToJSON?: boolean;
+  escapeRegex?: boolean;
+  escapeString?: boolean;
+  indent?: number;
+  maxDepth?: number;
+  min?: boolean;
+  printBasicPrototype?: boolean;
+  printFunctionName?: boolean;
+}
+interface Config extends Except<Argv, "rootDir" | "setupFiles" | "setupFilesAfterEnv" | "testPathPattern"> {
   backend?: Backend;
   cache?: boolean;
   compact?: boolean;
@@ -770,14 +781,19 @@ interface Config extends Except<Argv, "rootDir" | "setupFiles" | "testPathPatter
   rojoProject?: string;
   rootDir?: string;
   setupFiles?: Array<string>;
+  setupFilesAfterEnv?: Array<string>;
   showLuau?: boolean;
+  snapshotFormat?: SnapshotFormatOptions;
   sourceMap?: boolean;
   testPathPattern?: string;
   timeout?: number;
+  typecheck?: boolean;
+  typecheckOnly?: boolean;
+  typecheckTsconfig?: string;
   updateSnapshot?: boolean;
 }
 interface ResolvedConfig extends Config {
-  backend: "auto" | "open-cloud" | "studio";
+  backend: Backend;
   cache: boolean;
   color: boolean;
   compact: boolean;
@@ -794,9 +810,11 @@ interface ResolvedConfig extends Config {
   testMatch: Array<string>;
   testPathIgnorePatterns: Array<string>;
   timeout: number;
+  typecheck: boolean;
+  typecheckOnly: boolean;
+  typecheckTsconfig?: string;
   verbose: boolean;
 }
-type Backend = "auto" | "open-cloud" | "studio";
 declare const DEFAULT_CONFIG: ResolvedConfig;
 interface CliOptions {
   backend?: Backend;
@@ -815,15 +833,19 @@ interface CliOptions {
   projects?: Array<string>;
   rojoProject?: string;
   setupFiles?: Array<string>;
+  setupFilesAfterEnv?: Array<string>;
   showLuau?: boolean;
   silent?: boolean;
   sourceMap?: boolean;
   testNamePattern?: string;
   testPathPattern?: string;
   timeout?: number;
+  typecheck?: boolean;
+  typecheckOnly?: boolean;
+  typecheckTsconfig?: string;
   updateSnapshot?: boolean;
   verbose?: boolean;
   version?: boolean;
 }
 //#endregion
-export { Argv as a, ResolvedConfig as i, Config as n, DEFAULT_CONFIG as r, CliOptions as t };
+export { SnapshotFormatOptions as a, ResolvedConfig as i, Config as n, Argv as o, DEFAULT_CONFIG as r, CliOptions as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isentinel/jest-roblox",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Jest-compatible CLI for running roblox-ts tests via Roblox Open Cloud",
   "keywords": [
     "jest",
@@ -9,6 +9,9 @@
     "testing",
     "cli"
   ],
+  "bugs": {
+    "email": "christopher.buss@pm.me"
+  },
   "license": "MIT",
   "author": "Christopher Buss <christopher.buss@pm.me> (https://github.com/christopher-buss)",
   "sideEffects": false,
@@ -30,18 +33,25 @@
     "!dist/**/*.tsbuildinfo"
   ],
   "dependencies": {
+    "@jridgewell/trace-mapping": "^0.3.25",
     "arktype": "2.1.29",
+    "get-tsconfig": "4.13.6",
     "highlight.js": "11.11.1",
     "jiti": "2.6.1",
+    "oxc-parser": "0.116.0",
     "tinyrainbow": "3.0.3",
     "ws": "8.18.0"
   },
   "devDependencies": {
-    "@isentinel/eslint-config": "4.7.6",
+    "@isentinel/eslint-config": "5.0.0-beta.8",
+    "@oxc-project/types": "0.116.0",
     "@rbxts/jest": "3.13.3-ts.1",
-    "@rbxts/types": "1.0.896",
-    "@types/node": "24.10.4",
+    "@rbxts/types": "1.0.911",
+    "@total-typescript/shoehorn": "^0.1.2",
+    "@types/node": "24.10.13",
     "@types/ws": "8.5.13",
+    "@typescript/native-preview": "7.0.0-dev.20260308.1",
+    "@vitest/eslint-plugin": "1.6.9",
     "better-typescript-lib": "2.12.0",
     "bumpp": "10.4.1",
     "publint": "0.3.15",
@@ -53,18 +63,37 @@
     "node": ">=20.0.0"
   },
   "nx": {
+    "name": "jest-roblox-cli",
     "tags": [
       "scope:tooling",
       "type:cli"
     ],
     "projectType": "application",
+    "includedScripts": [
+      "!build"
+    ],
     "targets": {
+      "build": {
+        "command": "pnpm build:bundle && tsdown && pnpm build:plugin",
+        "options": {
+          "cwd": "tools/jest-roblox-cli"
+        }
+      },
       "lint": {
         "command": "eslint",
         "hasTypeAwareRules": true
       },
+      "build:bundle": {
+        "command": "pnpm build:bundle",
+        "options": {
+          "cwd": "tools/jest-roblox-cli"
+        }
+      },
       "test": {
         "command": "vitest run",
+        "dependsOn": [
+          "build:bundle"
+        ],
         "options": {
           "cwd": "tools/jest-roblox-cli"
         }
@@ -72,8 +101,9 @@
     }
   },
   "scripts": {
-    "build": "tsdown",
-    "build:plugin": "rojo build plugin/plugin.project.json -o plugin/JestRobloxRunner.rbxm",
+    "build": "pnpm build:bundle && tsdown && pnpm build:plugin",
+    "build:bundle": "darklua process -c .darklua-bundle.json luau/entry.luau src/test-runner.bundled.luau",
+    "build:plugin": "rm -rf plugin/out && darklua process -c .darklua-plugin.json luau/ plugin/out/shared/ && rojo build plugin/plugin.project.json -o plugin/JestRobloxRunner.rbxm",
     "release": "bumpp",
     "watch": "tsdown --watch"
   }

package/plugin/out/shared/entry.luau

@@ -0,0 +1,8 @@
+--!strict
+local HttpService = game:GetService("HttpService")
+
+local Runner = require(script.Parent:FindFirstChild('runner'))
+
+local config = HttpService:JSONDecode([=[__CONFIG_JSON__]=])
+
+return Runner.run(script, config)

package/plugin/out/shared/instance-resolver.luau

@@ -0,0 +1,93 @@
+--!strict
+local ReplicatedStorage = game:GetService("ReplicatedStorage")
+
+local module = {}
+
+function module.findInstance(path: string): Instance
+	local parts = string.split(path, "/")
+
+	local success, current = pcall(function()
+		return game:FindService(parts[1])
+	end)
+	assert(success, `Failed to find service {parts[1]}: {current}`)
+
+	for i = 2, #parts do
+		assert(current, `Failed to find '{parts[i - 1]}' in path {path}`)
+		current = current:FindFirstChild(parts[i])
+	end
+
+	assert(current, `Failed to find instance at path {path}`)
+
+	return current
+end
+
+function module.getJest(config: { jestPath: string? }): ModuleScript
+	local jestPath = config.jestPath
+	if jestPath then
+		local instance = module.findInstance(jestPath)
+		assert(instance, `Failed to find Jest instance at path {jestPath}`)
+		assert(instance:IsA("ModuleScript"), `Instance at path {jestPath} is not a ModuleScript`)
+		return instance :: ModuleScript
+	end
+
+	local jestInstance = ReplicatedStorage:FindFirstChild("Jest", true)
+	assert(jestInstance, "Failed to find Jest instance in ReplicatedStorage")
+	assert(
+		jestInstance:IsA("ModuleScript"),
+		"Jest instance in ReplicatedStorage is not a ModuleScript"
+	)
+	return jestInstance
+end
+
+function module.findRobloxShared(jestModule: ModuleScript): Instance?
+	local parent = jestModule.Parent
+	if parent then
+		local found = parent:FindFirstChild("RobloxShared")
+			or parent:FindFirstChild("jest-roblox-shared")
+		if found then
+			return found
+		end
+
+		if parent.Parent then
+			found = parent.Parent:FindFirstChild("RobloxShared")
+				or parent.Parent:FindFirstChild("jest-roblox-shared")
+			if found then
+				return found
+			end
+		end
+	end
+
+	return game:FindFirstChild("RobloxShared", true)
+end
+
+function module.findSiblingPackage(jestModule: ModuleScript, ...: string): Instance?
+	local parent = jestModule.Parent
+	if parent then
+		for _, name in { ... } do
+			local found = parent:FindFirstChild(name)
+			if found then
+				return found
+			end
+		end
+
+		if parent.Parent then
+			for _, name in { ... } do
+				local found = parent.Parent:FindFirstChild(name)
+				if found then
+					return found
+				end
+			end
+		end
+	end
+
+	for _, name in { ... } do
+		local found = game:FindFirstChild(name, true)
+		if found then
+			return found
+		end
+	end
+
+	return nil
+end
+
+return module

package/plugin/out/shared/mock/CoreScriptSyncService.luau

@@ -0,0 +1,19 @@
+--!strict
+local function getInstancePath(instance: Instance): string
+	local parts = {} :: { string }
+	local current: Instance? = instance
+	while current and current ~= game do
+		table.insert(parts, 1, current.Name)
+		current = current.Parent
+	end
+
+	return table.concat(parts, "/")
+end
+
+local CoreScriptSyncService = {}
+
+function CoreScriptSyncService:GetScriptFilePath(instance: Instance): string
+	return getInstancePath(instance)
+end
+
+return CoreScriptSyncService

package/plugin/out/shared/mock/FileSystemService.luau

@@ -0,0 +1,30 @@
+--!strict
+local function normalizeSnapPath(path: string): string
+	return (string.gsub(path, "%.snap%.lua$", ".snap.luau"))
+end
+
+local function create(snapshotWrites: { [string]: string })
+	local FileSystemService = {}
+
+	function FileSystemService:WriteFile(path: string, contents: string)
+		snapshotWrites[normalizeSnapPath(path)] = contents
+	end
+
+	function FileSystemService:CreateDirectories(_path: string) end
+
+	function FileSystemService:Exists(path: string): boolean
+		return snapshotWrites[normalizeSnapPath(path)] ~= nil
+	end
+
+	function FileSystemService:Remove(path: string)
+		snapshotWrites[normalizeSnapPath(path)] = nil
+	end
+
+	function FileSystemService:IsRegularFile(path: string): boolean
+		return snapshotWrites[normalizeSnapPath(path)] ~= nil
+	end
+
+	return FileSystemService
+end
+
+return create