tstyche 7.0.0-rc.1 → 7.1.0

package/README.md

@@ -30,14 +30,14 @@ test("isSameLength", () => {
 });
 ```
 
-To group and organize tests, TSTyche has:
+TSTyche lets you organize tests using:
 
-- `test()`, `it()` and `describe()` helpers,
-- with `.only`, `.skip` and `.todo` run mode flags.
+- helpers: `test()`, `it()` and `describe()`
+- run mode flags: `.only`, `.skip` and `.todo`
 
 ## Assertions
 
-The `expect` style assertions can check either the inferred type of an expression (as in the example above) or a type directly:
+The `expect` style assertions can check either the inferred type of an expression or a type directly:
 
 ```ts
 import { type _, expect } from "tstyche";
@@ -58,32 +58,32 @@ expect<WithLoading<_>>().type.not.toBeInstantiableWith<[string]>();
 
 Relation matchers:
 
-- `.toBe()` checks if a type is the same as the given type,
-- `.toBeAssignableFrom()` checks if a type is assignable from the given type,
-- `.toBeAssignableTo()` checks if a type is assignable to the given type.
+- `.toBe()` checks if a type is the same as the given type
+- `.toBeAssignableFrom()` checks if a type is assignable from the given type
+- `.toBeAssignableTo()` checks if a type is assignable to the given type
 
 Ability matchers:
 
-- `.toAcceptProps()` checks if a JSX component accepts the given props,
-- `.toBeApplicable` checks if a decorator is applicable to the given class or class member,
-- `.toBeCallableWith()` checks if a function is callable with the given arguments,
-- `.toBeConstructableWith()` checks if a class is constructable with the given arguments,
-- `.toBeInstantiableWith()` checks if a generic is instantiable with the given type arguments,
-- `.toHaveProperty()` checks if a type has the given property.
+- `.toAcceptProps()` checks if a JSX component accepts the given props
+- `.toBeApplicable` checks if a decorator is applicable to the given class or class member
+- `.toBeCallableWith()` checks if a function is callable with the given arguments
+- `.toBeConstructableWith()` checks if a class is constructable with the given arguments
+- `.toBeInstantiableWith()` checks if a generic is instantiable with the given type arguments
+- `.toHaveProperty()` checks if a type has the given property
 
 ## Runner
 
-The `tstyche` command is the heart of TSTyche. It allows you to select test files by path, filter tests by name and run them against specific versions of TypeScript:
+The `tstyche` command is the heart of TSTyche. It lets you select test files by path, filter tests by name and run them against specific versions of TypeScript:
 
 ```shell
 tstyche query-params --only multiple --target '>=5.6'
 ```
 
-It is that simple! Actually, TSTyche does even more:
+That is just the beginning. It even lets you:
 
-- checks messages of errors suppressed by `@ts-expect-error` directives,
-- generates type tests from a data table,
-- runs tests in watch mode.
+- check messages of errors suppressed by `@ts-expect-error` directives
+- generate type tests from a template file
+- run tests in watch mode
 
 ## Try It Out
 
