@isentinel/jest-roblox 0.2.7 → 0.3.0

package/dist/{executor-COuwZJJX.d.mts → schema-BpjBo-Aw.d.mts}

@@ -1,68 +1,5 @@
 import { ReportOptions } from "istanbul-reports";
 
-//#region packages/rojo-utils/dist/index.d.mts
-interface Mount {
-  dataModelPath: string;
-  fsPath: string;
-}
-//#endregion
-//#region node_modules/.pnpm/@rbxts+jest@3.13.3-ts.1/node_modules/@rbxts/jest/src/config.d.ts
-interface ReporterConfig {
-  reporter: string | ModuleScript;
-  options?: Record<string, any>;
-}
-type Argv = Partial<{
-  all: boolean;
-  automock: boolean;
-  bail: boolean | number;
-  changedSince: string;
-  ci: boolean;
-  clearCache: boolean;
-  clearMocks: boolean;
-  color: boolean;
-  colors: boolean;
-  config: string;
-  coverage: boolean;
-  debug: boolean;
-  env: string;
-  expand: boolean;
-  globals: string;
-  init: boolean;
-  injectGlobals: boolean;
-  json: boolean;
-  maxWorkers: number | string;
-  noStackTrace: boolean;
-  outputFile: string;
-  preset: string | undefined;
-  projects: Array<string>;
-  reporters: Array<string | ModuleScript | ReporterConfig>;
-  resetMocks: boolean;
-  resetModules: boolean;
-  restoreMocks: boolean;
-  rootDir: Instance;
-  roots: Array<string>;
-  runInBand: boolean;
-  selectProjects: Array<string>;
-  setupFiles: Array<ModuleScript>;
-  setupFilesAfterEnv: Array<ModuleScript>;
-  showConfig: boolean;
-  silent: boolean;
-  snapshotSerializers: Array<string>;
-  testEnvironment: string;
-  testEnvironmentOptions: string;
-  testFailureExitCode: string | undefined;
-  testMatch: Array<string>;
-  testNamePattern: string;
-  testPathIgnorePatterns: Array<string>;
-  testPathPattern: Array<string>;
-  testRegex: string | Array<string>;
-  testTimeout: number | undefined;
-  timers: string;
-  updateSnapshot: boolean;
-  verbose: boolean;
-  version: boolean;
-}>;
-//#endregion
 //#region node_modules/.pnpm/type-fest@5.5.0/node_modules/type-fest/source/is-any.d.ts
 /**
 Returns a boolean for whether the given type is `any`.
@@ -820,7 +757,7 @@ 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
-type Backend$1 = "auto" | "open-cloud" | "studio";
+type Backend = "auto" | "open-cloud" | "studio";
 type CoverageReporter = keyof ReportOptions;
 type FormatterEntry = [string, Record<string, unknown>] | string;
 interface SnapshotFormatOptions {
@@ -833,45 +770,82 @@ interface SnapshotFormatOptions {
   printBasicPrototype?: boolean;
   printFunctionName?: boolean;
 }
-declare const ROOT_ONLY_KEYS: ReadonlySet<string>;
 interface DisplayName {
   name: string;
   color: string;
 }
-interface ProjectTestConfig {
+/** Jest-passthrough keys valid both at `test:` and per-project. */
+interface SharedTestConfig {
   automock?: boolean;
   clearMocks?: boolean;
-  displayName: DisplayName | string;
-  exclude?: Array<string>;
-  include: Array<string>;
   injectGlobals?: boolean;
   mockDataModel?: boolean;
-  outDir?: string;
   resetMocks?: boolean;
   resetModules?: boolean;
   restoreMocks?: boolean;
-  root?: string;
   setupFiles?: Array<string>;
   setupFilesAfterEnv?: Array<string>;
   slowTestThreshold?: number;
   snapshotFormat?: SnapshotFormatOptions;
   snapshotSerializers?: Array<string>;
   testEnvironment?: string;
-  testEnvironmentOptions?: Record<string, unknown>;
+  testEnvironmentOptions?: Record<string, unknown> | string;
   testMatch?: Array<string>;
   testPathIgnorePatterns?: Array<string>;
   testRegex?: Array<string> | string;
   testTimeout?: number;
 }
