@goast/core 0.4.0 → 0.4.1

package/src/deps/jsr.io/@std/expect/{1.0.5 → 1.0.12}/_matchers.ts

@@ -1,23 +1,26 @@
-// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
-
-import { assertNotStrictEquals } from "../../assert/1.0.6/not_strict_equals.js";
-import { assertStrictEquals } from "../../assert/1.0.6/strict_equals.js";
-import { assertInstanceOf } from "../../assert/1.0.6/instance_of.js";
-import { assertIsError } from "../../assert/1.0.6/is_error.js";
-import { assertNotInstanceOf } from "../../assert/1.0.6/not_instance_of.js";
-import { assertMatch } from "../../assert/1.0.6/match.js";
-import { assertObjectMatch } from "../../assert/1.0.6/object_match.js";
-import { assertNotMatch } from "../../assert/1.0.6/not_match.js";
-import { AssertionError } from "../../assert/1.0.6/assertion_error.js";
+// Copyright 2018-2025 the Deno authors. MIT license.
+
+import { assertNotStrictEquals } from "../../assert/1.0.11/not_strict_equals.js";
+import { assertStrictEquals } from "../../assert/1.0.11/strict_equals.js";
+import { assertInstanceOf } from "../../assert/1.0.11/instance_of.js";
+import { assertIsError } from "./_assert_is_error.js";
+import { assertNotInstanceOf } from "../../assert/1.0.11/not_instance_of.js";
+import { assertMatch } from "../../assert/1.0.11/match.js";
+import { assertNotMatch } from "../../assert/1.0.11/not_match.js";
+import { AssertionError } from "../../assert/1.0.11/assertion_error.js";
 
 import { assertEquals } from "./_assert_equals.js";
 import { assertNotEquals } from "./_assert_not_equals.js";
 import { equal } from "./_equal.js";
-import { format } from "../../internal/1.0.4/format.js";
+import { format } from "../../internal/1.0.5/format.js";
 import type { AnyConstructor, MatcherContext, MatchResult } from "./_types.js";
 import { getMockCalls } from "./_mock_util.js";
 import { inspectArg, inspectArgs } from "./_inspect_args.js";