@@ -95,6 +95,10 @@ Try TSTyche online on StackBlitz:
 
 Visit [tstyche.org](https://tstyche.org) to view the full documentation.
 
+## Roadmap
+
+See [ROADMAP.md](https://github.com/tstyche/tstyche/blob/main/ROADMAP.md) for planned features.
+
 ## License
 
 [MIT][license-url] © TSTyche

package/dist/api.d.ts

@@ -36,8 +36,7 @@ declare enum TestTreeNodeBrand {
     Describe = "describe",
     Test = "test",
     It = "it",
-    Expect = "expect",
-    When = "when"
+    Expect = "expect"
 }
 
 declare enum TestTreeNodeFlags {
@@ -47,17 +46,9 @@ declare enum TestTreeNodeFlags {
     Todo = 4
 }
 
-declare class WhenNode extends TestTreeNode {
-    actionNode: ts.CallExpression;
-    actionNameNode: ts.PropertyAccessExpression;
-    abilityDiagnostics: Set<ts.Diagnostic>;
-    target: ts.NodeArray<ts.Expression> | ts.NodeArray<ts.TypeNode>;
-    constructor(compiler: typeof ts, brand: TestTreeNodeBrand, node: ts.CallExpression, parent: TestTree | TestTreeNode, flags: TestTreeNodeFlags, actionNode: ts.CallExpression, actionNameNode: ts.PropertyAccessExpression);
-}
-
 declare class TestTreeNode {
     brand: TestTreeNodeBrand;
-    children: Array<TestTreeNode | ExpectNode | WhenNode>;
+    children: Array<TestTreeNode | ExpectNode>;
     diagnostics: Set<ts.Diagnostic>;
     flags: TestTreeNodeFlags;
     name: string;
@@ -79,7 +70,7 @@ declare class ExpectNode extends TestTreeNode {
 }
 
 declare class TestTree {
-    children: Array<TestTreeNode | ExpectNode | WhenNode>;
+    children: Array<TestTreeNode | ExpectNode>;
     diagnostics: Set<ts.Diagnostic>;
     hasOnly: boolean;
     sourceFile: ts.SourceFile;
@@ -95,7 +86,6 @@ declare class DiagnosticOrigin {
     constructor(start: number, end: number, sourceFile: ts.SourceFile | JsonSourceFile, assertionNode?: ExpectNode);
     static fromAssertion(assertionNode: ExpectNode): DiagnosticOrigin;
     static fromNode(node: ts.Node, assertionNode?: ExpectNode): DiagnosticOrigin;
-    static fromNodes(nodes: ts.NodeArray<ts.Node>, assertionNode?: ExpectNode): DiagnosticOrigin;
 }
 
 declare class Diagnostic {
@@ -451,9 +441,6 @@ declare class SuppressedResult {
     constructor(suppressed: SuppressedError);
 }
 
-interface EventHandler {
-    on: (event: Event) => void;
-}
 type Event = ["config:error", {
     diagnostics: Array<Diagnostic>;
 }] | ["select:error", {
@@ -490,7 +477,7 @@ type Event = ["config:error", {
 }] | ["collect:error", {
     diagnostics: Array<Diagnostic>;
 }] | ["collect:node", {
-    node: TestTreeNode | ExpectNode | WhenNode;
+    node: TestTreeNode | ExpectNode;
 }] | ["collect:end", {
     tree: TestTree;
 }] | ["describe:start", {
@@ -536,6 +523,9 @@ type Event = ["config:error", {
 }] | ["watch:error", {
     diagnostics: Array<Diagnostic>;
 }];
+interface EventHandler {
+    on: (event: Event) => void;
+}
 
 declare class EventEmitter {
     #private;

package/dist/api.js

@@ -112,9 +112,6 @@ class DiagnosticOrigin {
     static fromNode(node, assertionNode) {
         return new DiagnosticOrigin(node.getStart(), node.getEnd(), node.getSourceFile(), assertionNode);
     }
-    static fromNodes(nodes, assertionNode) {
-        return new DiagnosticOrigin(nodes.pos, nodes.end, nodes[0].getSourceFile(), assertionNode);
-    }
 }
 
 function diagnosticBelongsToNode(diagnostic, node) {
@@ -776,9 +773,7 @@ class ManifestService {
         return manifest;
     }
     async #persist(manifest) {
-        if (!existsSync(this.#storePath)) {
-            await fs.mkdir(this.#storePath, { recursive: true });
-        }
+        await fs.mkdir(this.#storePath, { recursive: true });
         await fs.writeFile(this.#manifestFilePath, manifest.stringify());
     }
     async prune() {
@@ -851,28 +846,8 @@ class PackageService {
         this.#fetcher = fetcher;
         this.#lockService = lockService;
     }
-    async #add(packagePath, resource, diagnostic) {
-        const request = new Request(resource.tarball, { integrity: resource.integrity });
-        const response = await this.#fetcher.get(request, diagnostic);
-        if (response?.body != null) {
-            const targetPath = `${packagePath}-${Math.random().toString(32).slice(2)}`;
-            const stream = response.body.pipeThrough(new DecompressionStream("gzip"));
-            const tarReader = new TarReader(stream);
-            for await (const file of tarReader.extract()) {
-                const filePath = Path.join(targetPath, file.name.replace(/^package\//, ""));
-                const directoryPath = Path.dirname(filePath);
-                if (!existsSync(directoryPath)) {
-                    await fs.mkdir(directoryPath, { recursive: true });
-                }
-                await fs.writeFile(filePath, file.content);
-            }
-            await fs.rename(targetPath, packagePath);
-            return packagePath;
-        }
-        return;
-    }
     async ensure(packageVersion, manifest) {
-        let packagePath = Path.join(this.#storePath, `typescript@${packageVersion}`);
+        const packagePath = Path.join(this.#storePath, `typescript@${packageVersion}`);
         const diagnostic = Diagnostic.error(StoreDiagnosticText.failedToFetchPackage(packageVersion));
         if (await this.#lockService.isLocked(packagePath, diagnostic)) {
             return;
@@ -881,18 +856,29 @@ class PackageService {
             return packagePath;
         }
         EventEmitter.dispatch(["store:adds", { packagePath, packageVersion }]);
-        const resource = manifest?.packages[packageVersion];
-        if (resource != null) {
-            const lock = this.#lockService.getLock(packagePath);
-            try {
-                packagePath = await this.#add(packagePath, resource, diagnostic);
+        const resource = manifest.packages[packageVersion];
+        const lock = this.#lockService.getLock(packagePath);
+        try {
+            const request = new Request(resource.tarball, { integrity: resource.integrity });
+            const response = await this.#fetcher.get(request, diagnostic);
+            if (!response?.body) {
+                return;
             }
-            finally {
-                lock.release();
+            const targetPath = await fs.mkdtemp(`${packagePath}-`);
+            const stream = response.body.pipeThrough(new DecompressionStream("gzip"));
+            const tarReader = new TarReader(stream);
+            for await (const file of tarReader.extract()) {
+                const filePath = Path.join(targetPath, file.name.replace(/^package\//, ""));
+                const directoryPath = Path.dirname(filePath);
+                await fs.mkdir(directoryPath, { recursive: true });
+                await fs.writeFile(filePath, file.content);
             }
+            await fs.rename(targetPath, packagePath);
             return packagePath;
         }
-        return;
+        finally {
+            lock.release();
+        }
     }
 }
 
@@ -912,17 +898,20 @@ class Store {
         Store.#packageService = new PackageService(Store.#storePath, Store.#fetcher, Store.#lockService);
         Store.#manifestService = new ManifestService(Store.#storePath, Store.#npmRegistry, Store.#fetcher);
     }
-    static async fetch(tag) {
-        if (tag === "*" && environmentOptions.typescriptModule != null) {
-            return;
-        }
+    static async #ensure(tag) {
         await Store.open();
         const version = Store.manifest?.resolve(tag);
         if (!version) {
             Store.#onDiagnostics(Diagnostic.error(StoreDiagnosticText.cannotAddTypeScriptPackage(tag)));
             return;
         }
-        await Store.#packageService.ensure(version, Store.manifest);
+        return await Store.#packageService.ensure(version, Store.manifest);
+    }
+    static async fetch(tag) {
+        if (tag === "*" && environmentOptions.typescriptModule != null) {
+            return;
+        }
+        await Store.#ensure(tag);
     }
     static async load(tag) {
         let resolvedModule;
@@ -930,13 +919,7 @@ class Store {
             resolvedModule = environmentOptions.typescriptModule;
         }
         else {
-            await Store.open();
-            const version = Store.manifest?.resolve(tag);
-            if (!version) {
-                Store.#onDiagnostics(Diagnostic.error(StoreDiagnosticText.cannotAddTypeScriptPackage(tag)));
-                return;
-            }
-            const packagePath = await Store.#packageService.ensure(version, Store.manifest);
+            const packagePath = await Store.#ensure(tag);
             if (packagePath != null) {
                 resolvedModule = pathToFileURL(`${packagePath}/lib/typescript.js`).toString();
             }
@@ -950,7 +933,9 @@ class Store {
         EventEmitter.dispatch(["store:error", { diagnostics: [diagnostic] }]);
     }
     static async open() {
-        Store.open = () => Promise.resolve();
+        if (Store.manifest != null) {
+            return;
+        }
         Store.manifest = await Store.#manifestService.open();
         if (Store.manifest != null) {
             Store.#supportedTags = [...Object.keys(Store.manifest.resolutions), ...Store.manifest.versions];
@@ -1040,7 +1025,7 @@ class Options {
         },
         {
             brand: "boolean",
-            description: "Check errors silenced by '@ts-expect-error' directives.",
+            description: "Check errors suppressed by '@ts-expect-error' directives.",
             group: 4,
             name: "checkSuppressedErrors",
         },
@@ -1092,13 +1077,13 @@ class Options {
         },
         {
             brand: "string",
-            description: "Only run tests with matching name.",
+            description: "Only run tests with a matching name.",
             group: 2,
             name: "only",
         },
         {
             brand: "true",
-            description: "Remove all installed versions of the 'typescript' package and exit.",
+            description: "Remove all fetched versions of the 'typescript' package and exit.",
             group: 2,
             name: "prune",
         },
@@ -1132,7 +1117,7 @@ class Options {
         },
         {
             brand: "string",
-            description: "The path to a directory containing files of a test project.",
+            description: "The path to the root directory of a test project.",
             group: 2,
             name: "root",
         },
@@ -1144,13 +1129,13 @@ class Options {
         },
         {
             brand: "string",
-            description: "Skip tests with matching name.",
+            description: "Skip tests with a matching name.",
             group: 2,
             name: "skip",
         },
         {
             brand: "range",
-            description: "The range of TypeScript versions to test against.",
+            description: "The TypeScript version or range of versions to test against.",
             group: 2 | 4 | 8,
             name: "target",
         },
@@ -3350,15 +3335,8 @@ class AbilityLayer {
         this.#editor = editor;
     }
     #belongsToNode(node, diagnostic) {
-        switch (node.brand) {
-            case "expect":
-                return (diagnosticBelongsToNode(diagnostic, node.matcherNode) ||
-                    diagnosticBelongsToNode(diagnostic, node.source));
-            case "when":
-                return (diagnosticBelongsToNode(diagnostic, node.actionNode) &&
-                    !diagnosticBelongsToNode(diagnostic, node.target));
-        }
-        return false;
+        return (diagnosticBelongsToNode(diagnostic, node.matcherNode) ||
+            diagnosticBelongsToNode(diagnostic, node.source));
     }
     close(diagnostics) {
         if (diagnostics != null && this.#nodes.length > 0) {
@@ -3534,22 +3512,6 @@ class AbilityLayer {
             }
         }
     }
-    visitWhen(when) {
-        const whenStart = when.node.getStart();
-        const whenExpressionEnd = when.node.expression.getEnd();
-        const whenEnd = when.node.getEnd();
-        const actionNameEnd = when.actionNameNode.getEnd();
-        switch (when.actionNameNode.name.text) {
-            case "isCalledWith":
-                this.#nodes.push(when);
-                this.#editor.eraseTrailingComma(when.target);
-                this.#editor.replaceRanges([
-                    [whenStart, whenExpressionEnd, nodeIsChildOfExpressionStatement(this.#compiler, when.actionNode) ? ";" : ""],
-                    [whenEnd, actionNameEnd],
-                ]);
-                break;
-        }
-    }
 }
 
 class SourceTextEditor {
@@ -3721,14 +3683,7 @@ class Layers {
         this.#suppressedLayer.close(this.#suppressedDiagnostics);
     }
     visit(node) {
-        switch (node.brand) {
-            case "expect":
-                this.#abilityLayer.visitExpect(node);
-                break;
-            case "when":
-                this.#abilityLayer.visitWhen(node);
-                break;
-        }
+        this.#abilityLayer.visitExpect(node);
     }
 }
 
@@ -3880,8 +3835,6 @@ class IdentifierLookup {
                 return { brand: "test", flags };
             case "expect":
                 return { brand: "expect", flags };
-            case "when":
-                return { brand: "when", flags };
         }
         return;
     }
@@ -3899,25 +3852,6 @@ class TestTree {
     }
 }
 
-class WhenNode extends TestTreeNode {
-    actionNode;
-    actionNameNode;
-    abilityDiagnostics = new Set();
-    target;
-    constructor(compiler, brand, node, parent, flags, actionNode, actionNameNode) {
-        super(compiler, brand, node, parent, flags);
-        this.actionNode = actionNode;
-        this.actionNameNode = actionNameNode;
-        this.target = this.node.typeArguments ?? this.node.arguments;
-        for (const diagnostic of parent.diagnostics) {
-            if (diagnosticBelongsToNode(diagnostic, node)) {
-                this.diagnostics.add(diagnostic);
-                parent.diagnostics.delete(diagnostic);
-            }
-        }
-    }
-}
-
 class CollectService {
     #layers;
     #compiler;
@@ -3977,38 +3911,6 @@ class CollectService {
                     this.#onNode(expectNode, parent, testTree);
                     return;
                 }
-                if (meta.brand === "when") {
-                    const actionNameNode = this.#getChainedNode(node);
-                    if (!actionNameNode) {
-                        const text = "The final element in the chain must be an action.";
-                        const origin = DiagnosticOrigin.fromNode(node);
-                        this.#onDiagnostics(Diagnostic.error(text, origin));
-                        return;
-                    }
-                    const actionNode = this.#getActionNode(actionNameNode);
-                    if (!actionNode) {
-                        const text = "The action must be called with an argument.";
-                        const origin = DiagnosticOrigin.fromNode(actionNameNode);
-                        this.#onDiagnostics(Diagnostic.error(text, origin));
-                        return;
-                    }
-                    this.#compiler.forEachChild(actionNode, (node) => {
-                        if (this.#compiler.isCallExpression(node)) {
-                            const meta = this.#identifierLookup.resolveTestTreeNodeMeta(node);
-                            if (meta?.brand === "describe" ||
-                                meta?.brand === "it" ||
-                                meta?.brand === "test") {
-                                const text = CollectDiagnosticText.cannotBeNestedWithin(meta.brand, "when");
-                                const origin = DiagnosticOrigin.fromNode(node);
-                                this.#onDiagnostics(Diagnostic.error(text, origin));
-                            }
-                        }
-                    });
-                    const whenNode = new WhenNode(this.#compiler, meta.brand, node, parent, meta.flags, actionNode, actionNameNode);
-                    this.#layers.visit(whenNode);
-                    this.#onNode(whenNode, parent, testTree);
-                    return;
-                }
             }
         }
         if (this.#compiler.isImportDeclaration(node)) {
@@ -4050,7 +3952,6 @@ class CollectService {
                 }
                 break;
             case "expect":
-            case "when":
                 if (parent.brand === "describe") {
                     return false;
                 }
@@ -4079,12 +3980,6 @@ class CollectService {
         }
         return;
     }
-    #getActionNode(node) {
-        if (this.#compiler.isCallExpression(node.parent)) {
-            return node.parent;
-        }
-        return;
-    }
     #onDiagnostics(diagnostic) {
         EventEmitter.dispatch(["collect:error", { diagnostics: [diagnostic] }]);
     }
@@ -4103,7 +3998,6 @@ var TestTreeNodeBrand;
     TestTreeNodeBrand["Test"] = "test";
     TestTreeNodeBrand["It"] = "it";
     TestTreeNodeBrand["Expect"] = "expect";
-    TestTreeNodeBrand["When"] = "when";
 })(TestTreeNodeBrand || (TestTreeNodeBrand = {}));
 
 var TestTreeNodeFlags;
@@ -4117,7 +4011,7 @@ var TestTreeNodeFlags;
 class ProjectService {
     #compiler;
     #host;
-    #lastSeenProject = "";
+    #lastSeenProject = "none";
     #projectConfig;
     #resolvedConfig;
     #seenProjects = new Set();
@@ -4182,7 +4076,6 @@ class ProjectService {
             noUncheckedIndexedAccess: true,
             resolveJsonModule: true,
             strict: true,
-            verbatimModuleSyntax: true,
             target: this.#compiler.ScriptTarget.ESNext,
         };
         if (Version.isSatisfiedWith(this.#compiler.version, "5.6")) {
@@ -4226,7 +4119,7 @@ class ProjectService {
         if (Options.isJsonString(specifier)) {
             return {
                 kind: 3,
-                specifier: Path.resolve(this.#resolvedConfig.rootPath, `${Math.random().toString(32).slice(2)}.tsconfig.json`),
+                specifier: Path.resolve(this.#resolvedConfig.rootPath, `${Date.now().toString(36)}.tsconfig.json`),
             };
         }
         return { kind: 2, specifier };
@@ -5797,63 +5690,6 @@ class Reject {
     }
 }
 
-class WhenDiagnosticText {
-    static actionIsNotSupported(actionNameText) {
-        return `The '.${actionNameText}()' action is not supported.`;
-    }
-}
-
-class WhenService {
-    #compiler;
-    #onDiagnostics;
-    #reject;
-    constructor(compiler, reject, onDiagnostics) {
-        this.#compiler = compiler;
-        this.#reject = reject;
-        this.#onDiagnostics = onDiagnostics;
-    }
-    action(when) {
-        if (!argumentIsProvided(this.#compiler, "target", when.target[0], when.node.expression, this.#onDiagnostics) ||
-            this.#reject.argumentType([["target", when.target[0]]], this.#onDiagnostics)) {
-            return;
-        }
-        const actionNameText = when.actionNameNode.name.getText();
-        switch (actionNameText) {
-            case "isCalledWith":
-                break;
-            default:
-                this.#onActionIsNotSupported(actionNameText, when, this.#onDiagnostics);
-                return;
-        }
-        if (when.abilityDiagnostics.size > 0) {
-            const diagnostics = [];
-            for (const diagnostic of when.abilityDiagnostics) {
-                if (isDiagnosticWithLocation(diagnostic)) {
-                    const text = getDiagnosticMessageText(diagnostic);
-                    let origin;
-                    if (isDiagnosticWithLocation(diagnostic) && diagnosticBelongsToNode(diagnostic, when.node)) {
-                        origin = DiagnosticOrigin.fromNodes(when.target);
-                    }
-                    else {
-                        origin = new DiagnosticOrigin(diagnostic.start, getTextSpanEnd(diagnostic), when.node.getSourceFile());
-                    }
-                    let related;
-                    if (diagnostic.relatedInformation != null) {
-                        related = Diagnostic.fromDiagnostics(diagnostic.relatedInformation);
-                    }
-                    diagnostics.push(Diagnostic.error(text, origin).add({ related }));
-                }
-            }
-            this.#onDiagnostics(diagnostics);
-        }
-    }
-    #onActionIsNotSupported(actionNameText, when, onDiagnostics) {
-        const text = WhenDiagnosticText.actionIsNotSupported(actionNameText);
-        const origin = DiagnosticOrigin.fromNode(when.actionNameNode.name);
-        onDiagnostics([Diagnostic.error(text, origin)]);
-    }
-}
-
 class FixmeDiagnosticText {
     static considerRemoving() {
         return "Consider removing the '// @tstyche fixme' directive.";
@@ -5920,7 +5756,6 @@ class TestTreeWalker {
     #onFileDiagnostics;
     #position;
     #resolvedConfig;
-    #whenService;
     constructor(compiler, program, resolvedConfig, onFileDiagnostics, options) {
         this.#compiler = compiler;
         this.#resolvedConfig = resolvedConfig;
@@ -5930,7 +5765,6 @@ class TestTreeWalker {
         this.#position = options.position;
         const reject = new Reject(compiler, program, resolvedConfig);
         this.#expectService = new ExpectService(compiler, program, reject);
-        this.#whenService = new WhenService(compiler, reject, onFileDiagnostics);
     }
     async #resolveRunMode(flags, node) {
         const ifDirective = Directive.getDirectiveRange(this.#compiler, node, "if");
@@ -5975,9 +5809,6 @@ class TestTreeWalker {
                 case "expect":
                     await this.#visitExpect(node, runModeFlags, parentResult);
                     break;
-                case "when":
-                    this.#visitWhen(node);
-                    break;
             }
             if (fixmeDirective) {
                 FixmeService.end(fixmeDirective, node, this.#onFileDiagnostics);
@@ -6079,9 +5910,6 @@ class TestTreeWalker {
             EventEmitter.dispatch(["test:fail", { result: testResult }]);
         }
     }
-    #visitWhen(when) {
-        this.#whenService.action(when);
-    }
 }
 
 class FileRunner {
@@ -6170,7 +5998,7 @@ class FileRunner {
 class Runner {
     #eventEmitter = new EventEmitter();
     #resolvedConfig;
-    static version = "7.0.0-rc.1";
+    static version = "7.1.0";
     constructor(resolvedConfig) {
         this.#resolvedConfig = resolvedConfig;
     }

package/dist/index.cjs

@@ -17,4 +17,3 @@ exports.it = noopChain;
 exports.omit = noop;
 exports.pick = noop;
 exports.test = noopChain;
-exports.when = noopChain;

package/dist/index.d.cts

@@ -100,7 +100,7 @@ interface Matchers {
     /**
      * Checks if the type raises an error.
      *
-     * @deprecated This matcher is planned to be removed. For a replacement, see https://tstyche.org/guides/expect-errors.
+     * @deprecated This API is planned to be removed. For a replacement, see https://tstyche.org/guides/expect-errors.
      */
     toRaiseError: (...target: Array<string | number | RegExp>) => void;
 }
@@ -183,23 +183,6 @@ interface Test {
     todo: (name: string, callback?: () => void | Promise<void>) => void;
 }
 
-interface Actions {
-    /**
-     * Calls the given function with the provided arguments.
-     */
-    isCalledWith: (...args: Array<unknown>) => void;
-}
-interface When {
-    /**
-     * Creates a test plan.
-     */
-    <T>(): Actions;
-    /**
-     * Creates a test plan.
-     */
-    (target: unknown): Actions;
-}
-
 /**
  * The fill-in type. Useful to fill in the required type arguments of generic types.
  */
@@ -228,10 +211,6 @@ declare const it: Test;
  * Defines a single test.
  */
 declare const test: Test;
-/**
- * Creates a test plan.
- */
-declare const when: When;
 
-export { describe, expect, it, omit, pick, test, when };
+export { describe, expect, it, omit, pick, test };
 export type { _ };

package/dist/index.d.ts

@@ -100,7 +100,7 @@ interface Matchers {
     /**
      * Checks if the type raises an error.
      *
-     * @deprecated This matcher is planned to be removed. For a replacement, see https://tstyche.org/guides/expect-errors.
+     * @deprecated This API is planned to be removed. For a replacement, see https://tstyche.org/guides/expect-errors.
      */
     toRaiseError: (...target: Array<string | number | RegExp>) => void;
 }
@@ -183,23 +183,6 @@ interface Test {
     todo: (name: string, callback?: () => void | Promise<void>) => void;
 }
 
-interface Actions {
-    /**
-     * Calls the given function with the provided arguments.
-     */
-    isCalledWith: (...args: Array<unknown>) => void;
-}
-interface When {
-    /**
-     * Creates a test plan.
-     */
-    <T>(): Actions;
-    /**
-     * Creates a test plan.
-     */
-    (target: unknown): Actions;
-}
-
 /**
  * The fill-in type. Useful to fill in the required type arguments of generic types.
  */
@@ -228,10 +211,6 @@ declare const it: Test;
  * Defines a single test.
  */
 declare const test: Test;
-/**
- * Creates a test plan.
- */
-declare const when: When;
 
-export { describe, expect, it, omit, pick, test, when };
+export { describe, expect, it, omit, pick, test };
 export type { _ };

package/dist/index.js

@@ -9,4 +9,4 @@ const noopChain = new Proxy(noop, {
     },
 });
 
-export { noopChain as describe, noopChain as expect, noopChain as it, noop as omit, noop as pick, noopChain as test, noopChain as when };
+export { noopChain as describe, noopChain as expect, noopChain as it, noop as omit, noop as pick, noopChain as test };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tstyche",
-  "version": "7.0.0-rc.1",
+  "version": "7.1.0",
   "description": "Everything You Need for Type Testing.",
   "keywords": [
     "typescript",

package/schemas/config.json

@@ -8,7 +8,7 @@
       "type": "boolean"
     },
     "checkSuppressedErrors": {
-      "description": "Check errors silenced by '@ts-expect-error' directives.",
+      "description": "Check errors suppressed by '@ts-expect-error' directives.",
       "default": true,
       "type": "boolean"
     },
@@ -57,7 +57,7 @@
       }
     },
     "target": {
-      "description": "The range of TypeScript versions to test against.",
+      "description": "The TypeScript version or range of versions to test against.",
       "default": "*",
       "type": "string"
     },