@augment-vir/assert 31.37.0 → 31.39.0

package/dist/assertions/equality/simple-equality.js

@@ -1,6 +1,7 @@
 import { stringify } from '@augment-vir/core';
 import deepEqual from 'deep-eql';
 import { AssertionError } from '../../augments/assertion.error.js';
+import { DiffError } from '../../augments/diff.error.js';
 import { createWaitUntil } from '../../guard-types/wait-until-function.js';
 function customComparator(a, b) {
     if (typeof a === 'function' && typeof b === 'function') {
@@ -37,7 +38,13 @@ const assertions = {
      */
     strictEquals(actual, expected, failureMessage) {
         if (actual !== expected) {
-            throw new AssertionError(`\n\n${stringify(actual)}\n\ndoes not strictly equal\n\n${stringify(expected)}\n\n`, failureMessage);
+            if ((typeof actual === 'object' && actual) ||
+                (typeof expected === 'object' && expected)) {
+                throw new AssertionError(`Strict reference equality failed for \n\n${stringify(expected)}\n\n.`, failureMessage);
+            }
+            else {
+                throw new DiffError('Not strictly equal.', actual, expected, failureMessage);
+            }
         }
     },
     /**
@@ -68,7 +75,12 @@ const assertions = {
      */
     notStrictEquals(actual, expected, failureMessage) {
         if (actual === expected) {
-            throw new AssertionError(`\n\n${stringify(actual)}\n\nstrictly equals\n\n${stringify(expected)}\n\n`, failureMessage);
+            if (typeof actual === 'object' && actual) {
+                throw new AssertionError(`Strict reference INequality failed for \n\n${stringify(expected)}\n\n.`, failureMessage);
+            }
+            else {
+                throw new AssertionError(`\n\n${stringify(actual)}\n\nstrictly equals\n\n${stringify(expected)}\n\n`, failureMessage);
+            }
         }
     },
     /**
@@ -99,7 +111,13 @@ const assertions = {
      */
     looseEquals(actual, expected, failureMessage) {
         if (actual != expected) {
-            throw new AssertionError(`\n\n${stringify(actual)}\n\ndoes not loosely equal\n\n${stringify(expected)}\n\n`, failureMessage);
+            if ((typeof actual === 'object' && actual) ||
+                (typeof expected === 'object' && expected)) {
+                throw new AssertionError(`Loose reference equality failed for \n\n${stringify(expected)}\n\n.`, failureMessage);
+            }
+            else {
+                throw new DiffError('Not loosely equal.', actual, expected, failureMessage);
+            }
         }
     },
     /**
@@ -130,7 +148,12 @@ const assertions = {
      */
     notLooseEquals(actual, expected, failureMessage) {
         if (actual == expected) {
-            throw new AssertionError(`\n\n${stringify(actual)}\n\nloosely equals\n\n${stringify(expected)}\n\n`, failureMessage);
+            if (typeof actual === 'object' && actual) {
+                throw new AssertionError(`Loose reference INequality failed for \n\n${stringify(expected)}\n\n.`, failureMessage);
+            }
+            else {
+                throw new AssertionError(`\n\n${stringify(actual)}\n\nloosely equals\n\n${stringify(expected)}\n\n`, failureMessage);
+            }
         }
     },
     /**
@@ -167,7 +190,7 @@ const assertions = {
         if (!deepEqual(actual, expected, {
             comparator: customComparator,
         })) {
-            throw new AssertionError(`\n\n${stringify(actual)}\n\ndoes not deeply equal\n\n${stringify(expected)}\n\n`, failureMessage);
+            throw new DiffError('Not deeply equal.', actual, expected, failureMessage);
         }
     },
     /**
@@ -425,8 +448,12 @@ export const simpleEqualityGuards = {
             if (actual === expected) {
                 return actual;
             }
+            else if ((typeof actual === 'object' && actual) ||
+                (typeof expected === 'object' && expected)) {
+                throw new AssertionError(`Strict reference equality failed for \n\n${stringify(expected)}\n\n.`, failureMessage);
+            }
             else {
-                throw new AssertionError(`\n\n${stringify(actual)}\n\ndoes not strictly equal\n\n${stringify(expected)}\n\n`, failureMessage);
+                throw new DiffError('Not strictly equal.', actual, expected, failureMessage);
             }
         },
         /**
@@ -458,7 +485,12 @@ export const simpleEqualityGuards = {
          */
         notStrictEquals(actual, expected, failureMessage) {
             if (actual === expected) {
-                throw new AssertionError(`\n\n${stringify(actual)}\n\nstrictly equals\n\n${stringify(expected)}\n\n`, failureMessage);
+                if (typeof actual === 'object' && actual) {
+                    throw new AssertionError(`Strict reference INequality failed for \n\n${stringify(expected)}\n\n.`, failureMessage);
+                }
+                else {
+                    throw new AssertionError(`\n\n${stringify(actual)}\n\nstrictly equals\n\n${stringify(expected)}\n\n`, failureMessage);
+                }
             }
             else {
                 return actual;
@@ -495,8 +527,12 @@ export const simpleEqualityGuards = {
             if (actual == expected) {
                 return actual;
             }
+            else if ((typeof actual === 'object' && actual) ||
+                (typeof expected === 'object' && expected)) {
+                throw new AssertionError(`Loose reference equality failed for \n\n${stringify(expected)}\n\n.`, failureMessage);
+            }
             else {
-                throw new AssertionError(`\n\n${stringify(actual)}\n\ndoes not loosely equal\n\n${stringify(expected)}\n\n`, failureMessage);
+                throw new DiffError('Not loosely equal.', actual, expected, failureMessage);
             }
         },
         /**
@@ -528,7 +564,12 @@ export const simpleEqualityGuards = {
          */
         notLooseEquals(actual, expected, failureMessage) {
             if (actual == expected) {
-                throw new AssertionError(`\n\n${stringify(actual)}\n\nloosely equals\n\n${stringify(expected)}\n\n`, failureMessage);
+                if (typeof actual === 'object' && actual) {
+                    throw new AssertionError(`Loose reference INequality failed for \n\n${stringify(expected)}\n\n.`, failureMessage);
+                }
+                else {
+                    throw new AssertionError(`\n\n${stringify(actual)}\n\nloosely equals\n\n${stringify(expected)}\n\n`, failureMessage);
+                }
             }
             else {
                 return actual;
@@ -572,7 +613,7 @@ export const simpleEqualityGuards = {
                 return actual;
             }
             else {
-                throw new AssertionError(`\n\n${stringify(actual)}\n\ndoes not deeply equal\n\n${stringify(expected)}\n\n`, failureMessage);
+                throw new DiffError('Not deeply equal.', actual, expected, failureMessage);
             }
         },
         /**

package/dist/augments/diff.error.d.ts

@@ -0,0 +1,5 @@
+import { AssertionError } from './assertion.error.js';
+export declare class DiffError extends AssertionError {
+    name: string;
+    constructor(baseMessage: string, actual: unknown, expected: unknown, userCustomizedMessage: string | undefined);
+}

package/dist/augments/diff.error.js

@@ -0,0 +1,12 @@
+import { indent, prettyDiff } from '@augment-vir/core';
+import { AssertionError } from './assertion.error.js';
+export class DiffError extends AssertionError {
+    name = 'DiffError';
+    constructor(baseMessage, actual, expected, userCustomizedMessage) {
+        const diffString = prettyDiff(actual, expected);
+        super([
+            baseMessage,
+            indent(diffString),
+        ].join('\n'), userCustomizedMessage);
+    }
+}

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { type Primitive } from 'type-fest';
 export * from './augments/assertion-exports.js';
 export * from './augments/assertion.error.js';
 export * from './augments/custom-equality.js';
+export * from './augments/diff.error.js';
 export * from './augments/guards/assert-wrap.js';
 export * from './augments/guards/assert.js';
 export * from './augments/guards/check-wrap.js';

package/dist/index.js

@@ -1,6 +1,7 @@
 export * from './augments/assertion-exports.js';
 export * from './augments/assertion.error.js';
 export * from './augments/custom-equality.js';
+export * from './augments/diff.error.js';
 export * from './augments/guards/assert-wrap.js';
 export * from './augments/guards/assert.js';
 export * from './augments/guards/check-wrap.js';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@augment-vir/assert",
-    "version": "31.37.0",
+    "version": "31.39.0",
     "description": "A collection of assertions for test and production code alike.",
     "keywords": [
         "augment",
@@ -42,11 +42,11 @@
         "test:update": "npm test"
     },
     "dependencies": {
-        "@augment-vir/core": "^31.37.0",
+        "@augment-vir/core": "^31.39.0",
         "@date-vir/duration": "^7.4.2",
         "deep-eql": "^5.0.2",
         "expect-type": "^1.2.2",
-        "type-fest": "^5.0.0"
+        "type-fest": "^5.0.1"
     },
     "devDependencies": {
         "@types/deep-eql": "^4.0.2",
@@ -57,7 +57,7 @@
         "@web/test-runner-visual-regression": "^0.10.0",
         "c8": "^10.1.3",
         "istanbul-smart-text-reporter": "^1.1.5",
-        "typescript": "^5.9.2"
+        "typescript": "^5.9.3"
     },
     "engines": {
         "node": ">=22"