tstyche 6.0.3 → 6.2.0

package/dist/tag.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Runs TSTyche in the same process, streaming error messages and test results to the `stderr` and `stdout` in real-time.
+ *
+ * @returns A promise that resolves if the test run is successful and rejects if it fails.
+ */
+declare function tstyche(template: TemplateStringsArray, ...substitutions: Array<string>): Promise<void>;
+
+export { tstyche as default };

package/dist/tag.js

@@ -0,0 +1,36 @@
+import { Cli, EventEmitter, CancellationToken } from './tstyche.js';
+
+class StatusHandler {
+    #hasError = false;
+    hasError() {
+        return this.#hasError;
+    }
+    on([event, payload]) {
+        if (event === "run:start") {
+            this.#hasError = false;
+            return;
+        }
+        if ("diagnostics" in payload) {
+            if (payload.diagnostics.some((diagnostic) => diagnostic.category === "error")) {
+                this.#hasError = true;
+            }
+        }
+    }
+}
+async function tstyche(template, ...substitutions) {
+    const cli = new Cli({ noErrorExitCode: true });
+    const commandLine = String.raw(template, ...substitutions).split(/\s+/);
+    const eventEmitter = new EventEmitter();
+    const statusHandler = new StatusHandler();
+    eventEmitter.addHandler(statusHandler);
+    await cli.run(commandLine, new CancellationToken());
+    eventEmitter.removeHandler(statusHandler);
+    return new Promise((resolve, reject) => {
+        if (statusHandler.hasError()) {
+            reject(new Error("TSTyche test run failed. Check the output above for details."));
+        }
+        resolve();
+    });
+}
+
+export { tstyche as default };

package/dist/tstyche.d.ts

@@ -1,4 +1,5 @@
 import type ts from 'typescript';