-import { buildEqualOptions, iterableEquality } from "./_utils.js";
+import {
+  buildEqualOptions,
+  iterableEquality,
+  subsetEquality,
+} from "./_utils.js";
 
 export function toBe(context: MatcherContext, expect: unknown): MatchResult {
   if (context.isNot) {
@@ -85,14 +88,22 @@ export function toBeCloseTo(
 
   if (context.isNot) {
     if (pass) {
+      const defaultMessage =
+        `Expected the value ${value} not to be close to ${expected} (using ${numDigits} digits), but it is`;
       throw new AssertionError(
-        `Expected the value not to be close to ${expected} (using ${numDigits} digits), but it is`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (!pass) {
+      const defaultMessage =
+        `Expected the value ${value} to be close to ${expected} (using ${numDigits} digits), but it is not`;
       throw new AssertionError(
-        `Expected the value (${value} to be close to ${expected} (using ${numDigits} digits), but it is not`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -124,14 +135,20 @@ export function toBeFalsy(
   const isFalsy = !(context.value);
   if (context.isNot) {
     if (isFalsy) {
+      const defaultMessage = `Expected ${context.value} to NOT be falsy`;
       throw new AssertionError(
-        `Expected ${context.value} to NOT be falsy`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (!isFalsy) {
+      const defaultMessage = `Expected ${context.value} to be falsy`;
       throw new AssertionError(
-        `Expected ${context.value} to be falsy`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -143,14 +160,20 @@ export function toBeTruthy(
   const isTruthy = !!(context.value);
   if (context.isNot) {
     if (isTruthy) {
+      const defaultMessage = `Expected ${context.value} to NOT be truthy`;
       throw new AssertionError(
-        `Expected ${context.value} to NOT be truthy`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (!isTruthy) {
+      const defaultMessage = `Expected ${context.value} to be truthy`;
       throw new AssertionError(
-        `Expected ${context.value} to be truthy`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -163,14 +186,22 @@ export function toBeGreaterThanOrEqual(
   const isGreaterOrEqual = Number(context.value) >= Number(expected);
   if (context.isNot) {
     if (isGreaterOrEqual) {
+      const defaultMessage =
+        `Expected ${context.value} to NOT be greater than or equal ${expected}`;
       throw new AssertionError(
-        `Expected ${context.value} to NOT be greater than or equal ${expected}`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (!isGreaterOrEqual) {
+      const defaultMessage =
+        `Expected ${context.value} to be greater than or equal ${expected}`;
       throw new AssertionError(
-        `Expected ${context.value} to be greater than or equal ${expected}`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -183,14 +214,22 @@ export function toBeGreaterThan(
   const isGreater = Number(context.value) > Number(expected);
   if (context.isNot) {
     if (isGreater) {
+      const defaultMessage =
+        `Expected ${context.value} to NOT be greater than ${expected}`;
       throw new AssertionError(
-        `Expected ${context.value} to NOT be greater than ${expected}`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (!isGreater) {
+      const defaultMessage =
+        `Expected ${context.value} to be greater than ${expected}`;
       throw new AssertionError(
-        `Expected ${context.value} to be greater than ${expected}`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -213,14 +252,22 @@ export function toBeLessThanOrEqual(
   const isLower = Number(context.value) <= Number(expected);
   if (context.isNot) {
     if (isLower) {
+      const defaultMessage =
+        `Expected ${context.value} to NOT be lower than or equal ${expected}`;
       throw new AssertionError(
-        `Expected ${context.value} to NOT be lower than or equal ${expected}`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (!isLower) {
+      const defaultMessage =
+        `Expected ${context.value} to be lower than or equal ${expected}`;
       throw new AssertionError(
-        `Expected ${context.value} to be lower than or equal ${expected}`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -232,14 +279,22 @@ export function toBeLessThan(
   const isLower = Number(context.value) < Number(expected);
   if (context.isNot) {
     if (isLower) {
+      const defaultMessage =
+        `Expected ${context.value} to NOT be lower than ${expected}`;
       throw new AssertionError(
-        `Expected ${context.value} to NOT be lower than ${expected}`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (!isLower) {
+      const defaultMessage =
+        `Expected ${context.value} to be lower than ${expected}`;
       throw new AssertionError(
-        `Expected ${context.value} to be lower than ${expected}`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -294,14 +349,22 @@ export function toHaveLength(
 
   if (context.isNot) {
     if (hasLength) {
+      const defaultMessage =
+        `Expected value not to have length ${expected}, but it does`;
       throw new AssertionError(
-        `Expected value not to have length ${expected}, but it does`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (!hasLength) {
+      const defaultMessage =
+        `Expected value to have length ${expected}, but it does not: the value has length ${maybeLength}`;
       throw new AssertionError(
-        `Expected value to have length ${expected}, but it does not: the value has length ${maybeLength}`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -349,18 +412,24 @@ export function toHaveProperty(
 
   if (context.isNot) {
     if (hasProperty) {
+      const defaultMessage = `Expected the value not to have the property ${
+        propPath.join(".")
+      }${ofValue}, but it does`;
       throw new AssertionError(
-        `Expected the value not to have the property ${
-          propPath.join(".")
-        }${ofValue}, but it does`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (!hasProperty) {
+      const defaultMessage = `Expected the value to have the property ${
+        propPath.join(".")
+      }${ofValue}, but it does not`;
       throw new AssertionError(
-        `Expected the value to have the property ${
-          propPath.join(".")
-        }${ofValue}, but it does not`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -378,14 +447,22 @@ export function toContain(
 
   if (context.isNot) {
     if (doesContain) {
+      const defaultMessage =
+        `The value ${fmtValue} contains the expected item ${fmtExpected}`;
       throw new AssertionError(
-        `The value ${fmtValue} contains the expected item ${fmtExpected}`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (!doesContain) {
+      const defaultMessage =
+        `The value ${fmtValue} doesn't contain the expected item ${fmtExpected}`;
       throw new AssertionError(
-        `The value ${fmtValue} doesn't contain the expected item ${fmtExpected}`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -416,18 +493,24 @@ export function toContainEqual(
 
   if (context.isNot) {
     if (doesContain) {
-      throw new AssertionError(
-        `The value contains the expected item:
+      const defaultMessage = `The value contains the expected item:
 Value: ${fmtValue}
-Expected: ${fmtExpected}`,
+Expected: ${fmtExpected}`;
+      throw new AssertionError(
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (!doesContain) {
-      throw new AssertionError(
-        `The value doesn't contain the expected item:
+      const defaultMessage = `The value doesn't contain the expected item:
 Value: ${fmtValue}
-Expected: ${fmtExpected}`,
+Expected: ${fmtExpected}`;
+      throw new AssertionError(
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -462,34 +545,60 @@ export function toMatchObject(
   context: MatcherContext,
   expected: Record<PropertyKey, unknown> | Record<PropertyKey, unknown>[],
 ): MatchResult {
-  if (context.isNot) {
-    let objectMatch = false;
-    try {
-      assertObjectMatch(
-        // deno-lint-ignore no-explicit-any
-        context.value as Record<PropertyKey, any>,
-        expected as Record<PropertyKey, unknown>,
-        context.customMessage,
+  const received = context.value;
+
+  const defaultMsg = "Received value must be an object";
+
+  if (typeof received !== "object" || received === null) {
+    throw new AssertionError(
+      context.customMessage
+        ? `${context.customMessage}: ${defaultMsg}`
+        : defaultMsg,
+    );
+  }
+
+  if (typeof expected !== "object" || expected === null) {
+    throw new AssertionError(
+      context.customMessage
+        ? `${context.customMessage}: ${defaultMsg}`
+        : defaultMsg,
+    );
+  }
+
+  const pass = equal(context.value, expected, {
+    strictCheck: false,
+    customTesters: [
+      ...context.customTesters,
+      iterableEquality,
+      subsetEquality,
+    ],
+  });
+
+  const triggerError = () => {
+    const actualString = format(context.value);
+    const expectedString = format(expected);
+
+    if (context.isNot) {
+      const defaultMessage =
+        `Expected ${actualString} to NOT match ${expectedString}`;
+      throw new AssertionError(
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
-      objectMatch = true;
-      const actualString = format(context.value);
-      const expectedString = format(expected);
+    } else {
+      const defaultMessage =
+        `Expected ${actualString} to match ${expectedString}`;
       throw new AssertionError(
-        `Expected ${actualString} to NOT match ${expectedString}`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
-    } catch (e) {
-      if (objectMatch) {
-        throw e;
-      }
-      return;
     }
-  } else {
-    assertObjectMatch(
-      // deno-lint-ignore no-explicit-any
-      context.value as Record<PropertyKey, any>,
-      expected as Record<PropertyKey, unknown>,
-      context.customMessage,
-    );
+  };
+
+  if (context.isNot && pass || !context.isNot && !pass) {
+    triggerError();
   }
 }
 
@@ -499,14 +608,22 @@ export function toHaveBeenCalled(context: MatcherContext): MatchResult {
 
   if (context.isNot) {
     if (hasBeenCalled) {
+      const defaultMessage =
+        `Expected mock function not to be called, but it was called ${calls.length} time(s)`;
       throw new AssertionError(
-        `Expected mock function not to be called, but it was called ${calls.length} time(s)`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (!hasBeenCalled) {
+      const defaultMessage =
+        "Expected mock function to be called, but it was not called";
       throw new AssertionError(
-        `Expected mock function to be called, but it was not called`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -520,14 +637,22 @@ export function toHaveBeenCalledTimes(
 
   if (context.isNot) {
     if (calls.length === expected) {
+      const defaultMessage =
+        `Expected mock function not to be called ${expected} time(s), but it was`;
       throw new AssertionError(
-        `Expected mock function not to be called ${expected} time(s), but it was`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (calls.length !== expected) {
+      const defaultMessage =
+        `Expected mock function to be called ${expected} time(s), but it was called ${calls.length} time(s)`;
       throw new AssertionError(
-        `Expected mock function to be called ${expected} time(s), but it was called ${calls.length} time(s)`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -542,10 +667,13 @@ export function toHaveBeenCalledWith(
 
   if (context.isNot) {
     if (hasBeenCalled) {
+      const defaultMessage = `Expected mock function not to be called with ${
+        inspectArgs(expected)
+      }, but it was`;
       throw new AssertionError(
-        `Expected mock function not to be called with ${
-          inspectArgs(expected)
-        }, but it was`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
@@ -556,10 +684,14 @@ export function toHaveBeenCalledWith(
           calls.map((call) => inspectArgs(call.args)).join("\n    ")
         }`;
       }
+
+      const defaultMessage = `Expected mock function to be called with ${
+        inspectArgs(expected)
+      }, but it was not.${otherCalls}`;
       throw new AssertionError(
-        `Expected mock function to be called with ${
-          inspectArgs(expected)
-        }, but it was not.${otherCalls}`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -574,31 +706,42 @@ export function toHaveBeenLastCalledWith(
 
   if (context.isNot) {
     if (hasBeenCalled) {
-      throw new AssertionError(
+      const defaultMessage =
         `Expected mock function not to be last called with ${
           inspectArgs(expected)
-        }, but it was`,
+        }, but it was`;
+      throw new AssertionError(
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (!hasBeenCalled) {
       const lastCall = calls.at(-1);
       if (!lastCall) {
+        const defaultMessage = `Expected mock function to be last called with ${
+          inspectArgs(expected)
+        }, but it was not`;
         throw new AssertionError(
-          `Expected mock function to be last called with ${
-            inspectArgs(expected)
-          }, but it was not`,
+          context.customMessage
+            ? `${context.customMessage}: ${defaultMessage}`
+            : defaultMessage,
         );
       } else {
+        const defaultMessage = `Expected mock function to be last called with ${
+          inspectArgs(expected)
+        }, but it was last called with ${inspectArgs(lastCall.args)}`;
         throw new AssertionError(
-          `Expected mock function to be last called with ${
-            inspectArgs(expected)
-          }, but it was last called with ${inspectArgs(lastCall.args)}`,
+          context.customMessage
+            ? `${context.customMessage}: ${defaultMessage}`
+            : defaultMessage,
         );
       }
     }
   }
 }
+
 export function toHaveBeenNthCalledWith(
   context: MatcherContext,
   nth: number,
@@ -615,26 +758,38 @@ export function toHaveBeenNthCalledWith(
 
   if (context.isNot) {
     if (hasBeenCalled) {
-      throw new AssertionError(
+      const defaultMessage =
         `Expected the n-th call (n=${nth}) of mock function is not with ${
           inspectArgs(expected)
-        }, but it was`,
+        }, but it was`;
+      throw new AssertionError(
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (!hasBeenCalled) {
       const nthCall = calls[callIndex];
       if (!nthCall) {
-        throw new AssertionError(
+        const defaultMessage =
           `Expected the n-th call (n=${nth}) of mock function is with ${
             inspectArgs(expected)
-          }, but the n-th call does not exist`,
+          }, but the n-th call does not exist`;
+        throw new AssertionError(
+          context.customMessage
+            ? `${context.customMessage}: ${defaultMessage}`
+            : defaultMessage,
         );
       } else {
-        throw new AssertionError(
+        const defaultMessage =
           `Expected the n-th call (n=${nth}) of mock function is with ${
             inspectArgs(expected)
-          }, but it was with ${inspectArgs(nthCall.args)}`,
+          }, but it was with ${inspectArgs(nthCall.args)}`;
+        throw new AssertionError(
+          context.customMessage
+            ? `${context.customMessage}: ${defaultMessage}`
+            : defaultMessage,
         );
       }
     }
@@ -647,14 +802,22 @@ export function toHaveReturned(context: MatcherContext): MatchResult {
 
   if (context.isNot) {
     if (returned.length > 0) {
+      const defaultMessage =
+        `Expected the mock function to not have returned, but it returned ${returned.length} times`;
       throw new AssertionError(
-        `Expected the mock function to not have returned, but it returned ${returned.length} times`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (returned.length === 0) {
+      const defaultMessage =
+        `Expected the mock function to have returned, but it did not return`;
       throw new AssertionError(
-        `Expected the mock function to have returned, but it did not return`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -669,14 +832,22 @@ export function toHaveReturnedTimes(
 
   if (context.isNot) {
     if (returned.length === expected) {
+      const defaultMessage =
+        `Expected the mock function to not have returned ${expected} times, but it returned ${returned.length} times`;
       throw new AssertionError(
-        `Expected the mock function to not have returned ${expected} times, but it returned ${returned.length} times`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (returned.length !== expected) {
+      const defaultMessage =
+        `Expected the mock function to have returned ${expected} times, but it returned ${returned.length} times`;
       throw new AssertionError(
-        `Expected the mock function to have returned ${expected} times, but it returned ${returned.length} times`,
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -693,18 +864,26 @@ export function toHaveReturnedWith(
 
   if (context.isNot) {
     if (returnedWithExpected) {
-      throw new AssertionError(
+      const defaultMessage =
         `Expected the mock function to not have returned with ${
           inspectArg(expected)
-        }, but it did`,
+        }, but it did`;
+      throw new AssertionError(
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (!returnedWithExpected) {
-      throw new AssertionError(
+      const defaultMessage =
         `Expected the mock function to have returned with ${
           inspectArg(expected)
-        }, but it did not`,
+        }, but it did not`;
+      throw new AssertionError(
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -721,18 +900,26 @@ export function toHaveLastReturnedWith(
 
   if (context.isNot) {
     if (lastReturnedWithExpected) {
-      throw new AssertionError(
+      const defaultMessage =
         `Expected the mock function to not have last returned with ${
           inspectArg(expected)
-        }, but it did`,
+        }, but it did`;
+      throw new AssertionError(
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (!lastReturnedWithExpected) {
-      throw new AssertionError(
+      const defaultMessage =
         `Expected the mock function to have last returned with ${
           inspectArg(expected)
-        }, but it did not`,
+        }, but it did not`;
+      throw new AssertionError(
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -756,18 +943,26 @@ export function toHaveNthReturnedWith(
 
   if (context.isNot) {
     if (nthReturnedWithExpected) {
-      throw new AssertionError(
+      const defaultMessage =
         `Expected the mock function to not have n-th (n=${nth}) returned with ${
           inspectArg(expected)
-        }, but it did`,
+        }, but it did`;
+      throw new AssertionError(
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   } else {
     if (!nthReturnedWithExpected) {
-      throw new AssertionError(
+      const defaultMessage =
         `Expected the mock function to have n-th (n=${nth}) returned with ${
           inspectArg(expected)
-        }, but it did not`,
+        }, but it did not`;
+      throw new AssertionError(
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
       );
     }
   }
@@ -811,7 +1006,12 @@ export function toThrow<E extends Error = Error>(
         context.customMessage,
       );
       isError = true;
-      throw new AssertionError(`Expected to NOT throw ${expected}`);
+      const defaultMessage = `Expected to NOT throw ${expected}`;
+      throw new AssertionError(
+        context.customMessage
+          ? `${context.customMessage}: ${defaultMessage}`
+          : defaultMessage,
+      );
     } catch (e) {
       if (isError) {
         throw e;