@isentinel/jest-roblox 0.3.8 → 0.3.10

package/README.md

@@ -352,7 +352,7 @@ Create a file named drillbit.toml in your project's directory.
 
 ```toml
 [plugins.jest_roblox]
-github = "https://github.com/christopher-buss/jest-roblox-cli/releases/download/v0.3.8/JestRobloxRunner.rbxm"
+github = "https://github.com/christopher-buss/jest-roblox-cli/releases/download/v0.2.7/JestRobloxRunner.rbxm"
 ```
 
 Then run `drillbit` and it will download the plugin and install it in Studio for

package/bin/jest-roblox.js

@@ -10,10 +10,7 @@ const sourceEntry = resolve(dirname(fileURLToPath(import.meta.url)), "../src/cli
 
 registerHooks({ load, resolve: resolveLuau });
 
-if (existsSync(sourceEntry)) {
-	const { main } = await import("../src/cli.ts");
-	await main();
-} else {
-	const { main } = await import("../dist/cli.mjs");
-	await main();
-}
+const { main } = existsSync(sourceEntry)
+	? await import("../src/cli.ts")
+	: await import("../dist/cli.mjs");
+await main();

package/dist/cli.mjs

@@ -1,4 +1,4 @@
-import { A as outputSingleResult, I as parseGameOutput, W as formatBanner, Z as LuauScriptError, ct as VALID_BACKENDS, dt as isValidBackend, et as mergeCliWithConfig, ft as ConfigError, h as walkErrorChain, k as outputMultiResult, m as formatMissingScopes, n as runJestRoblox, pt as version, tt as loadConfig } from "./run-Cirdb_CB.mjs";
+import { B as parseGameOutput, J as formatBanner, N as outputMultiResult, P as outputSingleResult, bt as version, ct as loadConfig, ht as VALID_BACKENDS, n as runJestRoblox, st as mergeCliWithConfig, tt as LuauScriptError, v as formatMissingScopes, vt as isValidBackend, y as walkErrorChain, yt as ConfigError } from "./run-BKP7mem2.mjs";
 import { OpenCloudError } from "@bedrock-rbx/ocale";
 import process from "node:process";
 import { parseArgs as parseArgs$1 } from "node:util";
@@ -215,6 +215,7 @@ async function main() {
 	process.exitCode = await run(process.argv.slice(2));
 }
 const PARALLEL_FLAG = "--parallel";
+const IntegerLikePattern = /^-?\d+$/;
 function normalizeParallelFlag(args) {
 	const out = [];
 	for (let index = 0; index < args.length; index++) {
@@ -224,7 +225,7 @@ function normalizeParallelFlag(args) {
 			continue;
 		}
 		const next = args[index + 1];
-		if (next !== void 0 && !next.startsWith("-") && (next === "auto" || /^-?\d+$/.test(next))) {
+		if (next !== void 0 && !next.startsWith("-") && (next === "auto" || IntegerLikePattern.test(next))) {
 			out.push(PARALLEL_FLAG, next);
 			index += 1;
 		} else out.push(PARALLEL_FLAG, "auto");

package/dist/index.d.mts

@@ -106,6 +106,44 @@ interface CoverageArtifacts {
 }
 declare function readBuildManifest(filePath: string, options?: ReadBuildManifestOptions): ReadBuildManifestResult;
 //#endregion
+//#region src/artifacts/build-coverage-place.d.ts
+/**
+* Everything a caller (a Node-only "Machine A") needs after producing the
+* coverage-instrumented place offline, without executing any suite: the built
+* place (`coveragePlace.path` + content hash) and the paths of the sibling
+* manifests it shares a `buildId` with. The place is left on disk for the caller
+* to copy to the run machine — it is never cleaned.
+*/
+interface CoveragePlaceBundle {
+  buildId: string;
+  /** The always-on build record's path (`build-manifest.json`). */
+  buildManifestPath: string;
+  /** The coverage-data sibling manifest's path (`coverage-manifest.json`). */
+  coverageManifestPath: string;
+  /** The instrumented place: cwd-relative path + SHA-256 of its bytes. */
+  coveragePlace: BuildManifestArtifact;
+  /** Per-project DataModel paths baked into the place. */
+  projects: Array<BuildManifestProject>;
+  /** `false` on the incremental no-change reuse path (place was not rebuilt). */
+  rebuilt: boolean;
+}
+/**
+* Build the coverage-instrumented place **without running it** — the offline
+* half of the split producer. Instruments (incrementally) and rojo-builds the
+* place, bakes each project's `jest.config` stub into it so any runner that
+* opens the place can discover and run the suite unaided, publishes the sibling
+* Build + Coverage manifests, and hands back the place. No backend is resolved,
+* no suite executes, nothing hits the network. Coverage collection is forced on
+* regardless of the input config.
+*
+* The counterpart to `prepareArtifacts`, minus the run and the Clean Place —
+* the entry point for a machine that cannot execute Roblox at all. It shares the
+* `prepareBakedCoverage` seam with the run path but always bakes stubs (the run
+* path skips baking for studio-cli, which injects configs at runtime), because a
+* place handed to a foreign runner must be self-contained.
+*/
+declare function buildCoveragePlace(config: ResolvedConfig): Promise<CoveragePlaceBundle>;
+//#endregion
 //#region src/coverage-pipeline/types.d.ts
 /**
 * Raw hit counts for a single file, keyed by statement/function index.
@@ -423,9 +461,25 @@ interface OpenCloudOptions {
 }
 declare class OpenCloudBackend implements Backend {
   private readonly runner;
-  readonly kind = "open-cloud";
+  /** One-shot per run so parallel raced tasks don't repeat the warning. */
+  private raceWarned;
+  readonly kind: "open-cloud";
   constructor(credentials: OpenCloudCredentials, options?: OpenCloudOptions);
   runTests(options: BackendOptions): Promise<BackendResult>;
+  /**
+  * Optimistic version pinning. Pinned tasks
+  * (`/versions/{v}/luau-execution-session-tasks`) miss the warm-server pool
+  * whenever no server holds the freshly-uploaded version yet, costing a cold
+  * place boot per task (~10-45s, scaling with place size). Unpinned tasks
+  * boot the latest saved version from the warm pool, so the first attempt
+  * runs unpinned with a guard prepended: if the booted server is not on this
+  * run's version (a concurrent upload won the boot race), the task returns
+  * {@link PLACE_VERSION_RACE_SENTINEL} instead of running. On the sentinel,
+  * the task is retried once, pinned — correct by construction, no re-upload
+  * (the version exists even when it is no longer head), and no unpinned
+  * retry loop for a concurrent uploader to keep winning against.
+  */
+  private executeGuarded;
   private runBucket;
   private runStaticBuckets;
   private runWorkStealing;
@@ -568,7 +622,7 @@ declare class StudioCliBackend implements Backend {
   private readonly launch;
   private readonly studioPath?;
   private readonly timeout;
-  readonly kind = "studio-cli";
+  readonly kind: "studio-cli";
   constructor(options?: StudioCliOptions);
   runTests(options: BackendOptions): Promise<BackendResult>;
   /**
@@ -597,7 +651,7 @@ declare class StudioBackend implements Backend {
   private readonly timeout;
   private preConnected?;
   private wss?;
-  readonly kind = "studio";
+  readonly kind: "studio";
   constructor(options: StudioOptions);
   close(): void;
   runTests(options: BackendOptions): Promise<BackendResult>;
@@ -761,6 +815,40 @@ type ReadManifestResult = ParsedManifest<CoverageManifest>;
 declare const manifestSchema: type<CoverageManifest>;
 declare function readManifest(filePath: string): ReadManifestResult;
 //#endregion
+//#region src/coverage-pipeline/merge-raw-coverage.d.ts
+/**
+* Additively merge two raw coverage datasets. Overlapping files have their
+* hit counts summed (matching istanbul-lib-coverage's semantics).
+*/
+declare function mergeRawCoverage(target: RawCoverageData | undefined, source: RawCoverageData | undefined): RawCoverageData | undefined;
+//#endregion
+//#region src/coverage-pipeline/raw-coverage.d.ts
+/**
+* Normalize a raw coverage table into typed {@link RawCoverageData}. The input
+* is the per-file hit table the coverage probes accumulate at runtime — the
+* `_G.__jest_roblox_cov` global, or the `_coverage` field of a run envelope —
+* keyed by the stable per-file join key (`fileKey`). Luau serializes the
+* `s`/`f` counters as 1-based arrays and `b` as an array of arrays; this
+* canonicalizes them to string-keyed records while leaving the fileKey verbatim
+* (it is the byte-identical join key the static maps are also keyed to). Returns
+* `undefined` when the input is not an object or carries no file with a
+* statement map.
+*/
+declare function normalizeRawCoverage(coverage: unknown): RawCoverageData | undefined;
+/**
+* Extract raw coverage from a completed run's result envelope — the companion
+* seam for a run this CLI did not launch. Accepts the plugin's `jestOutput`
+* (a JSON string or an already-parsed object), or the bare `_G.__jest_roblox_cov`
+* table read straight off the run. When an object carries a `_coverage` field it
+* is used; otherwise the object is treated as the hit table itself. Returns
+* `undefined` for malformed JSON or an envelope with no coverage.
+*
+* A multi-project result (`{ entries: [{ jestOutput }, …] }`) carries one
+* envelope per project; parse each `entries[i].jestOutput` and combine with
+* `mergeRawCoverage`.
+*/
+declare function parseCoverageEnvelope(output: unknown): RawCoverageData | undefined;
+//#endregion
 //#region src/coverage-pipeline/attribution.d.ts
 interface AttributionResult {
   /** Per Luau file: statement id → ids of the tests that covered it. */
@@ -1608,4 +1696,4 @@ declare function visitExpression(expression: AstExpr, visitor: LuauVisitor): voi
 declare function visitStatement(statement: AstStat, visitor: LuauVisitor): void;
 declare function visitBlock(block: AstStatBlock, visitor: LuauVisitor): void; //#endregion
 //#endregion
-export { type ArtifactBundle, type AstExpr, type AstExprBinary, type AstExprCall, type AstExprFunction, type AstStat, type AstStatBlock, BUILD_MANIFEST_VERSION, type Backend, type BackendOptions, type BuildManifest, type BuildManifestArtifact, type BuildManifestFileRecord, type BuildManifestProject, type CliOptions, type Config, type ConfigInput, type CoverageManifest, DEFAULT_CONFIG, type DisplayName, type ExecuteResult, type FormatOutputOptions, type FormatterEntry, GLOBAL_TEST_KEYS, type GameOutputEntry, type GitHubActionsFormatterOptions, type GlobalTestConfig, type InlineProjectConfig, type InstrumentedFileRecord, JEST_ARGV_EXCLUDED_KEYS, type JestArgv, type JestResult, type LuauSpan, type LuauVisitor, MANIFEST_VERSION, type MultiProjectMerged, type MultiRunResult, type NonInstrumentedFileRecord, OpenCloudBackend, type ProjectEntry, type ProjectInput, type ProjectResult, type ProjectTestConfig, ROOT_CLI_KEYS, type ReadBuildManifestOptions, type ReadBuildManifestResult, type ReadManifestResult as ReadCoverageManifestResult, type ResolvedConfig, type ResolvedProjectConfig, type RunMode, type RunOptions, type RunProjectsOptions, type RunProjectsResult, type RunResult, SHARED_TEST_KEYS, type SharedTestConfig, type SingleRunResult, StudioBackend, StudioCliBackend, type TestCaseResult, type TestDefinition, type TestFileResult, type TestRecord, type TestStatus, type TscErrorInfo, type TypecheckOptions, type WorkspaceConfig, type WorkspaceRunResult, buildJestArgv, buildManifestSchema, manifestSchema as coverageManifestSchema, createOpenCloudBackend, createStudioBackend, createStudioCliBackend, defineConfig, defineProject, extractJsonFromOutput, formatAnnotations, formatExecuteOutput, formatFailure, formatGameOutputNotice, formatJobSummary, formatJson, formatResult, formatTestSummary, generateTestScript, hashFile, loadConfig, parseGameOutput, parseJestOutput, prepareArtifacts, readBuildManifest, readManifest as readCoverageManifest, resolveConfig, runJestRoblox, runProjects, runTypecheck, visitBlock, visitExpression, visitStatement, writeGameOutput, writeJsonFile };
+export { type ArtifactBundle, type AstExpr, type AstExprBinary, type AstExprCall, type AstExprFunction, type AstStat, type AstStatBlock, BUILD_MANIFEST_VERSION, type Backend, type BackendOptions, type BuildManifest, type BuildManifestArtifact, type BuildManifestFileRecord, type BuildManifestProject, type CliOptions, type Config, type ConfigInput, type CoverageManifest, type CoveragePlaceBundle, DEFAULT_CONFIG, type DisplayName, type ExecuteResult, type FormatOutputOptions, type FormatterEntry, GLOBAL_TEST_KEYS, type GameOutputEntry, type GitHubActionsFormatterOptions, type GlobalTestConfig, type InlineProjectConfig, type InstrumentedFileRecord, JEST_ARGV_EXCLUDED_KEYS, type JestArgv, type JestResult, type LuauSpan, type LuauVisitor, MANIFEST_VERSION, type MultiProjectMerged, type MultiRunResult, type NonInstrumentedFileRecord, OpenCloudBackend, type ProjectEntry, type ProjectInput, type ProjectResult, type ProjectTestConfig, ROOT_CLI_KEYS, type RawCoverageData, type RawFileCoverage, type ReadBuildManifestOptions, type ReadBuildManifestResult, type ReadManifestResult as ReadCoverageManifestResult, type ResolvedConfig, type ResolvedProjectConfig, type RunMode, type RunOptions, type RunProjectsOptions, type RunProjectsResult, type RunResult, SHARED_TEST_KEYS, type SharedTestConfig, type SingleRunResult, StudioBackend, StudioCliBackend, type TestCaseResult, type TestDefinition, type TestFileResult, type TestRecord, type TestStatus, type TscErrorInfo, type TypecheckOptions, type WorkspaceConfig, type WorkspaceRunResult, buildCoveragePlace, buildJestArgv, buildManifestSchema, manifestSchema as coverageManifestSchema, createOpenCloudBackend, createStudioBackend, createStudioCliBackend, defineConfig, defineProject, extractJsonFromOutput, formatAnnotations, formatExecuteOutput, formatFailure, formatGameOutputNotice, formatJobSummary, formatJson, formatResult, formatTestSummary, generateTestScript, hashFile, loadConfig, mergeRawCoverage, normalizeRawCoverage, parseCoverageEnvelope, parseGameOutput, parseJestOutput, prepareArtifacts, readBuildManifest, readManifest as readCoverageManifest, resolveConfig, runJestRoblox, runProjects, runTypecheck, visitBlock, visitExpression, visitStatement, writeGameOutput, writeJsonFile };

package/dist/index.mjs

@@ -1,5 +1,55 @@
-import { $ as parseJestOutput, B as writeJsonFile, C as visitStatement, D as emitBuildManifest, E as buildManifestSchema, F as formatGameOutputNotice, G as hashFile, H as formatResult, I as parseGameOutput, J as readManifest, K as MANIFEST_VERSION, L as writeGameOutput, M as formatJobSummary, N as formatExecuteOutput, O as readBuildManifest, P as runProjects, Q as extractJsonFromOutput, R as createTimingCollector, S as visitExpression, T as BUILD_MANIFEST_VERSION, U as formatTestSummary, V as formatFailure, X as applyAttribution, Y as writeManifest, _ as generateTestScript, a as loadRojoTree, at as JEST_ARGV_EXCLUDED_KEYS, b as findRojoProject, c as StudioBackend, d as createStudioCliBackend, et as mergeCliWithConfig, f as OpenCloudBackend, g as buildJestArgv, i as collectStubMounts, it as GLOBAL_TEST_KEYS, j as formatAnnotations, l as createStudioBackend, lt as defineConfig, n as runJestRoblox, nt as resolveConfig, o as runTypecheck, ot as ROOT_CLI_KEYS, p as createOpenCloudBackend, q as manifestSchema, r as runSingleOrMulti, rt as DEFAULT_CONFIG, s as resolveAllProjects, st as SHARED_TEST_KEYS, t as getRawProjects, tt as loadConfig, u as StudioCliBackend, ut as defineProject, v as COVERAGE_BUILD_MANIFEST_PATH, w as buildPlace, x as visitBlock, y as COVERAGE_MANIFEST_PATH, z as formatJson } from "./run-Cirdb_CB.mjs";
+import { $ as writeManifest, A as buildManifestSchema, B as parseGameOutput, C as COVERAGE_MANIFEST_PATH, D as visitStatement, E as visitExpression, F as formatAnnotations, G as formatFailure, H as createTimingCollector, I as formatJobSummary, K as formatResult, L as formatExecuteOutput, M as readBuildManifest, O as buildPlace, Q as readManifest, R as runProjects, S as COVERAGE_BUILD_MANIFEST_PATH, T as visitBlock, U as formatJson, V as writeGameOutput, W as writeJsonFile, X as MANIFEST_VERSION, Y as hashFile, Z as manifestSchema, _ as createOpenCloudBackend, _t as defineProject, a as collectStubMounts, at as parseCoverageEnvelope, b as buildJestArgv, c as runTypecheck, ct as loadConfig, d as resolveAllProjects, dt as GLOBAL_TEST_KEYS, et as applyAttribution, f as StudioBackend, ft as JEST_ARGV_EXCLUDED_KEYS, g as OpenCloudBackend, gt as defineConfig, h as createStudioCliBackend, i as buildImplicitProject, it as normalizeRawCoverage, j as emitBuildManifest, k as BUILD_MANIFEST_VERSION, l as cleanLeftoverStubs, lt as resolveConfig, m as StudioCliBackend, mt as SHARED_TEST_KEYS, n as runJestRoblox, nt as extractJsonFromOutput, o as loadRojoTree, ot as mergeRawCoverage, p as createStudioBackend, pt as ROOT_CLI_KEYS, q as formatTestSummary, r as runSingleOrMulti, rt as parseJestOutput, s as prepareBakedCoverage, st as mergeCliWithConfig, t as getRawProjects, u as generateProjectStubs, ut as DEFAULT_CONFIG, w as findRojoProject, x as generateTestScript, z as formatGameOutputNotice } from "./run-BKP7mem2.mjs";
 import * as path$1 from "node:path";
+//#region src/artifacts/build-coverage-place.ts
+const CACHE_DIR$1 = path$1.join(".jest-roblox", "cache");
+/**
+* Build the coverage-instrumented place **without running it** — the offline
+* half of the split producer. Instruments (incrementally) and rojo-builds the
+* place, bakes each project's `jest.config` stub into it so any runner that
+* opens the place can discover and run the suite unaided, publishes the sibling
+* Build + Coverage manifests, and hands back the place. No backend is resolved,
+* no suite executes, nothing hits the network. Coverage collection is forced on
+* regardless of the input config.
+*
+* The counterpart to `prepareArtifacts`, minus the run and the Clean Place —
+* the entry point for a machine that cannot execute Roblox at all. It shares the
+* `prepareBakedCoverage` seam with the run path but always bakes stubs (the run
+* path skips baking for studio-cli, which injects configs at runtime), because a
+* place handed to a foreign runner must be self-contained.
+*/
+async function buildCoveragePlace(config) {
+	const merged = mergeCliWithConfig({}, {
+		...config,
+		collectCoverage: true
+	});
+	const projects = await resolveProjects(merged);
+	const cacheRoot = path$1.resolve(merged.rootDir, CACHE_DIR$1);
+	cleanLeftoverStubs(projects, merged.rootDir);
+	generateProjectStubs(projects, merged.rootDir, cacheRoot);
+	const { artifacts } = prepareBakedCoverage(merged, projects, cacheRoot, true);
+	if (artifacts.rebuilt) emitBuildManifest(COVERAGE_BUILD_MANIFEST_PATH, artifacts);
+	return {
+		buildId: artifacts.buildId,
+		buildManifestPath: COVERAGE_BUILD_MANIFEST_PATH,
+		coverageManifestPath: COVERAGE_MANIFEST_PATH,
+		coveragePlace: artifacts.coveragePlace,
+		projects: artifacts.projects,
+		rebuilt: artifacts.rebuilt
+	};
+}
+/**
+* Resolve the project set the place is built from, mirroring `runSingleOrMulti`
+* dispatch: an explicit `projects:` config resolves through `resolveAllProjects`;
+* a bare config collapses to the single implicit project derived from its luau
+* roots. Type-only configs are irrelevant here — a build always instruments.
+*/
+async function resolveProjects(config) {
+	const rojoTree = loadRojoTree(config);
+	const rawProjects = getRawProjects(config);
+	if (rawProjects !== void 0 && rawProjects.length > 0) return resolveAllProjects(rawProjects, config, rojoTree, config.rootDir);
+	return [buildImplicitProject(config, rojoTree)];
+}
+//#endregion
 //#region src/artifacts/prepare-artifacts.ts
 const COVERAGE_DIR = path$1.dirname(COVERAGE_BUILD_MANIFEST_PATH);
 const CLEAN_PLACE_FILE = path$1.join(COVERAGE_DIR, "clean.rbxl");
@@ -81,4 +131,4 @@ async function buildCleanPlace(config) {
 	});
 }
 //#endregion
-export { BUILD_MANIFEST_VERSION, DEFAULT_CONFIG, GLOBAL_TEST_KEYS, JEST_ARGV_EXCLUDED_KEYS, MANIFEST_VERSION, OpenCloudBackend, ROOT_CLI_KEYS, SHARED_TEST_KEYS, StudioBackend, StudioCliBackend, buildJestArgv, buildManifestSchema, manifestSchema as coverageManifestSchema, createOpenCloudBackend, createStudioBackend, createStudioCliBackend, defineConfig, defineProject, extractJsonFromOutput, formatAnnotations, formatExecuteOutput, formatFailure, formatGameOutputNotice, formatJobSummary, formatJson, formatResult, formatTestSummary, generateTestScript, hashFile, loadConfig, parseGameOutput, parseJestOutput, prepareArtifacts, readBuildManifest, readManifest as readCoverageManifest, resolveConfig, runJestRoblox, runProjects, runTypecheck, visitBlock, visitExpression, visitStatement, writeGameOutput, writeJsonFile };
+export { BUILD_MANIFEST_VERSION, DEFAULT_CONFIG, GLOBAL_TEST_KEYS, JEST_ARGV_EXCLUDED_KEYS, MANIFEST_VERSION, OpenCloudBackend, ROOT_CLI_KEYS, SHARED_TEST_KEYS, StudioBackend, StudioCliBackend, buildCoveragePlace, buildJestArgv, buildManifestSchema, manifestSchema as coverageManifestSchema, createOpenCloudBackend, createStudioBackend, createStudioCliBackend, defineConfig, defineProject, extractJsonFromOutput, formatAnnotations, formatExecuteOutput, formatFailure, formatGameOutputNotice, formatJobSummary, formatJson, formatResult, formatTestSummary, generateTestScript, hashFile, loadConfig, mergeRawCoverage, normalizeRawCoverage, parseCoverageEnvelope, parseGameOutput, parseJestOutput, prepareArtifacts, readBuildManifest, readManifest as readCoverageManifest, resolveConfig, runJestRoblox, runProjects, runTypecheck, visitBlock, visitExpression, visitStatement, writeGameOutput, writeJsonFile };