+import type { WriteStream } from 'node:tty';
 
 declare enum CancellationReason {
     ConfigChange = "configChange",
@@ -15,9 +16,13 @@ declare class CancellationToken {
     reset(): void;
 }
 
+interface CliOptions {
+    noErrorExitCode?: boolean;
+}
 declare class Cli {
     #private;
-    run(commandLine: Array<string>, cancellationToken?: CancellationToken): Promise<void>;
+    constructor(options?: CliOptions);
+    run(commandLine: ReadonlyArray<string>, cancellationToken?: CancellationToken): Promise<void>;
 }
 
 declare enum DiagnosticCategory {
@@ -143,12 +148,15 @@ interface CommandLineOptions {
     listFiles?: boolean;
     only?: string;
     prune?: boolean;
+    quiet?: boolean;
     reporters?: Array<string>;
+    root?: string;
     showConfig?: boolean;
     skip?: string;
     target?: Array<string>;
     tsconfig?: string;
     update?: boolean;
+    verbose?: boolean;
     version?: boolean;
     watch?: boolean;
 }
@@ -157,6 +165,7 @@ interface ConfigFileOptions {
     checkSuppressedErrors?: boolean;
     failFast?: boolean;
     fixtureFileMatch?: Array<string>;
+    quiet?: boolean;
     rejectAnyType?: boolean;
     rejectNeverType?: boolean;
     reporters?: Array<string>;
@@ -164,6 +173,7 @@ interface ConfigFileOptions {
     target?: Array<string>;
     testFileMatch?: Array<string>;
     tsconfig?: string;
+    verbose?: boolean;
 }
 
 interface InlineConfig {
@@ -191,11 +201,11 @@ interface DirectiveRange {
 
 declare class Config {
     #private;
-    static parseCommandLine(commandLine: Array<string>): Promise<{
+    static parseCommandLine(commandLine: ReadonlyArray<string>): Promise<{
         commandLineOptions: CommandLineOptions;
         pathMatch: Array<string>;
     }>;
-    static parseConfigFile(filePath?: string): Promise<{
+    static parseConfigFile(configPath?: string, rootPath?: string): Promise<{
         configFileOptions: ConfigFileOptions;
         configFilePath: string;
     }>;
@@ -205,7 +215,7 @@ declare class Config {
         commandLineOptions?: Omit<CommandLineOptions, "config">;
         pathMatch?: Array<string>;
     }): ResolvedConfig;
-    static resolveConfigFilePath(filePath?: string): string;
+    static resolveConfigFilePath(configPath?: string, rootPath?: string): string;
 }
 
 declare enum OptionBrand {
@@ -300,6 +310,11 @@ declare abstract class BaseReporter implements Reporter {
     abstract on([event, payload]: ReporterEvent): void;
 }
 
+declare class DotReporter extends BaseReporter {
+    #private;
+    on([event, payload]: ReporterEvent): void;
+}
+
 declare class ListReporter extends BaseReporter {
     #private;
     on([event, payload]: ReporterEvent): void;
@@ -584,7 +599,9 @@ interface TextProps {
 }
 declare function Text({ children, color, indent }: TextProps): ScribblerJsx.Element;
 
-declare function addsPackageText(packageVersion: string, packagePath: string): ScribblerJsx.Element;
+declare function addsPackageText(packageVersion: string, packagePath: string, options?: {
+    short?: boolean;
+}): ScribblerJsx.Element;
 
 declare function describeNameText(name: string, indent?: number): ScribblerJsx.Element;
 
@@ -596,18 +613,29 @@ interface CodeFrameOptions {
 
 declare function diagnosticText(diagnostic: Diagnostic, codeFrameOptions?: CodeFrameOptions): ScribblerJsx.Element;
 
-declare function fileStatusText(status: FileResultStatus, file: FileLocation): ScribblerJsx.Element;
+declare function dotText(status: ResultStatus): ScribblerJsx.Element;
 
-declare function fileViewText(lines: Array<ScribblerJsx.Element>, addEmptyFinalLine: boolean): ScribblerJsx.Element;
+declare function fileStatusText(status: FileResultStatus, file: FileLocation): ScribblerJsx.Element;
 
 declare function formattedText(input: string | Array<string> | Record<string, unknown>): ScribblerJsx.Element;
 
 declare function helpText(options: Map<string, OptionDefinition>, version: string): ScribblerJsx.Element;
 
+declare class StreamController {
+    #private;
+    constructor(stream: WriteStream);
+    disable(): void;
+    enable(): void;
+    write(text: string): void;
+}
+
 declare class OutputService {
     #private;
+    static errorStream: StreamController;
+    static outputStream: StreamController;
     static clearTerminal(): void;
     static eraseLastLine(): void;
+    static writeBlankLine(count?: number): void;
     static writeError(element: ScribblerJsx.Element | Array<ScribblerJsx.Element>): void;
     static writeMessage(element: ScribblerJsx.Element | Array<ScribblerJsx.Element>): void;
     static writeWarning(element: ScribblerJsx.Element | Array<ScribblerJsx.Element>): void;
@@ -628,7 +656,8 @@ declare function summaryText({ targetCounts, fileCounts, testCounts, assertionCo
 declare function testNameText(status: Exclude<TestResultStatus, ResultStatus.Runs>, name: string, indent?: number): ScribblerJsx.Element;
 
 declare function usesCompilerText(compilerVersion: string, projectConfigFilePath: string | undefined, options?: {
-    prependEmptyLine: boolean;
+    prependEmptyLine?: boolean;
+    short?: boolean;
 }): ScribblerJsx.Element;
 
 declare function waitingForFileChangesText(): ScribblerJsx.Element;
@@ -714,5 +743,5 @@ declare class Version {
     static isSatisfiedWith(source: string, target: string): boolean;
 }
 
-export { BaseReporter, CancellationReason, CancellationToken, Cli, Color, Config, ConfigDiagnosticText, DescribeResult, Diagnostic, DiagnosticCategory, DiagnosticOrigin, Directive, EventEmitter, ExpectResult, FileLocation, FileResult, Line, ListReporter, OptionBrand, OptionGroup, Options, OutputService, Path, ProjectResult, Result, ResultStatus, Runner, Scribbler, ScribblerJsx, Select, SelectDiagnosticText, SetupReporter, Store, SummaryReporter, SuppressedResult, TargetResult, TestResult, Text, Version, WatchReporter, addsPackageText, defaultOptions, describeNameText, diagnosticBelongsToNode, diagnosticText, environmentOptions, fileStatusText, fileViewText, formattedText, getDiagnosticMessageText, getTextSpanEnd, helpText, isDiagnosticWithLocation, prologueText, summaryText, testNameText, usesCompilerText, waitingForFileChangesText, watchUsageText };
+export { BaseReporter, CancellationReason, CancellationToken, Cli, Color, Config, ConfigDiagnosticText, DescribeResult, Diagnostic, DiagnosticCategory, DiagnosticOrigin, Directive, DotReporter, EventEmitter, ExpectResult, FileLocation, FileResult, Line, ListReporter, OptionBrand, OptionGroup, Options, OutputService, Path, ProjectResult, Result, ResultStatus, Runner, Scribbler, ScribblerJsx, Select, SelectDiagnosticText, SetupReporter, Store, StreamController, SummaryReporter, SuppressedResult, TargetResult, TestResult, Text, Version, WatchReporter, addsPackageText, defaultOptions, describeNameText, diagnosticBelongsToNode, diagnosticText, dotText, environmentOptions, fileStatusText, formattedText, getDiagnosticMessageText, getTextSpanEnd, helpText, isDiagnosticWithLocation, prologueText, summaryText, testNameText, usesCompilerText, waitingForFileChangesText, watchUsageText };
 export type { AssertionCounts, AssertionResultStatus, CodeFrameOptions, CommandLineOptions, ConfigFileOptions, DiagnosticsHandler, DirectiveRange, EnvironmentOptions, Event, EventHandler, FileCounts, FileResultStatus, InlineConfig, ItemDefinition, OptionDefinition, Reporter, ReporterEvent, ResolvedConfig, ResultCounts, ResultTiming, ScribblerOptions, SuppressedCounts, SuppressedResultStatus, TargetCounts, TargetResultStatus, TestCounts, TestResultStatus, TextRange };

package/dist/tstyche.js

@@ -375,7 +375,7 @@ class ConfigDiagnosticText {
     static fileMatchPatternCannotStartWith(optionName, segment) {
         return [
             `A '${optionName}' pattern cannot start with '${segment}'.`,
-            "The files are only collected within the 'rootPath' directory.",
+            "The files are only collected within the root directory.",
         ];
     }
     static inspectSupportedVersions() {
@@ -1099,6 +1099,12 @@ class Options {
             group: 2,
             name: "prune",
         },
+        {
+            brand: "boolean",
+            description: "Silence all test runner output except errors and warnings.",
+            group: 2 | 4,
+            name: "quiet",
+        },
         {
             brand: "boolean",
             description: "Reject the 'any' type passed as an argument to the 'expect()' function or a matcher.",
@@ -1121,6 +1127,12 @@ class Options {
             },
             name: "reporters",
         },
+        {
+            brand: "string",
+            description: "The path to a directory containing files of a test project.",
+            group: 2,
+            name: "root",
+        },
         {
             brand: "string",
             description: "The path to a directory containing files of a test project.",
@@ -1167,6 +1179,12 @@ class Options {
             group: 2,
             name: "update",
         },
+        {
+            brand: "boolean",
+            description: "Enable detailed logging.",
+            group: 2 | 4,
+            name: "verbose",
+        },
         {
             brand: "true",
             description: "Print the version number and exit.",
@@ -1193,7 +1211,7 @@ class Options {
         return optionName.startsWith("--") ? optionName.slice(2) : optionName;
     }
     static #isBuiltinReporter(optionValue) {
-        return ["list", "summary"].includes(optionValue);
+        return ["dot", "list", "summary"].includes(optionValue);
     }
     static #isLookupStrategy(optionValue) {
         return ["findup", "ignore"].includes(optionValue);
@@ -1202,11 +1220,15 @@ class Options {
         const canonicalOptionName = Options.#getCanonicalOptionName(optionName);
         switch (canonicalOptionName) {
             case "config":
+            case "root":
             case "rootPath":
             case "tsconfig":
                 if (canonicalOptionName === "tsconfig" && Options.#isLookupStrategy(optionValue)) {
                     break;
                 }
+                if (optionValue.startsWith("file:")) {
+                    optionValue = fileURLToPath(optionValue);
+                }
                 optionValue = Path.resolve(rootPath, optionValue);
                 break;
             case "reporters":
@@ -1231,6 +1253,7 @@ class Options {
         const canonicalOptionName = Options.#getCanonicalOptionName(optionName);
         switch (canonicalOptionName) {
             case "config":
+            case "root":
             case "rootPath":
             case "tsconfig":
                 if (canonicalOptionName === "tsconfig" && Options.#isLookupStrategy(optionValue)) {
@@ -1553,6 +1576,7 @@ const defaultOptions = {
     checkSuppressedErrors: true,
     failFast: false,
     fixtureFileMatch: ["**/__fixtures__/*.{ts,tsx}", "**/fixtures/*.{ts,tsx}"],
+    quiet: false,
     rejectAnyType: true,
     rejectNeverType: true,
     reporters: ["list", "summary"],
@@ -1560,6 +1584,7 @@ const defaultOptions = {
     target: ["*"],
     testFileMatch: ["**/*.tst.*", "**/__typetests__/*.test.*", "**/typetests/*.test.*"],
     tsconfig: "findup",
+    verbose: false,
 };
 
 class Config {
@@ -1573,10 +1598,10 @@ class Config {
         await commandLineParser.parse(commandLine);
         return { commandLineOptions, pathMatch };
     }
-    static async parseConfigFile(filePath) {
-        const configFilePath = Config.resolveConfigFilePath(filePath);
+    static async parseConfigFile(configPath, rootPath) {
+        const configFilePath = Config.resolveConfigFilePath(configPath, rootPath);
         const configFileOptions = {
-            rootPath: Path.dirname(configFilePath),
+            rootPath: rootPath ?? Path.dirname(configFilePath),
         };
         if (existsSync(configFilePath)) {
             const configFileText = await fs.readFile(configFilePath, {
@@ -1599,10 +1624,16 @@ class Config {
         if ("config" in resolvedConfig) {
             delete resolvedConfig.config;
         }
+        if ("root" in resolvedConfig) {
+            delete resolvedConfig.root;
+        }
         return resolvedConfig;
     }
-    static resolveConfigFilePath(filePath) {
-        return filePath != null ? Path.resolve(filePath) : Path.resolve("./tstyche.config.json");
+    static resolveConfigFilePath(configPath, rootPath = ".") {
+        if (configPath != null) {
+            return Path.resolve(configPath);
+        }
+        return Path.resolve(rootPath, "./tstyche.config.json");
     }
 }
 
@@ -2198,7 +2229,10 @@ class Scribbler {
     }
 }
 
-function addsPackageText(packageVersion, packagePath) {
+function addsPackageText(packageVersion, packagePath, options) {
+    if (options?.short) {
+        return (jsx(Line, { children: jsx(Text, { color: "90", children: packageVersion }) }));
+    }
     return (jsx(Line, { children: [jsx(Text, { color: "90", children: "adds" }), " TypeScript ", packageVersion, jsx(Text, { color: "90", children: [" to ", packagePath] })] }));
 }
 
@@ -2295,6 +2329,16 @@ function diagnosticText(diagnostic, codeFrameOptions = {}) {
     return (jsx(Text, { children: [prefix, jsx(DiagnosticText, { codeFrameOptions: codeFrameOptions, diagnostic: diagnostic })] }));
 }
 
+function dotText(status) {
+    let statusColor;
+    let statusText = "·";
+    if (status === "failed") {
+        statusColor = "31";
+        statusText = "×";
+    }
+    return jsx(Text, { color: statusColor, children: statusText });
+}
+
 function getStatusColor(status) {
     switch (status) {
         case "runs":
@@ -2342,10 +2386,6 @@ function fileStatusText(status, file) {
     return (jsx(Line, { children: [jsx(Text, { color: getStatusColor(status), children: statusText }), " ", jsx(FileNameText, { filePath: file.path })] }));
 }
 
-function fileViewText(lines, addEmptyFinalLine) {
-    return (jsx(Text, { children: [[...lines], addEmptyFinalLine ? jsx(Line, {}) : undefined] }));
-}
-
 function formattedText(input) {
     if (typeof input === "string") {
         return jsx(Line, { children: input });
@@ -2415,35 +2455,56 @@ function helpText(options, version) {
     return (jsx(Text, { children: [jsx(HelpHeaderText, { tstycheVersion: version }), jsx(Line, {}), jsx(CommandLineUsageText, {}), jsx(Line, {}), jsx(CommandLineOptionsText, { optionDefinitions: options }), jsx(Line, {}), jsx(HelpFooterText, {}), jsx(Line, {})] }));
 }
 
+class StreamController {
+    #isEnabled = true;
+    #stream;
+    constructor(stream) {
+        this.#stream = stream;
+    }
+    disable() {
+        this.#isEnabled = false;
+    }
+    enable() {
+        this.#isEnabled = true;
+    }
+    write(text) {
+        this.#isEnabled && this.#stream.write(text);
+    }
+}
+
 class OutputService {
+    static errorStream = new StreamController(process.stderr);
+    static outputStream = new StreamController(process.stdout);
     static #isClear = false;
-    static #scribbler = new Scribbler();
-    static #stderr = process.stderr;
-    static #stdout = process.stdout;
+    static #newLine = "\n";
+    static #scribbler = new Scribbler({ newLine: OutputService.#newLine });
     static clearTerminal() {
         if (!OutputService.#isClear) {
-            OutputService.#stdout.write("\u001B[2J\u001B[3J\u001B[H");
+            OutputService.outputStream.write("\u001B[2J\u001B[3J\u001B[H");
             OutputService.#isClear = true;
         }
     }
     static eraseLastLine() {
-        OutputService.#stdout.write("\u001B[1A\u001B[0K");
+        OutputService.outputStream.write("\u001B[1A\u001B[0K");
     }
-    static #writeTo(stream, element) {
+    static #write(stream, element) {
         const elements = Array.isArray(element) ? element : [element];
         for (const element of elements) {
             stream.write(OutputService.#scribbler.render(element));
         }
         OutputService.#isClear = false;
     }
+    static writeBlankLine(count = 1) {
+        OutputService.outputStream.write(OutputService.#newLine.repeat(count));
+    }
     static writeError(element) {
-        OutputService.#writeTo(OutputService.#stderr, element);
+        OutputService.#write(OutputService.errorStream, element);
     }
     static writeMessage(element) {
-        OutputService.#writeTo(OutputService.#stdout, element);
+        OutputService.#write(OutputService.outputStream, element);
     }
     static writeWarning(element) {
-        OutputService.#writeTo(OutputService.#stderr, element);
+        OutputService.#write(OutputService.errorStream, element);
     }
 }
 
@@ -2503,6 +2564,9 @@ function testNameText(status, name, indent = 0) {
 }
 
 function usesCompilerText(compilerVersion, projectConfigFilePath, options) {
+    if (options?.short) {
+        return jsx(Text, { color: "34", children: compilerVersion });
+    }
     let projectConfigPathText;
     if (projectConfigFilePath != null) {
         projectConfigPathText = (jsx(Text, { color: "90", children: [" with ", Path.relative("", projectConfigFilePath)] }));
@@ -2532,6 +2596,55 @@ class BaseReporter {
     }
 }
 
+class DotReporter extends BaseReporter {
+    #diagnostics = [];
+    #hasReportedAdds = false;
+    on([event, payload]) {
+        switch (event) {
+            case "store:adds":
+                OutputService.writeMessage(addsPackageText(payload.packageVersion, payload.packagePath, { short: true }));
+                this.#hasReportedAdds = true;
+                break;
+            case "store:error":
+                for (const diagnostic of payload.diagnostics) {
+                    OutputService.writeError(diagnosticText(diagnostic));
+                }
+                break;
+            case "project:uses":
+                if (this.#hasReportedAdds) {
+                    if (!environmentOptions.noInteractive) {
+                        OutputService.eraseLastLine();
+                    }
+                    this.#hasReportedAdds = false;
+                }
+                if (this.resolvedConfig.target.length > 1) {
+                    OutputService.writeMessage(usesCompilerText(payload.compilerVersion, payload.projectConfigFilePath, { short: true }));
+                }
+                break;
+            case "target:end":
+                OutputService.writeBlankLine(2);
+                for (const diagnostic of this.#diagnostics) {
+                    OutputService.writeError(diagnosticText(diagnostic));
+                }
+                this.#diagnostics = [];
+                break;
+            case "file:end":
+                OutputService.writeMessage(dotText(payload.result.status));
+                break;
+            case "project:error":
+            case "file:error":
+            case "directive:error":
+            case "collect:error":
+            case "test:error":
+            case "suppressed:error":
+            case "expect:error":
+            case "expect:fail":
+                this.#diagnostics.push(...payload.diagnostics);
+                break;
+        }
+    }
+}
+
 class FileView {
     #indent = 0;
     #lines = [];
@@ -2557,8 +2670,8 @@ class FileView {
     getMessages() {
         return this.#messages;
     }
-    getViewText(options) {
-        return fileViewText(this.#lines, options?.appendEmptyLine || this.hasErrors());
+    getView() {
+        return this.#lines;
     }
     hasErrors() {
         return this.#messages.length > 0;
@@ -2571,14 +2684,12 @@ class ListReporter extends BaseReporter {
     #hasReportedAdds = false;
     #hasReportedError = false;
     #hasReportedUses = false;
-    #isFileViewExpanded = false;
-    #isLastFile() {
-        return this.#fileCount === 0;
-    }
+    #isVerbose = false;
     on([event, payload]) {
         switch (event) {
             case "run:start":
-                this.#isFileViewExpanded = payload.result.files.length === 1 && this.resolvedConfig.watch !== true;
+                this.#isVerbose =
+                    this.resolvedConfig.verbose || (payload.result.files.length === 1 && this.resolvedConfig.watch !== true);
                 break;
             case "store:adds":
                 OutputService.writeMessage(addsPackageText(payload.packageVersion, payload.packagePath));
@@ -2625,7 +2736,10 @@ class ListReporter extends BaseReporter {
                     OutputService.eraseLastLine();
                 }
                 OutputService.writeMessage(fileStatusText(payload.result.status, payload.result.file));
-                OutputService.writeMessage(this.#fileView.getViewText({ appendEmptyLine: this.#isLastFile() }));
+                OutputService.writeMessage(this.#fileView.getView());
+                if (this.#isVerbose || this.#fileCount === 0 || this.#fileView.hasErrors()) {
+                    OutputService.writeBlankLine();
+                }
                 if (this.#fileView.hasErrors()) {
                     OutputService.writeError(this.#fileView.getMessages());
                     this.#hasReportedError = true;
@@ -2633,32 +2747,32 @@ class ListReporter extends BaseReporter {
                 this.#fileView.clear();
                 break;
             case "describe:start":
-                if (this.#isFileViewExpanded) {
+                if (this.#isVerbose) {
                     this.#fileView.beginDescribe(payload.result.describe.name);
                 }
                 break;
             case "describe:end":
-                if (this.#isFileViewExpanded) {
+                if (this.#isVerbose) {
                     this.#fileView.endDescribe();
                 }
                 break;
             case "test:skip":
-                if (this.#isFileViewExpanded) {
+                if (this.#isVerbose) {
                     this.#fileView.addTest("skipped", payload.result.test.name);
                 }
                 break;
             case "test:fixme":
-                if (this.#isFileViewExpanded) {
+                if (this.#isVerbose) {
                     this.#fileView.addTest("fixme", payload.result.test.name);
                 }
                 break;
             case "test:todo":
-                if (this.#isFileViewExpanded) {
+                if (this.#isVerbose) {
                     this.#fileView.addTest("todo", payload.result.test.name);
                 }
                 break;
             case "test:error":
-                if (this.#isFileViewExpanded) {
+                if (this.#isVerbose) {
                     this.#fileView.addTest("failed", payload.result.test.name);
                 }
                 for (const diagnostic of payload.diagnostics) {
@@ -2666,12 +2780,12 @@ class ListReporter extends BaseReporter {
                 }
                 break;
             case "test:fail":
-                if (this.#isFileViewExpanded) {
+                if (this.#isVerbose) {
                     this.#fileView.addTest("failed", payload.result.test.name);
                 }
                 break;
             case "test:pass":
-                if (this.#isFileViewExpanded) {
+                if (this.#isVerbose) {
                     this.#fileView.addTest("passed", payload.result.test.name);
                 }
                 break;
@@ -2954,7 +3068,7 @@ class Glob {
 class SelectDiagnosticText {
     static #pathSelectOptions(resolvedConfig) {
         const text = [
-            `Root path:       ${resolvedConfig.rootPath}`,
+            `Root directory:  ${resolvedConfig.rootPath}`,
             `Test file match: ${resolvedConfig.testFileMatch.join(", ")}`,
         ];
         if (resolvedConfig.pathMatch.length > 0) {
@@ -5914,7 +6028,7 @@ class FileRunner {
 class Runner {
     #eventEmitter = new EventEmitter();
     #resolvedConfig;
-    static version = "6.0.3";
+    static version = "6.2.0";
     constructor(resolvedConfig) {
         this.#resolvedConfig = resolvedConfig;
     }
@@ -5933,14 +6047,16 @@ class Runner {
         }
         for (const reporter of this.#resolvedConfig.reporters) {
             switch (reporter) {
+                case "dot": {
+                    this.#eventEmitter.addReporter(new DotReporter(this.#resolvedConfig));
+                    break;
+                }
                 case "list": {
-                    const listReporter = new ListReporter(this.#resolvedConfig);
-                    this.#eventEmitter.addReporter(listReporter);
+                    this.#eventEmitter.addReporter(new ListReporter(this.#resolvedConfig));
                     break;
                 }
                 case "summary": {
-                    const summaryReporter = new SummaryReporter(this.#resolvedConfig);
-                    this.#eventEmitter.addReporter(summaryReporter);
+                    this.#eventEmitter.addReporter(new SummaryReporter(this.#resolvedConfig));
                     break;
                 }
                 default: {
@@ -5952,6 +6068,9 @@ class Runner {
         }
     }
     async run(files, cancellationToken = new CancellationToken()) {
+        if (this.#resolvedConfig.quiet) {
+            OutputService.outputStream.disable();
+        }
         if (!this.#resolvedConfig.watch) {
             OutputService.writeMessage(prologueText(Runner.version, this.#resolvedConfig.rootPath));
         }
@@ -5964,6 +6083,9 @@ class Runner {
         }
         this.#eventEmitter.removeReporters();
         this.#eventEmitter.removeHandlers();
+        if (this.#resolvedConfig.quiet) {
+            OutputService.outputStream.enable();
+        }
     }
     async #run(files, cancellationToken) {
         const result = new Result(files);
@@ -5995,11 +6117,15 @@ class Runner {
 
 class Cli {
     #eventEmitter = new EventEmitter();
+    #noErrorExitCode;
+    constructor(options) {
+        this.#noErrorExitCode = options?.noErrorExitCode ?? false;
+    }
     async run(commandLine, cancellationToken = new CancellationToken()) {
         const cancellationHandler = new CancellationHandler(cancellationToken, "configError");
         this.#eventEmitter.addHandler(cancellationHandler);
         const exitCodeHandler = new ExitCodeHandler();
-        this.#eventEmitter.addHandler(exitCodeHandler);
+        !this.#noErrorExitCode && this.#eventEmitter.addHandler(exitCodeHandler);
         const setupReporter = new SetupReporter();
         this.#eventEmitter.addReporter(setupReporter);
         if (commandLine.includes("--help")) {
@@ -6038,7 +6164,7 @@ class Cli {
                 this.#eventEmitter.addHandler(cancellationHandler);
                 this.#eventEmitter.addReporter(setupReporter);
             }
-            const { configFileOptions, configFilePath } = await Config.parseConfigFile(commandLineOptions.config);
+            const { configFileOptions, configFilePath } = await Config.parseConfigFile(commandLineOptions.config, commandLineOptions.root);
             const resolvedConfig = Config.resolve({
                 configFileOptions,
                 configFilePath,
@@ -6110,4 +6236,4 @@ class Cli {
     }
 }
 
-export { BaseReporter, CancellationReason, CancellationToken, Cli, Color, Config, ConfigDiagnosticText, DescribeResult, Diagnostic, DiagnosticCategory, DiagnosticOrigin, Directive, EventEmitter, ExpectResult, FileLocation, FileResult, Line, ListReporter, OptionBrand, OptionGroup, Options, OutputService, Path, ProjectResult, Result, ResultStatus, Runner, Scribbler, Select, SelectDiagnosticText, SetupReporter, Store, SummaryReporter, SuppressedResult, TargetResult, TestResult, Text, Version, WatchReporter, addsPackageText, defaultOptions, describeNameText, diagnosticBelongsToNode, diagnosticText, environmentOptions, fileStatusText, fileViewText, formattedText, getDiagnosticMessageText, getTextSpanEnd, helpText, isDiagnosticWithLocation, prologueText, summaryText, testNameText, usesCompilerText, waitingForFileChangesText, watchUsageText };
+export { BaseReporter, CancellationReason, CancellationToken, Cli, Color, Config, ConfigDiagnosticText, DescribeResult, Diagnostic, DiagnosticCategory, DiagnosticOrigin, Directive, DotReporter, EventEmitter, ExpectResult, FileLocation, FileResult, Line, ListReporter, OptionBrand, OptionGroup, Options, OutputService, Path, ProjectResult, Result, ResultStatus, Runner, Scribbler, Select, SelectDiagnosticText, SetupReporter, Store, StreamController, SummaryReporter, SuppressedResult, TargetResult, TestResult, Text, Version, WatchReporter, addsPackageText, defaultOptions, describeNameText, diagnosticBelongsToNode, diagnosticText, dotText, environmentOptions, fileStatusText, formattedText, getDiagnosticMessageText, getTextSpanEnd, helpText, isDiagnosticWithLocation, prologueText, summaryText, testNameText, usesCompilerText, waitingForFileChangesText, watchUsageText };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tstyche",
-  "version": "6.0.3",
+  "version": "6.2.0",
   "description": "Everything You Need for Type Testing.",
   "keywords": [
     "typescript",
@@ -25,6 +25,7 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./tag": "./dist/tag.js",
     "./tstyche": "./dist/tstyche.js",
     "./package.json": "./package.json"
   },