@wordpress/jest-console 8.37.0 → 8.37.1-next.06ee73755.0

package/LICENSE.md

@@ -1,6 +1,6 @@
 ## Gutenberg
 
-    Copyright 2016-2025 by the contributors
+    Copyright 2016-2026 by the contributors
 
 **License for Contributions (on and after April 15, 2021)**
 

package/build/declarations.d.cjs

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=declarations.d.cjs.map

package/build/{index.js → index.cjs}

@@ -23,8 +23,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // packages/jest-console/src/index.ts
-var import_matchers = require("./matchers");
-var import_supported_matchers = __toESM(require("./supported-matchers"));
+var import_matchers = require("./matchers.cjs");
+var import_supported_matchers = __toESM(require("./supported-matchers.cjs"));
 var setConsoleMethodSpy = (args) => {
   const [methodName, matcherName] = args;
   const spy = jest.spyOn(console, methodName).mockName(`console.${methodName}`);
@@ -34,7 +34,8 @@ var setConsoleMethodSpy = (args) => {
   }
   function assertExpectedCalls() {
     if (spy.assertionsNumber === 0 && spy.mock.calls.length > 0) {
-      expect(console).not[matcherName]();
+      const name = matcherName;
+      expect(console).not[name]();
     }
   }
   beforeAll(resetSpy);
@@ -45,4 +46,4 @@ var setConsoleMethodSpy = (args) => {
   afterEach(assertExpectedCalls);
 };
 Object.entries(import_supported_matchers.default).forEach(setConsoleMethodSpy);
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map

package/build/{index.js.map → index.cjs.map}

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["/**\n * Internal dependencies\n */\nimport './matchers';\nimport supportedMatchers from './supported-matchers';\nimport type { ExtendedMock } from './types';\n\n/**\n * Sets spy on the console object's method to make it possible to fail test when method called without assertion.\n *\n * @param args\n */\nconst setConsoleMethodSpy = ( args: [ string, string ] ) => {\n\tconst [ methodName, matcherName ] = args;\n\tconst spy = jest\n\t\t.spyOn( console, methodName as 'error' | 'info' | 'log' | 'warn' )\n\t\t.mockName( `console.${ methodName }` ) as ExtendedMock;\n\n\t/**\n\t * Resets the spy to its initial state.\n\t */\n\tfunction resetSpy() {\n\t\tspy.mockReset();\n\t\tspy.assertionsNumber = 0;\n\t}\n\n\t/**\n\t * Verifies that the spy has only been called if expected.\n\t */\n\tfunction assertExpectedCalls() {\n\t\tif ( spy.assertionsNumber === 0 && spy.mock.calls.length > 0 ) {\n\t\t\texpect( console ).not[ matcherName ]();\n\t\t}\n\t}\n\n\tbeforeAll( resetSpy );\n\n\tbeforeEach( () => {\n\t\tassertExpectedCalls();\n\t\tresetSpy();\n\t} );\n\n\tafterEach( assertExpectedCalls );\n};\n\nObject.entries( supportedMatchers ).forEach( setConsoleMethodSpy );\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;AAGA,sBAAO;AACP,gCAA8B;AAQ9B,IAAM,sBAAsB,CAAE,SAA8B;AAC3D,QAAM,CAAE,YAAY,WAAY,IAAI;AACpC,QAAM,MAAM,KACV,MAAO,SAAS,UAAgD,EAChE,SAAU,WAAY,UAAW,EAAG;AAKtC,WAAS,WAAW;AACnB,QAAI,UAAU;AACd,QAAI,mBAAmB;AAAA,EACxB;AAKA,WAAS,sBAAsB;AAC9B,QAAK,IAAI,qBAAqB,KAAK,IAAI,KAAK,MAAM,SAAS,GAAI;AAC9D,aAAQ,OAAQ,EAAE,IAAK,WAAY,EAAE;AAAA,IACtC;AAAA,EACD;AAEA,YAAW,QAAS;AAEpB,aAAY,MAAM;AACjB,wBAAoB;AACpB,aAAS;AAAA,EACV,CAAE;AAEF,YAAW,mBAAoB;AAChC;AAEA,OAAO,QAAS,0BAAAA,OAAkB,EAAE,QAAS,mBAAoB;",
+  "sourcesContent": ["/**\n * Internal dependencies\n */\nimport './matchers';\nimport supportedMatchers from './supported-matchers';\nimport type { ExtendedMock } from './types';\n\n/**\n * Sets spy on the console object's method to make it possible to fail test when method called without assertion.\n *\n * @param args\n */\nconst setConsoleMethodSpy = ( args: [ string, string ] ) => {\n\tconst [ methodName, matcherName ] = args;\n\tconst spy = jest\n\t\t.spyOn( console, methodName as 'error' | 'info' | 'log' | 'warn' )\n\t\t.mockName( `console.${ methodName }` ) as ExtendedMock;\n\n\t/**\n\t * Resets the spy to its initial state.\n\t */\n\tfunction resetSpy() {\n\t\tspy.mockReset();\n\t\tspy.assertionsNumber = 0;\n\t}\n\n\t/**\n\t * Verifies that the spy has only been called if expected.\n\t */\n\tfunction assertExpectedCalls() {\n\t\tif ( spy.assertionsNumber === 0 && spy.mock.calls.length > 0 ) {\n\t\t\t// Using 'as' to satisfy TypeScript compiler about the matcher name.\n\t\t\ttype MatcherName = `toHave${\n\t\t\t\t| 'Errored'\n\t\t\t\t| 'Informed'\n\t\t\t\t| 'Logged'\n\t\t\t\t| 'Warned' }`;\n\t\t\tconst name = matcherName as MatcherName;\n\n\t\t\texpect( console ).not[ name ]();\n\t\t}\n\t}\n\n\tbeforeAll( resetSpy );\n\n\tbeforeEach( () => {\n\t\tassertExpectedCalls();\n\t\tresetSpy();\n\t} );\n\n\tafterEach( assertExpectedCalls );\n};\n\nObject.entries( supportedMatchers ).forEach( setConsoleMethodSpy );\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;AAGA,sBAAO;AACP,gCAA8B;AAQ9B,IAAM,sBAAsB,CAAE,SAA8B;AAC3D,QAAM,CAAE,YAAY,WAAY,IAAI;AACpC,QAAM,MAAM,KACV,MAAO,SAAS,UAAgD,EAChE,SAAU,WAAY,UAAW,EAAG;AAKtC,WAAS,WAAW;AACnB,QAAI,UAAU;AACd,QAAI,mBAAmB;AAAA,EACxB;AAKA,WAAS,sBAAsB;AAC9B,QAAK,IAAI,qBAAqB,KAAK,IAAI,KAAK,MAAM,SAAS,GAAI;AAO9D,YAAM,OAAO;AAEb,aAAQ,OAAQ,EAAE,IAAK,IAAK,EAAE;AAAA,IAC/B;AAAA,EACD;AAEA,YAAW,QAAS;AAEpB,aAAY,MAAM;AACjB,wBAAoB;AACpB,aAAS;AAAA,EACV,CAAE;AAEF,YAAW,mBAAoB;AAChC;AAEA,OAAO,QAAS,0BAAAA,OAAkB,EAAE,QAAS,mBAAoB;",
   "names": ["supportedMatchers"]
 }

package/build/{matchers.js → matchers.cjs}

@@ -24,7 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 // packages/jest-console/src/matchers.ts
 var import_jest_matcher_utils = require("jest-matcher-utils");
-var import_supported_matchers = __toESM(require("./supported-matchers"));
+var import_supported_matchers = __toESM(require("./supported-matchers.cjs"));
 var createErrorMessage = (spyInfo) => {
   const { spy, pass, calls, matcherName, methodName, expected } = spyInfo;
   const hint = pass ? `.not${matcherName}` : matcherName;
@@ -90,4 +90,4 @@ expect.extend(
     {}
   )
 );
-//# sourceMappingURL=matchers.js.map
+//# sourceMappingURL=matchers.cjs.map

package/build/{supported-matchers.js → supported-matchers.cjs}

@@ -30,4 +30,4 @@ var supportedMatchers = {
   warn: "toHaveWarned"
 };
 var supported_matchers_default = supportedMatchers;
-//# sourceMappingURL=supported-matchers.js.map
+//# sourceMappingURL=supported-matchers.cjs.map

package/build/{types.js → types.cjs}

@@ -16,4 +16,4 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // packages/jest-console/src/types.ts
 var types_exports = {};
 module.exports = __toCommonJS(types_exports);
-//# sourceMappingURL=types.js.map
+//# sourceMappingURL=types.cjs.map

package/build-module/declarations.d.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=declarations.d.mjs.map

package/build-module/{index.js → index.mjs}

@@ -1,6 +1,6 @@
 // packages/jest-console/src/index.ts
-import "./matchers";
-import supportedMatchers from "./supported-matchers";
+import "./matchers.mjs";
+import supportedMatchers from "./supported-matchers.mjs";
 var setConsoleMethodSpy = (args) => {
   const [methodName, matcherName] = args;
   const spy = jest.spyOn(console, methodName).mockName(`console.${methodName}`);
@@ -10,7 +10,8 @@ var setConsoleMethodSpy = (args) => {
   }
   function assertExpectedCalls() {
     if (spy.assertionsNumber === 0 && spy.mock.calls.length > 0) {
-      expect(console).not[matcherName]();
+      const name = matcherName;
+      expect(console).not[name]();
     }
   }
   beforeAll(resetSpy);
@@ -21,4 +22,4 @@ var setConsoleMethodSpy = (args) => {
   afterEach(assertExpectedCalls);
 };
 Object.entries(supportedMatchers).forEach(setConsoleMethodSpy);
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.mjs.map

package/build-module/{index.js.map → index.mjs.map}

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["/**\n * Internal dependencies\n */\nimport './matchers';\nimport supportedMatchers from './supported-matchers';\nimport type { ExtendedMock } from './types';\n\n/**\n * Sets spy on the console object's method to make it possible to fail test when method called without assertion.\n *\n * @param args\n */\nconst setConsoleMethodSpy = ( args: [ string, string ] ) => {\n\tconst [ methodName, matcherName ] = args;\n\tconst spy = jest\n\t\t.spyOn( console, methodName as 'error' | 'info' | 'log' | 'warn' )\n\t\t.mockName( `console.${ methodName }` ) as ExtendedMock;\n\n\t/**\n\t * Resets the spy to its initial state.\n\t */\n\tfunction resetSpy() {\n\t\tspy.mockReset();\n\t\tspy.assertionsNumber = 0;\n\t}\n\n\t/**\n\t * Verifies that the spy has only been called if expected.\n\t */\n\tfunction assertExpectedCalls() {\n\t\tif ( spy.assertionsNumber === 0 && spy.mock.calls.length > 0 ) {\n\t\t\texpect( console ).not[ matcherName ]();\n\t\t}\n\t}\n\n\tbeforeAll( resetSpy );\n\n\tbeforeEach( () => {\n\t\tassertExpectedCalls();\n\t\tresetSpy();\n\t} );\n\n\tafterEach( assertExpectedCalls );\n};\n\nObject.entries( supportedMatchers ).forEach( setConsoleMethodSpy );\n"],
-  "mappings": ";AAGA,OAAO;AACP,OAAO,uBAAuB;AAQ9B,IAAM,sBAAsB,CAAE,SAA8B;AAC3D,QAAM,CAAE,YAAY,WAAY,IAAI;AACpC,QAAM,MAAM,KACV,MAAO,SAAS,UAAgD,EAChE,SAAU,WAAY,UAAW,EAAG;AAKtC,WAAS,WAAW;AACnB,QAAI,UAAU;AACd,QAAI,mBAAmB;AAAA,EACxB;AAKA,WAAS,sBAAsB;AAC9B,QAAK,IAAI,qBAAqB,KAAK,IAAI,KAAK,MAAM,SAAS,GAAI;AAC9D,aAAQ,OAAQ,EAAE,IAAK,WAAY,EAAE;AAAA,IACtC;AAAA,EACD;AAEA,YAAW,QAAS;AAEpB,aAAY,MAAM;AACjB,wBAAoB;AACpB,aAAS;AAAA,EACV,CAAE;AAEF,YAAW,mBAAoB;AAChC;AAEA,OAAO,QAAS,iBAAkB,EAAE,QAAS,mBAAoB;",
+  "sourcesContent": ["/**\n * Internal dependencies\n */\nimport './matchers';\nimport supportedMatchers from './supported-matchers';\nimport type { ExtendedMock } from './types';\n\n/**\n * Sets spy on the console object's method to make it possible to fail test when method called without assertion.\n *\n * @param args\n */\nconst setConsoleMethodSpy = ( args: [ string, string ] ) => {\n\tconst [ methodName, matcherName ] = args;\n\tconst spy = jest\n\t\t.spyOn( console, methodName as 'error' | 'info' | 'log' | 'warn' )\n\t\t.mockName( `console.${ methodName }` ) as ExtendedMock;\n\n\t/**\n\t * Resets the spy to its initial state.\n\t */\n\tfunction resetSpy() {\n\t\tspy.mockReset();\n\t\tspy.assertionsNumber = 0;\n\t}\n\n\t/**\n\t * Verifies that the spy has only been called if expected.\n\t */\n\tfunction assertExpectedCalls() {\n\t\tif ( spy.assertionsNumber === 0 && spy.mock.calls.length > 0 ) {\n\t\t\t// Using 'as' to satisfy TypeScript compiler about the matcher name.\n\t\t\ttype MatcherName = `toHave${\n\t\t\t\t| 'Errored'\n\t\t\t\t| 'Informed'\n\t\t\t\t| 'Logged'\n\t\t\t\t| 'Warned' }`;\n\t\t\tconst name = matcherName as MatcherName;\n\n\t\t\texpect( console ).not[ name ]();\n\t\t}\n\t}\n\n\tbeforeAll( resetSpy );\n\n\tbeforeEach( () => {\n\t\tassertExpectedCalls();\n\t\tresetSpy();\n\t} );\n\n\tafterEach( assertExpectedCalls );\n};\n\nObject.entries( supportedMatchers ).forEach( setConsoleMethodSpy );\n"],
+  "mappings": ";AAGA,OAAO;AACP,OAAO,uBAAuB;AAQ9B,IAAM,sBAAsB,CAAE,SAA8B;AAC3D,QAAM,CAAE,YAAY,WAAY,IAAI;AACpC,QAAM,MAAM,KACV,MAAO,SAAS,UAAgD,EAChE,SAAU,WAAY,UAAW,EAAG;AAKtC,WAAS,WAAW;AACnB,QAAI,UAAU;AACd,QAAI,mBAAmB;AAAA,EACxB;AAKA,WAAS,sBAAsB;AAC9B,QAAK,IAAI,qBAAqB,KAAK,IAAI,KAAK,MAAM,SAAS,GAAI;AAO9D,YAAM,OAAO;AAEb,aAAQ,OAAQ,EAAE,IAAK,IAAK,EAAE;AAAA,IAC/B;AAAA,EACD;AAEA,YAAW,QAAS;AAEpB,aAAY,MAAM;AACjB,wBAAoB;AACpB,aAAS;AAAA,EACV,CAAE;AAEF,YAAW,mBAAoB;AAChC;AAEA,OAAO,QAAS,iBAAkB,EAAE,QAAS,mBAAoB;",
   "names": []
 }

package/build-module/{matchers.js → matchers.mjs}

@@ -1,6 +1,6 @@
 // packages/jest-console/src/matchers.ts
 import { matcherHint, printExpected, printReceived } from "jest-matcher-utils";
-import supportedMatchers from "./supported-matchers";
+import supportedMatchers from "./supported-matchers.mjs";
 var createErrorMessage = (spyInfo) => {
   const { spy, pass, calls, matcherName, methodName, expected } = spyInfo;
   const hint = pass ? `.not${matcherName}` : matcherName;
@@ -66,4 +66,4 @@ expect.extend(
     {}
   )
 );
-//# sourceMappingURL=matchers.js.map
+//# sourceMappingURL=matchers.mjs.map

package/build-module/{supported-matchers.js → supported-matchers.mjs}

@@ -9,4 +9,4 @@ var supported_matchers_default = supportedMatchers;
 export {
   supported_matchers_default as default
 };
-//# sourceMappingURL=supported-matchers.js.map
+//# sourceMappingURL=supported-matchers.mjs.map

package/build-module/types.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=types.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/jest-console",
-	"version": "8.37.0",
+	"version": "8.37.1-next.06ee73755.0",
 	"description": "Custom Jest matchers for the Console object.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -25,23 +25,29 @@
 		"npm": ">=8.19.2"
 	},
 	"files": [
+		"src",
 		"build",
 		"build-module",
 		"build-types"
 	],
-	"main": "build/index.js",
-	"module": "build-module/index.js",
+	"main": "build/index.cjs",
+	"module": "build-module/index.mjs",
 	"exports": {
 		".": {
 			"types": "./build-types/index.d.ts",
-			"import": "./build-module/index.js",
-			"require": "./build/index.js"
+			"import": "./build-module/index.mjs",
+			"require": "./build/index.cjs"
 		},
 		"./package.json": "./package.json"
 	},
-	"types": "build-types",
+	"types": "index.d.ts",
 	"dependencies": {
-		"jest-matcher-utils": "^29.6.2"
+		"jest-matcher-utils": "^29.6.2",
+		"jest-mock": "^29.6.2"
+	},
+	"devDependencies": {
+		"@testing-library/jest-dom": "^6.6.3",
+		"@types/jest": "^29.5.14"
 	},
 	"peerDependencies": {
 		"jest": ">=29"
@@ -49,5 +55,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "2cf13ec6cf86153c9b3cf369bf5c59046f5cd950"
+	"gitHead": "fd315436f44683a993d5f053789b5279d95b2872"
 }

package/src/declarations.d.ts

@@ -0,0 +1,46 @@
+// Definitions originally written by Damien Sorel <https://github.com/mistic100> under MIT license.
+// https://github.com/DefinitelyTyped/DefinitelyTyped/blob/f0b72c12f6b561e4342dc8a1cf87432d2ad40ae7/types/wordpress__jest-console/index.d.ts
+
+declare namespace jest {
+	interface Matchers< R, T > {
+		/**
+		 * Ensure that `console.error` function was called.
+		 */
+		toHaveErrored(): R;
+
+		/**
+		 * Ensure that `console.error` function was called with specific arguments.
+		 */
+		toHaveErroredWith( ...args: unknown[] ): R;
+
+		/**
+		 * Ensure that `console.info` function was called.
+		 */
+		toHaveInformed(): R;
+
+		/**
+		 * Ensure that `console.info` function was called with specific arguments.
+		 */
+		toHaveInformedWith( ...args: unknown[] ): R;
+
+		/**
+		 * Ensure that `console.log` function was called.
+		 */
+		toHaveLogged(): R;
+
+		/**
+		 * Ensure that `console.log` function was called with specific arguments.
+		 */
+		toHaveLoggedWith( ...args: unknown[] ): R;
+
+		/**
+		 * Ensure that `console.warn` function was called.
+		 */
+		toHaveWarned(): R;
+
+		/**
+		 * Ensure that `console.warn` function was called with specific arguments.
+		 */
+		toHaveWarnedWith( ...args: unknown[] ): R;
+	}
+}

package/src/index.ts

@@ -0,0 +1,54 @@
+/**
+ * Internal dependencies
+ */
+import './matchers';
+import supportedMatchers from './supported-matchers';
+import type { ExtendedMock } from './types';
+
+/**
+ * Sets spy on the console object's method to make it possible to fail test when method called without assertion.
+ *
+ * @param args
+ */
+const setConsoleMethodSpy = ( args: [ string, string ] ) => {
+	const [ methodName, matcherName ] = args;
+	const spy = jest
+		.spyOn( console, methodName as 'error' | 'info' | 'log' | 'warn' )
+		.mockName( `console.${ methodName }` ) as ExtendedMock;
+
+	/**
+	 * Resets the spy to its initial state.
+	 */
+	function resetSpy() {
+		spy.mockReset();
+		spy.assertionsNumber = 0;
+	}
+
+	/**
+	 * Verifies that the spy has only been called if expected.
+	 */
+	function assertExpectedCalls() {
+		if ( spy.assertionsNumber === 0 && spy.mock.calls.length > 0 ) {
+			// Using 'as' to satisfy TypeScript compiler about the matcher name.
+			type MatcherName = `toHave${
+				| 'Errored'
+				| 'Informed'
+				| 'Logged'
+				| 'Warned' }`;
+			const name = matcherName as MatcherName;
+
+			expect( console ).not[ name ]();
+		}
+	}
+
+	beforeAll( resetSpy );
+
+	beforeEach( () => {
+		assertExpectedCalls();
+		resetSpy();
+	} );
+
+	afterEach( assertExpectedCalls );
+};
+
+Object.entries( supportedMatchers ).forEach( setConsoleMethodSpy );

package/src/matchers.ts

@@ -0,0 +1,121 @@
+/**
+ * External dependencies
+ */
+import { matcherHint, printExpected, printReceived } from 'jest-matcher-utils';
+
+/**
+ * Internal dependencies
+ */
+import supportedMatchers from './supported-matchers';
+import type { Mock } from 'jest-mock';
+import type {
+	ExtendedMock,
+	MatcherFunction,
+	MatcherResult,
+	MatcherWithArgsFunction,
+} from './types';
+
+interface SpyInfo {
+	spy: Mock;
+	pass: boolean;
+	calls: unknown[][];
+	matcherName: string;
+	methodName: string;
+	expected?: unknown[];
+}
+
+const createErrorMessage = ( spyInfo: SpyInfo ) => {
+	const { spy, pass, calls, matcherName, methodName, expected } = spyInfo;
+	const hint = pass ? `.not${ matcherName }` : matcherName;
+	const message = pass
+		? `Expected mock function not to be called but it was called with:\n${ calls.map(
+				printReceived
+		  ) }`
+		: `Expected mock function to be called${
+				expected ? ` with:\n${ printExpected( expected ) }\n` : '.'
+		  }\nbut it was called with:\n${ calls.map( printReceived ) }`;
+
+	return () =>
+		`${ matcherHint( hint, spy.getMockName() ) }` +
+		'\n\n' +
+		message +
+		'\n\n' +
+		`console.${ methodName }() should not be used unless explicitly expected\n` +
+		'See https://www.npmjs.com/package/@wordpress/jest-console for details.';
+};
+
+const createSpyInfo = (
+	spy: Mock,
+	matcherName: string,
+	methodName: string,
+	expected?: unknown[]
+) => {
+	const calls = spy.mock.calls;
+
+	const pass = expected
+		? JSON.stringify( calls ).includes( JSON.stringify( expected ) )
+		: calls.length > 0;
+
+	const message = createErrorMessage( {
+		spy,
+		pass,
+		calls,
+		matcherName,
+		methodName,
+		expected,
+	} );
+
+	return {
+		pass,
+		message,
+	};
+};
+
+const createToHaveBeenCalledMatcher =
+	( matcherName: string, methodName: string ) =>
+	( received: Record< string, Mock > ): MatcherResult => {
+		const spy = received[ methodName ] as ExtendedMock;
+		const spyInfo = createSpyInfo( spy, matcherName, methodName );
+		spy.assertionsNumber += 1;
+		return spyInfo;
+	};
+
+const createToHaveBeenCalledWith = (
+	matcherName: string,
+	methodName: string
+) =>
+	function (
+		received: Record< string, Mock >,
+		...expected: unknown[]
+	): MatcherResult {
+		const spy = received[ methodName ] as ExtendedMock;
+		const spyInfo = createSpyInfo( spy, matcherName, methodName, expected );
+		spy.assertionsNumber += 1;
+		return spyInfo;
+	};
+
+type MatchersObject = Record<
+	string,
+	MatcherFunction | MatcherWithArgsFunction
+>;
+
+expect.extend(
+	Object.entries( supportedMatchers ).reduce< MatchersObject >(
+		( result, [ methodName, matcherName ] ) => {
+			const matcherNameWith = `${ matcherName }With`;
+
+			return {
+				...result,
+				[ matcherName ]: createToHaveBeenCalledMatcher(
+					`.${ matcherName }`,
+					methodName
+				),
+				[ matcherNameWith ]: createToHaveBeenCalledWith(
+					`.${ matcherNameWith }`,
+					methodName
+				),
+			};
+		},
+		{}
+	)
+);

package/src/supported-matchers.ts

@@ -0,0 +1,8 @@
+const supportedMatchers: Record< string, string > = {
+	error: 'toHaveErrored',
+	info: 'toHaveInformed',
+	log: 'toHaveLogged',
+	warn: 'toHaveWarned',
+};
+
+export default supportedMatchers;

package/src/test/index.test.ts

@@ -0,0 +1,93 @@
+/* eslint-disable no-console */
+
+/**
+ * Internal dependencies
+ */
+import '../matchers';
+
+describe( 'jest-console', () => {
+	describe.each( [
+		[ 'error', 'toHaveErrored' ],
+		[ 'info', 'toHaveInformed' ],
+		[ 'log', 'toHaveLogged' ],
+		[ 'warn', 'toHaveWarned' ],
+	] )( 'console.%s', ( methodName, matcherName ) => {
+		const matcherNameWith = `${ matcherName }With`;
+		const message = `This is ${ methodName }!`;
+
+		test( `${ matcherName } works`, () => {
+			console[ methodName ]( message );
+
+			expect( console )[ matcherName ]();
+		} );
+
+		test( `${ matcherName } works when not called`, () => {
+			expect( console ).not[ matcherName ]();
+			expect( () => expect( console )[ matcherName ]() ).toThrow(
+				'Expected mock function to be called.'
+			);
+		} );
+
+		test( `${ matcherNameWith } works with arguments that match`, () => {
+			console[ methodName ]( message );
+
+			expect( console )[ matcherNameWith ]( message );
+		} );
+
+		test( `${ matcherNameWith } works when not called`, () => {
+			expect( console ).not[ matcherNameWith ]( message );
+			expect( () =>
+				expect( console )[ matcherNameWith ]( message )
+			).toThrow(
+				/Expected mock function to be called with:.*but it was called with:/s
+			);
+		} );
+
+		test( `${ matcherNameWith } works with many arguments that do not match`, () => {
+			console[ methodName ]( 'Unknown message.' );
+			console[ methodName ]( message, 'Unknown param.' );
+
+			expect( console ).not[ matcherNameWith ]( message );
+			expect( () =>
+				expect( console )[ matcherNameWith ]( message )
+			).toThrow(
+				/Expected mock function to be called with:.*but it was called with:.*Unknown param./s
+			);
+		} );
+
+		test( 'assertions number gets incremented after every matcher call', () => {
+			const spy = console[ methodName ];
+
+			expect( spy.assertionsNumber ).toBe( 0 );
+
+			console[ methodName ]( message );
+
+			expect( console )[ matcherName ]();
+			expect( spy.assertionsNumber ).toBe( 1 );
+
+			expect( console )[ matcherNameWith ]( message );
+			expect( spy.assertionsNumber ).toBe( 2 );
+		} );
+
+		describe( 'lifecycle', () => {
+			beforeAll( () => {
+				// Disable reason:
+				// This is a difficult one to test, since the matcher's
+				// own lifecycle is defined to run before ours. Infer
+				// that we're being watched by testing the console
+				// method as being a spy.
+				// eslint-disable-next-line jest/no-standalone-expect
+				expect(
+					console[ methodName ].assertionsNumber
+				).toBeGreaterThanOrEqual( 0 );
+			} );
+
+			// Disable reason:
+			// See beforeAll implementation and explanation added there.
+			// eslint-disable-next-line jest/expect-expect
+			it( 'captures logging in lifecycle', () => {} );
+		} );
+	} );
+} );
+
+/* eslint-enable no-console */

package/src/types.ts

@@ -0,0 +1,34 @@
+/**
+ * External dependencies
+ */
+import type { Mock } from 'jest-mock';
+
+/**
+ * Interface for the extended Jest Mock that includes the assertionsNumber property
+ */
+export interface ExtendedMock extends Mock {
+	assertionsNumber: number;
+}
+
+/**
+ * Interface for the matcher result object
+ */
+export interface MatcherResult {
+	pass: boolean;
+	message: () => string;
+}
+
+/**
+ * Interface for the matcher function
+ */
+export type MatcherFunction = (
+	received: Record< string, Mock >
+) => MatcherResult;
+
+/**
+ * Interface for the matcher function with arguments
+ */
+export type MatcherWithArgsFunction = (
+	received: Record< string, Mock >,
+	...expected: unknown[]
+) => MatcherResult;

package/build/declarations.d.js

@@ -1,2 +0,0 @@
-"use strict";
-//# sourceMappingURL=declarations.d.js.map

package/build-module/declarations.d.js

@@ -1 +0,0 @@
-//# sourceMappingURL=declarations.d.js.map

package/build-module/types.js

@@ -1 +0,0 @@
-//# sourceMappingURL=types.js.map