+/** Jest-passthrough keys valid only per-project (under `projects[N].test`). */
+interface ProjectTestConfig extends SharedTestConfig {
+  displayName: DisplayName | string;
+  exclude?: Array<string>;
+  include: Array<string>;
+  outDir?: string;
+  root?: string;
+}
 interface InlineProjectConfig {
   test: ProjectTestConfig;
 }
+/** Workspace-only knobs. Ignored outside `--workspace` mode. */
+interface WorkspaceConfig {
+  /**
+  * When `true`, emit one Per-package Game Output file per selected
+  * (package, project) under `<workspaceRoot>/.jest-roblox/output/`.
+  * Consensus-resolved across packages; only `true` is accepted.
+  */
+  gameOutput?: true;
+  /**
+  * When `true`, emit one per-package result file (the Jest result JSON)
+  * per selected (package, project) under
+  * `<workspaceRoot>/.jest-roblox/output/`. Consensus-resolved across
+  * packages; only `true` is accepted.
+  */
+  outputFile?: true;
+  /**
+  * Globs (relative to `root`) selecting package directories — each must
+  * contain a `jest.config.*`. Lets workspace mode enumerate packages in
+  * Luau-only / npm / yarn repos that have no `pnpm-workspace.yaml`.
+  * Required together with `root`; independent of `gameOutput`/`outputFile`.
+  */
+  packages?: Array<string>;
+  /**
+  * The workspace root. Relative in source; resolved to an absolute path at
+  * load, anchored to the file that declares it (typically a shared config
+  * reached via `extends:`). Required together with `packages`.
+  */
+  root?: string;
+}
 type ProjectEntry = InlineProjectConfig | string;
-interface Config extends Except<Argv, "projects" | "rootDir" | "setupFiles" | "setupFilesAfterEnv" | "testPathPattern"> {
-  backend?: Backend$1;
-  cache?: boolean;
+/** Jest-passthrough keys valid only at root `test:` (not per-project). */
+interface GlobalTestConfig extends SharedTestConfig {
+  all?: boolean;
+  bail?: boolean | number;
+  changedSince?: string;
+  ci?: boolean;
+  clearCache?: boolean;
   collectCoverage?: boolean;
   collectCoverageFrom?: Array<string>;
+  coverage?: boolean;
   coverageDirectory?: string;
   coveragePathIgnorePatterns?: Array<string>;
   coverageReporters?: Array<CoverageReporter>;
@@ -881,43 +855,92 @@ interface Config extends Except<Argv, "projects" | "rootDir" | "setupFiles" | "s
     lines?: number;
     statements?: number;
   };
+  debug?: boolean;
+  displayName?: DisplayName | string;
+  env?: string;
+  exclude?: Array<string>;
+  expand?: boolean;
+  globals?: string;
+  include?: Array<string>;
+  maxWorkers?: number | string;
+  noStackTrace?: boolean;
+  outDir?: string;
+  passWithNoTests?: boolean;
+  preset?: string;
+  projects?: Array<ProjectEntry>;
+  reporters?: Array<string>;
+  roots?: Array<string>;
+  runInBand?: boolean;
+  selectProjects?: Array<string>;
+  showConfig?: boolean;
+  silent?: boolean;
+  testFailureExitCode?: string;
+  testNamePattern?: string;
+  testPathPattern?: string;
+  timers?: string;
+  updateSnapshot?: boolean;
+  verbose?: boolean;
+}
+/**
+* Root-level config: CLI/runner keys plus the `test:` block where all
+* jest-passthrough options live.
+*/
+interface Config {
+  backend?: Backend;
+  color?: boolean;
+  coverageCache?: boolean;
   extends?: Array<string> | string;
   formatters?: Array<FormatterEntry>;
-  gameOutput?: string;
+  /**
+  * Where to write Game Output. A path, or `true` to default to
+  * `game-output.log` under the root. In workspace mode this becomes the
+  * single Aggregated Game Output file (consensus-resolved).
+  */
+  gameOutput?: string | true;
   jestPath?: string;
   luauRoots?: Array<string>;
+  /**
+  * Where to write the Jest result JSON. A path, or `true` to default to
+  * `jest-output.log` under the root. In workspace mode this becomes the
+  * single aggregated result file (consensus-resolved).
+  */
+  outputFile?: string | true;
   parallel?: "auto" | number;
-  passWithNoTests?: boolean;
   placeFile?: string;
-  pollInterval?: number;
+  placeId?: string;
   port?: number;
-  projects?: Array<ProjectEntry>;
-  reporters?: Array<string>;
   rojoProject?: string;
   rootDir?: string;
-  setupFiles?: Array<string>;
-  setupFilesAfterEnv?: Array<string>;
   showLuau?: boolean;
-  snapshotFormat?: SnapshotFormatOptions;
   sourceMap?: boolean;
-  testPathPattern?: string;
+  test?: GlobalTestConfig;
   timeout?: number;
   typecheck?: boolean;
   typecheckOnly?: boolean;
   typecheckTsconfig?: string;
-  updateSnapshot?: boolean;
+  universeId?: string;
+  workspace?: WorkspaceConfig;
 }
