@fgv/ts-utils-jest 5.0.0-15 → 5.0.0-17

package/README.md

@@ -16,6 +16,7 @@ Also includes a handful of custom matchers to simplify the testing of other cust
 - [Summary](#summary)
 - [Installation](#installation)
 - [Setup](#setup)
+  - [ANSI Color Stripping](#ansi-color-stripping)
 - [API](#api)
   - [Testing Result\<T\>](#testing-resultt)
     - [.toFail()](#tofail)
@@ -43,6 +44,16 @@ npm install --save-dev @fgv/ts-utils-jest
 
 Note that snapshot testing for Jest itself can be tricky because different environments (e.g. CLI vs IDE vs CICD) might generate slightly different output due to e.g. differences in color display of diffs.   To facilitate snapshot testing across multiple environments, this library also provides an extensible set of snapshot resolvers that can be used to capture environment-specific snapshots.
 
+### ANSI Color Stripping
+
+**All matchers in this library automatically strip ANSI color codes** from Jest output to ensure consistent snapshots across different terminal environments. This includes:
+
+- **Jest matcher utilities** (`printExpected`, `printReceived`) used in error messages
+- **Snapshot content** passed to `toMatchSnapshot()` and `toFailTestAndMatchSnapshot()`
+- **Test failure messages** captured by custom matcher testing utilities
+
+This means you can run tests with any terminal color settings (`FORCE_COLOR=0`, `FORCE_COLOR=1`, or default) and get identical snapshot results. No special configuration is required - the color stripping happens automatically.
+
 ## API
 
 ### Testing Result\<T\>

package/config/jest-disable-colors.js

@@ -0,0 +1,34 @@
+// Disable colors in Jest to ensure consistent snapshot behavior
+// This setup file ensures that Jest matchers don't include ANSI color codes
+// in their output, which was causing snapshot test failures when running
+// via different environments (direct Jest vs Heft/Rush)
+
+// Force Jest to not use colors
+process.env.FORCE_COLOR = '0';
+
+// Monkey patch the jest-matcher-utils functions to remove colors
+const matcherUtils = require('jest-matcher-utils');
+
+// Store original functions
+const originalPrintExpected = matcherUtils.printExpected;
+const originalPrintReceived = matcherUtils.printReceived;
+const originalMatcherHint = matcherUtils.matcherHint;
+
+// Override with non-colored versions
+matcherUtils.printExpected = function (value) {
+  // Remove ANSI color codes from the output
+  const result = originalPrintExpected.call(this, value);
+  return result.replace(/\x1b\[[0-9;]*m/g, '');
+};
+
+matcherUtils.printReceived = function (value) {
+  // Remove ANSI color codes from the output
+  const result = originalPrintReceived.call(this, value);
+  return result.replace(/\x1b\[[0-9;]*m/g, '');
+};
+
+matcherUtils.matcherHint = function (matcherName, received, expected, options) {
+  // Remove ANSI color codes from the output
+  const result = originalMatcherHint.call(this, matcherName, received, expected, options);
+  return result.replace(/\x1b\[[0-9;]*m/g, '');
+};

package/lib/matchers/toFailTestAndMatchSnapshot/index.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const jest_snapshot_1 = require("jest-snapshot");
 const predicate_1 = require("./predicate");
 const jest_matcher_utils_1 = require("jest-matcher-utils");
+const colorHelpers_1 = require("../../utils/colorHelpers");
 exports.default = {
     toFailTestAndMatchSnapshot: function (cb) {
         const context = this;
@@ -20,7 +21,7 @@ exports.default = {
                 }
             };
         }
-        return jest_snapshot_1.toMatchSnapshot.call(context, cbResult.value, 'toFailTestAndMatchSnapshot');
+        return jest_snapshot_1.toMatchSnapshot.call(context, (0, colorHelpers_1.stripAnsiColors)(cbResult.value), 'toFailTestAndMatchSnapshot');
     }
 };
 //# sourceMappingURL=index.js.map

package/lib/utils/colorHelpers.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Utility functions for handling ANSI color codes in test output.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Strips ANSI color/style escape sequences from a string.
+ *
+ * This function removes all ANSI escape sequences commonly used for
+ * terminal colors and text styling, making the output suitable for
+ * color-agnostic snapshot testing.
+ *
+ * @param text - The text that may contain ANSI escape sequences
+ * @returns The text with all ANSI escape sequences removed
+ *
+ * @example
+ * ```typescript
+ * const coloredText = '\u001b[31mError:\u001b[39m Something failed';
+ * const plainText = stripAnsiColors(coloredText);
+ * console.log(plainText); // "Error: Something failed"
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Common usage in Jest matchers
+ * const formattedOutput = matcherUtils.printReceived(value);
+ * const cleanOutput = stripAnsiColors(formattedOutput);
+ * expect(cleanOutput).toMatchSnapshot();
+ * ```
+ *
+ * @public
+ */
+export declare function stripAnsiColors(text: string): string;
+/**
+ * Creates a wrapper function that strips ANSI colors from any string-returning function.
+ *
+ * This is useful for wrapping Jest matcher utility functions to make them
+ * color-agnostic for snapshot testing.
+ *
+ * @param fn - A function that returns a string (potentially with ANSI colors)
+ * @returns A wrapped function that returns the same string with colors stripped
+ *
+ * @example
+ * ```typescript
+ * import { printReceived } from 'jest-matcher-utils';
+ *
+ * const printReceivedClean = createColorStripWrapper(printReceived);
+ * const output = printReceivedClean(someValue); // No colors
+ * ```
+ *
+ * @public
+ */
+export declare function createColorStripWrapper<T extends (...args: unknown[]) => string>(fn: T): T;
+//# sourceMappingURL=colorHelpers.d.ts.map

package/lib/utils/colorHelpers.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * Utility functions for handling ANSI color codes in test output.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripAnsiColors = stripAnsiColors;
+exports.createColorStripWrapper = createColorStripWrapper;
+/**
+ * Regular expression to match ANSI color/style escape sequences.
+ *
+ * This matches:
+ * - ESC character (ASCII 27) followed by `[`
+ * - `[0-9;]*` - Zero or more digits and semicolons (parameters)
+ * - `[a-zA-Z]` - Single letter command (m for SGR, K for erase, etc.)
+ *
+ * Examples of what this matches:
+ * - `\u001b[31m` - Red foreground
+ * - `\u001b[39m` - Default foreground
+ * - `\u001b[2m` - Dim/faint
+ * - `\u001b[22m` - Normal intensity
+ *
+ * Using a pre-compiled regex literal to satisfy ESLint security requirements.
+ * We use the unicode escape sequence \\u001b instead of \\x1b to avoid control-regex warnings.
+ */
+// eslint-disable-next-line @rushstack/security/no-unsafe-regexp, no-control-regex
+const ANSI_COLOR_REGEX = /\u001b\[[0-9;]*[a-zA-Z]/g;
+/**
+ * Strips ANSI color/style escape sequences from a string.
+ *
+ * This function removes all ANSI escape sequences commonly used for
+ * terminal colors and text styling, making the output suitable for
+ * color-agnostic snapshot testing.
+ *
+ * @param text - The text that may contain ANSI escape sequences
+ * @returns The text with all ANSI escape sequences removed
+ *
+ * @example
+ * ```typescript
+ * const coloredText = '\u001b[31mError:\u001b[39m Something failed';
+ * const plainText = stripAnsiColors(coloredText);
+ * console.log(plainText); // "Error: Something failed"
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Common usage in Jest matchers
+ * const formattedOutput = matcherUtils.printReceived(value);
+ * const cleanOutput = stripAnsiColors(formattedOutput);
+ * expect(cleanOutput).toMatchSnapshot();
+ * ```
+ *
+ * @public
+ */
+function stripAnsiColors(text) {
+    return text.replace(ANSI_COLOR_REGEX, '');
+}
+/**
+ * Creates a wrapper function that strips ANSI colors from any string-returning function.
+ *
+ * This is useful for wrapping Jest matcher utility functions to make them
+ * color-agnostic for snapshot testing.
+ *
+ * @param fn - A function that returns a string (potentially with ANSI colors)
+ * @returns A wrapped function that returns the same string with colors stripped
+ *
+ * @example
+ * ```typescript
+ * import { printReceived } from 'jest-matcher-utils';
+ *
+ * const printReceivedClean = createColorStripWrapper(printReceived);
+ * const output = printReceivedClean(someValue); // No colors
+ * ```
+ *
+ * @public
+ */
+function createColorStripWrapper(fn) {
+    return ((...args) => {
+        const result = fn(...args);
+        return stripAnsiColors(result);
+    });
+}
+//# sourceMappingURL=colorHelpers.js.map

package/lib/utils/matcherHelpers.js

@@ -5,8 +5,12 @@ exports.printExpectedDetailedResult = printExpectedDetailedResult;
 exports.printReceivedResult = printReceivedResult;
 exports.printReceivedDetailedResult = printReceivedDetailedResult;
 const jest_matcher_utils_1 = require("jest-matcher-utils");
+const colorHelpers_1 = require("./colorHelpers");
+// Create color-stripped versions of Jest matcher utilities
+const printExpectedClean = (0, colorHelpers_1.createColorStripWrapper)(jest_matcher_utils_1.printExpected);
+const printReceivedClean = (0, colorHelpers_1.createColorStripWrapper)(jest_matcher_utils_1.printReceived);
 function printExpectedValue(outcome, expected) {
-    return expected !== undefined ? `  ${outcome} with ${(0, jest_matcher_utils_1.printExpected)(expected)}` : `  ${outcome}`;
+    return expected !== undefined ? `  ${outcome} with ${printExpectedClean(expected)}` : `  ${outcome}`;
 }
 function printExpectedResult(expect, isNot, expected) {
     return [
@@ -31,14 +35,14 @@ function printExpectedDetailedResult(expect, isNot, expectedMessage, expectedDet
             : expect === 'success'
                 ? printExpectedValue('Not success', expectedMessage)
                 : printExpectedValue('Not failure', expectedMessage),
-        `  Detail: "${(0, jest_matcher_utils_1.printExpected)(expectedDetail)}"`
+        `  Detail: "${printExpectedClean(expectedDetail)}"`
     ].join('\n');
 }
 function printReceivedResult(received) {
     return [
         'Received:',
         received.isSuccess()
-            ? `  Success with ${(0, jest_matcher_utils_1.printReceived)(received.value)}`
+            ? `  Success with ${printReceivedClean(received.value)}`
             : `  Failure with "${received.message}"`
     ].join('\n');
 }
@@ -46,8 +50,8 @@ function printReceivedDetailedResult(received) {
     return [
         'Received:',
         received.isSuccess()
-            ? `  Success with "${(0, jest_matcher_utils_1.printReceived)(received.value)}"\n  Detail: "${(0, jest_matcher_utils_1.printReceived)(received.detail)}"`
-            : `  Failure with "${received.message}"\n  Detail: "${(0, jest_matcher_utils_1.printReceived)(received.detail)}"`
+            ? `  Success with "${printReceivedClean(received.value)}"\n  Detail: "${printReceivedClean(received.detail)}"`
+            : `  Failure with "${received.message}"\n  Detail: "${printReceivedClean(received.detail)}"`
     ].join('\n');
 }
 //# sourceMappingURL=matcherHelpers.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fgv/ts-utils-jest",
-  "version": "5.0.0-15",
+  "version": "5.0.0-17",
   "description": "Custom matchers for ts-utils result class",
   "main": "lib/index.js",
   "keywords": [
@@ -42,10 +42,10 @@
     "@types/heft-jest": "1.0.6",
     "eslint-plugin-n": "^16.6.2",
     "eslint-plugin-tsdoc": "~0.4.0",
-    "@fgv/ts-utils": "5.0.0-15"
+    "@fgv/ts-utils": "5.0.0-17"
   },
   "peerDependencies": {
-    "@fgv/ts-utils": "5.0.0-15"
+    "@fgv/ts-utils": "5.0.0-17"
   },
   "scripts": {
     "build": "heft build --clean",

package/src/__snapshots__/index.test.ts.snap

@@ -1,10 +1,10 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`verify matchers accessibility toFailTestAndMatchSnapshot exists and works: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).toBe(expected) // Object.is equality
+"expect(received).toBe(expected) // Object.is equality
 
-Expected: false
-Received: true"
+Expected: false
+Received: true"
 `;
 
 exports[`verify matchers accessibility toSucceedAndMatchSnapshot exists and works: toSucceedAndMatchSnapshot 1`] = `

package/src/matchers/toFail/__snapshots__/index.test.ts.snap

@@ -1,7 +1,7 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`.toFail reports details for a failed test with .not: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).not.toFail(expected)
+"expect(received).not.toFail(expected)
 Expected:
   Not failure
 Received:
@@ -9,9 +9,9 @@ Received:
 `;
 
 exports[`.toFail reports details for a failed test: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).toFail(expected)
+"expect(received).toFail(expected)
 Expected:
   Failure
 Received:
-  Success with \\"hello\\""
+  Success with \\"hello\\""
 `;

package/src/matchers/toFailTest/__snapshots__/index.test.ts.snap

@@ -1,14 +1,14 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`.toFailTest logs details correctly for a failed .not result: toFailTestAndMatchSnapshot 1`] = `
-"expect(callback).not.toFailTest(expected)
+"expect(callback).not.toFailTest(expected)
 Expected:
   Not failure
   Received: Test failed"
 `;
 
 exports[`.toFailTest logs details correctly for a failed result: toFailTestAndMatchSnapshot 1`] = `
-"expect(callback).toFailTest(expected)
+"expect(callback).toFailTest(expected)
 Expected:
   Failure
   Received: Test passed"

package/src/matchers/toFailTestAndMatchSnapshot/__snapshots__/index.test.ts.snap

@@ -1,14 +1,14 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`.toFailTestAndMatchSnapshot logs details correctly for a failed result: toFailTestAndMatchSnapshot 1`] = `
-"expect(callback).toFailTestAndMatchSnapshot(expected)
+"expect(callback).toFailTestAndMatchSnapshot(expected)
   Expected: Callback to fail with an error that matches snapshot
   Received: Callback succeeded"
 `;
 
 exports[`.toFailTestAndMatchSnapshot passes for a test that fails with a result matching the snapshot: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).toBe(expected) // Object.is equality
+"expect(received).toBe(expected) // Object.is equality
 
-Expected: false
-Received: true"
+Expected: false
+Received: true"
 `;

package/src/matchers/toFailTestAndMatchSnapshot/index.ts

@@ -3,6 +3,7 @@ import { Context, toMatchSnapshot } from 'jest-snapshot';
 import { matcherName, predicate } from './predicate';
 
 import { matcherHint } from 'jest-matcher-utils';
+import { stripAnsiColors } from '../../utils/colorHelpers';
 
 declare global {
   // eslint-disable-next-line @typescript-eslint/no-namespace
@@ -40,7 +41,7 @@ export default {
     }
     return toMatchSnapshot.call(
       context,
-      cbResult.value,
+      stripAnsiColors(cbResult.value),
       'toFailTestAndMatchSnapshot'
     ) as jest.CustomMatcherResult;
   }

package/src/matchers/toFailTestWith/__snapshots__/index.test.ts.snap

@@ -1,34 +1,34 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`.toFailTestWith logs failure correctly when callback fails with .not: toFailTestAndMatchSnapshot 1`] = `
-"expect(callback).not.toFailTestWith(expectedMessage)
+"expect(callback).not.toFailTestWith(expectedMessage)
 Expected:
-  Not failure with /expect/i
+  Not failure with /expect/i
   Received: Callback failed with:
 >>>>
-expect(received).toBe(expected) // Object.is equality
+expect(received).toBe(expected) // Object.is equality
 
-Expected: false
-Received: true
+Expected: false
+Received: true
 <<<<"
 `;
 
 exports[`.toFailTestWith logs failure correctly when callback returns an unexpected value: toFailTestAndMatchSnapshot 1`] = `
-"expect(callback).toFailTestWith(expectedMessage)
+"expect(callback).toFailTestWith(expectedMessage)
 Expected:
-  Failure with /random text/i
+  Failure with /random text/i
   Received: Callback failed with:
 >>>>
-expect(received).toBe(expected) // Object.is equality
+expect(received).toBe(expected) // Object.is equality
 
-Expected: \\"goodbye\\"
-Received: \\"hello\\"
+Expected: \\"goodbye\\"
+Received: \\"hello\\"
 <<<<"
 `;
 
 exports[`.toFailTestWith logs failure correctly when callback succeeds: toFailTestAndMatchSnapshot 1`] = `
-"expect(callback).toFailTestWith(expectedMessage)
+"expect(callback).toFailTestWith(expectedMessage)
 Expected:
-  Failure with \\"whatever\\"
+  Failure with \\"whatever\\"
   Received: Callback succeeded"
 `;

package/src/matchers/toFailWith/__snapshots__/index.test.ts.snap

@@ -1,25 +1,25 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`.toFailWith reports details correctly on a failure due to a success result: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).toFailWith(expected)
+"expect(received).toFailWith(expected)
 Expected:
-  Failure with \\"hello\\"
+  Failure with \\"hello\\"
 Received:
-  Success with \\"hello\\""
+  Success with \\"hello\\""
 `;
 
 exports[`.toFailWith reports details correctly on a failure due to non-matching failure value: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).toFailWith(expected)
+"expect(received).toFailWith(expected)
 Expected:
-  Failure with \\"error\\"
+  Failure with \\"error\\"
 Received:
   Failure with \\"oops\\""
 `;
 
 exports[`.toFailWith reports details correctly on a failure with a .not: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).not.toFailWith(expected)
+"expect(received).not.toFailWith(expected)
 Expected:
-  Not failure with \\"oops\\"
+  Not failure with \\"oops\\"
 Received:
   Failure with \\"oops\\""
 `;

package/src/matchers/toFailWithDetail/__snapshots__/index.test.ts.snap

@@ -1,41 +1,41 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`.toFailWithDetail reports details correctly on a failure due to a success result: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).toFailWith(expected)
+"expect(received).toFailWith(expected)
 Expected:
-  Failure with \\"hello\\"
-  Detail: \\"\\"detail\\"\\"
+  Failure with \\"hello\\"
+  Detail: \\"\\"detail\\"\\"
 Received:
-  Success with \\"\\"hello\\"\\"
-  Detail: \\"undefined\\""
+  Success with \\"\\"hello\\"\\"
+  Detail: \\"undefined\\""
 `;
 
 exports[`.toFailWithDetail reports details correctly on a failure due to non-matching detail value: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).toFailWith(expected)
+"expect(received).toFailWith(expected)
 Expected:
-  Failure with \\"error\\"
-  Detail: \\"\\"detail\\"\\"
+  Failure with \\"error\\"
+  Detail: \\"\\"detail\\"\\"
 Received:
   Failure with \\"error\\"
-  Detail: \\"\\"other detail\\"\\""
+  Detail: \\"\\"other detail\\"\\""
 `;
 
 exports[`.toFailWithDetail reports details correctly on a failure due to non-matching failure value: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).toFailWith(expected)
+"expect(received).toFailWith(expected)
 Expected:
-  Failure with \\"error\\"
-  Detail: \\"\\"detail\\"\\"
+  Failure with \\"error\\"
+  Detail: \\"\\"detail\\"\\"
 Received:
   Failure with \\"oops\\"
-  Detail: \\"\\"detail\\"\\""
+  Detail: \\"\\"detail\\"\\""
 `;
 
 exports[`.toFailWithDetail reports details correctly on a failure with a .not: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).not.toFailWith(expected)
+"expect(received).not.toFailWith(expected)
 Expected:
-  Not failure with \\"oops\\"
-  Detail: \\"\\"detail\\"\\"
+  Not failure with \\"oops\\"
+  Detail: \\"\\"detail\\"\\"
 Received:
   Failure with \\"oops\\"
-  Detail: \\"\\"detail\\"\\""
+  Detail: \\"\\"detail\\"\\""
 `;

package/src/matchers/toHaveBeenCalledWithArgumentsMatching/__snapshots__/index.test.ts.snap

@@ -1,77 +1,77 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`.toHaveBeenCalledWithArgumentsMatching reports a helpful message if a .not test fails with few calls 1`] = `
-"expect(received).not.toHaveBeenCalledWithArgumentsMatching(expected)
+"expect(received).not.toHaveBeenCalledWithArgumentsMatching(expected)
 Expected no call with arguments matching:
-      [Any<String>]
+      [Any<String>]
 Received (1 total):
-*000: [\\"arg1\\"]"
+*000: [\\"arg1\\"]"
 `;
 
 exports[`.toHaveBeenCalledWithArgumentsMatching reports a helpful message if a .not test fails with many calls "for a call in the middle" 1`] = `
-"expect(received).not.toHaveBeenCalledWithArgumentsMatching(expected)
+"expect(received).not.toHaveBeenCalledWithArgumentsMatching(expected)
 Expected no call with arguments matching:
-      [\\"arg3\\"]
+      [\\"arg3\\"]
 Received (7 total):
- 002: [\\"arg2\\"]
-*003: [\\"arg3\\"]
- 004: [\\"arg4\\"]"
+ 002: [\\"arg2\\"]
+*003: [\\"arg3\\"]
+ 004: [\\"arg4\\"]"
 `;
 
 exports[`.toHaveBeenCalledWithArgumentsMatching reports a helpful message if a .not test fails with many calls "for the first call" 1`] = `
-"expect(received).not.toHaveBeenCalledWithArgumentsMatching(expected)
+"expect(received).not.toHaveBeenCalledWithArgumentsMatching(expected)
 Expected no call with arguments matching:
-      [\\"arg0\\"]
+      [\\"arg0\\"]
 Received (7 total):
-*000: [\\"arg0\\"]
- 001: [\\"arg1\\"]
- 002: [\\"arg2\\"]"
+*000: [\\"arg0\\"]
+ 001: [\\"arg1\\"]
+ 002: [\\"arg2\\"]"
 `;
 
 exports[`.toHaveBeenCalledWithArgumentsMatching reports a helpful message if a .not test fails with many calls "for the last call" 1`] = `
-"expect(received).not.toHaveBeenCalledWithArgumentsMatching(expected)
+"expect(received).not.toHaveBeenCalledWithArgumentsMatching(expected)
 Expected no call with arguments matching:
-      [\\"arg6\\"]
+      [\\"arg6\\"]
 Received (7 total):
- 004: [\\"arg4\\"]
- 005: [\\"arg5\\"]
-*006: [\\"arg6\\"]"
+ 004: [\\"arg4\\"]
+ 005: [\\"arg5\\"]
+*006: [\\"arg6\\"]"
 `;
 
 exports[`.toHaveBeenCalledWithArgumentsMatching reports a helpful message if a .not test fails with many calls "for the second call" 1`] = `
-"expect(received).not.toHaveBeenCalledWithArgumentsMatching(expected)
+"expect(received).not.toHaveBeenCalledWithArgumentsMatching(expected)
 Expected no call with arguments matching:
-      [StringMatching /1/]
+      [StringMatching /1/]
 Received (7 total):
- 000: [\\"arg0\\"]
-*001: [\\"arg1\\"]
- 002: [\\"arg2\\"]"
+ 000: [\\"arg0\\"]
+*001: [\\"arg1\\"]
+ 002: [\\"arg2\\"]"
 `;
 
 exports[`.toHaveBeenCalledWithArgumentsMatching reports a helpful message if a .not test fails with many calls "for the second-to-last-call" 1`] = `
-"expect(received).not.toHaveBeenCalledWithArgumentsMatching(expected)
+"expect(received).not.toHaveBeenCalledWithArgumentsMatching(expected)
 Expected no call with arguments matching:
-      [\\"arg5\\"]
+      [\\"arg5\\"]
 Received (7 total):
- 004: [\\"arg4\\"]
-*005: [\\"arg5\\"]
- 006: [\\"arg6\\"]"
+ 004: [\\"arg4\\"]
+*005: [\\"arg5\\"]
+ 006: [\\"arg6\\"]"
 `;
 
 exports[`.toHaveBeenCalledWithArgumentsMatching reports a helpful message if a call is not matched 1`] = `
-"expect(received).toHaveBeenCalledWithArgumentsMatching(expected)
+"expect(received).toHaveBeenCalledWithArgumentsMatching(expected)
 Expected call with arguments matching:
-      [\\"call7\\"]
+      [\\"call7\\"]
 Received (6 total):
- 003: [\\"call4\\"]
- 004: [\\"call5\\"]
- 005: [\\"call6\\"]"
+ 003: [\\"call4\\"]
+ 004: [\\"call5\\"]
+ 005: [\\"call6\\"]"
 `;
 
 exports[`.toHaveBeenCalledWithArgumentsMatching reports a helpful message if function was not called 1`] = `
-"expect(received).toHaveBeenCalledWithArgumentsMatching(expected)
+"expect(received).toHaveBeenCalledWithArgumentsMatching(expected)
 Expected call with arguments matching:
-      [\\"call7\\"]
+      [\\"call7\\"]
 Received (0 total):"
 `;
 

package/src/matchers/toSucceed/__snapshots__/index.test.ts.snap

@@ -1,15 +1,15 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`.toSucceed reports details for a failed .not test: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).not.toSucceed(expected)
+"expect(received).not.toSucceed(expected)
 Expected:
   Not success
 Received:
-  Success with \\"hello\\""
+  Success with \\"hello\\""
 `;
 
 exports[`.toSucceed reports details for a failed test: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).toSucceed(expected)
+"expect(received).toSucceed(expected)
 Expected:
   Success
 Received:

package/src/matchers/toSucceedAndMatchInlineSnapshot/__snapshots__/index.test.ts.snap

@@ -1,7 +1,7 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`.toSucceedAndMatchSnapshot logs details correctly for a failed result: toFailTestAndMatchSnapshot 1`] = `
-"expect(callback).toSucceedAndMatchInlineSnapshot(expected)
+"expect(callback).toSucceedAndMatchInlineSnapshot(expected)
 Expected:
   Callback to succeed with a result that matches the snapshot
 Received:
@@ -9,7 +9,7 @@ Received:
 `;
 
 exports[`.toSucceedAndMatchSnapshot logs details correctly for a failed result: toFailTestAndMatchSnapshot 2`] = `
-"expect(received).not.toMatchInlineSnapshot(properties, snapshot)
+"expect(received).not.toMatchInlineSnapshot(properties, snapshot)
 
-Matcher error: Snapshot matchers cannot be used with not"
+Matcher error: Snapshot matchers cannot be used with not"
 `;

package/src/matchers/toSucceedAndMatchSnapshot/__snapshots__/index.test.ts.snap

@@ -1,7 +1,7 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`.toSucceedAndMatchSnapshot logs details correctly for a failed result: toFailTestAndMatchSnapshot 1`] = `
-"expect(callback).toSucceedAndMatchSnapshot(expected)
+"expect(callback).toSucceedAndMatchSnapshot(expected)
 Expected:
   Callback to succeed with a result that matches the snapshot
 Received:
@@ -9,9 +9,9 @@ Received:
 `;
 
 exports[`.toSucceedAndMatchSnapshot logs details correctly for a failed result: toFailTestAndMatchSnapshot 2`] = `
-"expect(received).not.toMatchSnapshot(hint)
+"expect(received).not.toMatchSnapshot(hint)
 
-Matcher error: Snapshot matchers cannot be used with not"
+Matcher error: Snapshot matchers cannot be used with not"
 `;
 
 exports[`.toSucceedAndMatchSnapshot passes for a success result that matches the snapshot: toSucceedAndMatchSnapshot 1`] = `

package/src/matchers/toSucceedAndSatisfy/__snapshots__/index.test.ts.snap

@@ -1,37 +1,37 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`.toSucceedAndSatisfy reports details when callback fails an expectation: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).toBe(expected) // Object.is equality
+"expect(received).toBe(expected) // Object.is equality
 
-Expected: \\"goodbye\\"
-Received: \\"hello\\""
+Expected: \\"goodbye\\"
+Received: \\"hello\\""
 `;
 
 exports[`.toSucceedAndSatisfy reports details when callback returns false: toFailTestAndMatchSnapshot 1`] = `
-"expect(result).toSucceedAndSatisfy(callback)
+"expect(result).toSucceedAndSatisfy(callback)
 Expected:
-  Success with \\"successful callback\\"
+  Success with \\"successful callback\\"
 Received:
-  Success with \\"hello\\"
+  Success with \\"hello\\"
   Callback returned false"
 `;
 
 exports[`.toSucceedAndSatisfy reports details when callback throws an exception: toFailTestAndMatchSnapshot 1`] = `"UH OH AN ERROR"`;
 
 exports[`.toSucceedAndSatisfy reports details when received is a failure result: toFailTestAndMatchSnapshot 1`] = `
-"expect(result).toSucceedAndSatisfy(callback)
+"expect(result).toSucceedAndSatisfy(callback)
 Expected:
-  Success with \\"successful callback\\"
+  Success with \\"successful callback\\"
 Received:
   Failure with \\"oops\\"
   Callback was not invoked"
 `;
 
 exports[`.toSucceedAndSatisfy reports details with success and .not: toFailTestAndMatchSnapshot 1`] = `
-"expect(result).not.toSucceedAndSatisfy(callback)
+"expect(result).not.toSucceedAndSatisfy(callback)
 Expected:
-  Not success with \\"successful callback\\"
+  Not success with \\"successful callback\\"
 Received:
-  Success with \\"hello\\"
+  Success with \\"hello\\"
   Callback returned true"
 `;

package/src/matchers/toSucceedWith/__snapshots__/index.test.ts.snap

@@ -1,25 +1,25 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`.toSucceedWith reports details when it fails due to a failure result: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).toSucceedWith(expected)
+"expect(received).toSucceedWith(expected)
 Expected:
-  Success with \\"oops\\"
+  Success with \\"oops\\"
 Received:
   Failure with \\"oops\\""
 `;
 
 exports[`.toSucceedWith reports details when it fails due to a success result with .not: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).not.toSucceedWith(expected)
+"expect(received).not.toSucceedWith(expected)
 Expected:
-  Not success with \\"hello\\"
+  Not success with \\"hello\\"
 Received:
-  Success with \\"hello\\""
+  Success with \\"hello\\""
 `;
 
 exports[`.toSucceedWith reports details when it fails due to success with a non-matching value: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).toSucceedWith(expected)
+"expect(received).toSucceedWith(expected)
 Expected:
-  Success with \\"goodbye\\"
+  Success with \\"goodbye\\"
 Received:
-  Success with \\"hello\\""
+  Success with \\"hello\\""
 `;

package/src/matchers/toSucceedWithDetail/__snapshots__/index.test.ts.snap

@@ -1,41 +1,41 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`.toSucceedWithDetail reports details when it fails due to a failure result: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).toSucceedWithDetail(expected)
+"expect(received).toSucceedWithDetail(expected)
 Expected:
-  Success with \\"oops\\"
-  Detail: \\"\\"detail\\"\\"
+  Success with \\"oops\\"
+  Detail: \\"\\"detail\\"\\"
 Received:
   Failure with \\"oops\\"
-  Detail: \\"\\"detail\\"\\""
+  Detail: \\"\\"detail\\"\\""
 `;
 
 exports[`.toSucceedWithDetail reports details when it fails due to a success result with .not: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).not.toSucceedWithDetail(expected)
+"expect(received).not.toSucceedWithDetail(expected)
 Expected:
-  Not success with \\"hello\\"
-  Detail: \\"\\"detail\\"\\"
+  Not success with \\"hello\\"
+  Detail: \\"\\"detail\\"\\"
 Received:
-  Success with \\"\\"hello\\"\\"
-  Detail: \\"\\"detail\\"\\""
+  Success with \\"\\"hello\\"\\"
+  Detail: \\"\\"detail\\"\\""
 `;
 
 exports[`.toSucceedWithDetail reports details when it fails due to success with a non-matching detail: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).toSucceedWithDetail(expected)
+"expect(received).toSucceedWithDetail(expected)
 Expected:
-  Success with \\"hello\\"
-  Detail: \\"\\"other detail\\"\\"
+  Success with \\"hello\\"
+  Detail: \\"\\"other detail\\"\\"
 Received:
-  Success with \\"\\"hello\\"\\"
-  Detail: \\"\\"detail\\"\\""
+  Success with \\"\\"hello\\"\\"
+  Detail: \\"\\"detail\\"\\""
 `;
 
 exports[`.toSucceedWithDetail reports details when it fails due to success with a non-matching value: toFailTestAndMatchSnapshot 1`] = `
-"expect(received).toSucceedWithDetail(expected)
+"expect(received).toSucceedWithDetail(expected)
 Expected:
-  Success with \\"goodbye\\"
-  Detail: \\"\\"detail\\"\\"
+  Success with \\"goodbye\\"
+  Detail: \\"\\"detail\\"\\"
 Received:
-  Success with \\"\\"hello\\"\\"
-  Detail: \\"\\"detail\\"\\""
+  Success with \\"\\"hello\\"\\"
+  Detail: \\"\\"detail\\"\\""
 `;

package/src/utils/colorHelpers.ts

@@ -0,0 +1,82 @@
+/**
+ * Utility functions for handling ANSI color codes in test output.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Regular expression to match ANSI color/style escape sequences.
+ *
+ * This matches:
+ * - ESC character (ASCII 27) followed by `[`
+ * - `[0-9;]*` - Zero or more digits and semicolons (parameters)
+ * - `[a-zA-Z]` - Single letter command (m for SGR, K for erase, etc.)
+ *
+ * Examples of what this matches:
+ * - `\u001b[31m` - Red foreground
+ * - `\u001b[39m` - Default foreground
+ * - `\u001b[2m` - Dim/faint
+ * - `\u001b[22m` - Normal intensity
+ *
+ * Using a pre-compiled regex literal to satisfy ESLint security requirements.
+ * We use the unicode escape sequence \\u001b instead of \\x1b to avoid control-regex warnings.
+ */
+// eslint-disable-next-line @rushstack/security/no-unsafe-regexp, no-control-regex
+const ANSI_COLOR_REGEX: RegExp = /\u001b\[[0-9;]*[a-zA-Z]/g;
+
+/**
+ * Strips ANSI color/style escape sequences from a string.
+ *
+ * This function removes all ANSI escape sequences commonly used for
+ * terminal colors and text styling, making the output suitable for
+ * color-agnostic snapshot testing.
+ *
+ * @param text - The text that may contain ANSI escape sequences
+ * @returns The text with all ANSI escape sequences removed
+ *
+ * @example
+ * ```typescript
+ * const coloredText = '\u001b[31mError:\u001b[39m Something failed';
+ * const plainText = stripAnsiColors(coloredText);
+ * console.log(plainText); // "Error: Something failed"
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Common usage in Jest matchers
+ * const formattedOutput = matcherUtils.printReceived(value);
+ * const cleanOutput = stripAnsiColors(formattedOutput);
+ * expect(cleanOutput).toMatchSnapshot();
+ * ```
+ *
+ * @public
+ */
+export function stripAnsiColors(text: string): string {
+  return text.replace(ANSI_COLOR_REGEX, '');
+}
+
+/**
+ * Creates a wrapper function that strips ANSI colors from any string-returning function.
+ *
+ * This is useful for wrapping Jest matcher utility functions to make them
+ * color-agnostic for snapshot testing.
+ *
+ * @param fn - A function that returns a string (potentially with ANSI colors)
+ * @returns A wrapped function that returns the same string with colors stripped
+ *
+ * @example
+ * ```typescript
+ * import { printReceived } from 'jest-matcher-utils';
+ *
+ * const printReceivedClean = createColorStripWrapper(printReceived);
+ * const output = printReceivedClean(someValue); // No colors
+ * ```
+ *
+ * @public
+ */
+export function createColorStripWrapper<T extends (...args: unknown[]) => string>(fn: T): T {
+  return ((...args: Parameters<T>) => {
+    const result = fn(...args);
+    return stripAnsiColors(result);
+  }) as T;
+}

package/src/utils/matcherHelpers.ts

@@ -1,8 +1,13 @@
 import { printExpected, printReceived } from 'jest-matcher-utils';
 import { DetailedResult, Result } from '../ts-utils';
+import { createColorStripWrapper } from './colorHelpers';
+
+// Create color-stripped versions of Jest matcher utilities
+const printExpectedClean: typeof printExpected = createColorStripWrapper(printExpected);
+const printReceivedClean: typeof printReceived = createColorStripWrapper(printReceived);
 
 function printExpectedValue<T>(outcome: string, expected?: T): string {
-  return expected !== undefined ? `  ${outcome} with ${printExpected(expected)}` : `  ${outcome}`;
+  return expected !== undefined ? `  ${outcome} with ${printExpectedClean(expected)}` : `  ${outcome}`;
 }
 
 export function printExpectedResult<T>(expect: 'success' | 'failure', isNot: boolean, expected?: T): string {
@@ -34,7 +39,7 @@ export function printExpectedDetailedResult<T, TD>(
       : expect === 'success'
       ? printExpectedValue('Not success', expectedMessage)
       : printExpectedValue('Not failure', expectedMessage),
-    `  Detail: "${printExpected(expectedDetail)}"`
+    `  Detail: "${printExpectedClean(expectedDetail)}"`
   ].join('\n');
 }
 
@@ -42,7 +47,7 @@ export function printReceivedResult<T>(received: Result<T>): string {
   return [
     'Received:',
     received.isSuccess()
-      ? `  Success with ${printReceived(received.value)}`
+      ? `  Success with ${printReceivedClean(received.value)}`
       : `  Failure with "${received.message}"`
   ].join('\n');
 }
@@ -51,7 +56,9 @@ export function printReceivedDetailedResult<T, TD>(received: DetailedResult<T, T
   return [
     'Received:',
     received.isSuccess()
-      ? `  Success with "${printReceived(received.value)}"\n  Detail: "${printReceived(received.detail)}"`
-      : `  Failure with "${received.message}"\n  Detail: "${printReceived(received.detail)}"`
+      ? `  Success with "${printReceivedClean(received.value)}"\n  Detail: "${printReceivedClean(
+          received.detail
+        )}"`
+      : `  Failure with "${received.message}"\n  Detail: "${printReceivedClean(received.detail)}"`
   ].join('\n');
 }