@xylabs/vitest-matchers 7.0.7 → 8.0.0

package/README.md

@@ -1,639 +1,3 @@
-[![logo][]](https://xylabs.com)
-
 # @xylabs/vitest-matchers
 
-[![npm][npm-badge]][npm-link]
-[![license][license-badge]][license-link]
-
-> Base functionality used throughout XY Labs TypeScript/JavaScript libraries
-
-## Install
-
-Using npm:
-
-```sh
-npm install {{name}}
-```
-
-Using yarn:
-
-```sh
-yarn add {{name}}
-```
-
-Using pnpm:
-
-```sh
-pnpm add {{name}}
-```
-
-Using bun:
-
-```sh
-bun add {{name}}
-```
-
-
-## License
-
-See the [LICENSE](LICENSE) file for license rights and limitations (LGPL-3.0-only).
-
-## Reference
-
-### packages
-
-  ### vitest-matchers
-
-    ### .temp-typedoc
-
-      ### interfaces
-
-        ### <a id="ExpectationResult"></a>ExpectationResult
-
-[**@xylabs/vitest-matchers**](#../README)
-
-***
-
-Result returned by a custom matcher function.
-
-## Properties
-
-### actual?
-
-```ts
-optional actual?: unknown;
-```
-
-The actual value received by the matcher.
-
-***
-
-### expected?
-
-```ts
-optional expected?: unknown;
-```
-
-The expected value the matcher compared against.
-
-***
-
-### message
-
-```ts
-message: () => string;
-```
-
-Returns a human-readable failure or negation message.
-
-### Returns
-
-`string`
-
-***
-
-### pass
-
-```ts
-pass: boolean;
-```
-
-Whether the matcher assertion passed.
-
-      ### variables
-
-        ### <a id="matchers"></a>matchers
-
-[**@xylabs/vitest-matchers**](#../README)
-
-***
-
-```ts
-const matchers: object;
-```
-
-Collection of custom Vitest matchers extending the built-in `expect` assertions.
-
-## Type Declaration
-
-### toBeArrayOfSize()
-
-```ts
-toBeArrayOfSize(received, expectedSize): ExpectationResult;
-```
-
-Asserts the received value is an array with the specified length.
-
-### Parameters
-
-#### received
-
-`unknown`
-
-The value to check.
-
-#### expectedSize
-
-`number`
-
-The expected array length.
-
-### Returns
-
-[`ExpectationResult`](#../interfaces/ExpectationResult)
-
-### toBeArray()
-
-```ts
-toBeArray(received): ExpectationResult;
-```
-
-Asserts the received value is an array.
-
-### Parameters
-
-#### received
-
-`unknown`
-
-The value to check.
-
-### Returns
-
-[`ExpectationResult`](#../interfaces/ExpectationResult)
-
-### toBeOneOf()
-
-```ts
-toBeOneOf(received, expected): ExpectationResult;
-```
-
-Asserts the received value is one of the values in the expected array.
-
-### Parameters
-
-#### received
-
-`unknown`
-
-The value to check.
-
-#### expected
-
-`unknown`[]
-
-The array of acceptable values.
-
-### Returns
-
-[`ExpectationResult`](#../interfaces/ExpectationResult)
-
-### toBeNegative()
-
-```ts
-toBeNegative(received): ExpectationResult;
-```
-
-Asserts the received number is negative (less than zero).
-
-### Parameters
-
-#### received
-
-`number`
-
-The number to check.
-
-### Returns
-
-[`ExpectationResult`](#../interfaces/ExpectationResult)
-
-### toBePositive()
-
-```ts
-toBePositive(received): ExpectationResult;
-```
-
-Asserts the received number is positive (greater than zero).
-
-### Parameters
-
-#### received
-
-`number`
-
-The number to check.
-
-### Returns
-
-[`ExpectationResult`](#../interfaces/ExpectationResult)
-
-### toBeNumber
-
-```ts
-toBeNumber: (received) => ExpectationResult;
-```
-
-Asserts the received value is of type `number` and not NaN.
-
-### Parameters
-
-#### received
-
-`unknown`
-
-The value to check.
-
-### Returns
-
-[`ExpectationResult`](#../interfaces/ExpectationResult)
-
-### toBeFunction
-
-```ts
-toBeFunction: (received) => ExpectationResult;
-```
-
-Asserts the received value is of type `function`.
-
-### Parameters
-
-#### received
-
-`unknown`
-
-The value to check.
-
-### Returns
-
-[`ExpectationResult`](#../interfaces/ExpectationResult)
-
-### toBeString
-
-```ts
-toBeString: (received) => ExpectationResult;
-```
-
-Asserts the received value is of type `string`.
-
-### Parameters
-
-#### received
-
-`unknown`
-
-The value to check.
-
-### Returns
-
-[`ExpectationResult`](#../interfaces/ExpectationResult)
-
-### toBeObject()
-
-```ts
-toBeObject(received): ExpectationResult;
-```
-
-Asserts the received value is a plain object (not an array or null).
-
-### Parameters
-
-#### received
-
-`unknown`
-
-The value to check.
-
-### Returns
-
-[`ExpectationResult`](#../interfaces/ExpectationResult)
-
-### toBeInteger()
-
-```ts
-toBeInteger(received): ExpectationResult;
-```
-
-Asserts the received number is an integer.
-
-### Parameters
-
-#### received
-
-`number`
-
-The number to check.
-
-### Returns
-
-[`ExpectationResult`](#../interfaces/ExpectationResult)
-
-### toBeFalse()
-
-```ts
-toBeFalse(received): ExpectationResult;
-```
-
-Asserts the received value is strictly `false`.
-
-### Parameters
-
-#### received
-
-`unknown`
-
-The value to check.
-
-### Returns
-
-[`ExpectationResult`](#../interfaces/ExpectationResult)
-
-### toBeTrue()
-
-```ts
-toBeTrue(received): ExpectationResult;
-```
-
-Asserts the received value is strictly `true`.
-
-### Parameters
-
-#### received
-
-`unknown`
-
-The value to check.
-
-### Returns
-
-[`ExpectationResult`](#../interfaces/ExpectationResult)
-
-### toContainAllValues()
-
-```ts
-toContainAllValues(received, expectedValues): object;
-```
-
-Asserts that all expected values are present in the received array or object values.
-
-### Parameters
-
-#### received
-
-`unknown`
-
-The array or object to check.
-
-#### expectedValues
-
-`unknown`[]
-
-The values that must all be present.
-
-### Returns
-
-`object`
-
-#### pass
-
-```ts
-pass: boolean = false;
-```
-
-#### message
-
-```ts
-message: () => string;
-```
-
-##### Returns
-
-`string`
-
-### toContainKey()
-
-```ts
-toContainKey(received, key): object;
-```
-
-Asserts that the received object contains the specified key.
-
-### Parameters
-
-#### received
-
-`object`
-
-The object to check.
-
-#### key
-
-`string`
-
-The key that should be present.
-
-### Returns
-
-`object`
-
-#### pass
-
-```ts
-pass: boolean = true;
-```
-
-#### message
-
-```ts
-message: () => string;
-```
-
-##### Returns
-
-`string`
-
-### toInclude()
-
-```ts
-toInclude(received, value): object;
-```
-
-Asserts that the received array, string, or object values include the specified value.
-
-### Parameters
-
-#### received
-
-`unknown`
-
-The array, string, or object to search within.
-
-#### value
-
-`any`
-
-The value to look for.
-
-### Returns
-
-`object`
-
-#### pass
-
-```ts
-pass: boolean;
-```
-
-#### message
-
-```ts
-message: () => string;
-```
-
-##### Returns
-
-`string`
-
-### toIncludeAllMembers()
-
-```ts
-toIncludeAllMembers(received, expected): ExpectationResult;
-```
-
-Asserts that the received array includes all members of the expected array.
-
-### Parameters
-
-#### received
-
-`unknown`[]
-
-The array to check.
-
-#### expected
-
-`unknown`[]
-
-The members that must all be present.
-
-### Returns
-
-[`ExpectationResult`](#../interfaces/ExpectationResult)
-
-### toContainAllKeys()
-
-```ts
-toContainAllKeys(received, expectedKeys): ExpectationResult;
-```
-
-Asserts that the received object contains all of the specified keys.
-
-### Parameters
-
-#### received
-
-`object`
-
-The object to check.
-
-#### expectedKeys
-
-`string`[]
-
-The keys that must all be present.
-
-### Returns
-
-[`ExpectationResult`](#../interfaces/ExpectationResult)
-
-### toContainValues()
-
-```ts
-toContainValues(received, expectedValues): ExpectationResult;
-```
-
-Asserts that the received object contains all of the specified values (using deep equality).
-
-### Parameters
-
-#### received
-
-`object`
-
-The object to check.
-
-#### expectedValues
-
-`unknown`[]
-
-The values that must all be present.
-
-### Returns
-
-[`ExpectationResult`](#../interfaces/ExpectationResult)
-
-### toBeEmpty()
-
-```ts
-toBeEmpty(received): ExpectationResult;
-```
-
-Asserts the received value is empty (zero-length array/string, empty object, or empty Map/Set).
-
-### Parameters
-
-#### received
-
-`unknown`
-
-The value to check.
-
-### Returns
-
-[`ExpectationResult`](#../interfaces/ExpectationResult)
-
-### toBeValidDate()
-
-```ts
-toBeValidDate(received): object;
-```
-
-Asserts the received value is a valid Date instance (not an invalid date).
-
-### Parameters
-
-#### received
-
-`unknown`
-
-The value to check.
-
-### Returns
-
-`object`
-
-#### pass
-
-```ts
-pass: boolean = isValid;
-```
-
-#### message
-
-```ts
-message: () => string;
-```
-
-##### Returns
-
-`string`
-
-## Credits
-
-[Made with 🔥 and ❄️ by XY Labs](https://xylabs.com)
-
-[npm-badge]: https://img.shields.io/npm/v/@xylabs/vitest-matchers.svg
-[npm-link]: https://www.npmjs.com/package/@xylabs/vitest-matchers
-[license-badge]: https://img.shields.io/npm/l/@xylabs/vitest-matchers.svg
-[license-link]: https://github.com/xylabs/sdk-js/blob/main/LICENSE
-[logo]: https://cdn.xy.company/img/brand/XYPersistentCompany_Logo_Icon_Colored.svg
+DEPRECATED — use `@ariestools/vitest-matchers` instead.

package/dist/neutral/index.d.ts

@@ -1,2 +1,2 @@
-export * from './customMatchers.ts';
+export * from '@ariestools/vitest-matchers';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAA"}

package/dist/neutral/index.mjs

@@ -1,369 +1,3 @@
-// src/customMatchers.ts
-var formatValue = (value) => {
-  if (typeof value === "string") return value;
-  if (typeof value === "number" && !Number.isFinite(value)) return String(value);
-  const json = JSON.stringify(value);
-  return json ?? String(value);
-};
-function toBeType(received, expectedType) {
-  const isPass = typeof received === expectedType && !Number.isNaN(received);
-  return isPass ? {
-    message: () => `expected ${formatValue(received)} not to be a ${expectedType}`,
-    pass: true
-  } : {
-    message: () => `expected ${formatValue(received)} to be a ${expectedType}`,
-    pass: false
-  };
-}
-var matchers = {
-  /**
-   * Asserts the received value is an array with the specified length.
-   * @param received - The value to check.
-   * @param expectedSize - The expected array length.
-   */
-  toBeArrayOfSize(received, expectedSize) {
-    const isPass = Array.isArray(received) && received.length === expectedSize;
-    return isPass ? {
-      message: () => `expected array not to have size ${expectedSize}, but received array of size ${received.length}`,
-      pass: true
-    } : {
-      message: () => Array.isArray(received) ? `expected array of size ${expectedSize}, but received array of size ${received.length}` : `expected array of size ${expectedSize}, but received a non-array`,
-      pass: false
-    };
-  },
-  /**
-   * Asserts the received value is an array.
-   * @param received - The value to check.
-   */
-  toBeArray(received) {
-    const isPass = Array.isArray(received);
-    return isPass ? {
-      message: () => "expected array",
-      pass: true
-    } : {
-      message: () => `expected array, but received ${typeof received}`,
-      pass: false
-    };
-  },
-  /**
-   * Asserts the received value is one of the values in the expected array.
-   * @param received - The value to check.
-   * @param expected - The array of acceptable values.
-   */
-  toBeOneOf(received, expected) {
-    const isPass = expected.includes(received);
-    return isPass ? {
-      pass: true,
-      message: () => `expected ${formatValue(received)} not to be one of ${JSON.stringify(expected)}`
-    } : {
-      pass: false,
-      message: () => `expected ${formatValue(received)} to be one of ${JSON.stringify(expected)}`
-    };
-  },
-  /**
-   * Asserts the received number is negative (less than zero).
-   * @param received - The number to check.
-   */
-  toBeNegative(received) {
-    if (typeof received !== "number") {
-      throw new TypeError(`Expected a number, but received ${typeof received}`);
-    }
-    const isPass = received < 0;
-    return isPass ? {
-      pass: true,
-      message: () => `expected ${received} not to be negative`
-    } : {
-      pass: false,
-      message: () => `expected ${received} to be negative`
-    };
-  },
-  /**
-   * Asserts the received number is positive (greater than zero).
-   * @param received - The number to check.
-   */
-  toBePositive(received) {
-    if (typeof received !== "number") {
-      throw new TypeError(`Expected a number, but received ${typeof received}`);
-    }
-    const isPass = received > 0;
-    return isPass ? {
-      pass: true,
-      message: () => `expected ${received} not to be positive`
-    } : {
-      pass: false,
-      message: () => `expected ${received} to be positive`
-    };
-  },
-  /**
-   * Asserts the received value is of type `number` and not NaN.
-   * @param received - The value to check.
-   */
-  toBeNumber: (received) => toBeType(received, "number"),
-  /**
-   * Asserts the received value is of type `function`.
-   * @param received - The value to check.
-   */
-  toBeFunction: (received) => toBeType(received, "function"),
-  /**
-   * Asserts the received value is of type `string`.
-   * @param received - The value to check.
-   */
-  toBeString: (received) => toBeType(received, "string"),
-  /**
-   * Asserts the received value is a plain object (not an array or null).
-   * @param received - The value to check.
-   */
-  toBeObject(received) {
-    const isPass = typeof received === "object" && !Array.isArray(received) && received !== null;
-    return isPass ? {
-      message: () => `expected ${formatValue(received)} to be object`,
-      pass: true
-    } : {
-      message: () => `expected ${formatValue(received)} to be an object but was ${Array.isArray(received) ? "array" : typeof received}`,
-      pass: false
-    };
-  },
-  /**
-   * Asserts the received number is an integer.
-   * @param received - The number to check.
-   */
-  toBeInteger(received) {
-    if (typeof received !== "number") {
-      throw new TypeError(`Expected a number, but received ${typeof received}`);
-    }
-    const isPass = Number.isSafeInteger(received);
-    return isPass ? {
-      pass: true,
-      message: () => `expected ${received} not to be an integer`
-    } : {
-      pass: false,
-      message: () => `expected ${received} to be an integer`
-    };
-  },
-  /**
-   * Asserts the received value is strictly `false`.
-   * @param received - The value to check.
-   */
-  toBeFalse(received) {
-    const isPass = received === false;
-    return isPass ? {
-      message: () => `expected ${formatValue(received)} to be false`,
-      pass: true
-    } : {
-      message: () => `expected ${formatValue(received)} to be false but was not false`,
-      pass: false
-    };
-  },
-  /**
-   * Asserts the received value is strictly `true`.
-   * @param received - The value to check.
-   */
-  toBeTrue(received) {
-    const isPass = received === true;
-    return isPass ? {
-      message: () => `expected ${formatValue(received)} to be true`,
-      pass: true
-    } : {
-      message: () => `expected ${formatValue(received)} to be true but was not true`,
-      pass: false
-    };
-  },
-  /**
-   * Asserts that all expected values are present in the received array or object values.
-   * @param received - The array or object to check.
-   * @param expectedValues - The values that must all be present.
-   */
-  toContainAllValues(received, expectedValues) {
-    let receivedValues;
-    if (Array.isArray(received)) {
-      receivedValues = received;
-    } else if (typeof received === "object" && received !== null) {
-      receivedValues = Object.values(received);
-    } else {
-      return {
-        pass: false,
-        message: () => `Expected an array or object, but received ${typeof received}.`
-      };
-    }
-    const isPass = expectedValues.every((value) => receivedValues.includes(value));
-    return {
-      pass: isPass,
-      message: () => isPass ? `Expected ${JSON.stringify(received)} not to contain all values ${JSON.stringify(expectedValues)}, but it does.` : `Expected ${JSON.stringify(received)} to contain all values ${JSON.stringify(expectedValues)}, but it does not.`
-    };
-  },
-  /**
-   * Asserts that the received object contains the specified key.
-   * @param received - The object to check.
-   * @param key - The key that should be present.
-   */
-  toContainKey(received, key) {
-    const isPass = Object.prototype.hasOwnProperty.call(received, key);
-    return isPass ? {
-      pass: true,
-      message: () => `Expected object not to contain key "${key}", but it does.`
-    } : {
-      pass: false,
-      message: () => `Expected object to contain key "${key}", but it does not.`
-    };
-  },
-  /**
-   * Asserts that the received array, string, or object values include the specified value.
-   * @param received - The array, string, or object to search within.
-   * @param value - The value to look for.
-   */
-  toInclude(received, value) {
-    let isPass;
-    if (Array.isArray(received)) {
-      isPass = received.includes(value);
-    } else if (typeof received === "string") {
-      isPass = received.includes(String(value));
-    } else if (typeof received === "object" && received !== null) {
-      isPass = Object.values(received).includes(value);
-    } else {
-      isPass = false;
-    }
-    return {
-      pass: isPass,
-      message: () => isPass ? `Expected ${JSON.stringify(received)} not to include ${JSON.stringify(value)}, but it does.` : `Expected ${JSON.stringify(received)} to include ${JSON.stringify(value)}, but it does not.`
-    };
-  },
-  /**
-   * Asserts that the received array includes all members of the expected array.
-   * @param received - The array to check.
-   * @param expected - The members that must all be present.
-   */
-  toIncludeAllMembers(received, expected) {
-    if (!Array.isArray(received) || !Array.isArray(expected)) {
-      return {
-        pass: false,
-        message: () => "Expected both received and expected values to be arrays."
-      };
-    }
-    const missingMembers = expected.filter((item) => !received.includes(item));
-    return missingMembers.length === 0 ? {
-      pass: true,
-      message: () => `Expected array not to include all members of ${JSON.stringify(expected)}, but it does.`
-    } : {
-      pass: false,
-      message: () => `Expected array to include all members of ${JSON.stringify(expected)}. Missing members: ${JSON.stringify(
-        missingMembers
-      )}.`
-    };
-  },
-  /**
-   * Asserts that the received object contains all of the specified keys.
-   * @param received - The object to check.
-   * @param expectedKeys - The keys that must all be present.
-   */
-  toContainAllKeys(received, expectedKeys) {
-    if (typeof received !== "object" || received === null) {
-      return {
-        pass: false,
-        message: () => `Expected ${JSON.stringify(received)} to be an object.`
-      };
-    }
-    if (!Array.isArray(expectedKeys)) {
-      return {
-        pass: false,
-        message: () => `Expected keys to be an array, but received ${JSON.stringify(expectedKeys)}.`
-      };
-    }
-    const missingKeys = expectedKeys.filter((key) => !Object.hasOwn(received, key));
-    return missingKeys.length === 0 ? {
-      pass: true,
-      message: () => `Expected object not to contain all keys ${JSON.stringify(expectedKeys)}, but it does.`
-    } : {
-      pass: false,
-      message: () => `Expected object to contain all keys ${JSON.stringify(expectedKeys)}. Missing keys: ${JSON.stringify(
-        missingKeys
-      )}.`
-    };
-  },
-  /**
-   * Asserts that the received object contains all of the specified values (using deep equality).
-   * @param received - The object to check.
-   * @param expectedValues - The values that must all be present.
-   */
-  toContainValues(received, expectedValues) {
-    if (typeof received !== "object" || received === null) {
-      return {
-        pass: false,
-        message: () => `Expected ${JSON.stringify(received)} to be an object.`
-      };
-    }
-    if (!Array.isArray(expectedValues)) {
-      return {
-        pass: false,
-        message: () => `Expected values to be an array, but received ${JSON.stringify(expectedValues)}.`
-      };
-    }
-    const objectValues = Object.values(received);
-    const deepEqual = (a, b) => {
-      if (a === b) return true;
-      if (typeof a !== typeof b) return false;
-      if (a !== null && b !== null && typeof a === "object" && typeof b === "object") {
-        const aKeys = Object.keys(a);
-        const bKeys = Object.keys(b);
-        if (aKeys.length !== bKeys.length) return false;
-        const aRecord = a;
-        const bRecord = b;
-        return aKeys.every((key) => deepEqual(aRecord[key], bRecord[key]));
-      }
-      return false;
-    };
-    const missingValues = expectedValues.filter(
-      (expectedValue) => objectValues.every((value) => !deepEqual(value, expectedValue))
-    );
-    return missingValues.length === 0 ? {
-      pass: true,
-      message: () => `Expected object not to contain all values ${JSON.stringify(expectedValues)}, but it does.`
-    } : {
-      pass: false,
-      message: () => `Expected object to contain all values ${JSON.stringify(expectedValues)}. Missing values: ${JSON.stringify(
-        missingValues
-      )}.`
-    };
-  },
-  /**
-   * Asserts the received value is empty (zero-length array/string, empty object, or empty Map/Set).
-   * @param received - The value to check.
-   */
-  toBeEmpty(received) {
-    const isEmpty = (() => {
-      if (Array.isArray(received) || typeof received === "string") {
-        return received.length === 0;
-      }
-      if (received !== null && typeof received === "object") {
-        return Object.keys(received).length === 0;
-      }
-    })();
-    if (isEmpty === void 0) {
-      return {
-        pass: false,
-        message: () => `Expected value to be an empty array, string, object, Map, or Set, but received ${typeof received}.`
-      };
-    }
-    return isEmpty ? {
-      pass: true,
-      message: () => "Expected value not to be empty, but it was."
-    } : {
-      pass: false,
-      message: () => "Expected value to be empty, but it was not."
-    };
-  },
-  /**
-   * Asserts the received value is a valid Date instance (not an invalid date).
-   * @param received - The value to check.
-   */
-  toBeValidDate(received) {
-    const isValid = received instanceof Date && !Number.isNaN(received.getTime());
-    return {
-      pass: isValid,
-      message: () => isValid ? `expected ${received.toISOString()} not to be a valid Date` : `expected ${formatValue(received)} to be a valid Date`
-    };
-  }
-};
-export {
-  matchers
-};
+// src/index.ts
+export * from "@ariestools/vitest-matchers";
 //# sourceMappingURL=index.mjs.map

package/dist/neutral/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/customMatchers.ts"],
-  "sourcesContent": ["/** Result returned by a custom matcher function. */\nexport interface ExpectationResult {\n  /** The actual value received by the matcher. */\n  actual?: unknown\n  /** The expected value the matcher compared against. */\n  expected?: unknown\n  /** Returns a human-readable failure or negation message. */\n  message: () => string\n  /** Whether the matcher assertion passed. */\n  pass: boolean\n}\n\nconst formatValue = (value: unknown): string => {\n  if (typeof value === 'string') return value\n  if (typeof value === 'number' && !Number.isFinite(value)) return String(value)\n  const json = JSON.stringify(value)\n  return json ?? String(value)\n}\n\n/**\n * Checks whether the received value matches the expected JavaScript type and is not NaN.\n * @param received - The value to check.\n * @param expectedType - The expected `typeof` string (e.g. 'number', 'string').\n * @returns An ExpectationResult indicating pass or fail.\n */\nfunction toBeType(received: unknown, expectedType: string): ExpectationResult {\n  const isPass = typeof received === expectedType && !Number.isNaN(received)\n  return isPass\n    ? {\n        message: () => `expected ${formatValue(received)} not to be a ${expectedType}`,\n        pass: true,\n      }\n    : {\n        message: () => `expected ${formatValue(received)} to be a ${expectedType}`,\n        pass: false,\n      }\n}\n\n/** Collection of custom Vitest matchers extending the built-in `expect` assertions. */\nexport const matchers = {\n  /**\n   * Asserts the received value is an array with the specified length.\n   * @param received - The value to check.\n   * @param expectedSize - The expected array length.\n   */\n  toBeArrayOfSize(received: unknown, expectedSize: number): ExpectationResult {\n    const isPass = Array.isArray(received) && received.length === expectedSize\n    return isPass\n      ? {\n          message: () => `expected array not to have size ${expectedSize}, but received array of size ${received.length}`,\n          pass: true,\n        }\n      : {\n          message: () => Array.isArray(received)\n            ? `expected array of size ${expectedSize}, but received array of size ${received.length}`\n            : `expected array of size ${expectedSize}, but received a non-array`,\n          pass: false,\n        }\n  },\n  /**\n   * Asserts the received value is an array.\n   * @param received - The value to check.\n   */\n  toBeArray(received: unknown): ExpectationResult {\n    const isPass = Array.isArray(received)\n    return isPass\n      ? {\n          message: () => 'expected array',\n          pass: true,\n        }\n      : {\n          message: () => `expected array, but received ${typeof received}`,\n          pass: false,\n        }\n  },\n  /**\n   * Asserts the received value is one of the values in the expected array.\n   * @param received - The value to check.\n   * @param expected - The array of acceptable values.\n   */\n  toBeOneOf(received: unknown, expected: unknown[]): ExpectationResult {\n    const isPass = expected.includes(received)\n    return isPass\n      ? {\n          pass: true,\n          message: () =>\n            `expected ${formatValue(received)} not to be one of ${JSON.stringify(expected)}`,\n        }\n      : {\n          pass: false,\n          message: () =>\n            `expected ${formatValue(received)} to be one of ${JSON.stringify(expected)}`,\n        }\n  },\n  /**\n   * Asserts the received number is negative (less than zero).\n   * @param received - The number to check.\n   */\n  toBeNegative(received: number): ExpectationResult {\n    if (typeof received !== 'number') {\n      throw new TypeError(`Expected a number, but received ${typeof received}`)\n    }\n\n    const isPass = received < 0\n    return isPass\n      ? {\n          pass: true,\n          message: () =>\n            `expected ${received} not to be negative`,\n        }\n      : {\n          pass: false,\n          message: () =>\n            `expected ${received} to be negative`,\n        }\n  },\n  /**\n   * Asserts the received number is positive (greater than zero).\n   * @param received - The number to check.\n   */\n  toBePositive(received: number): ExpectationResult {\n    if (typeof received !== 'number') {\n      throw new TypeError(`Expected a number, but received ${typeof received}`)\n    }\n\n    const isPass = received > 0\n    return isPass\n      ? {\n          pass: true,\n          message: () =>\n            `expected ${received} not to be positive`,\n        }\n      : {\n          pass: false,\n          message: () =>\n            `expected ${received} to be positive`,\n        }\n  },\n  /**\n   * Asserts the received value is of type `number` and not NaN.\n   * @param received - The value to check.\n   */\n  toBeNumber: (received: unknown) => toBeType(received, 'number'),\n  /**\n   * Asserts the received value is of type `function`.\n   * @param received - The value to check.\n   */\n  toBeFunction: (received: unknown) => toBeType(received, 'function'),\n  /**\n   * Asserts the received value is of type `string`.\n   * @param received - The value to check.\n   */\n  toBeString: (received: unknown) => toBeType(received, 'string'),\n  /**\n   * Asserts the received value is a plain object (not an array or null).\n   * @param received - The value to check.\n   */\n  toBeObject(received: unknown): ExpectationResult {\n    const isPass = typeof received === 'object' && !Array.isArray(received) && received !== null\n    return isPass\n      ? {\n          message: () => `expected ${formatValue(received)} to be object`,\n          pass: true,\n        }\n      : {\n          message: () => `expected ${formatValue(received)} to be an object but was ${Array.isArray(received) ? 'array' : typeof received}`,\n          pass: false,\n        }\n  },\n  /**\n   * Asserts the received number is an integer.\n   * @param received - The number to check.\n   */\n  toBeInteger(received: number): ExpectationResult {\n    if (typeof received !== 'number') {\n      throw new TypeError(`Expected a number, but received ${typeof received}`)\n    }\n\n    const isPass = Number.isSafeInteger(received)\n    return isPass\n      ? {\n          pass: true,\n          message: () =>\n            `expected ${received} not to be an integer`,\n        }\n      : {\n          pass: false,\n          message: () =>\n            `expected ${received} to be an integer`,\n        }\n  },\n  /**\n   * Asserts the received value is strictly `false`.\n   * @param received - The value to check.\n   */\n  toBeFalse(received: unknown): ExpectationResult {\n    const isPass = received === false\n    return isPass\n      ? {\n          message: () => `expected ${formatValue(received)} to be false`,\n          pass: true,\n        }\n      : {\n          message: () => `expected ${formatValue(received)} to be false but was not false`,\n          pass: false,\n        }\n  },\n  /**\n   * Asserts the received value is strictly `true`.\n   * @param received - The value to check.\n   */\n  toBeTrue(received: unknown): ExpectationResult {\n    const isPass = received === true\n    return isPass\n      ? {\n          message: () => `expected ${formatValue(received)} to be true`,\n          pass: true,\n        }\n      : {\n          message: () => `expected ${formatValue(received)} to be true but was not true`,\n          pass: false,\n        }\n  },\n  /**\n   * Asserts that all expected values are present in the received array or object values.\n   * @param received - The array or object to check.\n   * @param expectedValues - The values that must all be present.\n   */\n  toContainAllValues(received: unknown, expectedValues: unknown[]) {\n    let receivedValues: unknown[]\n\n    // Check if received is an array or an object\n    if (Array.isArray(received)) {\n      receivedValues = received\n    } else if (typeof received === 'object' && received !== null) {\n      receivedValues = Object.values(received)\n    } else {\n      return {\n        pass: false,\n        message: () => `Expected an array or object, but received ${typeof received}.`,\n      }\n    }\n\n    // Check if all expected values are in the received values\n    const isPass = expectedValues.every(value => receivedValues.includes(value))\n\n    return {\n      pass: isPass,\n      message: () =>\n        isPass\n          ? `Expected ${JSON.stringify(received)} not to contain all values ${JSON.stringify(expectedValues)}, but it does.`\n          : `Expected ${JSON.stringify(received)} to contain all values ${JSON.stringify(expectedValues)}, but it does not.`,\n    }\n  },\n  /**\n   * Asserts that the received object contains the specified key.\n   * @param received - The object to check.\n   * @param key - The key that should be present.\n   */\n  toContainKey(received: object, key: string) {\n    const isPass = Object.prototype.hasOwnProperty.call(received, key)\n    return isPass\n      ? {\n          pass: true,\n          message: () => `Expected object not to contain key \"${key}\", but it does.`,\n        }\n      : {\n          pass: false,\n          message: () => `Expected object to contain key \"${key}\", but it does not.`,\n        }\n  },\n  /**\n   * Asserts that the received array, string, or object values include the specified value.\n   * @param received - The array, string, or object to search within.\n   * @param value - The value to look for.\n   */\n  toInclude(received: unknown, value: unknown) {\n    let isPass: boolean\n\n    if (Array.isArray(received)) {\n      isPass = received.includes(value)\n    } else if (typeof received === 'string') {\n      isPass = received.includes(String(value))\n    } else if (typeof received === 'object' && received !== null) {\n      isPass = Object.values(received).includes(value)\n    } else {\n      isPass = false\n    }\n\n    return {\n      pass: isPass,\n      message: () =>\n        isPass\n          ? `Expected ${JSON.stringify(received)} not to include ${JSON.stringify(value)}, but it does.`\n          : `Expected ${JSON.stringify(received)} to include ${JSON.stringify(value)}, but it does not.`,\n    }\n  },\n  /**\n   * Asserts that the received array includes all members of the expected array.\n   * @param received - The array to check.\n   * @param expected - The members that must all be present.\n   */\n  toIncludeAllMembers(received: unknown[], expected: unknown[]): ExpectationResult {\n    if (!Array.isArray(received) || !Array.isArray(expected)) {\n      return {\n        pass: false,\n        message: () => 'Expected both received and expected values to be arrays.',\n      }\n    }\n\n    const missingMembers = expected.filter(item => !received.includes(item))\n\n    return missingMembers.length === 0\n      ? {\n          pass: true,\n          message: () =>\n            `Expected array not to include all members of ${JSON.stringify(expected)}, but it does.`,\n        }\n      : {\n          pass: false,\n          message: () =>\n            `Expected array to include all members of ${JSON.stringify(expected)}. Missing members: ${JSON.stringify(\n              missingMembers,\n            )}.`,\n        }\n  },\n  /**\n   * Asserts that the received object contains all of the specified keys.\n   * @param received - The object to check.\n   * @param expectedKeys - The keys that must all be present.\n   */\n  toContainAllKeys(received: object, expectedKeys: string[]): ExpectationResult {\n    if (typeof received !== 'object' || received === null) {\n      return {\n        pass: false,\n        message: () => `Expected ${JSON.stringify(received)} to be an object.`,\n      }\n    }\n\n    if (!Array.isArray(expectedKeys)) {\n      return {\n        pass: false,\n        message: () => `Expected keys to be an array, but received ${JSON.stringify(expectedKeys)}.`,\n      }\n    }\n\n    const missingKeys = expectedKeys.filter(key => !Object.hasOwn(received, key))\n\n    return missingKeys.length === 0\n      ? {\n          pass: true,\n          message: () =>\n            `Expected object not to contain all keys ${JSON.stringify(expectedKeys)}, but it does.`,\n        }\n      : {\n          pass: false,\n          message: () =>\n            `Expected object to contain all keys ${JSON.stringify(expectedKeys)}. Missing keys: ${JSON.stringify(\n              missingKeys,\n            )}.`,\n        }\n  },\n  /**\n   * Asserts that the received object contains all of the specified values (using deep equality).\n   * @param received - The object to check.\n   * @param expectedValues - The values that must all be present.\n   */\n  toContainValues(received: object, expectedValues: unknown[]): ExpectationResult {\n    if (typeof received !== 'object' || received === null) {\n      return {\n        pass: false,\n        message: () => `Expected ${JSON.stringify(received)} to be an object.`,\n      }\n    }\n\n    if (!Array.isArray(expectedValues)) {\n      return {\n        pass: false,\n        message: () => `Expected values to be an array, but received ${JSON.stringify(expectedValues)}.`,\n      }\n    }\n\n    const objectValues = Object.values(received)\n\n    const deepEqual = (a: unknown, b: unknown): boolean => {\n      if (a === b) return true\n      if (typeof a !== typeof b) return false\n      if (a !== null && b !== null && typeof a === 'object' && typeof b === 'object') {\n        const aKeys = Object.keys(a)\n        const bKeys = Object.keys(b)\n        if (aKeys.length !== bKeys.length) return false\n        const aRecord = a as Record<string, unknown>\n        const bRecord = b as Record<string, unknown>\n        return aKeys.every(key => deepEqual(aRecord[key], bRecord[key]))\n      }\n      return false\n    }\n\n    const missingValues = expectedValues.filter(\n      expectedValue => objectValues.every(value => !deepEqual(value, expectedValue)),\n    )\n\n    return missingValues.length === 0\n      ? {\n          pass: true,\n          message: () =>\n            `Expected object not to contain all values ${JSON.stringify(expectedValues)}, but it does.`,\n        }\n      : {\n          pass: false,\n          message: () =>\n            `Expected object to contain all values ${JSON.stringify(expectedValues)}. Missing values: ${JSON.stringify(\n              missingValues,\n            )}.`,\n        }\n  },\n  /**\n   * Asserts the received value is empty (zero-length array/string, empty object, or empty Map/Set).\n   * @param received - The value to check.\n   */\n  toBeEmpty(received: unknown): ExpectationResult {\n    const isEmpty = (() => {\n      if (Array.isArray(received) || typeof received === 'string') {\n        return received.length === 0\n      }\n      if (received !== null && typeof received === 'object') {\n        return Object.keys(received).length === 0\n      }\n    })()\n\n    if (isEmpty === undefined) {\n      return {\n        pass: false,\n        message: () =>\n          `Expected value to be an empty array, string, object, Map, or Set, but received ${typeof received}.`,\n      }\n    }\n\n    return isEmpty\n      ? {\n          pass: true,\n          message: () =>\n            'Expected value not to be empty, but it was.',\n        }\n      : {\n          pass: false,\n          message: () =>\n            'Expected value to be empty, but it was not.',\n        }\n  },\n  /**\n   * Asserts the received value is a valid Date instance (not an invalid date).\n   * @param received - The value to check.\n   */\n  toBeValidDate(\n    received: unknown,\n  ) {\n    const isValid\n      = received instanceof Date && !Number.isNaN(received.getTime())\n\n    return {\n      pass: isValid,\n      message: () =>\n        isValid\n          ? `expected ${received.toISOString()} not to be a valid Date`\n          : `expected ${formatValue(received)} to be a valid Date`,\n    }\n  },\n}\n"],
-  "mappings": "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",
+  "sources": ["../../src/index.ts"],
+  "sourcesContent": ["export * from '@ariestools/vitest-matchers'\n"],
+  "mappings": ";AAAA,cAAc;",
   "names": []
 }

package/dist/neutral/model.d.ts

@@ -1,2 +1,2 @@
-export type { ExpectationResult } from './customMatchers.ts';
+export * from '@ariestools/vitest-matchers/model';
 //# sourceMappingURL=model.d.ts.map

package/dist/neutral/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/model.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/model.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAA"}

package/dist/neutral/model.mjs

@@ -1 +1,3 @@
+// src/model.ts
+export * from "@ariestools/vitest-matchers/model";
 //# sourceMappingURL=model.mjs.map

package/dist/neutral/model.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": [],
-  "sourcesContent": [],
-  "mappings": "",
+  "sources": ["../../src/model.ts"],
+  "sourcesContent": ["export * from '@ariestools/vitest-matchers/model'\n"],
+  "mappings": ";AAAA,cAAc;",
   "names": []
 }

package/package.json

@@ -1,15 +1,11 @@
 {
   "name": "@xylabs/vitest-matchers",
-  "version": "7.0.7",
-  "description": "Base functionality used throughout XY Labs TypeScript/JavaScript libraries",
+  "version": "8.0.0",
+  "description": "DEPRECATED — use @ariestools/vitest-matchers. Backward-compatibility re-export shim.",
   "keywords": [
-    "log",
-    "logger",
-    "logging",
     "xylabs",
-    "utility",
-    "typescript",
-    "esm"
+    "deprecated",
+    "shim"
   ],
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -46,20 +42,22 @@
     "!**/*.test.*",
     "README.md"
   ],
+  "dependencies": {
+    "@ariestools/vitest-matchers": "~8.0.0"
+  },
   "devDependencies": {
     "@xylabs/toolchain": "~8.6.2",
     "@xylabs/tsconfig": "~8.6.2",
     "browserslist": "~4.28.4",
     "eslint": "~10.6.0",
     "eslint-import-resolver-typescript": "~4.4.5",
-    "typescript": "~6.0.3",
-    "vite": "~8.1.3",
-    "vitest": "~4.1.9"
+    "typescript": "~6.0.3"
   },
   "engines": {
     "node": ">=18"
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "deprecated": "Use @ariestools/vitest-matchers instead. @xylabs/vitest-matchers is a compatibility shim only and will not receive further updates."
 }

package/dist/neutral/customMatchers.d.ts

@@ -1,135 +0,0 @@
-/** Result returned by a custom matcher function. */
-export interface ExpectationResult {
-    /** The actual value received by the matcher. */
-    actual?: unknown;
-    /** The expected value the matcher compared against. */
-    expected?: unknown;
-    /** Returns a human-readable failure or negation message. */
-    message: () => string;
-    /** Whether the matcher assertion passed. */
-    pass: boolean;
-}
-/** Collection of custom Vitest matchers extending the built-in `expect` assertions. */
-export declare const matchers: {
-    /**
-     * Asserts the received value is an array with the specified length.
-     * @param received - The value to check.
-     * @param expectedSize - The expected array length.
-     */
-    toBeArrayOfSize(received: unknown, expectedSize: number): ExpectationResult;
-    /**
-     * Asserts the received value is an array.
-     * @param received - The value to check.
-     */
-    toBeArray(received: unknown): ExpectationResult;
-    /**
-     * Asserts the received value is one of the values in the expected array.
-     * @param received - The value to check.
-     * @param expected - The array of acceptable values.
-     */
-    toBeOneOf(received: unknown, expected: unknown[]): ExpectationResult;
-    /**
-     * Asserts the received number is negative (less than zero).
-     * @param received - The number to check.
-     */
-    toBeNegative(received: number): ExpectationResult;
-    /**
-     * Asserts the received number is positive (greater than zero).
-     * @param received - The number to check.
-     */
-    toBePositive(received: number): ExpectationResult;
-    /**
-     * Asserts the received value is of type `number` and not NaN.
-     * @param received - The value to check.
-     */
-    toBeNumber: (received: unknown) => ExpectationResult;
-    /**
-     * Asserts the received value is of type `function`.
-     * @param received - The value to check.
-     */
-    toBeFunction: (received: unknown) => ExpectationResult;
-    /**
-     * Asserts the received value is of type `string`.
-     * @param received - The value to check.
-     */
-    toBeString: (received: unknown) => ExpectationResult;
-    /**
-     * Asserts the received value is a plain object (not an array or null).
-     * @param received - The value to check.
-     */
-    toBeObject(received: unknown): ExpectationResult;
-    /**
-     * Asserts the received number is an integer.
-     * @param received - The number to check.
-     */
-    toBeInteger(received: number): ExpectationResult;
-    /**
-     * Asserts the received value is strictly `false`.
-     * @param received - The value to check.
-     */
-    toBeFalse(received: unknown): ExpectationResult;
-    /**
-     * Asserts the received value is strictly `true`.
-     * @param received - The value to check.
-     */
-    toBeTrue(received: unknown): ExpectationResult;
-    /**
-     * Asserts that all expected values are present in the received array or object values.
-     * @param received - The array or object to check.
-     * @param expectedValues - The values that must all be present.
-     */
-    toContainAllValues(received: unknown, expectedValues: unknown[]): {
-        pass: boolean;
-        message: () => string;
-    };
-    /**
-     * Asserts that the received object contains the specified key.
-     * @param received - The object to check.
-     * @param key - The key that should be present.
-     */
-    toContainKey(received: object, key: string): {
-        pass: boolean;
-        message: () => string;
-    };
-    /**
-     * Asserts that the received array, string, or object values include the specified value.
-     * @param received - The array, string, or object to search within.
-     * @param value - The value to look for.
-     */
-    toInclude(received: unknown, value: unknown): {
-        pass: boolean;
-        message: () => string;
-    };
-    /**
-     * Asserts that the received array includes all members of the expected array.
-     * @param received - The array to check.
-     * @param expected - The members that must all be present.
-     */
-    toIncludeAllMembers(received: unknown[], expected: unknown[]): ExpectationResult;
-    /**
-     * Asserts that the received object contains all of the specified keys.
-     * @param received - The object to check.
-     * @param expectedKeys - The keys that must all be present.
-     */
-    toContainAllKeys(received: object, expectedKeys: string[]): ExpectationResult;
-    /**
-     * Asserts that the received object contains all of the specified values (using deep equality).
-     * @param received - The object to check.
-     * @param expectedValues - The values that must all be present.
-     */
-    toContainValues(received: object, expectedValues: unknown[]): ExpectationResult;
-    /**
-     * Asserts the received value is empty (zero-length array/string, empty object, or empty Map/Set).
-     * @param received - The value to check.
-     */
-    toBeEmpty(received: unknown): ExpectationResult;
-    /**
-     * Asserts the received value is a valid Date instance (not an invalid date).
-     * @param received - The value to check.
-     */
-    toBeValidDate(received: unknown): {
-        pass: boolean;
-        message: () => string;
-    };
-};
-//# sourceMappingURL=customMatchers.d.ts.map

package/dist/neutral/customMatchers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"customMatchers.d.ts","sourceRoot":"","sources":["../../src/customMatchers.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,MAAM,CAAA;IACrB,4CAA4C;IAC5C,IAAI,EAAE,OAAO,CAAA;CACd;AA4BD,uFAAuF;AACvF,eAAO,MAAM,QAAQ;IACnB;;;;OAIG;8BACuB,OAAO,gBAAgB,MAAM,GAAG,iBAAiB;IAc3E;;;OAGG;wBACiB,OAAO,GAAG,iBAAiB;IAY/C;;;;OAIG;wBACiB,OAAO,YAAY,OAAO,EAAE,GAAG,iBAAiB;IAcpE;;;OAGG;2BACoB,MAAM,GAAG,iBAAiB;IAkBjD;;;OAGG;2BACoB,MAAM,GAAG,iBAAiB;IAkBjD;;;OAGG;2BACoB,OAAO;IAC9B;;;OAGG;6BACsB,OAAO;IAChC;;;OAGG;2BACoB,OAAO;IAC9B;;;OAGG;yBACkB,OAAO,GAAG,iBAAiB;IAYhD;;;OAGG;0BACmB,MAAM,GAAG,iBAAiB;IAkBhD;;;OAGG;wBACiB,OAAO,GAAG,iBAAiB;IAY/C;;;OAGG;uBACgB,OAAO,GAAG,iBAAiB;IAY9C;;;;OAIG;iCAC0B,OAAO,kBAAkB,OAAO,EAAE;;;;IA0B/D;;;;OAIG;2BACoB,MAAM,OAAO,MAAM;;;;IAY1C;;;;OAIG;wBACiB,OAAO,SAAS,OAAO;;;;IAqB3C;;;;OAIG;kCAC2B,OAAO,EAAE,YAAY,OAAO,EAAE,GAAG,iBAAiB;IAwBhF;;;;OAIG;+BACwB,MAAM,gBAAgB,MAAM,EAAE,GAAG,iBAAiB;IA+B7E;;;;OAIG;8BACuB,MAAM,kBAAkB,OAAO,EAAE,GAAG,iBAAiB;IAiD/E;;;OAGG;wBACiB,OAAO,GAAG,iBAAiB;IA8B/C;;;OAGG;4BAES,OAAO;;;;CAapB,CAAA"}