ava 4.0.0-rc.1 → 4.1.0

package/entrypoints/eslint-plugin-helper.cjs

@@ -90,7 +90,7 @@ function load(projectDir, overrides) {
 
 	const helper = Object.freeze({
 		classifyFile: classifyForESLint,
-		classifyImport: importPath => {
+		classifyImport(importPath) {
 			if (hasExtension(globs.extensions, importPath)) {
 				// The importPath has one of the test file extensions: we can classify
 				// it directly.

package/entrypoints/main.mjs

@@ -1,3 +1 @@
-import test from '../lib/worker/main.cjs';
-
-export default test;
+export {default} from '../lib/worker/main.cjs';

package/lib/api.js

@@ -177,13 +177,19 @@ export default class Api extends Emittery {
 				const fileCount = selectedFiles.length;
 
 				// The files must be in the same order across all runs, so sort them.
-				selectedFiles = selectedFiles.sort((a, b) => a.localeCompare(b, [], {numeric: true}));
+				const defaultComparator = (a, b) => a.localeCompare(b, [], {numeric: true});
+				selectedFiles = selectedFiles.sort(this.options.sortTestFiles || defaultComparator);
 				selectedFiles = chunkd(selectedFiles, currentIndex, totalRuns);
 
 				const currentFileCount = selectedFiles.length;
 
 				runStatus = new RunStatus(fileCount, {currentFileCount, currentIndex, totalRuns}, selectionInsights);
 			} else {
+				// If a custom sorter was configured, use it.
+				if (this.options.sortTestFiles) {
+					selectedFiles = selectedFiles.sort(this.options.sortTestFiles);
+				}
+
 				runStatus = new RunStatus(selectedFiles.length, null, selectionInsights);
 			}
 
@@ -232,10 +238,13 @@ export default class Api extends Emittery {
 				}
 			});
 
-			const providerStates = (await Promise.all(providers.map(async ({type, main}) => {
+			const providerStates = [];
+			await Promise.all(providers.map(async ({type, main}) => {
 				const state = await main.compile({cacheDir: this._createCacheDir(), files: testFiles});
-				return state === null ? null : {type, state};
-			}))).filter(state => state !== null);
+				if (state !== null) {
+					providerStates.push({type, state});
+				}
+			}));
 
 			// Resolve the correct concurrency value.
 			let concurrency = Math.min(os.cpus().length, isCi ? 2 : Number.POSITIVE_INFINITY);
@@ -258,8 +267,8 @@ export default class Api extends Emittery {
 				}
 
 				const lineNumbers = getApplicableLineNumbers(globs.normalizeFileForMatching(apiOptions.projectDir, file), filter);
-				// Removing `providers` field because they cannot be transfered to the worker threads.
-				const {providers, ...forkOptions} = apiOptions;
+				// Removing `providers` and `sortTestFiles` fields because they cannot be transferred to the worker threads.
+				const {providers, sortTestFiles, ...forkOptions} = apiOptions;
 				const options = {
 					...forkOptions,
 					providerStates,

package/lib/chalk.js

@@ -1,9 +1,8 @@
-import chalk from 'chalk';
+import {Chalk} from 'chalk'; // eslint-disable-line unicorn/import-style
 
-let instance = new chalk.Instance(); // eslint-disable-line import/no-mutable-exports
-export default instance;
+let chalk = new Chalk(); // eslint-disable-line import/no-mutable-exports
 
-export {instance as chalk};
+export {chalk};
 
 let configured = false;
 export function set(options) {
@@ -12,5 +11,5 @@ export function set(options) {
 	}
 
 	configured = true;
-	instance = new chalk.Instance(options);
+	chalk = new Chalk(options);
 }

package/lib/cli.js

@@ -21,6 +21,7 @@ import {splitPatternAndLineNumbers} from './line-numbers.js';
 import {loadConfig} from './load-config.js';
 import normalizeModuleTypes from './module-types.js';
 import normalizeNodeArguments from './node-arguments.js';
+import pkg from './pkg.cjs';
 import providerManager from './provider-manager.js';
 import DefaultReporter from './reporters/default.js';
 import TapReporter from './reporters/tap.js';
@@ -87,7 +88,7 @@ const FLAGS = {
 	verbose: {
 		alias: 'v',
 		coerce: coerceLastValue,
-		description: 'Enable verbose output (no-op)',
+		description: 'Enable verbose output (default)',
 		type: 'boolean',
 	},
 	watch: {
@@ -102,8 +103,15 @@ export default async function loadCli() { // eslint-disable-line complexity
 	let conf;
 	let confError;
 	try {
-		const {argv: {config: configFile}} = yargs(hideBin(process.argv)).help(false);
-		conf = await loadConfig({configFile});
+		const {argv: {config: configFile}} = yargs(hideBin(process.argv)).help(false).version(false);
+		const loaded = await loadConfig({configFile});
+		if (loaded.unsupportedFiles.length > 0) {
+			console.log(chalk.magenta(
+				`  ${figures.warning} AVA does not support JSON config, ignoring:\n\n    ${loaded.unsupportedFiles.join('\n    ')}`,
+			));
+		}
+
+		conf = loaded.config;
 		if (conf.configFile && path.basename(conf.configFile) !== path.relative(conf.projectDir, conf.configFile)) {
 			console.log(chalk.magenta(`  ${figures.warning} Using configuration from ${conf.configFile}`));
 		}
@@ -132,6 +140,7 @@ export default async function loadCli() { // eslint-disable-line complexity
 
 	let resetCache = false;
 	const {argv} = yargs(hideBin(process.argv))
+		.version(pkg.version)
 		.parserConfiguration({
 			'boolean-negation': true,
 			'camel-case-expansion': false,
@@ -161,7 +170,7 @@ export default async function loadCli() { // eslint-disable-line complexity
 		})
 		.command('* [<pattern>...]', 'Run tests', yargs => yargs.options(FLAGS).positional('pattern', {
 			array: true,
-			describe: 'Select which test files to run. Leave empty if you want AVA to run all test files as per your configuration. Accepts glob patterns, directories that (recursively) contain test files, and file paths. Add a colon and specify line numbers of specific tests to run',
+			describe: 'Select which test files to run. Leave empty if you want AVA to run all test files as per your configuration. Accepts glob patterns, directories that (recursively) contain test files, and file paths optionally suffixed with a colon and comma-separated numbers and/or ranges identifying the 1-based line(s) of specific tests to run',
 			type: 'string',
 		}), argv => {
 			if (activeInspector) {
@@ -188,7 +197,7 @@ export default async function loadCli() { // eslint-disable-line complexity
 				},
 			}).positional('pattern', {
 				demand: true,
-				describe: 'Glob patterns to select a single test file to debug. Add a colon and specify line numbers of specific tests to run',
+				describe: 'Glob pattern to select a single test file to debug, optionally suffixed with a colon and comma-separated numbers and/or ranges identifying the 1-based line(s) of specific tests to run',
 				type: 'string',
 			}),
 			argv => {
@@ -231,7 +240,12 @@ export default async function loadCli() { // eslint-disable-line complexity
 		}
 	}
 
-	const chalkOptions = {level: combined.color === false ? 0 : (await import('chalk')).level}; // eslint-disable-line node/no-unsupported-features/es-syntax
+	const chalkOptions = {level: 0};
+	if (combined.color !== false) {
+		const {supportsColor: {level}} = await import('chalk'); // eslint-disable-line node/no-unsupported-features/es-syntax, unicorn/import-style
+		chalkOptions.level = level;
+	}
+
 	const {set: setChalk} = await import('./chalk.js'); // eslint-disable-line node/no-unsupported-features/es-syntax
 	setChalk(chalkOptions);
 
@@ -314,16 +328,20 @@ export default async function loadCli() { // eslint-disable-line complexity
 		exit('’sources’ has been removed. Use ’ignoredByWatcher’ to provide glob patterns of files that the watcher should ignore.');
 	}
 
-	let pkg;
+	if (Reflect.has(conf, 'sortTestFiles') && typeof conf.sortTestFiles !== 'function') {
+		exit('’sortTestFiles’ must be a comparator function.');
+	}
+
+	let projectPackageObject;
 	try {
-		pkg = JSON.parse(fs.readFileSync(path.resolve(projectDir, 'package.json')));
+		projectPackageObject = JSON.parse(fs.readFileSync(path.resolve(projectDir, 'package.json')));
 	} catch (error) {
 		if (error.code !== 'ENOENT') {
 			throw error;
 		}
 	}
 
-	const {type: defaultModuleType = 'commonjs'} = pkg || {};
+	const {type: defaultModuleType = 'commonjs'} = projectPackageObject || {};
 
 	const providers = [];
 	if (Reflect.has(conf, 'typescript')) {
@@ -406,6 +424,7 @@ export default async function loadCli() { // eslint-disable-line complexity
 		moduleTypes,
 		nodeArguments,
 		parallelRuns,
+		sortTestFiles: conf.sortTestFiles,
 		projectDir,
 		providers,
 		ranFromCli: true,

package/lib/code-excerpt.js

@@ -2,7 +2,6 @@ import fs from 'node:fs';
 
 import truncate from 'cli-truncate';
 import codeExcerpt from 'code-excerpt';
-import equalLength from 'equal-length';
 
 import {chalk} from './chalk.js';
 
@@ -34,20 +33,15 @@ export default function exceptCode(source, options = {}) {
 		value: truncate(item.value, maxWidth - String(line).length - 5),
 	}));
 
-	const joinedLines = lines.map(line => line.value).join('\n');
-	const extendedLines = equalLength(joinedLines).split('\n');
+	const extendedWidth = Math.max(...lines.map(item => item.value.length));
 
 	return lines
-		.map((item, index) => ({
-			line: item.line,
-			value: extendedLines[index],
-		}))
 		.map(item => {
 			const isErrorSource = item.line === line;
 
 			const lineNumber = formatLineNumber(item.line, line) + ':';
 			const coloredLineNumber = isErrorSource ? lineNumber : chalk.grey(lineNumber);
-			const result = ` ${coloredLineNumber} ${item.value}`;
+			const result = ` ${coloredLineNumber} ${item.value.padEnd(extendedWidth)}`;
 
 			return isErrorSource ? chalk.bgRed(result) : result;
 		})

package/lib/concordance-options.js

@@ -1,11 +1,12 @@
 import {inspect} from 'node:util';
 
 import ansiStyles from 'ansi-styles';
+import {Chalk} from 'chalk'; // eslint-disable-line unicorn/import-style
 import stripAnsi from 'strip-ansi';
 
 import {chalk} from './chalk.js';
 
-const forceColor = new chalk.Instance({level: Math.max(chalk.level, 1)});
+const forceColor = new Chalk({level: Math.max(chalk.level, 1)});
 
 const colorTheme = {
 	boolean: ansiStyles.yellow,

package/lib/eslint-plugin-helper-worker.js

@@ -41,7 +41,7 @@ const buildGlobs = ({conf, providers, projectDir, overrideExtensions, overrideFi
 
 const resolveGlobs = async (projectDir, overrideExtensions, overrideFiles) => {
 	if (!configCache.has(projectDir)) {
-		configCache.set(projectDir, loadConfig({resolveFrom: projectDir}).then(async conf => {
+		configCache.set(projectDir, loadConfig({resolveFrom: projectDir}).then(async ({config: conf}) => {
 			const providers = await collectProviders({conf, projectDir});
 			return {conf, providers};
 		}));

package/lib/fork.js

@@ -4,7 +4,7 @@ import {fileURLToPath} from 'node:url';
 import {Worker} from 'node:worker_threads';
 
 import Emittery from 'emittery';
-import pEvent from 'p-event';
+import {pEvent} from 'p-event';
 
 import {controlFlow} from './ipc-flow-control.cjs';
 import serializeError from './serialize-error.js';

package/lib/globs.js

@@ -4,27 +4,23 @@ import path from 'node:path';
 import {globby, globbySync} from 'globby';
 
 import {
-	classify,
 	defaultIgnorePatterns,
 	hasExtension,
-	isHelperish,
-	matches,
 	normalizeFileForMatching,
-	normalizePattern,
 	normalizePatterns,
 	processMatchingPatterns,
 } from './glob-helpers.cjs';
 
 export {
 	classify,
-	defaultIgnorePatterns,
-	hasExtension,
 	isHelperish,
 	matches,
-	normalizeFileForMatching,
 	normalizePattern,
+	defaultIgnorePatterns,
+	hasExtension,
+	normalizeFileForMatching,
 	normalizePatterns,
-};
+} from './glob-helpers.cjs';
 
 const defaultIgnoredByWatcherPatterns = [
 	'**/*.snap.md', // No need to rerun tests when the Markdown files change.
@@ -120,11 +116,13 @@ const globDirectoriesSync = (cwd, patterns) => {
 };
 
 export async function findFiles({cwd, extensions, filePatterns}) {
-	return (await globFiles(cwd, filePatterns)).filter(file => hasExtension(extensions, file));
+	const files = await globFiles(cwd, filePatterns);
+	return files.filter(file => hasExtension(extensions, file));
 }
 
 export async function findTests({cwd, extensions, filePatterns}) {
-	return (await findFiles({cwd, extensions, filePatterns})).filter(file => !path.basename(file).startsWith('_'));
+	const files = await findFiles({cwd, extensions, filePatterns});
+	return files.filter(file => !path.basename(file).startsWith('_'));
 }
 
 export function getChokidarIgnorePatterns({ignoredByWatcherPatterns}) {

package/lib/load-config.js

@@ -20,14 +20,15 @@ const importConfig = async ({configFile, fileForErrorMessage}) => {
 };
 
 const loadConfigFile = async ({projectDir, configFile}) => {
-	if (!fs.existsSync(configFile)) {
-		return null;
-	}
-
 	const fileForErrorMessage = path.relative(projectDir, configFile);
 	try {
+		await fs.promises.access(configFile);
 		return {config: await importConfig({configFile, fileForErrorMessage}), configFile, fileForErrorMessage};
 	} catch (error) {
+		if (error.code === 'ENOENT') {
+			return null;
+		}
+
 		throw Object.assign(new Error(`Error loading ${fileForErrorMessage}: ${error.message}`), {parent: error});
 	}
 };
@@ -63,6 +64,20 @@ async function findRepoRoot(fromDir) {
 	return root;
 }
 
+async function checkJsonFile(searchDir) {
+	const file = path.join(searchDir, 'ava.config.json');
+	try {
+		await fs.promises.access(file);
+		return file;
+	} catch (error) {
+		if (error.code === 'ENOENT') {
+			return null;
+		}
+
+		throw error;
+	}
+}
+
 export async function loadConfig({configFile, resolveFrom = process.cwd(), defaults = {}} = {}) {
 	let packageConf = await packageConfig('ava', {cwd: resolveFrom});
 	const filepath = packageJsonPath(packageConf);
@@ -74,6 +89,7 @@ export async function loadConfig({configFile, resolveFrom = process.cwd(), defau
 	const allowConflictWithPackageJson = Boolean(configFile);
 	configFile = resolveConfigFile(configFile);
 
+	const unsupportedFiles = [];
 	let fileConf = NO_SUCH_FILE;
 	let fileForErrorMessage;
 	let conflicting = [];
@@ -86,11 +102,18 @@ export async function loadConfig({configFile, resolveFrom = process.cwd(), defau
 		let searchDir = projectDir;
 		const stopAt = path.dirname(repoRoot);
 		do {
-			[{config: fileConf, fileForErrorMessage, configFile} = {config: NO_SUCH_FILE, fileForErrorMessage: undefined}, ...conflicting] = (await Promise.all([ // eslint-disable-line no-await-in-loop
+			const [jsonFile, ...results] = await Promise.all([ // eslint-disable-line no-await-in-loop
+				checkJsonFile(searchDir),
 				loadConfigFile({projectDir, configFile: path.join(searchDir, 'ava.config.js')}),
 				loadConfigFile({projectDir, configFile: path.join(searchDir, 'ava.config.cjs')}),
 				loadConfigFile({projectDir, configFile: path.join(searchDir, 'ava.config.mjs')}),
-			])).filter(result => result !== null);
+			]);
+
+			if (jsonFile !== null) {
+				unsupportedFiles.push(jsonFile);
+			}
+
+			[{config: fileConf, fileForErrorMessage, configFile} = {config: NO_SUCH_FILE, fileForErrorMessage: undefined}, ...conflicting] = results.filter(result => result !== null);
 
 			searchDir = path.dirname(searchDir);
 		} while (fileConf === NO_SUCH_FILE && searchDir !== stopAt);
@@ -137,5 +160,5 @@ export async function loadConfig({configFile, resolveFrom = process.cwd(), defau
 		}
 	}
 
-	return config;
+	return {config, unsupportedFiles};
 }

package/lib/reporters/tap.js

@@ -4,7 +4,7 @@ import path from 'node:path';
 import indentString from 'indent-string';
 import plur from 'plur';
 import stripAnsi from 'strip-ansi';
-import supertap from 'supertap';
+import * as supertap from 'supertap';
 
 import beautifyStack from './beautify-stack.js';
 import prefixTitle from './prefix-title.js';

package/lib/runner.js

@@ -224,8 +224,8 @@ export default class Runner extends Emittery {
 		return this.snapshots.skipSnapshot(options);
 	}
 
-	saveSnapshotState() {
-		return {touchedFiles: this.snapshots.save()};
+	async saveSnapshotState() {
+		return {touchedFiles: await this.snapshots.save()};
 	}
 
 	onRun(runnable) {

package/lib/snapshot-manager.js

@@ -182,8 +182,8 @@ function sortBlocks(blocksByTitle, blockIndices) {
 	);
 }
 
-function encodeSnapshots(snapshotData) {
-	const encoded = cbor.encodeOne(snapshotData, {
+async function encodeSnapshots(snapshotData) {
+	const encoded = await cbor.encodeAsync(snapshotData, {
 		omitUndefinedProperties: true,
 		canonical: true,
 	});
@@ -351,7 +351,7 @@ class Manager {
 		this.recordSerialized({belongsTo, index, ...snapshot});
 	}
 
-	save() {
+	async save() {
 		const {dir, relFile, snapFile, snapPath, reportPath} = this;
 
 		if (this.updating && this.newBlocksByTitle.size === 0) {
@@ -371,15 +371,17 @@ class Manager {
 			),
 		};
 
-		const buffer = encodeSnapshots(snapshots);
+		const buffer = await encodeSnapshots(snapshots);
 		const reportBuffer = generateReport(relFile, snapFile, snapshots);
 
-		fs.mkdirSync(dir, {recursive: true});
+		await fs.promises.mkdir(dir, {recursive: true});
 
 		const temporaryFiles = [];
 		const tmpfileCreated = file => temporaryFiles.push(file);
-		writeFileAtomic.sync(snapPath, buffer, {tmpfileCreated});
-		writeFileAtomic.sync(reportPath, reportBuffer, {tmpfileCreated});
+		await Promise.all([
+			writeFileAtomic(snapPath, buffer, {tmpfileCreated}),
+			writeFileAtomic(reportPath, reportBuffer, {tmpfileCreated}),
+		]);
 		return {
 			changedFiles: [snapPath, reportPath],
 			temporaryFiles,
@@ -398,7 +400,9 @@ const resolveSourceFile = mem(file => {
 		return file;
 	}
 
-	return fileURLToPath(payload.sources[0]);
+	return payload.sources[0].startsWith('file://')
+		? fileURLToPath(payload.sources[0])
+		: payload.sources[0];
 });
 
 export const determineSnapshotDir = mem(({file, fixedLocation, projectDir}) => {

package/lib/test.js

@@ -24,16 +24,16 @@ const testMap = new WeakMap();
 class ExecutionContext extends Assertions {
 	constructor(test) {
 		super({
-			pass: () => {
+			pass() {
 				test.countPassedAssertion();
 			},
-			pending: promise => {
+			pending(promise) {
 				test.addPendingAssertion(promise);
 			},
-			fail: error => {
+			fail(error) {
 				test.addFailedAssertion(error);
 			},
-			skip: () => {
+			skip() {
 				test.countPassedAssertion();
 			},
 			compareWithSnapshot: options => test.compareWithSnapshot(options),
@@ -109,7 +109,7 @@ class ExecutionContext extends Assertions {
 				logs: [...logs], // Don't allow modification of logs.
 				passed,
 				title: attemptTitle,
-				commit: ({retainLogs = true} = {}) => {
+				commit({retainLogs = true} = {}) {
 					if (committed) {
 						return;
 					}
@@ -132,7 +132,7 @@ class ExecutionContext extends Assertions {
 						startingSnapshotCount,
 					});
 				},
-				discard: ({retainLogs = false} = {}) => {
+				discard({retainLogs = false} = {}) {
 					if (committed) {
 						test.saveFirstError(new Error('Can’t discard a result that was previously committed'));
 						return;

package/lib/worker/base.js

@@ -81,7 +81,7 @@ const run = async options => {
 
 	runner.on('finish', async () => {
 		try {
-			const {touchedFiles} = runner.saveSnapshotState();
+			const {touchedFiles} = await runner.saveSnapshotState();
 			if (touchedFiles) {
 				channel.send({type: 'touched-files', files: touchedFiles});
 			}
@@ -123,13 +123,13 @@ const run = async options => {
 	// Install before processing options.require, so if helpers are added to the
 	// require configuration the *compiled* helper will be loaded.
 	const {projectDir, providerStates = []} = options;
-	const providers = (await Promise.all(providerStates.map(async ({type, state}) => {
+	const providers = [];
+	await Promise.all(providerStates.map(async ({type, state}) => {
 		if (type === 'typescript') {
-			return (await providerManager.typescript(projectDir)).worker({extensionsToLoadAsModules, state});
+			const provider = await providerManager.typescript(projectDir);
+			providers.push(provider.worker({extensionsToLoadAsModules, state}));
 		}
-
-		return null;
-	}))).filter(provider => provider !== null);
+	}));
 
 	const require = createRequire(import.meta.url);
 	const load = async ref => {

package/lib/worker/channel.cjs

@@ -3,12 +3,44 @@ const events = require('events');
 const process = require('process');
 const {MessageChannel, threadId} = require('worker_threads');
 
-const pEvent = require('p-event');
-
 const timers = require('../now-and-timers.cjs');
 
 const {isRunningInChildProcess, isRunningInThread} = require('./utils.cjs');
 
+let pEvent = async (emitter, event, options) => {
+	// We need to import p-event, but import() is asynchronous. Buffer any events
+	// emitted in the meantime. Don't handle errors.
+	const buffer = [];
+	const addToBuffer = (...args) => buffer.push(args);
+	emitter.on(event, addToBuffer);
+
+	try {
+		({pEvent} = await import('p-event')); // eslint-disable-line node/no-unsupported-features/es-syntax
+	} finally {
+		emitter.off(event, addToBuffer);
+	}
+
+	if (buffer.length === 0) {
+		return pEvent(emitter, event, options);
+	}
+
+	// Now replay buffered events.
+	const replayEmitter = new events.EventEmitter();
+	const promise = pEvent(replayEmitter, event, options);
+	for (const args of buffer) {
+		replayEmitter.emit(event, ...args);
+	}
+
+	const replay = (...args) => replayEmitter.emit(event, ...args);
+	emitter.on(event, replay);
+
+	try {
+		return await promise;
+	} finally {
+		emitter.off(event, replay);
+	}
+};
+
 const selectAvaMessage = type => message => message.ava && message.ava.type === type;
 
 class RefCounter {

package/lib/worker/guard-environment.cjs

@@ -6,12 +6,11 @@ const {isRunningInThread, isRunningInChildProcess} = require('./utils.cjs');
 
 // Check if the test is being run without AVA cli
 if (!isRunningInChildProcess && !isRunningInThread) {
-	const chalk = require('chalk'); // Use default Chalk instance.
 	if (process.argv[1]) {
 		const fp = path.relative('.', process.argv[1]);
 
 		console.log();
-		console.error(`Test files must be run with the AVA CLI:\n\n    ${chalk.grey.dim('$')} ${chalk.cyan('ava ' + fp)}\n`);
+		console.error(`Test files must be run with the AVA CLI:\n\n    $ ava ${fp}\n`);
 
 		process.exit(1); // eslint-disable-line unicorn/no-process-exit
 	} else {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ava",
-	"version": "4.0.0-rc.1",
+	"version": "4.1.0",
 	"description": "Node.js test runner that lets you develop with confidence.",
 	"license": "MIT",
 	"repository": "avajs/ava",
@@ -70,72 +70,71 @@
 		"typescript"
 	],
 	"dependencies": {
-		"acorn": "^8.5.0",
+		"acorn": "^8.7.0",
 		"acorn-walk": "^8.2.0",
 		"ansi-styles": "^6.1.0",
 		"arrgv": "^1.0.2",
 		"arrify": "^3.0.0",
 		"callsites": "^4.0.0",
-		"cbor": "^8.0.2",
-		"chalk": "^4.1.2",
-		"chokidar": "^3.5.2",
+		"cbor": "^8.1.0",
+		"chalk": "^5.0.0",
+		"chokidar": "^3.5.3",
 		"chunkd": "^2.0.1",
-		"ci-info": "^3.2.0",
+		"ci-info": "^3.3.0",
 		"ci-parallel-vars": "^1.0.1",
 		"clean-yaml-object": "^0.1.0",
 		"cli-truncate": "^3.1.0",
-		"code-excerpt": "^3.0.0",
+		"code-excerpt": "^4.0.0",
 		"common-path-prefix": "^3.0.0",
 		"concordance": "^5.0.4",
 		"currently-unhandled": "^0.4.1",
-		"debug": "^4.3.2",
+		"debug": "^4.3.3",
 		"del": "^6.0.0",
-		"emittery": "^0.10.0",
-		"equal-length": "^1.0.1",
+		"emittery": "^0.10.1",
 		"figures": "^4.0.0",
-		"globby": "^12.0.2",
+		"globby": "^13.1.1",
 		"ignore-by-default": "^2.0.0",
 		"indent-string": "^5.0.0",
 		"is-error": "^2.2.2",
 		"is-plain-object": "^5.0.0",
 		"is-promise": "^4.0.0",
 		"matcher": "^5.0.0",
-		"mem": "^9.0.1",
+		"mem": "^9.0.2",
 		"ms": "^2.1.3",
-		"p-event": "^4.2.0",
-		"p-map": "^5.2.0",
-		"picomatch": "^2.3.0",
+		"p-event": "^5.0.1",
+		"p-map": "^5.3.0",
+		"picomatch": "^2.3.1",
 		"pkg-conf": "^4.0.0",
-		"plur": "^4.0.0",
+		"plur": "^5.1.0",
 		"pretty-ms": "^7.0.1",
 		"resolve-cwd": "^3.0.0",
 		"slash": "^3.0.0",
-		"stack-utils": "^2.0.3",
+		"stack-utils": "^2.0.5",
 		"strip-ansi": "^7.0.1",
-		"supertap": "^2.0.0",
+		"supertap": "^3.0.1",
 		"temp-dir": "^2.0.0",
-		"write-file-atomic": "^3.0.3",
-		"yargs": "^17.2.1"
+		"write-file-atomic": "^4.0.1",
+		"yargs": "^17.3.1"
 	},
 	"devDependencies": {
 		"@ava/test": "github:avajs/test",
-		"@ava/typescript": "^2.0.0",
-		"@sinonjs/fake-timers": "^8.0.1",
+		"@ava/typescript": "^3.0.1",
+		"@sinonjs/fake-timers": "^9.1.1",
 		"ansi-escapes": "^5.0.0",
-		"c8": "^7.10.0",
+		"c8": "^7.11.0",
 		"delay": "^5.0.0",
-		"execa": "^5.1.1",
-		"fs-extra": "^10.0.0",
+		"execa": "^6.1.0",
+		"fs-extra": "^10.0.1",
 		"get-stream": "^6.0.1",
 		"replace-string": "^4.0.0",
-		"sinon": "^11.1.2",
-		"tap": "^15.0.10",
+		"sinon": "^13.0.1",
+		"tap": "^16.0.0",
 		"temp-write": "^5.0.0",
 		"tempy": "^2.0.0",
 		"touch": "^3.1.0",
-		"tsd": "^0.18.0",
-		"typescript": "^4.4.4",
-		"xo": "^0.46.3",
+		"tsd": "^0.19.1",
+		"typescript": "^4.6.2",
+		"xo": "^0.48.0",
 		"zen-observable": "^0.8.15"
 	},
 	"peerDependencies": {

package/readme.md

@@ -6,7 +6,7 @@ Follow the [AVA Twitter account](https://twitter.com/ava__js) for updates.
 
 Read our [contributing guide](.github/CONTRIBUTING.md) if you're looking to contribute (issues / PRs / etc).
 
-![](media/mini-reporter.gif)
+![](media/verbose-reporter.png)
 
 
 Translations: [Español](https://github.com/avajs/ava-docs/blob/master/es_ES/readme.md), [Français](https://github.com/avajs/ava-docs/blob/master/fr_FR/readme.md), [Italiano](https://github.com/avajs/ava-docs/blob/master/it_IT/readme.md), [日本語](https://github.com/avajs/ava-docs/blob/master/ja_JP/readme.md), [한국어](https://github.com/avajs/ava-docs/blob/master/ko_KR/readme.md), [Português](https://github.com/avajs/ava-docs/blob/master/pt_BR/readme.md), [Русский](https://github.com/avajs/ava-docs/blob/master/ru_RU/readme.md), [简体中文](https://github.com/avajs/ava-docs/blob/master/zh_CN/readme.md)
@@ -71,7 +71,7 @@ Don't forget to configure the `test` script in your `package.json` as per above.
 Create a file named `test.js` in the project root directory:
 
 ```js
-const test = require('ava');
+import test from 'ava';
 
 test('foo', t => {
 	t.pass();
@@ -139,17 +139,16 @@ We have a growing list of [common pitfalls](docs/08-common-pitfalls.md) you may
 
 ### Recipes
 
-- [Shared workers](docs/recipes/shared-workers.md)
 - [Test setup](docs/recipes/test-setup.md)
-- [Code coverage](docs/recipes/code-coverage.md)
+- [TypeScript](docs/recipes/typescript.md)
+- [Shared workers](docs/recipes/shared-workers.md)
 - [Watch mode](docs/recipes/watch-mode.md)
-- [Endpoint testing](docs/recipes/endpoint-testing.md)
 - [When to use `t.plan()`](docs/recipes/when-to-use-plan.md)
-- [Browser testing](docs/recipes/browser-testing.md)
-- [TypeScript](docs/recipes/typescript.md)
-- [Using ES modules](docs/recipes/es-modules.md)
 - [Passing arguments to your test files](docs/recipes/passing-arguments-to-your-test-files.md)
-- [Testing React components](docs/recipes/react.md)
+- [Splitting tests in CI](docs/recipes/splitting-tests-ci.md)
+- [Code coverage](docs/recipes/code-coverage.md)
+- [Endpoint testing](docs/recipes/endpoint-testing.md)
+- [Browser testing](docs/recipes/browser-testing.md)
 - [Testing Vue.js components](docs/recipes/vue.md)
 - [Debugging tests with Chrome DevTools](docs/recipes/debugging-with-chrome-devtools.md)
 - [Debugging tests with VSCode](docs/recipes/debugging-with-vscode.md)
@@ -188,7 +187,6 @@ It's the [Andromeda galaxy](https://simple.wikipedia.org/wiki/Andromeda_galaxy).
 
 - [eslint-plugin-ava](https://github.com/avajs/eslint-plugin-ava) — Lint rules for AVA tests
 - [@ava/typescript](https://github.com/avajs/typescript) — Test TypeScript projects
-- [@ava/babel](https://github.com/avajs/babel) — Compile test files using Babel, for AVA 3
 - [@ava/cooperate](https://github.com/avajs/cooperate) — Low-level primitives to enable cooperation between test files
 - [@ava/get-port](https://github.com/avajs/get-port) — Reserve a port while testing
 

package/types/assertions.d.ts

@@ -138,6 +138,18 @@ export interface DeepEqualAssertion {
 	 */
 	<Actual, Expected extends Actual>(actual: Actual, expected: Expected, message?: string): actual is Expected;
 
+	/**
+	 * Assert that `actual` is [deeply equal](https://github.com/concordancejs/concordance#comparison-details) to
+	 * `expected`, returning a boolean indicating whether the assertion passed.
+	 */
+	<Actual extends Expected, Expected>(actual: Actual, expected: Expected, message?: string): expected is Actual;
+
+	/**
+	 * Assert that `actual` is [deeply equal](https://github.com/concordancejs/concordance#comparison-details) to
+	 * `expected`, returning a boolean indicating whether the assertion passed.
+	 */
+	<Actual, Expected>(actual: Actual, expected: Expected, message?: string): boolean;
+
 	/** Skip this assertion. */
 	skip(actual: any, expected: any, message?: string): void;
 }