tstyche 5.0.0-beta.2 → 5.0.0-beta.4

package/build/index.d.cts

@@ -146,7 +146,7 @@ interface Matchers {
 }
 interface Modifier {
     /**
-     * Passes the source type to the matcher.
+     * Indicates a type-level assertion.
      */
     type: Matchers & {
         /**

package/build/index.d.ts

@@ -146,7 +146,7 @@ interface Matchers {
 }
 interface Modifier {
     /**
-     * Passes the source type to the matcher.
+     * Indicates a type-level assertion.
      */
     type: Matchers & {
         /**

package/build/tstyche.d.ts

@@ -615,6 +615,8 @@ declare class OutputService {
     static writeWarning(element: ScribblerJsx.Element | Array<ScribblerJsx.Element>): void;
 }
 
+declare function prologueText(runnerVersion: string, rootPath: string): ScribblerJsx.Element;
+
 interface SummaryTextOptions {
     targetCounts: ResultCounts;
     fileCounts: ResultCounts;
@@ -731,5 +733,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, PluginService, 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, summaryText, testNameText, usesCompilerText, waitingForFileChangesText, watchUsageText };
+export { BaseReporter, CancellationReason, CancellationToken, Cli, Color, Config, ConfigDiagnosticText, DescribeResult, Diagnostic, DiagnosticCategory, DiagnosticOrigin, Directive, EventEmitter, ExpectResult, FileLocation, FileResult, Line, ListReporter, OptionBrand, OptionGroup, Options, OutputService, Path, PluginService, 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 type { AssertionCounts, AssertionResultStatus, CodeFrameOptions, CommandLineOptions, ConfigFileOptions, DiagnosticsHandler, DirectiveRange, EnvironmentOptions, Event, EventHandler, FileCounts, FileResultStatus, InlineConfig, ItemDefinition, OptionDefinition, Plugin, Reporter, ReporterEvent, ResolvedConfig, ResultCounts, ResultTiming, ScribblerOptions, SelectHookContext, SuppressedCounts, SuppressedResultStatus, TargetCounts, TargetResultStatus, TestCounts, TestResultStatus, TextRange };

package/build/tstyche.js

@@ -731,7 +731,7 @@ class ManifestService {
         const versions = [];
         const packageMetadata = (await response.json());
         for (const [tag, meta] of Object.entries(packageMetadata.versions)) {
-            if (!tag.includes("-") && Version.isSatisfiedWith(tag, "4.7.2")) {
+            if (!tag.includes("-") && Version.isSatisfiedWith(tag, "5.0.2")) {
                 versions.push(tag);
                 packages[tag] = { integrity: meta.dist.integrity, tarball: meta.dist.tarball };
             }
@@ -858,9 +858,6 @@ class PackageService {
             const stream = response.body.pipeThrough(new DecompressionStream("gzip"));
             const tarReader = new TarReader(stream);
             for await (const file of tarReader.extract()) {
-                if (!file.name.startsWith("package/")) {
-                    continue;
-                }
                 const filePath = Path.join(targetPath, file.name.replace(/^package\//, ""));
                 const directoryPath = Path.dirname(filePath);
                 if (!existsSync(directoryPath)) {
@@ -968,7 +965,7 @@ class Store {
             modulePath = Path.resolve(modulePath, "../tsserverlibrary.js");
         }
         const sourceText = await fs.readFile(modulePath, { encoding: "utf8" });
-        const toExpose = ["isApplicableIndexType", "isTypeIdenticalTo"];
+        const toExpose = ["isTypeIdenticalTo"];
         const modifiedSourceText = sourceText.replace("return checker;", `return { ...checker, ${toExpose.join(", ")} };`);
         const compiledWrapper = vm.compileFunction(modifiedSourceText, ["exports", "require", "module", "__filename", "__dirname"], { filename: modulePath });
         compiledWrapper(exports, createRequire(modulePath), module, modulePath, Path.dirname(modulePath));
@@ -2491,6 +2488,10 @@ class OutputService {
     }
 }
 
+function prologueText(runnerVersion, rootPath) {
+    return (jsx(Text, { children: [jsx(Line, { children: [jsx(Text, { color: "90", children: "····" }), " TSTyche ", runnerVersion, jsx(Text, { color: "90", children: [" at ", rootPath] })] }), jsx(Line, {})] }));
+}
+
 function RowText({ label, text }) {
     return (jsx(Line, { children: [`${label}:`.padEnd(12), text] }));
 }
@@ -3305,6 +3306,7 @@ class AbilityLayer {
         const expectExpressionEnd = expect.node.expression.getEnd();
         const expectEnd = expect.node.getEnd();
         const matcherNameEnd = expect.matcherNameNode.getEnd();
+        const matcherNodeEnd = expect.matcherNode.getEnd();
         switch (expect.matcherNameNode.name.text) {
             case "toBeApplicable":
                 this.#nodes.push(expect);
@@ -3344,18 +3346,71 @@ class AbilityLayer {
                 }
                 break;
             }
-            case "toBeConstructableWith":
+            case "toBeConstructableWith": {
                 this.#nodes.push(expect);
-                this.#editor.eraseTrailingComma(expect.source);
-                this.#editor.replaceRanges([
-                    [
-                        expectStart,
-                        expectExpressionEnd,
-                        nodeIsChildOfExpressionStatement(this.#compiler, expect.matcherNode) ? "; new" : "new",
-                    ],
-                    [expectEnd, matcherNameEnd],
-                ]);
+                const sourceNode = expect.source[0];
+                if (!sourceNode) {
+                    return;
+                }
+                if (nodeBelongsToArgumentList(this.#compiler, sourceNode)) {
+                    this.#editor.eraseTrailingComma(expect.source);
+                    this.#editor.replaceRanges([
+                        [
+                            expectStart,
+                            expectExpressionEnd,
+                            nodeIsChildOfExpressionStatement(this.#compiler, expect.matcherNode) ? "; new" : "new",
+                        ],
+                        [expectEnd, matcherNameEnd],
+                    ]);
+                }
+                else {
+                    const sourceText = sourceNode.getFullText();
+                    this.#editor.replaceRanges([
+                        [
+                            expectStart,
+                            matcherNameEnd,
+                            nodeIsChildOfExpressionStatement(this.#compiler, expect.matcherNode)
+                                ? `;new (undefined as any as ${sourceText})`
+                                : `new (undefined as any as ${sourceText})`,
+                        ],
+                    ]);
+                }
+                break;
+            }
+            case "toHaveProperty": {
+                this.#nodes.push(expect);
+                const sourceNode = expect.source[0];
+                const targetNode = expect.target?.[0];
+                if (!sourceNode || !targetNode) {
+                    return;
+                }
+                const sourceText = sourceNode.getFullText();
+                const targetText = targetNode.getFullText();
+                if (nodeBelongsToArgumentList(this.#compiler, sourceNode)) {
+                    this.#editor.eraseTrailingComma(expect.source);
+                    this.#editor.replaceRanges([
+                        [
+                            expectStart,
+                            matcherNodeEnd,
+                            nodeIsChildOfExpressionStatement(this.#compiler, expect.matcherNode)
+                                ? `;(${sourceText})[${targetText}]`
+                                : `(${sourceText})[${targetText}]`,
+                        ],
+                    ]);
+                }
+                else {
+                    this.#editor.replaceRanges([
+                        [
+                            expectStart,
+                            matcherNodeEnd,
+                            nodeIsChildOfExpressionStatement(this.#compiler, expect.matcherNode)
+                                ? `;(undefined as any as ${sourceText})[${targetText}]`
+                                : `(undefined as any as ${sourceText})[${targetText}]`,
+                        ],
+                    ]);
+                }
                 break;
+            }
         }
     }
     visitWhen(when) {
@@ -3987,6 +4042,7 @@ class ProjectService {
     }
     #getDefaultCompilerOptions() {
         const defaultCompilerOptions = {
+            allowImportingTsExtensions: true,
             exactOptionalPropertyTypes: true,
             jsx: this.#compiler.JsxEmit.Preserve,
             module: this.#compiler.ModuleKind.NodeNext,
@@ -3994,12 +4050,9 @@ class ProjectService {
             noUncheckedIndexedAccess: true,
             resolveJsonModule: true,
             strict: true,
+            verbatimModuleSyntax: true,
             target: this.#compiler.ScriptTarget.ESNext,
         };
-        if (Version.isSatisfiedWith(this.#compiler.version, "5.0")) {
-            defaultCompilerOptions.allowImportingTsExtensions = true;
-            defaultCompilerOptions.verbatimModuleSyntax = true;
-        }
         if (Version.isSatisfiedWith(this.#compiler.version, "5.6")) {
             defaultCompilerOptions.noUncheckedSideEffectImports = true;
         }
@@ -4303,19 +4356,6 @@ class MatchWorker {
         this.typeChecker = typeChecker;
         this.assertionNode = assertionNode;
     }
-    checkHasApplicableIndexType(sourceNode, targetNode) {
-        const sourceType = this.getType(sourceNode);
-        const targetType = this.getType(targetNode);
-        return this.typeChecker
-            .getIndexInfosOfType(sourceType)
-            .some(({ keyType }) => this.typeChecker.isApplicableIndexType(targetType, keyType));
-    }
-    checkHasProperty(sourceNode, propertyNameText) {
-        const sourceType = this.getType(sourceNode);
-        return sourceType
-            .getProperties()
-            .some((property) => this.#compiler.unescapeLeadingUnderscores(property.escapedName) === propertyNameText);
-    }
     checkIsAssignableTo(sourceNode, targetNode) {
         return this.#checkIsRelatedTo(sourceNode, targetNode, "assignable");
     }
@@ -4771,16 +4811,8 @@ class ToBeConstructableWith extends AbilityMatcherBase {
     explainText = ExpectDiagnosticText.isConstructable;
     explainNotText = ExpectDiagnosticText.isNotConstructable;
     match(matchWorker, sourceNode, targetNodes, onDiagnostics) {
-        let type;
-        if (this.compiler.isCallExpression(sourceNode)) {
-            type = matchWorker.typeChecker.getResolvedSignature(sourceNode)?.getReturnType();
-        }
-        if (this.compiler.isExpressionWithTypeArguments(sourceNode) ||
-            this.compiler.isIdentifier(sourceNode) ||
-            this.compiler.isPropertyAccessExpression(sourceNode)) {
-            type = matchWorker.getType(sourceNode);
-        }
-        if (!type || type.getConstructSignatures().length === 0) {
+        const sourceType = matchWorker.getType(sourceNode);
+        if (sourceType.getConstructSignatures().length === 0) {
             const text = [];
             if (nodeBelongsToArgumentList(this.compiler, sourceNode)) {
                 text.push(ExpectDiagnosticText.argumentMustBe("source", "a constructable expression"));
@@ -4788,7 +4820,7 @@ class ToBeConstructableWith extends AbilityMatcherBase {
             else {
                 text.push(ExpectDiagnosticText.typeArgumentMustBe("Source", "a constructable type"));
             }
-            if (type != null && type.getCallSignatures().length > 0) {
+            if (sourceType.getCallSignatures().length > 0) {
                 text.push(ExpectDiagnosticText.didYouMeanToUse("the '.toBeCallableWith()' matcher"));
             }
             const origin = DiagnosticOrigin.fromNode(sourceNode);
@@ -4835,14 +4867,7 @@ class ToHaveProperty {
             diagnostics.push(Diagnostic.error(text, origin));
         }
         const targetType = matchWorker.getType(targetNode);
-        let propertyNameText = "";
-        if (isStringOrNumberLiteralType(this.#compiler, targetType)) {
-            propertyNameText = targetType.value.toString();
-        }
-        else if (isUniqueSymbolType(this.#compiler, targetType)) {
-            propertyNameText = this.#compiler.unescapeLeadingUnderscores(targetType.escapedName);
-        }
-        else {
+        if (!(isStringOrNumberLiteralType(this.#compiler, targetType) || isUniqueSymbolType(this.#compiler, targetType))) {
             const expectedText = "of type 'string | number | symbol'";
             const text = ExpectDiagnosticText.argumentMustBe("key", expectedText);
             const origin = DiagnosticOrigin.fromNode(targetNode);
@@ -4852,11 +4877,9 @@ class ToHaveProperty {
             onDiagnostics(diagnostics);
             return;
         }
-        const isMatch = matchWorker.checkHasProperty(sourceNode, propertyNameText) ||
-            matchWorker.checkHasApplicableIndexType(sourceNode, targetNode);
         return {
             explain: () => this.#explain(matchWorker, sourceNode, targetNode),
-            isMatch,
+            isMatch: matchWorker.assertionNode.abilityDiagnostics.size === 0,
         };
     }
 }
@@ -5241,7 +5264,7 @@ class TestTreeWalker {
             }
             const fixmeDirective = Directive.getDirectiveRange(this.#compiler, node, "fixme");
             if (fixmeDirective) {
-                FixmeService.start(fixmeDirective, node);
+                await FixmeService.start(fixmeDirective, node);
             }
             switch (node.brand) {
                 case "describe":
@@ -5454,7 +5477,7 @@ class FileRunner {
 class Runner {
     #eventEmitter = new EventEmitter();
     #resolvedConfig;
-    static version = "5.0.0-beta.2";
+    static version = "5.0.0-beta.4";
     constructor(resolvedConfig) {
         this.#resolvedConfig = resolvedConfig;
     }
@@ -5492,6 +5515,9 @@ class Runner {
         }
     }
     async run(files, cancellationToken = new CancellationToken()) {
+        if (!this.#resolvedConfig.watch) {
+            OutputService.writeMessage(prologueText(Runner.version, this.#resolvedConfig.rootPath));
+        }
         const fileLocations = files.map((file) => (file instanceof FileLocation ? file : new FileLocation(file)));
         this.#addHandlers(cancellationToken);
         await this.#addReporters();
@@ -5654,4 +5680,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, PluginService, 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, summaryText, testNameText, usesCompilerText, waitingForFileChangesText, watchUsageText };
+export { BaseReporter, CancellationReason, CancellationToken, Cli, Color, Config, ConfigDiagnosticText, DescribeResult, Diagnostic, DiagnosticCategory, DiagnosticOrigin, Directive, EventEmitter, ExpectResult, FileLocation, FileResult, Line, ListReporter, OptionBrand, OptionGroup, Options, OutputService, Path, PluginService, 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tstyche",
-  "version": "5.0.0-beta.2",
+  "version": "5.0.0-beta.4",
   "description": "Everything You Need for Type Testing.",
   "keywords": [
     "typescript",
@@ -22,10 +22,6 @@
   "type": "module",
   "exports": {
     ".": {
-      "types@4.x": {
-        "import": "./build/4.x/index.d.ts",
-        "require": "./build/4.x/index.d.cts"
-      },
       "import": "./build/index.js",
       "require": "./build/index.cjs"
     },
@@ -34,16 +30,9 @@
   },
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
-  "typesVersions": {
-    "4.x": {
-      "build/*": [
-        "./build/4.x/*"
-      ]
-    }
-  },
   "bin": "./build/bin.js",
   "peerDependencies": {
-    "typescript": ">=4.7"
+    "typescript": ">=5.0"
   },
   "peerDependenciesMeta": {
     "typescript": {

package/build/4.x/index.d.cts

@@ -1,251 +0,0 @@
-interface Describe {
-    /**
-     * Defines a group of tests.
-     *
-     * @param name - The name of the group.
-     * @param callback - The function to create a scope for a group of tests.
-     */
-    (name: string, callback: () => void | Promise<void>): void;
-    /**
-     * Marks a group of tests as focused.
-     *
-     * @param name - The name of the group.
-     * @param callback - The function to create a scope for a group of tests.
-     */
-    only: (name: string, callback: () => void | Promise<void>) => void;
-    /**
-     * Marks a group of tests as skipped.
-     *
-     * @param name - The name of the group.
-     * @param callback - The function to create a scope for a group of tests.
-     */
-    skip: (name: string, callback: () => void | Promise<void>) => void;
-    /**
-     * Marks a group of tests as yet to be implemented.
-     *
-     * @param name - The name of the group.
-     * @param callback - The function to create a scope for a group of tests.
-     */
-    todo: (name: string, callback?: () => void | Promise<void>) => void;
-}
-interface Test {
-    /**
-     * Defines a single test.
-     *
-     * @param name - The name of the test.
-     * @param callback - The function with a code snippet and assertions.
-     */
-    (name: string, callback: () => void | Promise<void>): void;
-    /**
-     * Marks a test as focused.
-     *
-     * @param name - The name of the test.
-     * @param callback - The function with a code snippet and assertions.
-     */
-    only: (name: string, callback: () => void | Promise<void>) => void;
-    /**
-     * Marks a test as skipped.
-     *
-     * @param name - The name of the test.
-     * @param callback - The function with a code snippet and assertions.
-     */
-    skip: (name: string, callback: () => void | Promise<void>) => void;
-    /**
-     * Marks a test as yet to be implemented.
-     *
-     * @param name - The name of the test.
-     * @param callback - The function with a code snippet and assertions.
-     */
-    todo: (name: string, callback?: () => void | Promise<void>) => void;
-}
-interface Matchers {
-    /**
-     * Checks if the JSX component accepts props of the given type.
-     *
-     * @remarks
-     *
-     * This is a work in progress feature. Generic components are not yet supported.
-     */
-    toAcceptProps: {
-        /**
-         * Checks if the JSX component accepts props of the given type.
-         *
-         * @remarks
-         *
-         * This is a work in progress feature. Generic components are not yet supported.
-         */
-        <Target>(): void;
-        /**
-         * Checks if the JSX component accepts the given props.
-         *
-         * @remarks
-         *
-         * This is a work in progress feature. Generic components are not yet supported.
-         */
-        (target: unknown): void;
-    };
-    /**
-     * Checks if the source type is the same as the target type.
-     */
-    toBe: {
-        /**
-         * Checks if the source type is the same as the target type.
-         */
-        <Target>(): void;
-        /**
-         * Checks if the source type is the same as type of the target expression.
-         */
-        (target: unknown): void;
-    };
-    /**
-     * Checks if the source type is assignable from the target type.
-     */
-    toBeAssignableFrom: {
-        /**
-         * Checks if the source type is assignable from the target type.
-         */
-        <Target>(): void;
-        /**
-         * Checks if the source type is assignable from type of the target expression.
-         */
-        (target: unknown): void;
-    };
-    /**
-     * Checks if the source type is assignable to the target type.
-     */
-    toBeAssignableTo: {
-        /**
-         * Checks if the source type is assignable to the target type.
-         */
-        <Target>(): void;
-        /**
-         * Checks if the source type is assignable to type of the target expression.
-         */
-        (target: unknown): void;
-    };
-    /**
-     * Checks if the source type is callable with the given arguments.
-     */
-    toBeCallableWith: (...args: Array<unknown>) => void;
-    /**
-     * Checks if the source type is constructable with the given arguments.
-     */
-    toBeConstructableWith: (...args: Array<unknown>) => void;
-    /**
-     * Checks if a property key exists on the source type.
-     */
-    toHaveProperty: (key: string | number | symbol) => void;
-    /**
-     * Checks if the source type raises an error.
-     */
-    toRaiseError: (...target: Array<string | number | RegExp>) => void;
-}
-interface Modifier {
-    /**
-     * Passes the source type to the matcher.
-     */
-    type: Matchers & {
-        /**
-         * Negates the assertion.
-         */
-        not: Matchers;
-    };
-}
-interface Expect {
-    /**
-     * Builds an assertion.
-     *
-     * @template Source - The type which is checked.
-     */
-    <Source>(): Modifier;
-    /**
-     * Builds an assertion.
-     *
-     * @param source - The expression whose type is checked.
-     */
-    (source: unknown): Modifier;
-    /**
-     * Marks an assertion as focused.
-     */
-    only: {
-        /**
-         * Marks an assertion as focused.
-         *
-         * @template Source - The type which is checked.
-         */
-        <Source>(): Modifier;
-        /**
-         * Marks an assertion as focused.
-         *
-         * @param source - The expression whose type is checked.
-         */
-        (source: unknown): Modifier;
-    };
-    /**
-     * Marks an assertion as skipped.
-     */
-    skip: {
-        /**
-         * Marks an assertion as skipped.
-         *
-         * @template Source - The type which is checked.
-         */
-        <Source>(): Modifier;
-        /**
-         * Marks an assertion as skipped.
-         *
-         * @param source - The expression whose type is checked.
-         */
-        (source: unknown): Modifier;
-    };
-}
-/**
- * Builds an assertion.
- */
-declare const expect: Expect;
-/**
- * Reshapes type of the given object by removing the specified keys.
- */
-declare function omit<T, K extends PropertyKey>(object: T, ...keys: [K, ...Array<K>]): Omit<T, K>;
-/**
- * Reshapes type of the given object by keeping only the specified keys.
- */
-declare function pick<T, K extends keyof T>(object: T, ...keys: [K, ...Array<K>]): Pick<T, K>;
-/**
- * Defines a test group.
- */
-declare const describe: Describe;
-/**
- * Defines a single test.
- */
-declare const it: Test;
-/**
- * Defines a single test.
- */
-declare const test: Test;
-interface Actions {
-    /**
-     * Calls the given function with the provided arguments.
-     */
-    isCalledWith: (...args: Array<unknown>) => void;
-}
-interface When {
-    /**
-     * Creates a test plan.
-     *
-     * @template Target - The type upon which an action is performed.
-     */
-    <Target>(): Actions;
-    /**
-     * Creates a test plan.
-     *
-     * @param target - The expression upon which an action is performed.
-     */
-    (target: unknown): Actions;
-}
-/**
- * Creates a test plan.
- */
-declare const when: When;
-
-export { describe, expect, it, omit, pick, test, when };

package/build/4.x/index.d.ts

@@ -1,251 +0,0 @@
-interface Describe {
-    /**
-     * Defines a group of tests.
-     *
-     * @param name - The name of the group.
-     * @param callback - The function to create a scope for a group of tests.
-     */
-    (name: string, callback: () => void | Promise<void>): void;
-    /**
-     * Marks a group of tests as focused.
-     *
-     * @param name - The name of the group.
-     * @param callback - The function to create a scope for a group of tests.
-     */
-    only: (name: string, callback: () => void | Promise<void>) => void;
-    /**
-     * Marks a group of tests as skipped.
-     *
-     * @param name - The name of the group.
-     * @param callback - The function to create a scope for a group of tests.
-     */
-    skip: (name: string, callback: () => void | Promise<void>) => void;
-    /**
-     * Marks a group of tests as yet to be implemented.
-     *
-     * @param name - The name of the group.
-     * @param callback - The function to create a scope for a group of tests.
-     */
-    todo: (name: string, callback?: () => void | Promise<void>) => void;
-}
-interface Test {
-    /**
-     * Defines a single test.
-     *
-     * @param name - The name of the test.
-     * @param callback - The function with a code snippet and assertions.
-     */
-    (name: string, callback: () => void | Promise<void>): void;
-    /**
-     * Marks a test as focused.
-     *
-     * @param name - The name of the test.
-     * @param callback - The function with a code snippet and assertions.
-     */
-    only: (name: string, callback: () => void | Promise<void>) => void;
-    /**
-     * Marks a test as skipped.
-     *
-     * @param name - The name of the test.
-     * @param callback - The function with a code snippet and assertions.
-     */
-    skip: (name: string, callback: () => void | Promise<void>) => void;
-    /**
-     * Marks a test as yet to be implemented.
-     *
-     * @param name - The name of the test.
-     * @param callback - The function with a code snippet and assertions.
-     */
-    todo: (name: string, callback?: () => void | Promise<void>) => void;
-}
-interface Matchers {
-    /**
-     * Checks if the JSX component accepts props of the given type.
-     *
-     * @remarks
-     *
-     * This is a work in progress feature. Generic components are not yet supported.
-     */
-    toAcceptProps: {
-        /**
-         * Checks if the JSX component accepts props of the given type.
-         *
-         * @remarks
-         *
-         * This is a work in progress feature. Generic components are not yet supported.
-         */
-        <Target>(): void;
-        /**
-         * Checks if the JSX component accepts the given props.
-         *
-         * @remarks
-         *
-         * This is a work in progress feature. Generic components are not yet supported.
-         */
-        (target: unknown): void;
-    };
-    /**
-     * Checks if the source type is the same as the target type.
-     */
-    toBe: {
-        /**
-         * Checks if the source type is the same as the target type.
-         */
-        <Target>(): void;
-        /**
-         * Checks if the source type is the same as type of the target expression.
-         */
-        (target: unknown): void;
-    };
-    /**
-     * Checks if the source type is assignable from the target type.
-     */
-    toBeAssignableFrom: {
-        /**
-         * Checks if the source type is assignable from the target type.
-         */
-        <Target>(): void;
-        /**
-         * Checks if the source type is assignable from type of the target expression.
-         */
-        (target: unknown): void;
-    };
-    /**
-     * Checks if the source type is assignable to the target type.
-     */
-    toBeAssignableTo: {
-        /**
-         * Checks if the source type is assignable to the target type.
-         */
-        <Target>(): void;
-        /**
-         * Checks if the source type is assignable to type of the target expression.
-         */
-        (target: unknown): void;
-    };
-    /**
-     * Checks if the source type is callable with the given arguments.
-     */
-    toBeCallableWith: (...args: Array<unknown>) => void;
-    /**
-     * Checks if the source type is constructable with the given arguments.
-     */
-    toBeConstructableWith: (...args: Array<unknown>) => void;
-    /**
-     * Checks if a property key exists on the source type.
-     */
-    toHaveProperty: (key: string | number | symbol) => void;
-    /**
-     * Checks if the source type raises an error.
-     */
-    toRaiseError: (...target: Array<string | number | RegExp>) => void;
-}
-interface Modifier {
-    /**
-     * Passes the source type to the matcher.
-     */
-    type: Matchers & {
-        /**
-         * Negates the assertion.
-         */
-        not: Matchers;
-    };
-}
-interface Expect {
-    /**
-     * Builds an assertion.
-     *
-     * @template Source - The type which is checked.
-     */
-    <Source>(): Modifier;
-    /**
-     * Builds an assertion.
-     *
-     * @param source - The expression whose type is checked.
-     */
-    (source: unknown): Modifier;
-    /**
-     * Marks an assertion as focused.
-     */
-    only: {
-        /**
-         * Marks an assertion as focused.
-         *
-         * @template Source - The type which is checked.
-         */
-        <Source>(): Modifier;
-        /**
-         * Marks an assertion as focused.
-         *
-         * @param source - The expression whose type is checked.
-         */
-        (source: unknown): Modifier;
-    };
-    /**
-     * Marks an assertion as skipped.
-     */
-    skip: {
-        /**
-         * Marks an assertion as skipped.
-         *
-         * @template Source - The type which is checked.
-         */
-        <Source>(): Modifier;
-        /**
-         * Marks an assertion as skipped.
-         *
-         * @param source - The expression whose type is checked.
-         */
-        (source: unknown): Modifier;
-    };
-}
-/**
- * Builds an assertion.
- */
-declare const expect: Expect;
-/**
- * Reshapes type of the given object by removing the specified keys.
- */
-declare function omit<T, K extends PropertyKey>(object: T, ...keys: [K, ...Array<K>]): Omit<T, K>;
-/**
- * Reshapes type of the given object by keeping only the specified keys.
- */
-declare function pick<T, K extends keyof T>(object: T, ...keys: [K, ...Array<K>]): Pick<T, K>;
-/**
- * Defines a test group.
- */
-declare const describe: Describe;
-/**
- * Defines a single test.
- */
-declare const it: Test;
-/**
- * Defines a single test.
- */
-declare const test: Test;
-interface Actions {
-    /**
-     * Calls the given function with the provided arguments.
-     */
-    isCalledWith: (...args: Array<unknown>) => void;
-}
-interface When {
-    /**
-     * Creates a test plan.
-     *
-     * @template Target - The type upon which an action is performed.
-     */
-    <Target>(): Actions;
-    /**
-     * Creates a test plan.
-     *
-     * @param target - The expression upon which an action is performed.
-     */
-    (target: unknown): Actions;
-}
-/**
- * Creates a test plan.
- */
-declare const when: When;
-
-export { describe, expect, it, omit, pick, test, when };