tstyche 3.0.0-beta.4 → 3.0.0-beta.6

package/build/tstyche.d.ts

@@ -132,7 +132,8 @@ declare enum OptionBrand {
 
 declare enum OptionGroup {
     CommandLine = 2,
-    ConfigFile = 4
+    ConfigFile = 4,
+    ResolvedConfig = 6
 }
 
 declare class ConfigDiagnosticText {
@@ -146,6 +147,7 @@ declare class ConfigDiagnosticText {
     static testFileMatchCannotStartWith(segment: string): Array<string>;
     static requiresValueType(optionName: string, optionBrand: OptionBrand, optionGroup: OptionGroup): string;
     static unknownOption(optionName: string): string;
+    static usage(optionName: string, optionBrand: OptionBrand, optionGroup: OptionGroup): Promise<Array<string>>;
     static versionIsNotSupported(value: string): string;
     static watchCannotBeEnabled(): string;
 }
@@ -178,6 +180,10 @@ interface ConfigFileOptions {
      * The list of glob patterns matching the test files.
      */
     testFileMatch?: Array<string>;
+    /**
+     * The look up strategy to be used to find the TSConfig file.
+     */
+    tsconfig?: string;
 }
 
 /**
@@ -232,6 +238,10 @@ interface CommandLineOptions {
      * The list of TypeScript versions to be tested on.
      */
     target?: Array<string>;
+    /**
+     * The look up strategy to be used to find the TSConfig file.
+     */
+    tsconfig?: string;
     /**
      * Fetch the 'typescript' package metadata from the registry and exit.
      */
@@ -297,6 +307,8 @@ interface ListTypeOptionDefinition extends BaseOptionDefinition {
 declare class Options {
     #private;
     static for(optionGroup: OptionGroup): Map<string, OptionDefinition>;
+    static resolve(optionName: string, optionValue: string, rootPath?: string): string;
+    static validate(optionDefinition: OptionDefinition | ItemDefinition, optionValue: string, optionGroup: OptionGroup, onDiagnostics: DiagnosticsHandler$1, origin?: DiagnosticOrigin): Promise<void>;
 }
 
 declare const defaultOptions: Required<ConfigFileOptions>;
@@ -443,10 +455,10 @@ type TargetResultStatus = ResultStatus.Runs | ResultStatus.Passed | ResultStatus
 declare class TargetResult {
     results: Map<string | undefined, ProjectResult>;
     status: TargetResultStatus;
+    target: string;
     tasks: Array<Task>;
     timing: ResultTiming;
-    versionTag: string;
-    constructor(versionTag: string, tasks: Array<Task>);
+    constructor(target: string, tasks: Array<Task>);
 }
 
 declare class Result {
@@ -706,25 +718,6 @@ declare class ResultHandler implements EventHandler {
     on([event, payload]: Event): void;
 }
 
-interface Hooks {
-    /**
-     * Is called after configuration is resolved and allows to modify it.
-     */
-    config?: (resolvedConfig: ResolvedConfig) => ResolvedConfig | Promise<ResolvedConfig>;
-    /**
-     * Is called after test files are selected and allows to modify the list.
-     */
-    select?: (testFiles: Array<string>) => Array<string | URL> | Promise<Array<string | URL>>;
-}
-
-declare class HooksService {
-    #private;
-    static addHandler(hooks: Hooks): void;
-    static call(hook: "config", resolvedConfig: ResolvedConfig): Promise<ResolvedConfig>;
-    static call(hook: "select", testFiles: Array<string>): Promise<Array<string | URL>>;
-    static removeHandlers(): void;
-}
-
 type InputHandler = (chunk: string) => void;
 declare class InputService {
     #private;
@@ -841,9 +834,35 @@ declare class Path {
     static resolve(...filePaths: Array<string>): string;
 }
 
+interface SelectHookContext {
+    resolvedConfig: ResolvedConfig;
+}
+interface Plugin {
+    /**
+     * The name of this plugin.
+     */
+    name: string;
+    /**
+     * Is called after configuration is resolved and allows to modify it.
+     */
+    config?: (resolvedConfig: ResolvedConfig) => ResolvedConfig | Promise<ResolvedConfig>;
+    /**
+     * Is called after test files are selected and allows to modify the list.
+     */
+    select?: (this: SelectHookContext, testFiles: Array<string>) => Array<string | URL> | Promise<Array<string | URL>>;
+}
+
+type Hooks = Required<Omit<Plugin, "name">>;
+declare class PluginService {
+    #private;
+    static addHandler(plugin: Plugin): void;
+    static call<T extends keyof Hooks>(hook: T, argument: Parameters<Hooks[T]>[0], context: ThisParameterType<Hooks[T]>): Promise<Awaited<ReturnType<Hooks[T]>>>;
+    static removeHandlers(): void;
+}
+
 declare class ProjectService {
     #private;
-    constructor(compiler: typeof ts);
+    constructor(resolvedConfig: ResolvedConfig, compiler: typeof ts);
     closeFile(filePath: string): void;
     getDefaultProject(filePath: string): ts.server.Project | undefined;
     getLanguageService(filePath: string): ts.LanguageService | undefined;
@@ -909,4 +928,4 @@ declare class WatchService {
     watch(cancellationToken: CancellationToken): AsyncIterable<Array<Task>>;
 }
 
-export { Assertion, BaseReporter, CancellationHandler, CancellationReason, CancellationToken, Cli, CollectService, Color, type CommandLineOptions, Config, ConfigDiagnosticText, type ConfigFileOptions, DescribeResult, Diagnostic, DiagnosticCategory, DiagnosticOrigin, type DiagnosticsHandler$1 as DiagnosticsHandler, type EnvironmentOptions, type Event, EventEmitter, type EventHandler, ExitCodeHandler, ExpectResult, ExpectService, type FileWatchHandler, FileWatcher, type Hooks, HooksService, type InputHandler, InputService, type ItemDefinition, Line, ListReporter, type MatchResult, OptionBrand, type OptionDefinition, OptionGroup, Options, OutputService, Path, ProjectResult, ProjectService, type Reporter, type ReporterEvent, type ResolvedConfig, Result, ResultCount, ResultHandler, ResultStatus, ResultTiming, Runner, Scribbler, ScribblerJsx, type ScribblerOptions, Select, SelectDiagnosticText, SetupReporter, SourceFile, Store, SummaryReporter, TargetResult, type TargetResultStatus, Task, TaskResult, type TaskResultStatus, TestMember, TestMemberBrand, TestMemberFlags, TestResult, TestTree, Text, type TypeChecker, Version, type WatchHandler, WatchReporter, WatchService, Watcher, type WatcherOptions, addsPackageText, defaultOptions, describeNameText, diagnosticText, environmentOptions, fileViewText, formattedText, helpText, summaryText, taskStatusText, testNameText, usesCompilerText, waitingForFileChangesText, watchUsageText };
+export { Assertion, BaseReporter, CancellationHandler, CancellationReason, CancellationToken, Cli, CollectService, Color, type CommandLineOptions, Config, ConfigDiagnosticText, type ConfigFileOptions, DescribeResult, Diagnostic, DiagnosticCategory, DiagnosticOrigin, type DiagnosticsHandler$1 as DiagnosticsHandler, type EnvironmentOptions, type Event, EventEmitter, type EventHandler, ExitCodeHandler, ExpectResult, ExpectService, type FileWatchHandler, FileWatcher, type InputHandler, InputService, type ItemDefinition, Line, ListReporter, type MatchResult, OptionBrand, type OptionDefinition, OptionGroup, Options, OutputService, Path, type Plugin, PluginService, ProjectResult, ProjectService, type Reporter, type ReporterEvent, type ResolvedConfig, Result, ResultCount, ResultHandler, ResultStatus, ResultTiming, Runner, Scribbler, ScribblerJsx, type ScribblerOptions, Select, SelectDiagnosticText, SetupReporter, SourceFile, Store, SummaryReporter, TargetResult, type TargetResultStatus, Task, TaskResult, type TaskResultStatus, TestMember, TestMemberBrand, TestMemberFlags, TestResult, TestTree, Text, type TypeChecker, Version, type WatchHandler, WatchReporter, WatchService, Watcher, type WatcherOptions, addsPackageText, defaultOptions, describeNameText, diagnosticText, environmentOptions, fileViewText, formattedText, helpText, summaryText, taskStatusText, testNameText, usesCompilerText, waitingForFileChangesText, watchUsageText };

package/build/tstyche.js

@@ -1,64 +1,12 @@
-import { writeFileSync, rmSync, existsSync, watch } from 'node:fs';
 import fs from 'node:fs/promises';
-import path from 'node:path';
-import { pathToFileURL, fileURLToPath } from 'node:url';
 import { createRequire } from 'node:module';
 import vm from 'node:vm';
 import os from 'node:os';
 import process from 'node:process';
+import path from 'node:path';
+import { writeFileSync, rmSync, existsSync, watch } from 'node:fs';
 import streamConsumers from 'node:stream/consumers';
-
-class ConfigDiagnosticText {
-    static expected(element) {
-        return `Expected ${element}.`;
-    }
-    static expectsListItemType(optionName, optionBrand) {
-        return `Item of the '${optionName}' list must be of type ${optionBrand}.`;
-    }
-    static expectsValue(optionName, optionGroup) {
-        optionName = ConfigDiagnosticText.#optionName(optionName, optionGroup);
-        return `Option '${optionName}' expects a value.`;
-    }
-    static fileDoesNotExist(filePath) {
-        return `The specified path '${filePath}' does not exist.`;
-    }
-    static moduleWasNotFound(specifier) {
-        return `The specified module '${specifier}' was not found.`;
-    }
-    static #optionName(optionName, optionGroup) {
-        switch (optionGroup) {
-            case 2:
-                return `--${optionName}`;
-            case 4:
-                return optionName;
-        }
-    }
-    static seen(element) {
-        return `The ${element} was seen here.`;
-    }
-    static testFileMatchCannotStartWith(segment) {
-        return [
-            `A test file match pattern cannot start with '${segment}'.`,
-            "The test files are only collected within the 'rootPath' directory.",
-        ];
-    }
-    static requiresValueType(optionName, optionBrand, optionGroup) {
-        optionName = ConfigDiagnosticText.#optionName(optionName, optionGroup);
-        return `Option '${optionName}' requires a value of type ${optionBrand}.`;
-    }
-    static unknownOption(optionName) {
-        return `Unknown option '${optionName}'.`;
-    }
-    static versionIsNotSupported(value) {
-        if (value === "current") {
-            return "Cannot use 'current' as a target. Failed to resolve the path to the currently installed TypeScript module.";
-        }
-        return `TypeScript version '${value}' is not supported.`;
-    }
-    static watchCannotBeEnabled() {
-        return "Watch mode cannot be enabled in continuous integration environment.";
-    }
-}
+import { pathToFileURL, fileURLToPath } from 'node:url';
 
 class DiagnosticOrigin {
     assertion;
@@ -169,49 +117,6 @@ class SourceFile {
     }
 }
 
-class EventEmitter {
-    static instanceCount = 0;
-    static #handlers = new Map();
-    static #reporters = new Map();
-    #scope;
-    constructor() {
-        this.#scope = EventEmitter.instanceCount++;
-        EventEmitter.#handlers.set(this.#scope, new Set());
-        EventEmitter.#reporters.set(this.#scope, new Set());
-    }
-    addHandler(handler) {
-        EventEmitter.#handlers.get(this.#scope)?.add(handler);
-    }
-    addReporter(reporter) {
-        EventEmitter.#reporters.get(this.#scope)?.add(reporter);
-    }
-    static dispatch(event) {
-        function forEachHandler(handlers, event) {
-            for (const handler of handlers) {
-                handler.on(event);
-            }
-        }
-        for (const handlers of EventEmitter.#handlers.values()) {
-            forEachHandler(handlers, event);
-        }
-        for (const handlers of EventEmitter.#reporters.values()) {
-            forEachHandler(handlers, event);
-        }
-    }
-    removeHandler(handler) {
-        EventEmitter.#handlers.get(this.#scope)?.delete(handler);
-    }
-    removeReporter(reporter) {
-        EventEmitter.#reporters.get(this.#scope)?.delete(reporter);
-    }
-    removeHandlers() {
-        EventEmitter.#handlers.get(this.#scope)?.clear();
-    }
-    removeReporters() {
-        EventEmitter.#reporters.get(this.#scope)?.clear();
-    }
-}
-
 class Path {
     static normalizeSlashes;
     static {
@@ -317,6 +222,49 @@ class Environment {
 
 const environmentOptions = Environment.resolve();
 
+class EventEmitter {
+    static instanceCount = 0;
+    static #handlers = new Map();
+    static #reporters = new Map();
+    #scope;
+    constructor() {
+        this.#scope = EventEmitter.instanceCount++;
+        EventEmitter.#handlers.set(this.#scope, new Set());
+        EventEmitter.#reporters.set(this.#scope, new Set());
+    }
+    addHandler(handler) {
+        EventEmitter.#handlers.get(this.#scope)?.add(handler);
+    }
+    addReporter(reporter) {
+        EventEmitter.#reporters.get(this.#scope)?.add(reporter);
+    }
+    static dispatch(event) {
+        function forEachHandler(handlers, event) {
+            for (const handler of handlers) {
+                handler.on(event);
+            }
+        }
+        for (const handlers of EventEmitter.#handlers.values()) {
+            forEachHandler(handlers, event);
+        }
+        for (const handlers of EventEmitter.#reporters.values()) {
+            forEachHandler(handlers, event);
+        }
+    }
+    removeHandler(handler) {
+        EventEmitter.#handlers.get(this.#scope)?.delete(handler);
+    }
+    removeReporter(reporter) {
+        EventEmitter.#reporters.get(this.#scope)?.delete(reporter);
+    }
+    removeHandlers() {
+        EventEmitter.#handlers.get(this.#scope)?.clear();
+    }
+    removeReporters() {
+        EventEmitter.#reporters.get(this.#scope)?.clear();
+    }
+}
+
 class Version {
     static isGreaterThan(source, target) {
         return !(source === target) && Version.#satisfies(source, target);
@@ -809,86 +757,73 @@ class Store {
     }
 }
 
-class OptionUsageText {
-    #optionGroup;
-    constructor(optionGroup) {
-        this.#optionGroup = optionGroup;
+class ConfigDiagnosticText {
+    static expected(element) {
+        return `Expected ${element}.`;
     }
-    async get(optionName, optionBrand) {
-        const usageText = [];
+    static expectsListItemType(optionName, optionBrand) {
+        return `Item of the '${optionName}' list must be of type ${optionBrand}.`;
+    }
+    static expectsValue(optionName, optionGroup) {
+        optionName = ConfigDiagnosticText.#optionName(optionName, optionGroup);
+        return `Option '${optionName}' expects a value.`;
+    }
+    static fileDoesNotExist(filePath) {
+        return `The specified path '${filePath}' does not exist.`;
+    }
+    static moduleWasNotFound(specifier) {
+        return `The specified module '${specifier}' was not found.`;
+    }
+    static #optionName(optionName, optionGroup) {
+        return optionGroup === 2 ? `--${optionName}` : optionName;
+    }
+    static seen(element) {
+        return `The ${element} was seen here.`;
+    }
+    static testFileMatchCannotStartWith(segment) {
+        return [
+            `A test file match pattern cannot start with '${segment}'.`,
+            "The test files are only collected within the 'rootPath' directory.",
+        ];
+    }
+    static requiresValueType(optionName, optionBrand, optionGroup) {
+        const optionNameText = ConfigDiagnosticText.#optionName(optionName, optionGroup);
+        return `Option '${optionNameText}' requires a value of type ${optionBrand}.`;
+    }
+    static unknownOption(optionName) {
+        return `Unknown option '${optionName}'.`;
+    }
+    static async usage(optionName, optionBrand, optionGroup) {
+        const text = [];
         switch (optionName) {
             case "target": {
-                switch (this.#optionGroup) {
+                switch (optionGroup) {
                     case 2:
-                        usageText.push("Value for the '--target' option must be a single tag or a comma separated list.", "Usage examples: '--target 4.9', '--target latest', '--target 4.9,5.3.2,current'.");
+                        text.push("Value for the '--target' option must be a single tag or a comma separated list.", "Usage examples: '--target 4.9', '--target latest', '--target 4.9,5.3.2,current'.");
                         break;
                     case 4:
-                        usageText.push("Item of the 'target' list must be a supported version tag.");
+                        text.push("Item of the 'target' list must be a supported version tag.");
                         break;
                 }
                 const supportedTags = await Store.getSupportedTags();
                 if (supportedTags != null) {
-                    usageText.push(`Supported tags: ${["'", supportedTags.join("', '"), "'"].join("")}.`);
+                    text.push(`Supported tags: ${["'", supportedTags.join("', '"), "'"].join("")}.`);
                 }
                 break;
             }
             default:
-                usageText.push(ConfigDiagnosticText.requiresValueType(optionName, optionBrand, this.#optionGroup));
+                text.push(ConfigDiagnosticText.requiresValueType(optionName, optionBrand, optionGroup));
         }
-        return usageText;
-    }
-}
-
-class OptionValidator {
-    #onDiagnostics;
-    #optionGroup;
-    #optionUsageText;
-    constructor(optionGroup, onDiagnostics) {
-        this.#optionGroup = optionGroup;
-        this.#onDiagnostics = onDiagnostics;
-        this.#optionUsageText = new OptionUsageText(this.#optionGroup);
+        return text;
     }
-    async check(optionName, optionValue, optionBrand, origin) {
-        switch (optionName) {
-            case "config":
-            case "rootPath":
-                if (!existsSync(optionValue)) {
-                    this.#onDiagnostics(Diagnostic.error(ConfigDiagnosticText.fileDoesNotExist(optionValue), origin));
-                }
-                break;
-            case "reporters":
-                if (["list", "summary"].includes(optionValue)) {
-                    break;
-                }
-            case "plugins":
-                try {
-                    await import(optionValue);
-                }
-                catch {
-                    this.#onDiagnostics(Diagnostic.error(ConfigDiagnosticText.moduleWasNotFound(optionValue), origin));
-                }
-                break;
-            case "target":
-                if ((await Store.validateTag(optionValue)) === false) {
-                    this.#onDiagnostics(Diagnostic.error([
-                        ConfigDiagnosticText.versionIsNotSupported(optionValue),
-                        ...(await this.#optionUsageText.get(optionName, optionBrand)),
-                    ], origin));
-                }
-                break;
-            case "testFileMatch":
-                for (const segment of ["/", "../"]) {
-                    if (optionValue.startsWith(segment)) {
-                        this.#onDiagnostics(Diagnostic.error(ConfigDiagnosticText.testFileMatchCannotStartWith(segment), origin));
-                    }
-                }
-                break;
-            case "watch":
-                if (environmentOptions.isCi) {
-                    this.#onDiagnostics(Diagnostic.error(ConfigDiagnosticText.watchCannotBeEnabled(), origin));
-                }
-                break;
+    static versionIsNotSupported(value) {
+        if (value === "current") {
+            return "Cannot use 'current' as a target. Failed to resolve the path to the currently installed TypeScript module.";
         }
+        return `TypeScript version '${value}' is not supported.`;
+    }
+    static watchCannotBeEnabled() {
+        return "Watch mode cannot be enabled in continuous integration environment.";
     }
 }
 
@@ -1001,6 +936,12 @@ class Options {
             },
             name: "testFileMatch",
         },
+        {
+            brand: "string",
+            description: "The look up strategy to be used to find the TSConfig file.",
+            group: 2 | 4,
+            name: "tsconfig",
+        },
         {
             brand: "bareTrue",
             description: "Fetch the 'typescript' package metadata from the registry and exit.",
@@ -1029,29 +970,89 @@ class Options {
         }
         return definitionMap;
     }
+    static resolve(optionName, optionValue, rootPath = ".") {
+        switch (optionName) {
+            case "tsconfig":
+                if (["findup", "ignore"].includes(optionValue)) {
+                    break;
+                }
+            case "config":
+            case "rootPath":
+                optionValue = Path.resolve(rootPath, optionValue);
+                break;
+            case "plugins":
+            case "reporters":
+                if (optionValue.startsWith(".")) {
+                    optionValue = pathToFileURL(Path.join(Path.relative(".", rootPath), optionValue)).toString();
+                }
+                break;
+        }
+        return optionValue;
+    }
+    static async validate(optionDefinition, optionValue, optionGroup, onDiagnostics, origin) {
+        switch (optionDefinition.name) {
+            case "tsconfig":
+                if (["findup", "ignore"].includes(optionValue)) {
+                    break;
+                }
+            case "config":
+            case "rootPath":
+                if (!existsSync(optionValue)) {
+                    onDiagnostics(Diagnostic.error(ConfigDiagnosticText.fileDoesNotExist(optionValue), origin));
+                }
+                break;
+            case "reporters":
+                if (["list", "summary"].includes(optionValue)) {
+                    break;
+                }
+            case "plugins":
+                try {
+                    await import(optionValue);
+                }
+                catch {
+                    onDiagnostics(Diagnostic.error(ConfigDiagnosticText.moduleWasNotFound(optionValue), origin));
+                }
+                break;
+            case "target":
+                if ((await Store.validateTag(optionValue)) === false) {
+                    onDiagnostics(Diagnostic.error([
+                        ConfigDiagnosticText.versionIsNotSupported(optionValue),
+                        await ConfigDiagnosticText.usage(optionDefinition.name, optionDefinition.brand, optionGroup),
+                    ].flat(), origin));
+                }
+                break;
+            case "testFileMatch":
+                for (const segment of ["/", "../"]) {
+                    if (optionValue.startsWith(segment)) {
+                        onDiagnostics(Diagnostic.error(ConfigDiagnosticText.testFileMatchCannotStartWith(segment), origin));
+                    }
+                }
+                break;
+            case "watch":
+                if (environmentOptions.isCi) {
+                    onDiagnostics(Diagnostic.error(ConfigDiagnosticText.watchCannotBeEnabled(), origin));
+                }
+                break;
+        }
+    }
 }
 
 class CommandLineParser {
     #commandLineOptions;
     #onDiagnostics;
     #options;
-    #optionGroup = 2;
-    #optionUsageText;
-    #optionValidator;
     #pathMatch;
     constructor(commandLine, pathMatch, onDiagnostics) {
         this.#commandLineOptions = commandLine;
         this.#pathMatch = pathMatch;
         this.#onDiagnostics = onDiagnostics;
-        this.#options = Options.for(this.#optionGroup);
-        this.#optionUsageText = new OptionUsageText(this.#optionGroup);
-        this.#optionValidator = new OptionValidator(this.#optionGroup, this.#onDiagnostics);
+        this.#options = Options.for(2);
     }
     async #onExpectsValue(optionDefinition) {
         const text = [
-            ConfigDiagnosticText.expectsValue(optionDefinition.name, this.#optionGroup),
-            ...(await this.#optionUsageText.get(optionDefinition.name, optionDefinition.brand)),
-        ];
+            ConfigDiagnosticText.expectsValue(optionDefinition.name, 2),
+            await ConfigDiagnosticText.usage(optionDefinition.name, optionDefinition.brand, 2),
+        ].flat();
         this.#onDiagnostics(Diagnostic.error(text));
     }
     async parse(commandLineArgs) {
@@ -1082,11 +1083,11 @@ class CommandLineParser {
         let optionValue = this.#resolveOptionValue(commandLineArgs[index]);
         switch (optionDefinition.brand) {
             case "bareTrue":
-                await this.#optionValidator.check(optionDefinition.name, optionValue, optionDefinition.brand);
+                await Options.validate(optionDefinition, optionValue, 2, this.#onDiagnostics);
                 this.#commandLineOptions[optionDefinition.name] = true;
                 break;
             case "boolean":
-                await this.#optionValidator.check(optionDefinition.name, optionValue, optionDefinition.brand);
+                await Options.validate(optionDefinition, optionValue, 2, this.#onDiagnostics);
                 this.#commandLineOptions[optionDefinition.name] = optionValue !== "false";
                 if (optionValue === "false" || optionValue === "true") {
                     index++;
@@ -1094,20 +1095,13 @@ class CommandLineParser {
                 break;
             case "list":
                 if (optionValue !== "") {
-                    let optionValues = optionValue
+                    const optionValues = optionValue
                         .split(",")
                         .map((value) => value.trim())
-                        .filter((value) => value !== "");
-                    if (optionDefinition.name === "plugins" || optionDefinition.name === "reporters") {
-                        optionValues = optionValues.map((optionValue) => {
-                            if (optionValue.startsWith(".")) {
-                                return pathToFileURL(optionValue).toString();
-                            }
-                            return optionValue;
-                        });
-                    }
+                        .filter((value) => value !== "")
+                        .map((value) => Options.resolve(optionDefinition.name, value));
                     for (const optionValue of optionValues) {
-                        await this.#optionValidator.check(optionDefinition.name, optionValue, optionDefinition.brand);
+                        await Options.validate(optionDefinition, optionValue, 2, this.#onDiagnostics);
                     }
                     this.#commandLineOptions[optionDefinition.name] = optionValues;
                     index++;
@@ -1117,10 +1111,8 @@ class CommandLineParser {
                 break;
             case "string":
                 if (optionValue !== "") {
-                    if (optionDefinition.name === "config") {
-                        optionValue = Path.resolve(optionValue);
-                    }
-                    await this.#optionValidator.check(optionDefinition.name, optionValue, optionDefinition.brand);
+                    optionValue = Options.resolve(optionDefinition.name, optionValue);
+                    await Options.validate(optionDefinition, optionValue, 2, this.#onDiagnostics);
                     this.#commandLineOptions[optionDefinition.name] = optionValue;
                     index++;
                     break;
@@ -1268,21 +1260,18 @@ class ConfigFileParser {
     #jsonScanner;
     #onDiagnostics;
     #options;
-    #optionGroup = 4;
-    #optionValidator;
     #sourceFile;
     constructor(configFileOptions, sourceFile, onDiagnostics) {
         this.#configFileOptions = configFileOptions;
         this.#sourceFile = sourceFile;
         this.#onDiagnostics = onDiagnostics;
-        this.#options = Options.for(this.#optionGroup);
+        this.#options = Options.for(4);
         this.#jsonScanner = new JsonScanner(this.#sourceFile);
-        this.#optionValidator = new OptionValidator(this.#optionGroup, this.#onDiagnostics);
     }
     #onRequiresValue(optionDefinition, jsonNode, isListItem) {
         const text = isListItem
             ? ConfigDiagnosticText.expectsListItemType(optionDefinition.name, optionDefinition.brand)
-            : ConfigDiagnosticText.requiresValueType(optionDefinition.name, optionDefinition.brand, this.#optionGroup);
+            : ConfigDiagnosticText.requiresValueType(optionDefinition.name, optionDefinition.brand, 4);
         this.#onDiagnostics(Diagnostic.error(text, jsonNode.origin));
     }
     async #parseValue(optionDefinition, isListItem = false) {
@@ -1305,16 +1294,9 @@ class ConfigFileParser {
                     this.#onRequiresValue(optionDefinition, jsonNode, isListItem);
                     break;
                 }
-                if (optionDefinition.name === "plugins" || optionDefinition.name === "reporters") {
-                    if (optionValue.startsWith(".")) {
-                        const configFilePath = Path.relative(".", Path.dirname(this.#sourceFile.fileName));
-                        optionValue = pathToFileURL(Path.join(configFilePath, optionValue)).toString();
-                    }
-                }
-                if (optionDefinition.name === "rootPath") {
-                    optionValue = Path.resolve(Path.dirname(this.#sourceFile.fileName), optionValue);
-                }
-                await this.#optionValidator.check(optionDefinition.name, optionValue, optionDefinition.brand, jsonNode.origin);
+                const rootPath = Path.dirname(this.#sourceFile.fileName);
+                optionValue = Options.resolve(optionDefinition.name, optionValue, rootPath);
+                await Options.validate(optionDefinition, optionValue, 4, this.#onDiagnostics, jsonNode.origin);
                 break;
             }
             case "list": {
@@ -1420,6 +1402,7 @@ const defaultOptions = {
     rootPath: Path.resolve("./"),
     target: environmentOptions.typescriptPath != null ? ["current"] : ["latest"],
     testFileMatch: ["**/*.tst.*", "**/__typetests__/*.test.*", "**/typetests/*.test.*"],
+    tsconfig: "findup",
 };
 
 class Config {
@@ -1479,6 +1462,7 @@ var OptionGroup;
 (function (OptionGroup) {
     OptionGroup[OptionGroup["CommandLine"] = 2] = "CommandLine";
     OptionGroup[OptionGroup["ConfigFile"] = 4] = "ConfigFile";
+    OptionGroup[OptionGroup["ResolvedConfig"] = 6] = "ResolvedConfig";
 })(OptionGroup || (OptionGroup = {}));
 
 class CancellationHandler {
@@ -1596,11 +1580,11 @@ var ResultStatus;
 class TargetResult {
     results = new Map();
     status = "runs";
+    target;
     tasks;
     timing = new ResultTiming();
-    versionTag;
-    constructor(versionTag, tasks) {
-        this.versionTag = versionTag;
+    constructor(target, tasks) {
+        this.target = target;
         this.tasks = tasks;
     }
 }
@@ -1824,25 +1808,6 @@ class ResultHandler {
     }
 }
 
-class HooksService {
-    static #handlers = new Set();
-    static addHandler(hooks) {
-        HooksService.#handlers.add(hooks);
-    }
-    static async call(hook, options) {
-        for (const handler of HooksService.#handlers) {
-            const result = await handler[hook]?.(options);
-            if (result != null) {
-                options = result;
-            }
-        }
-        return options;
-    }
-    static removeHandlers() {
-        HooksService.#handlers.clear();
-    }
-}
-
 function jsx(type, props) {
     return { props, type };
 }
@@ -2224,6 +2189,25 @@ function watchUsageText() {
     return jsx(Text, { children: usageText });
 }
 
+class PluginService {
+    static #handlers = new Map();
+    static addHandler(plugin) {
+        PluginService.#handlers.set(plugin.name, plugin);
+    }
+    static async call(hook, argument, context) {
+        let result = argument;
+        for (const [, plugin] of PluginService.#handlers) {
+            if (hook in plugin) {
+                result = await plugin[hook].call(context, result);
+            }
+        }
+        return result;
+    }
+    static removeHandlers() {
+        PluginService.#handlers.clear();
+    }
+}
+
 class BaseReporter {
     resolvedConfig;
     constructor(resolvedConfig) {
@@ -2460,7 +2444,7 @@ class Task {
     filePath;
     position;
     constructor(filePath, position) {
-        this.filePath = Path.normalizeSlashes(this.#toPath(filePath));
+        this.filePath = Path.resolve(this.#toPath(filePath));
         this.position = position;
     }
     #toPath(filePath) {
@@ -3087,8 +3071,10 @@ var TestMemberFlags;
 
 class ProjectService {
     #compiler;
+    #resolvedConfig;
     #service;
-    constructor(compiler) {
+    constructor(resolvedConfig, compiler) {
+        this.#resolvedConfig = resolvedConfig;
         this.#compiler = compiler;
         const noop = () => undefined;
         const noopLogger = {
@@ -3123,6 +3109,15 @@ class ProjectService {
             useInferredProjectPerProjectRoot: true,
             useSingleInferredProject: false,
         });
+        switch (this.#resolvedConfig.tsconfig) {
+            case "findup":
+                break;
+            case "ignore":
+                this.#service.getConfigFileNameForFile = () => undefined;
+                break;
+            default:
+                this.#service.getConfigFileNameForFile = () => this.#resolvedConfig.tsconfig;
+        }
         this.#service.setCompilerOptionsForInferredProjects(this.#getDefaultCompilerOptions());
     }
     closeFile(filePath) {
@@ -3757,7 +3752,7 @@ class ToRaiseError {
         if (this.#compiler.isStringLiteralLike(targetNode)) {
             return this.#compiler.flattenDiagnosticMessageText(diagnostic.messageText, " ", 0).includes(targetNode.text);
         }
-        return Number.parseInt(targetNode.text) === diagnostic.code;
+        return Number.parseInt(targetNode.text, 10) === diagnostic.code;
     }
 }
 
@@ -4038,7 +4033,7 @@ class TaskRunner {
         this.#resolvedConfig = resolvedConfig;
         this.#compiler = compiler;
         this.#collectService = new CollectService(compiler);
-        this.#projectService = new ProjectService(compiler);
+        this.#projectService = new ProjectService(this.#resolvedConfig, compiler);
     }
     run(task, cancellationToken) {
         if (cancellationToken?.isCancellationRequested === true) {
@@ -4052,6 +4047,13 @@ class TaskRunner {
         this.#projectService.closeFile(task.filePath);
     }
     #run(task, taskResult, cancellationToken) {
+        if (!existsSync(task.filePath)) {
+            EventEmitter.dispatch([
+                "task:error",
+                { diagnostics: [Diagnostic.error(`Test file '${task.filePath}' does not exist.`)], result: taskResult },
+            ]);
+            return;
+        }
         const languageService = this.#projectService.getLanguageService(task.filePath);
         if (!languageService) {
             return;
@@ -4095,7 +4097,7 @@ class TaskRunner {
 class Runner {
     #eventEmitter = new EventEmitter();
     #resolvedConfig;
-    static version = "3.0.0-beta.4";
+    static version = "3.0.0-beta.6";
     constructor(resolvedConfig) {
         this.#resolvedConfig = resolvedConfig;
     }
@@ -4143,10 +4145,10 @@ class Runner {
     async #run(tasks, cancellationToken) {
         const result = new Result(this.#resolvedConfig, tasks);
         EventEmitter.dispatch(["run:start", { result }]);
-        for (const versionTag of this.#resolvedConfig.target) {
-            const targetResult = new TargetResult(versionTag, tasks);
+        for (const target of this.#resolvedConfig.target) {
+            const targetResult = new TargetResult(target, tasks);
             EventEmitter.dispatch(["target:start", { result: targetResult }]);
-            const compiler = await Store.load(versionTag);
+            const compiler = await Store.load(target);
             if (compiler) {
                 const taskRunner = new TaskRunner(this.#resolvedConfig, compiler);
                 for (const task of tasks) {
@@ -4219,11 +4221,11 @@ class Cli {
                 }
                 continue;
             }
-            for (const plugin of resolvedConfig.plugins) {
-                const hooks = (await import(plugin)).default;
-                HooksService.addHandler(hooks);
+            for (const pluginIdentifier of resolvedConfig.plugins) {
+                const plugin = (await import(pluginIdentifier)).default;
+                PluginService.addHandler(plugin);
             }
-            resolvedConfig = await HooksService.call("config", resolvedConfig);
+            resolvedConfig = await PluginService.call("config", resolvedConfig, {});
             if (commandLine.includes("--showConfig")) {
                 OutputService.writeMessage(formattedText({ ...resolvedConfig, ...environmentOptions }));
                 continue;
@@ -4244,7 +4246,7 @@ class Cli {
                     continue;
                 }
             }
-            testFiles = await HooksService.call("select", testFiles);
+            testFiles = await PluginService.call("select", testFiles, { resolvedConfig });
             if (commandLine.includes("--listFiles")) {
                 OutputService.writeMessage(formattedText(testFiles.map((testFile) => testFile.toString())));
                 continue;
@@ -4253,7 +4255,7 @@ class Cli {
             this.#eventEmitter.removeReporter(setupReporter);
             const runner = new Runner(resolvedConfig);
             await runner.run(testFiles, cancellationToken);
-            HooksService.removeHandlers();
+            PluginService.removeHandlers();
         } while (cancellationToken.reason === "configChange");
         this.#eventEmitter.removeHandlers();
     }
@@ -4285,4 +4287,4 @@ class Cli {
     }
 }
 
-export { Assertion, BaseReporter, CancellationHandler, CancellationReason, CancellationToken, Cli, CollectService, Color, Config, ConfigDiagnosticText, DescribeResult, Diagnostic, DiagnosticCategory, DiagnosticOrigin, EventEmitter, ExitCodeHandler, ExpectResult, ExpectService, FileWatcher, HooksService, InputService, Line, ListReporter, OptionBrand, OptionGroup, Options, OutputService, Path, ProjectResult, ProjectService, Result, ResultCount, ResultHandler, ResultStatus, ResultTiming, Runner, Scribbler, Select, SelectDiagnosticText, SetupReporter, SourceFile, Store, SummaryReporter, TargetResult, Task, TaskResult, TestMember, TestMemberBrand, TestMemberFlags, TestResult, TestTree, Text, Version, WatchReporter, WatchService, Watcher, addsPackageText, defaultOptions, describeNameText, diagnosticText, environmentOptions, fileViewText, formattedText, helpText, summaryText, taskStatusText, testNameText, usesCompilerText, waitingForFileChangesText, watchUsageText };
+export { Assertion, BaseReporter, CancellationHandler, CancellationReason, CancellationToken, Cli, CollectService, Color, Config, ConfigDiagnosticText, DescribeResult, Diagnostic, DiagnosticCategory, DiagnosticOrigin, EventEmitter, ExitCodeHandler, ExpectResult, ExpectService, FileWatcher, InputService, Line, ListReporter, OptionBrand, OptionGroup, Options, OutputService, Path, PluginService, ProjectResult, ProjectService, Result, ResultCount, ResultHandler, ResultStatus, ResultTiming, Runner, Scribbler, Select, SelectDiagnosticText, SetupReporter, SourceFile, Store, SummaryReporter, TargetResult, Task, TaskResult, TestMember, TestMemberBrand, TestMemberFlags, TestResult, TestTree, Text, Version, WatchReporter, WatchService, Watcher, addsPackageText, defaultOptions, describeNameText, diagnosticText, environmentOptions, fileViewText, formattedText, helpText, summaryText, taskStatusText, testNameText, usesCompilerText, waitingForFileChangesText, watchUsageText };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tstyche",
-  "version": "3.0.0-beta.4",
+  "version": "3.0.0-beta.6",
   "description": "The Essential Type Testing Tool.",
   "keywords": [
     "typescript",
@@ -61,16 +61,16 @@
     "test:unit": "yarn test:run **/__tests__/*.test.js --parallel"
   },
   "devDependencies": {
-    "@biomejs/biome": "1.9.3",
+    "@biomejs/biome": "1.9.4",
     "@rollup/plugin-typescript": "12.1.1",
-    "@types/node": "20.16.11",
-    "@types/react": "18.3.11",
+    "@types/node": "20.17.1",
+    "@types/react": "18.3.12",
     "ajv": "8.17.1",
-    "cspell": "8.15.3",
+    "cspell": "8.15.4",
     "magic-string": "0.30.12",
     "monocart-coverage-reports": "2.11.1",
     "pretty-ansi": "2.0.0",
-    "rollup": "4.24.0",
+    "rollup": "4.24.2",
     "rollup-plugin-dts": "6.1.1",
     "tslib": "2.8.0",
     "typescript": "5.6.3"
@@ -83,7 +83,7 @@
       "optional": true
     }
   },
-  "packageManager": "yarn@4.5.0",
+  "packageManager": "yarn@4.5.1",
   "engines": {
     "node": ">=18.17"
   }