tstyche 1.1.0 → 2.0.0-beta.1

package/README.md

@@ -25,7 +25,7 @@ function firstItem<T>(target: Array<T>): T | undefined {
 }
 
 test("firstItem", () => {
-  expect(firstItem(["a", "b", "c"])).type.toEqual<string | undefined>();
+  expect(firstItem(["a", "b", "c"])).type.toBe<string | undefined>();
 
   expect(firstItem()).type.toRaiseError("Expected 1 argument");
 });
@@ -52,13 +52,13 @@ function secondItem<T>(target: Array<T>): T | undefined {
 test("handles numbers", () => {
   assert.strictEqual(secondItem([1, 2, 3]), 2);
 
-  tstyche.expect(secondItem([1, 2, 3])).type.toEqual<number | undefined>();
+  tstyche.expect(secondItem([1, 2, 3])).type.toBe<number | undefined>();
 });
 ```
 
 Here is the list of all matchers:
 
-- `.toBeAssignable()`, `.toEqual()`, `.toMatch()` compares types or types of expression,
+- `.toBe()`, `.toBeAssignableTo()`, `.toBeAssignableWith()`, `.toMatch()` compare types or types of expression,
 - `.toHaveProperty()` looks up keys on an object type,
 - `.toRaiseError()` captures the type error message or code,
 - `.toBeString()`, `.toBeNumber()`, `.toBeVoid()` and 9 more shorthand checks for primitive types.
@@ -91,8 +91,8 @@ If you have any questions or suggestions, [start a discussion](https://github.co
 [license-url]: https://github.com/tstyche/tstyche/blob/main/LICENSE.md
 [requirements-badge]: https://badgen.net/npm/node/tstyche
 [requirements-url]: https://tstyche.org/reference/requirements
-[install-size-badge]: https://badgen.net/install-size/install/tstyche
-[install-size-url]: https://install-size.com/result?p=tstyche
+[install-size-badge]: https://badgen.net/packagephobia/install/tstyche
+[install-size-url]: https://packagephobia.com/result?p=tstyche
 [coverage-badge]: https://badgen.net/codacy/coverage/a581ca5c323a455886b7bdd9623c4ec8
 [coverage-url]: https://app.codacy.com/gh/tstyche/tstyche/coverage/dashboard
 [discord-badge]: https://badgen.net/static/chat/on%20Discord

package/build/index.d.cts

@@ -60,22 +60,115 @@ interface Test {
 }
 interface Matchers {
     /**
-     * Checks if the `any` type is identical to the source type.
+     * Checks if the source type is identical to the target type.
      */
-    toBeAny: () => void;
+    toBe: {
+        /**
+         * Checks if the source type is identical to the target type.
+         */
+        <Target>(): void;
+        /**
+         * Checks if the source type is identical to type of the target expression.
+         */
+        (target: unknown): void;
+    };
     /**
-     * Checks if the target type is assignable to the source type.
+     * Checks if the source type is assignable with the target type.
+     *
+     * @deprecated Use `.toBeAssignableWith()` or `.toBeAssignableTo()` instead. This matcher will be removed in TSTyche 3.
+     * To learn more, visit https://tstyche.org/release-notes/tstyche-2.
      */
     toBeAssignable: {
         /**
-         * Checks if the target type is assignable to the source type.
+         * Checks if the source type is assignable with the target type.
+         *
+         * @deprecated Use `.toBeAssignableWith()` or `.toBeAssignableTo()` instead. This matcher will be removed in TSTyche 3.
+         * To learn more, visit https://tstyche.org/release-notes/tstyche-2.
+         */
+        <Target>(): void;
+        /**
+         * Checks if the source type is assignable with type of the target expression.
+         *
+         * @deprecated Use `.toBeAssignableWith()` or `.toBeAssignableTo()` instead. This matcher will be removed in TSTyche 3.
+         * To learn more, visit https://tstyche.org/release-notes/tstyche-2.
+         */
+        (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 type of the target expression is assignable to the source type.
+         * Checks if the source type is assignable to type of the target expression.
          */
         (target: unknown): void;
     };
+    /**
+     * Checks if the source type is assignable with the target type.
+     */
+    toBeAssignableWith: {
+        /**
+         * Checks if the source type is assignable with the target type.
+         */
+        <Target>(): void;
+        /**
+         * Checks if the source type is assignable with type of the target expression.
+         */
+        (target: unknown): void;
+    };
+    /**
+     * Checks if the source type is identical to the target type.
+     *
+     * @deprecated Use `.toBe()` instead. This matcher will be removed in TSTyche 3.
+     * To learn more, visit https://tstyche.org/release-notes/tstyche-2.
+     */
+    toEqual: {
+        /**
+         * Checks if the source type is identical to the target type.
+         *
+         * @deprecated Use `.toBe()` instead. This matcher will be removed in TSTyche 3.
+         * To learn more, visit https://tstyche.org/release-notes/tstyche-2.
+         */
+        <Target>(): void;
+        /**
+         * Checks if the source type is identical to type of the target expression.
+         *
+         * @deprecated This matcher will be removed in TSTyche 3.
+         * To learn more, visit https://tstyche.org/release-notes/tstyche-2.
+         */
+        (target: unknown): void;
+    };
+    /**
+     * Checks if a property key exists on the source type.
+     */
+    toHaveProperty: (key: string | number | symbol) => void;
+    /**
+     * Checks if the source type matches the target type.
+     */
+    toMatch: {
+        /**
+         * Checks if the source type matches the target type.
+         */
+        <Target>(): void;
+        /**
+         * Checks if the source type matches type of the target expression.
+         */
+        (target: unknown): void;
+    };
+    /**
+     * Checks if the source type raises an error.
+     */
+    toRaiseError: (...target: Array<string | number>) => void;
+}
+interface Matchers {
+    /**
+     * Checks if the source type is `any`.
+     */
+    toBeAny: () => void;
     /**
      * Checks if the source type is `bigint`.
      */
@@ -120,40 +213,6 @@ interface Matchers {
      * Checks if the source type is `void`.
      */
     toBeVoid: () => void;
-    /**
-     * Check if the target type is identical to the source type.
-     */
-    toEqual: {
-        /**
-         * Checks if the target type is identical to the source type.
-         */
-        <Target>(): void;
-        /**
-         * Checks if type of the target expression is identical to the source type.
-         */
-        (target: unknown): void;
-    };
-    /**
-     * Checks if a property key exists on the source type.
-     */
-    toHaveProperty: (key: string | number | symbol) => void;
-    /**
-     * Checks if the target type is a subtype the source type.
-     */
-    toMatch: {
-        /**
-         * Checks if the target type is a subtype the source type.
-         */
-        <Target>(): void;
-        /**
-         * Checks if type of the target expression is a subtype the source type.
-         */
-        (target: unknown): void;
-    };
-    /**
-     * Checks if the source type raises an error.
-     */
-    toRaiseError: (...target: Array<string | number>) => void;
 }
 interface Modifier {
     /**

package/build/index.d.ts

@@ -60,22 +60,115 @@ interface Test {
 }
 interface Matchers {
     /**
-     * Checks if the `any` type is identical to the source type.
+     * Checks if the source type is identical to the target type.
      */
-    toBeAny: () => void;
+    toBe: {
+        /**
+         * Checks if the source type is identical to the target type.
+         */
+        <Target>(): void;
+        /**
+         * Checks if the source type is identical to type of the target expression.
+         */
+        (target: unknown): void;
+    };
     /**
-     * Checks if the target type is assignable to the source type.
+     * Checks if the source type is assignable with the target type.
+     *
+     * @deprecated Use `.toBeAssignableWith()` or `.toBeAssignableTo()` instead. This matcher will be removed in TSTyche 3.
+     * To learn more, visit https://tstyche.org/release-notes/tstyche-2.
      */
     toBeAssignable: {
         /**
-         * Checks if the target type is assignable to the source type.
+         * Checks if the source type is assignable with the target type.
+         *
+         * @deprecated Use `.toBeAssignableWith()` or `.toBeAssignableTo()` instead. This matcher will be removed in TSTyche 3.
+         * To learn more, visit https://tstyche.org/release-notes/tstyche-2.
+         */
+        <Target>(): void;
+        /**
+         * Checks if the source type is assignable with type of the target expression.
+         *
+         * @deprecated Use `.toBeAssignableWith()` or `.toBeAssignableTo()` instead. This matcher will be removed in TSTyche 3.
+         * To learn more, visit https://tstyche.org/release-notes/tstyche-2.
+         */
+        (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 type of the target expression is assignable to the source type.
+         * Checks if the source type is assignable to type of the target expression.
          */
         (target: unknown): void;
     };
+    /**
+     * Checks if the source type is assignable with the target type.
+     */
+    toBeAssignableWith: {
+        /**
+         * Checks if the source type is assignable with the target type.
+         */
+        <Target>(): void;
+        /**
+         * Checks if the source type is assignable with type of the target expression.
+         */
+        (target: unknown): void;
+    };
+    /**
+     * Checks if the source type is identical to the target type.
+     *
+     * @deprecated Use `.toBe()` instead. This matcher will be removed in TSTyche 3.
+     * To learn more, visit https://tstyche.org/release-notes/tstyche-2.
+     */
+    toEqual: {
+        /**
+         * Checks if the source type is identical to the target type.
+         *
+         * @deprecated Use `.toBe()` instead. This matcher will be removed in TSTyche 3.
+         * To learn more, visit https://tstyche.org/release-notes/tstyche-2.
+         */
+        <Target>(): void;
+        /**
+         * Checks if the source type is identical to type of the target expression.
+         *
+         * @deprecated This matcher will be removed in TSTyche 3.
+         * To learn more, visit https://tstyche.org/release-notes/tstyche-2.
+         */
+        (target: unknown): void;
+    };
+    /**
+     * Checks if a property key exists on the source type.
+     */
+    toHaveProperty: (key: string | number | symbol) => void;
+    /**
+     * Checks if the source type matches the target type.
+     */
+    toMatch: {
+        /**
+         * Checks if the source type matches the target type.
+         */
+        <Target>(): void;
+        /**
+         * Checks if the source type matches type of the target expression.
+         */
+        (target: unknown): void;
+    };
+    /**
+     * Checks if the source type raises an error.
+     */
+    toRaiseError: (...target: Array<string | number>) => void;
+}
+interface Matchers {
+    /**
+     * Checks if the source type is `any`.
+     */
+    toBeAny: () => void;
     /**
      * Checks if the source type is `bigint`.
      */
@@ -120,40 +213,6 @@ interface Matchers {
      * Checks if the source type is `void`.
      */
     toBeVoid: () => void;
-    /**
-     * Check if the target type is identical to the source type.
-     */
-    toEqual: {
-        /**
-         * Checks if the target type is identical to the source type.
-         */
-        <Target>(): void;
-        /**
-         * Checks if type of the target expression is identical to the source type.
-         */
-        (target: unknown): void;
-    };
-    /**
-     * Checks if a property key exists on the source type.
-     */
-    toHaveProperty: (key: string | number | symbol) => void;
-    /**
-     * Checks if the target type is a subtype the source type.
-     */
-    toMatch: {
-        /**
-         * Checks if the target type is a subtype the source type.
-         */
-        <Target>(): void;
-        /**
-         * Checks if type of the target expression is a subtype the source type.
-         */
-        (target: unknown): void;
-    };
-    /**
-     * Checks if the source type raises an error.
-     */
-    toRaiseError: (...target: Array<string | number>) => void;
 }
 interface Modifier {
     /**