-interface ResolvedConfig extends Except<Config, "projects"> {
-  backend: Backend$1;
-  cache: boolean;
+/**
+* Resolved config flattens the root CLI keys with the `test:` jest options
+* so downstream code (executor, projects, test-script, formatters) can read
+* options uniformly. Refactoring those consumers to read `config.test.foo`
+* is follow-up work; this shape lets the structural split land first.
+*/
+interface ResolvedConfig extends Except<Config, "test">, Except<GlobalTestConfig, "projects"> {
+  backend: Backend;
   collectCoverage: boolean;
   color: boolean;
+  coverageCache: boolean;
   coverageDirectory: string;
   coveragePathIgnorePatterns: Array<string>;
   coverageReporters: Array<CoverageReporter>;
+  /** `true` is expanded to `<rootDir>/game-output.log` at resolve time; an explicit path is kept as-is. */
+  gameOutput?: string;
+  /** `true` is expanded to `<rootDir>/jest-output.log` at resolve time; an explicit path is kept as-is. */
+  outputFile?: string;
   passWithNoTests: boolean;
   placeFile: string;
-  pollInterval: number;
   port: number;
   projects?: Array<string>;
   rootDir: string;
@@ -936,12 +959,14 @@ type MergerFunction<T> = (defaults: T) => T;
 type Mergeable<T> = MergerFunction<T> | T;
 declare const DEFAULT_CONFIG: ResolvedConfig;
 interface CliOptions {
-  backend?: Backend$1;
-  cache?: boolean;
+  affectedSince?: string;
+  apiKey?: string;
+  backend?: Backend;
   collectCoverage?: boolean;
   collectCoverageFrom?: Array<string>;
   color?: boolean;
   config?: string;
+  coverageCache?: boolean;
   coverageDirectory?: string;
   coverageReporters?: Array<CoverageReporter>;
   files?: Array<string>;
@@ -949,9 +974,10 @@ interface CliOptions {
   gameOutput?: string;
   help?: boolean;
   outputFile?: string;
+  packages?: string;
   parallel?: "auto" | number;
   passWithNoTests?: boolean;
-  pollInterval?: number;
+  placeId?: string;
   port?: number;
   project?: Array<string>;
   reporters?: Array<string>;
@@ -967,222 +993,34 @@ interface CliOptions {
   typecheck?: boolean;
   typecheckOnly?: boolean;
   typecheckTsconfig?: string;
+  universeId?: string;
   updateSnapshot?: boolean;
   verbose?: boolean;
   version?: boolean;
+  workspace?: boolean;
+  /** Directory to load the workspace config from when run outside a package. */
+  workspaceRoot?: string;
 }
-interface ConfigInput extends Except<Config, "collectCoverageFrom" | "coveragePathIgnorePatterns" | "coverageReporters" | "formatters" | "luauRoots" | "reporters" | "setupFiles" | "setupFilesAfterEnv" | "testMatch" | "testPathIgnorePatterns"> {
-  collectCoverageFrom?: Mergeable<Array<string>>;
-  coveragePathIgnorePatterns?: Mergeable<Array<string>>;
-  coverageReporters?: Mergeable<Array<CoverageReporter>>;
+interface ConfigInput extends Except<Config, "formatters" | "luauRoots" | "test"> {
   formatters?: Mergeable<Array<FormatterEntry>>;
   luauRoots?: Mergeable<Array<string>>;
-  reporters?: Mergeable<Array<string>>;
-  setupFiles?: Mergeable<Array<string>>;
-  setupFilesAfterEnv?: Mergeable<Array<string>>;
-  testMatch?: Mergeable<Array<string>>;
-  testPathIgnorePatterns?: Mergeable<Array<string>>;
-}
-declare const defineConfig: (input: ConfigInput) => ConfigInput;
-declare const defineProject: (input: ProjectTestConfig) => ProjectTestConfig;
-//#endregion
-//#region src/config/projects.d.ts
-interface ResolvedProjectConfig {
-  config: ResolvedConfig;
-  displayColor?: string;
-  displayName: string;
-  /** Original include patterns (with TS extensions) for filesystem discovery. */
-  include: Array<string>;
-  /**
-  * Single resolved output directory (workspace-relative). Set only when
-  * resolution produced exactly one mount; undefined when the project spans
-  * multiple rojo mounts. Kept for back-compat; new code should consume
-  * `rojoMounts` instead.
-  */
-  outDir?: string;
-  /** DataModel paths Jest walks up from to discover test configs. */
-  projects: Array<string>;
-  /** Internal: FS↔DataModel pairs for stub generation and shadow sync. */
-  rojoMounts: Array<Mount>;
-  /** Luau-side testMatch patterns (extensions stripped). */
-  testMatch: Array<string>;
-}
-//#endregion
-//#region src/coverage/types.d.ts
-/**
-* Raw hit counts for a single file, keyed by statement/function index.
-*/
-interface RawFileCoverage {
-  b?: Record<string, Array<number>>;
-  f?: Record<string, number>;
-  s: Record<string, number>;
-}
-/**
-* Raw coverage data for all files, keyed by original Luau-relative path.
-*/
-type RawCoverageData = Record<string, RawFileCoverage>;
-//#endregion
-//#region src/types/jest-result.d.ts
-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;
-}
-interface TestFileResult {
-  failureMessage?: string;
-  numFailingTests: number;
-  numPassingTests: number;
-  numPendingTests: number;
-  testFilePath: string;
-  testResults: Array<TestCaseResult>;
-}
-interface SnapshotSummary {
-  added: number;
-  matched: number;
-  total: number;
-  unmatched: number;
-  updated: number;
+  test?: GlobalTestConfigInput;
 }
-interface JestResult {
-  numFailedTests: number;
-  numPassedTests: number;
-  numPendingTests: number;
-  numTodoTests?: 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 {
-  coverageData?: RawCoverageData;
-  luauTiming?: Record<string, number>;
-  result: JestResult;
-  setupSeconds?: number;
-  snapshotWrites?: SnapshotWrites;
-}
-declare function extractJsonFromOutput(output: string): string | undefined;
-declare function parseJestOutput(output: string): ParseResult;
-//#endregion
-//#region src/backends/interface.d.ts
-interface ProjectJob {
-  config: ResolvedConfig;
-  displayColor?: string;
-  displayName: string;
-  testFiles: Array<string>;
-}
-interface BackendOptions {
-  jobs: Array<ProjectJob>;
-  /**
-  * Open-Cloud-only: number of concurrent Open Cloud Luau execution sessions
-  * to fire. Unset or 1 means one session carrying all jobs. `"auto"` resolves
-  * to min(jobs.length, 3). Studio backend must error when this is set to
-  * anything other than undefined/1 (Phase 4 enforces at the CLI layer).
-  */
-  parallel?: "auto" | number;
-}
-interface BackendTiming {
-  executionMs: number;
-  uploadCached?: boolean;
-  uploadMs?: number;
-}
-interface ProjectBackendResult {
-  coverageData?: RawCoverageData;
-  displayColor?: string;
-  displayName: string;
-  elapsedMs: number;
-  gameOutput?: string;
-  luauTiming?: Record<string, number>;
-  result: JestResult;
-  setupMs?: number;
-  snapshotWrites?: SnapshotWrites;
-}
-interface BackendResult {
-  results: Array<ProjectBackendResult>;
-  timing: BackendTiming;
-}
-type BackendKind = "open-cloud" | "studio";
-interface Backend {
-  close?(): Promise<void> | void;
-  readonly kind: BackendKind;
-  runTests(options: BackendOptions): Promise<BackendResult>;
-}
-//#endregion
-//#region src/source-mapper/index.d.ts
-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
-interface TimingResult {
-  coverageMs?: number;
-  executionMs: number;
-  setupMs?: number;
-  startTime: number;
-  testsMs: number;
-  totalMs: number;
-  uploadCached?: boolean;
-  uploadMs?: number;
-}
-//#endregion
-//#region src/executor.d.ts
-interface ExecuteOptions {
-  backend: Backend;
-  config: ResolvedConfig;
-  deferFormatting?: boolean;
-  testFiles: Array<string>;
-  version: string;
-}
-interface ExecuteResult {
-  coverageData?: RawCoverageData;
-  exitCode: number;
-  gameOutput?: string;
-  output: string;
-  result: JestResult;
-  sourceMapper?: SourceMapper;
-  timing: TimingResult;
-}
-interface FormatOutputOptions {
-  config: ResolvedConfig;
-  result: JestResult;
-  sourceMapper?: SourceMapper;
-  timing: TimingResult;
-  version: string;
-}
-declare function formatExecuteOutput(options: FormatOutputOptions): string;
+type MergeableTestKey = "collectCoverageFrom" | "coveragePathIgnorePatterns" | "coverageReporters" | "coverageThreshold" | "reporters" | "roots" | "selectProjects" | "setupFiles" | "setupFilesAfterEnv" | "snapshotFormat" | "snapshotSerializers" | "testMatch" | "testPathIgnorePatterns";
+type GlobalTestConfigInput = Except<GlobalTestConfig, MergeableTestKey> & { [K in MergeableTestKey]?: Mergeable<NonNullable<GlobalTestConfig[K]>> };
+declare const SHARED_TEST_KEYS: ReadonlySet<string>;
+/** Keys valid in `test:` (root) but not per-project (`projects[N].test`). */
+declare const GLOBAL_TEST_KEYS: ReadonlySet<string>;
+/** Root-level CLI/runner keys. The complement of `test:` jest-passthrough keys. */
+declare const ROOT_CLI_KEYS: ReadonlySet<string>;
 /**
-* Single-project convenience wrapper: builds a length-1 jobs array, fires
-* `executeBackend` once, and maps the single entry through
-* `processProjectResult`. Multi-project callers drive `executeBackend` +
-* `processProjectResult` directly from `cli.ts`.
+* Keys excluded from jest argv when building the test runner script. Includes
+* all CLI/runner-level keys plus the coverage keys, which live under `test:`
+* by config shape but are consumed by the runner's lute-based coverage layer
+* (not jest itself).
 */
-declare function execute(options: ExecuteOptions): Promise<ExecuteResult>;
+declare const JEST_ARGV_EXCLUDED_KEYS: ReadonlySet<string>;
+declare const defineConfig: (input: ConfigInput) => ConfigInput;
+declare const defineProject: (input: InlineProjectConfig) => InlineProjectConfig;
 //#endregion
-export { defineConfig as A, FormatterEntry as C, ROOT_ONLY_KEYS as D, ProjectTestConfig as E, Argv as M, ResolvedConfig as O, DisplayName as S, ProjectEntry as T, ResolvedProjectConfig as _, formatExecuteOutput as a, ConfigInput as b, Backend as c, extractJsonFromOutput as d, parseJestOutput as f, TestStatus as g, TestFileResult as h, execute as i, defineProject as j, SnapshotFormatOptions as k, BackendOptions as l, TestCaseResult as m, ExecuteResult as n, TimingResult as o, JestResult as p, FormatOutputOptions as r, SourceMapper as s, ExecuteOptions as t, BackendResult as u, CliOptions as v, InlineProjectConfig as w, DEFAULT_CONFIG as x, Config as y };
+export { SnapshotFormatOptions as _, DisplayName as a, defineProject as b, GlobalTestConfig as c, ProjectEntry as d, ProjectTestConfig as f, SharedTestConfig as g, SHARED_TEST_KEYS as h, DEFAULT_CONFIG as i, InlineProjectConfig as l, ResolvedConfig as m, Config as n, FormatterEntry as o, ROOT_CLI_KEYS as p, ConfigInput as r, GLOBAL_TEST_KEYS as s, CliOptions as t, JEST_ARGV_EXCLUDED_KEYS as u, WorkspaceConfig as v, defineConfig as y };