@japa/runner 2.5.1 → 3.0.0-1

package/build/src/hooks.d.ts

@@ -0,0 +1,9 @@
+import { Runner } from '../modules/core/main.js';
+import type { Config } from './types.js';
+export declare class GlobalHooks {
+    #private;
+    apply(config: Required<Config>): void;
+    setup(runner: Runner): Promise<void>;
+    teardown(error: Error | null, runner: Runner): Promise<void>;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/build/src/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/hooks.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAkD,MAAM,YAAY,CAAA;AAKxF,qBAAa,WAAW;;IAQtB,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IAQxB,KAAK,CAAC,MAAM,EAAE,MAAM;IASpB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM;CAWnD"}

package/build/src/hooks.js

@@ -0,0 +1,26 @@
+import Hooks from '@poppinss/hooks';
+export class GlobalHooks {
+    #hooks = new Hooks();
+    #setupRunner;
+    #teardownRunner;
+    apply(config) {
+        config.setup.forEach((hook) => this.#hooks.add('setup', hook));
+        config.teardown.forEach((hook) => this.#hooks.add('teardown', hook));
+    }
+    async setup(runner) {
+        this.#setupRunner = this.#hooks.runner('setup');
+        this.#teardownRunner = this.#hooks.runner('teardown');
+        await this.#setupRunner.run(runner);
+    }
+    async teardown(error, runner) {
+        if (this.#setupRunner) {
+            await this.#setupRunner.cleanup(error, runner);
+        }
+        if (this.#teardownRunner) {
+            if (!error) {
+                await this.#teardownRunner.run(runner);
+            }
+            await this.#teardownRunner.cleanup(error, runner);
+        }
+    }
+}

package/build/src/planner.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="@types/node" resolution-mode="require"/>
+import type { Config, TestSuite } from './types.js';
+export declare class Planner {
+    #private;
+    constructor(config: Required<Config>);
+    plan(): Promise<{
+        reporters: import("@japa/core/types").NamedReporterContract[];
+        suites: (TestSuite & {
+            filesURLs: URL[];
+        })[];
+        refinerFilters: {
+            layer: "tags" | "tests" | "groups";
+            filters: string[];
+        }[];
+        config: Required<Config>;
+    }>;
+}
+//# sourceMappingURL=planner.d.ts.map

package/build/src/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/planner.ts"],"names":[],"mappings":";AAWA,OAAO,KAAK,EAAE,MAAM,EAAa,SAAS,EAAE,MAAM,YAAY,CAAA;AAO9D,qBAAa,OAAO;;gBAIN,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IA6E9B,IAAI;;;;;;;;;;;CAWX"}

package/build/src/planner.js

@@ -0,0 +1,67 @@
+import validator from './validator.js';
+import { FilesManager } from './files_manager.js';
+export class Planner {
+    #config;
+    #fileManager = new FilesManager();
+    constructor(config) {
+        validator.validateActivatedReporters(config);
+        validator.validateSuitesFilter(config);
+        validator.validateSuitesForUniqueness(config);
+        this.#config = config;
+    }
+    #getActivatedReporters() {
+        return this.#config.reporters.activated.map((activated) => {
+            return this.#config.reporters.list.find(({ name }) => activated === name);
+        });
+    }
+    async #collectFiles(files) {
+        let filesURLs = await this.#fileManager.getFiles(this.#config.cwd, files);
+        if (this.#config.filters.files && this.#config.filters.files.length) {
+            filesURLs = this.#fileManager.grep(filesURLs, this.#config.filters.files);
+        }
+        return filesURLs;
+    }
+    async #getSuites() {
+        let suites = [];
+        let suitesFilters = this.#config.filters.suites || [];
+        if ('files' in this.#config) {
+            suites.push({
+                name: 'default',
+                files: this.#config.files,
+                timeout: this.#config.timeout,
+                retries: this.#config.retries,
+                filesURLs: await this.#collectFiles(this.#config.files),
+            });
+        }
+        if ('suites' in this.#config) {
+            for (let suite of this.#config.suites) {
+                if (!suitesFilters.length || suitesFilters.includes(suite.name)) {
+                    suites.push({
+                        ...suite,
+                        filesURLs: await this.#collectFiles(suite.files),
+                    });
+                }
+            }
+        }
+        return suites;
+    }
+    #getRefinerFilters() {
+        return Object.keys(this.#config.filters).reduce((result, layer) => {
+            if (layer === 'tests' || layer === 'tags' || layer === 'groups') {
+                result.push({ layer, filters: this.#config.filters[layer] });
+            }
+            return result;
+        }, []);
+    }
+    async plan() {
+        const suites = await this.#getSuites();
+        const reporters = this.#getActivatedReporters();
+        const refinerFilters = this.#getRefinerFilters();
+        return {
+            reporters,
+            suites,
+            refinerFilters,
+            config: this.#config,
+        };
+    }
+}

package/build/src/plugins/retry.d.ts

@@ -0,0 +1,8 @@
+import type { PluginFn } from '../types.js';
+export declare function getFailedTests(): Promise<{
+    tests?: string[];
+}>;
+export declare function cacheFailedTests(tests: string[]): Promise<void>;
+export declare function clearCache(): Promise<void>;
+export declare const retryPlugin: PluginFn;
+//# sourceMappingURL=retry.d.ts.map

package/build/src/plugins/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/plugins/retry.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAY3C,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAUpE;AAKD,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,iBAGrD;AAKD,wBAAsB,UAAU,kBAE/B;AAKD,eAAO,MAAM,WAAW,EAAE,QAkBzB,CAAA"}

package/build/src/plugins/retry.js

@@ -0,0 +1,42 @@
+import { join } from 'node:path';
+import findCacheDirectory from 'find-cache-dir';
+import { mkdir, readFile, unlink, writeFile } from 'node:fs/promises';
+import cliui from '../helpers.js';
+const CACHE_DIR = findCacheDirectory({ name: '@japa/runner' });
+const SUMMARY_FILE = CACHE_DIR ? join(CACHE_DIR, 'summary.json') : undefined;
+export async function getFailedTests() {
+    try {
+        const summary = await readFile(SUMMARY_FILE, 'utf-8');
+        return JSON.parse(summary);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return {};
+        }
+        throw new Error('Unable to read failed tests cache file', { cause: error });
+    }
+}
+export async function cacheFailedTests(tests) {
+    await mkdir(CACHE_DIR, { recursive: true });
+    await writeFile(SUMMARY_FILE, JSON.stringify({ tests: tests }));
+}
+export async function clearCache() {
+    await unlink(SUMMARY_FILE);
+}
+export const retryPlugin = async function retry({ config, cliArgs }) {
+    if (!SUMMARY_FILE) {
+        return;
+    }
+    config.teardown.push(async (runner) => {
+        const summary = runner.getSummary();
+        await cacheFailedTests(summary.failedTestsTitles);
+    });
+    if (cliArgs.retry) {
+        const { tests } = await getFailedTests();
+        if (!tests || !tests.length) {
+            console.log(cliui.colors.bgYellow().black(' No failing tests found. Running all the tests '));
+            return;
+        }
+        config.filters.tests = tests;
+    }
+};

package/build/src/reporters/dot.d.ts

@@ -0,0 +1,7 @@
+import type { TestEndNode } from '../../modules/core/types.js';
+import { BaseReporter } from '../../modules/core/reporters/base.js';
+export declare class DotReporter extends BaseReporter {
+    protected onTestEnd(payload: TestEndNode): void;
+    protected end(): Promise<void>;
+}
+//# sourceMappingURL=dot.d.ts.map

package/build/src/reporters/dot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dot.d.ts","sourceRoot":"","sources":["../../../src/reporters/dot.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AAKnE,qBAAa,WAAY,SAAQ,YAAY;IAI3C,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,WAAW;cAkBxB,GAAG;CAIpB"}

package/build/src/reporters/dot.js

@@ -0,0 +1,24 @@
+import cliui from '../helpers.js';
+import { BaseReporter } from '../../modules/core/reporters/base.js';
+export class DotReporter extends BaseReporter {
+    onTestEnd(payload) {
+        let output = '';
+        if (payload.isTodo) {
+            output = cliui.colors.cyan('-');
+        }
+        else if (payload.hasError || payload.isFailing) {
+            output = cliui.colors.red('×');
+        }
+        else if (payload.isSkipped) {
+            output = cliui.colors.yellow('-');
+        }
+        else {
+            output = cliui.colors.green('•');
+        }
+        process.stdout.write(`${output}`);
+    }
+    async end() {
+        console.log('');
+        await this.printSummary(this.runner.getSummary());
+    }
+}

package/build/src/reporters/main.d.ts

@@ -0,0 +1,5 @@
+import type { BaseReporterOptions, NamedReporterContract } from '../types.js';
+export declare const spec: (options?: BaseReporterOptions) => NamedReporterContract;
+export declare const dot: (options?: BaseReporterOptions) => NamedReporterContract;
+export declare const ndjson: (options?: BaseReporterOptions) => NamedReporterContract;
+//# sourceMappingURL=main.d.ts.map

package/build/src/reporters/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/reporters/main.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAK7E,eAAO,MAAM,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,mBAAmB,KAAK,qBAKrD,CAAA;AAKD,eAAO,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,mBAAmB,KAAK,qBAKpD,CAAA;AAKD,eAAO,MAAM,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,mBAAmB,KAAK,qBAKvD,CAAA"}

package/build/src/reporters/main.js

@@ -0,0 +1,21 @@
+import { DotReporter } from './dot.js';
+import { SpecReporter } from './spec.js';
+import { NdJSONReporter } from './ndjson.js';
+export const spec = (options) => {
+    return {
+        name: 'spec',
+        handler: (...args) => new SpecReporter(options).boot(...args),
+    };
+};
+export const dot = (options) => {
+    return {
+        name: 'dot',
+        handler: (...args) => new DotReporter(options).boot(...args),
+    };
+};
+export const ndjson = (options) => {
+    return {
+        name: 'ndjson',
+        handler: (...args) => new NdJSONReporter(options).boot(...args),
+    };
+};

package/build/src/reporters/ndjson.d.ts

@@ -0,0 +1,12 @@
+import { BaseReporter } from '../../modules/core/main.js';
+import type { TestEndNode, SuiteEndNode, GroupEndNode, SuiteStartNode, GroupStartNode } from '../../modules/core/types.js';
+export declare class NdJSONReporter extends BaseReporter {
+    #private;
+    protected onTestEnd(payload: TestEndNode): void;
+    protected onGroupStart(payload: GroupStartNode): void;
+    protected onGroupEnd(payload: GroupEndNode): void;
+    protected onSuiteStart(payload: SuiteStartNode): void;
+    protected onSuiteEnd(payload: SuiteEndNode): void;
+    protected end(): Promise<void>;
+}
+//# sourceMappingURL=ndjson.d.ts.map

package/build/src/reporters/ndjson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjson.d.ts","sourceRoot":"","sources":["../../../src/reporters/ndjson.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACf,MAAM,6BAA6B,CAAA;AAMpC,qBAAa,cAAe,SAAQ,YAAY;;IAQ9C,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAuB/C,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IASrD,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAQjD,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IASrD,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;cASjC,GAAG;CAWpB"}

package/build/src/reporters/ndjson.js

@@ -0,0 +1,61 @@
+import { relative } from 'node:path';
+import { BaseReporter } from '../../modules/core/main.js';
+export class NdJSONReporter extends BaseReporter {
+    #getRelativeFilename(fileName) {
+        return relative(process.cwd(), fileName);
+    }
+    onTestEnd(payload) {
+        console.log(JSON.stringify({
+            event: 'test:end',
+            filePath: this.currentFileName,
+            relativePath: this.currentFileName
+                ? this.#getRelativeFilename(this.currentFileName)
+                : undefined,
+            title: payload.title,
+            duration: payload.duration,
+            failReason: payload.failReason,
+            isFailing: payload.isFailing,
+            skipReason: payload.skipReason,
+            isSkipped: payload.isSkipped,
+            isTodo: payload.isTodo,
+            isPinned: payload.isPinned,
+            retryAttempt: payload.retryAttempt,
+            retries: payload.retries,
+            errors: payload.errors,
+        }));
+    }
+    onGroupStart(payload) {
+        console.log(JSON.stringify({
+            event: 'group:start',
+            title: payload.title,
+        }));
+    }
+    onGroupEnd(payload) {
+        JSON.stringify({
+            event: 'group:end',
+            title: payload.title,
+            errors: payload.errors,
+        });
+    }
+    onSuiteStart(payload) {
+        console.log(JSON.stringify({
+            event: 'suite:start',
+            ...payload,
+        }));
+    }
+    onSuiteEnd(payload) {
+        console.log(JSON.stringify({
+            event: 'suite:end',
+            ...payload,
+        }));
+    }
+    async end() {
+        const summary = this.runner.getSummary();
+        console.log(JSON.stringify({
+            aggregates: summary.aggregates,
+            duration: summary.duration,
+            failedTestsTitles: summary.failedTestsTitles,
+            hasError: summary.hasError,
+        }));
+    }
+}

package/build/src/reporters/spec.d.ts

@@ -0,0 +1,11 @@
+import { BaseReporter } from '../../modules/core/main.js';
+import { GroupStartNode, TestEndNode } from '../../modules/core/types.js';
+export declare class SpecReporter extends BaseReporter {
+    #private;
+    protected onTestStart(): void;
+    protected onTestEnd(payload: TestEndNode): void;
+    protected onGroupStart(payload: GroupStartNode): void;
+    protected onGroupEnd(): void;
+    protected end(): Promise<void>;
+}
+//# sourceMappingURL=spec.d.ts.map

package/build/src/reporters/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../src/reporters/spec.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAKzE,qBAAa,YAAa,SAAQ,YAAY;;IA8H5C,SAAS,CAAC,WAAW,IAAI,IAAI;IAc7B,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAI/C,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IASrD,SAAS,CAAC,UAAU,IAAI,IAAI;cAWZ,GAAG;CAIpB"}

package/build/src/reporters/spec.js

@@ -0,0 +1,103 @@
+import ms from 'ms';
+import { relative } from 'node:path';
+import cliui from '../helpers.js';
+import { BaseReporter } from '../../modules/core/main.js';
+export class SpecReporter extends BaseReporter {
+    #isFirstLoneTest = true;
+    #getTestIcon(payload) {
+        if (payload.isTodo) {
+            return cliui.colors.cyan(cliui.icons.info);
+        }
+        if (payload.isFailing) {
+            return payload.hasError
+                ? cliui.colors.magenta(cliui.icons.squareSmallFilled)
+                : cliui.colors.red(cliui.icons.cross);
+        }
+        if (payload.hasError) {
+            return cliui.colors.red(cliui.icons.cross);
+        }
+        if (payload.isSkipped) {
+            return cliui.colors.yellow(cliui.icons.bullet);
+        }
+        return cliui.colors.green(cliui.icons.tick);
+    }
+    #getTestMessage(payload) {
+        const message = typeof payload.title === 'string' ? payload.title : payload.title.expanded;
+        if (payload.isTodo) {
+            return cliui.colors.blue(message);
+        }
+        if (payload.isFailing) {
+            return payload.hasError ? cliui.colors.magenta(message) : cliui.colors.red(message);
+        }
+        if (payload.hasError) {
+            return cliui.colors.red(message);
+        }
+        if (payload.isSkipped) {
+            return cliui.colors.yellow(message);
+        }
+        return cliui.colors.grey(message);
+    }
+    #getSubText(payload) {
+        if (payload.isSkipped && payload.skipReason) {
+            return cliui.colors.yellow(payload.skipReason);
+        }
+        if (!payload.isFailing) {
+            return;
+        }
+        if (!payload.hasError) {
+            return cliui.colors.magenta(`Test marked with ".fails()" must finish with an error`);
+        }
+        if (payload.failReason) {
+            return cliui.colors.magenta(payload.failReason);
+        }
+        const testErrorMessage = payload.errors.find((error) => error.phase === 'test');
+        if (testErrorMessage && testErrorMessage.error) {
+            return cliui.colors.magenta(testErrorMessage.error.message);
+        }
+    }
+    #getRelativeFilename(fileName) {
+        return relative(process.cwd(), fileName);
+    }
+    #printTest(payload) {
+        const icon = this.#getTestIcon(payload);
+        const message = this.#getTestMessage(payload);
+        const prefix = payload.isPinned ? cliui.colors.yellow('[PINNED] ') : '';
+        const indentation = this.currentFileName || this.currentGroupName ? '  ' : '';
+        const duration = cliui.colors.dim(`(${ms(payload.duration)})`);
+        const retries = payload.retryAttempt && payload.retryAttempt > 1
+            ? cliui.colors.dim(`(x${payload.retryAttempt}) `)
+            : '';
+        let subText = this.#getSubText(payload);
+        subText = subText ? `\n${indentation}  ${subText}` : '';
+        console.log(`${indentation}${icon} ${prefix}${retries}${message} ${duration}${subText}`);
+    }
+    #printGroup(payload) {
+        const title = this.currentSuiteName !== 'default'
+            ? `${this.currentSuiteName} / ${payload.title}`
+            : payload.title;
+        const suffix = this.currentFileName
+            ? cliui.colors.dim(` (${this.#getRelativeFilename(this.currentFileName)})`)
+            : '';
+        console.log(`\n${title}${suffix}`);
+    }
+    onTestStart() {
+        if (this.currentFileName && this.#isFirstLoneTest) {
+            console.log(`\n${cliui.colors.dim(this.#getRelativeFilename(this.currentFileName))}`);
+        }
+        this.#isFirstLoneTest = false;
+    }
+    onTestEnd(payload) {
+        this.#printTest(payload);
+    }
+    onGroupStart(payload) {
+        this.#isFirstLoneTest = false;
+        this.#printGroup(payload);
+    }
+    onGroupEnd() {
+        this.#isFirstLoneTest = true;
+    }
+    async end() {
+        const summary = this.runner.getSummary();
+        await this.printSummary(summary);
+    }
+}

package/build/src/types.d.ts

@@ -1,68 +1,67 @@
-import { Refiner, FilteringOptions, ReporterContract } from '@japa/core';
-import { Test, Group, TestContext, Runner, Suite } from './core/main';
-/**
- * The cleanup function for runner hooks
- */
-export declare type RunnerHooksCleanupHandler = (error: null | any, runner: Runner) => Promise<any> | any;
-/**
- * The function that can be registered as a runner hook
- */
-export declare type RunnerHooksHandler = (runner: Runner) => Promise<any> | any | RunnerHooksCleanupHandler | Promise<RunnerHooksCleanupHandler>;
-/**
- * Allowed filters
- */
+/// <reference types="@types/node" resolution-mode="require"/>
+import type { HookHandler } from '@poppinss/hooks/types';
+import type { Emitter, Refiner, Runner, Suite } from '../modules/core/main.js';
+import type { FilteringOptions, NamedReporterContract } from '../modules/core/types.js';
+export * from '../modules/core/types.js';
+export type SetupHookState = [[runner: Runner], [error: Error | null, runner: Runner]];
+export type SetupHookHandler = HookHandler<SetupHookState[0], SetupHookState[1]>;
+export type TeardownHookState = [[runner: Runner], [error: Error | null, runner: Runner]];
+export type TeardownHookHandler = HookHandler<TeardownHookState[0], TeardownHookState[1]>;
+export type HooksEvents = {
+    setup: SetupHookState;
+    teardown: TeardownHookState;
+};
+export type CLIArgs = {
+    _?: string[];
+    tags?: string | string[];
+    files?: string | string[];
+    tests?: string | string[];
+    groups?: string | string[];
+    timeout?: string;
+    retries?: string;
+    reporter?: string | string[];
+    forceExit?: boolean;
+    help?: boolean;
+    matchAll?: boolean;
+} & Record<string, string | string[] | boolean>;
 export type Filters = FilteringOptions & {
     files?: string[];
     suites?: string[];
 };
-/**
- * Shape of the plugin function
- */
-export type PluginFn = (config: Required<Config>, runner: Runner, classes: {
-    Test: typeof Test;
-    TestContext: typeof TestContext;
-    Group: typeof Group;
+export type PluginFn = (japa: {
+    config: Required<Config>;
+    cliArgs: CLIArgs;
+    runner: Runner;
+    emitter: Emitter;
 }) => void | Promise<void>;
-/**
- * Runner hooks
- */
-export type RunnerHooks = {
-    setup: RunnerHooksHandler[];
-    teardown: RunnerHooksHandler[];
-};
-/**
- * Base configuration options
- */
 export type BaseConfig = {
-    cliArgs?: Record<string, any>;
     cwd?: string;
     timeout?: number;
-    plugins?: PluginFn[];
+    retries?: number;
     filters?: Filters;
     configureSuite?: (suite: Suite) => void;
-    reporters?: ReporterContract[];
-    importer?: (filePath: string) => void | Promise<void>;
+    reporters?: {
+        activated: string[];
+        list: NamedReporterContract[];
+    };
+    plugins?: PluginFn[];
+    importer?: (filePath: URL) => void | Promise<void>;
     refiner?: Refiner;
     forceExit?: boolean;
-} & Partial<RunnerHooks>;
-/**
- * Type for the "config.files" property
- */
-export type ConfigFiles = string[] | (() => string[] | Promise<string[]>);
-/**
- * Type for the "config.suite" property
- */
-export type ConfigSuite = {
+    setup?: SetupHookHandler[];
+    teardown?: TeardownHookHandler[];
+};
+export type TestFiles = string | string[] | (() => URL[] | Promise<URL[]>);
+export type TestSuite = {
     name: string;
-    files: string | string[] | (() => string[] | Promise<string[]>);
+    files: TestFiles;
     configure?: (suite: Suite) => void;
     timeout?: number;
+    retries?: number;
 };
-/**
- * Configuration options
- */
 export type Config = BaseConfig & ({
-    files: ConfigFiles;
+    files: TestFiles;
 } | {
-    suites: ConfigSuite[];
+    suites: TestSuite[];
 });
+//# sourceMappingURL=types.d.ts.map

package/build/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/build/src/types.js

@@ -1,10 +1 @@
-"use strict";
-/*
- * @japa/runner
- *
- * (c) Japa.dev
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
+export * from '../modules/core/types.js';

package/build/src/validator.d.ts

@@ -0,0 +1,11 @@
+import { Config } from './types.js';
+declare class Validator {
+    ensureIsConfigured(config: Required<Config> | undefined): void;
+    ensureIsInPlanningPhase(phase: 'idle' | 'planning' | 'executing'): void;
+    validateSuitesFilter(config: Required<Config>): void;
+    validateSuitesForUniqueness(config: Required<Config>): void;
+    validateActivatedReporters(config: Required<Config>): void;
+}
+declare const _default: Validator;
+export default _default;
+//# sourceMappingURL=validator.d.ts.map

package/build/src/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/validator.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAMnC,cAAM,SAAS;IAIb,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,SAAS;IAWvD,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW;IAWhE,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IA+B7C,2BAA2B,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IAoBpD,0BAA0B,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;CAYpD;;AAED,wBAA8B"}

package/build/src/validator.js

@@ -0,0 +1,46 @@
+class Validator {
+    ensureIsConfigured(config) {
+        if (!config) {
+            throw new Error(`Cannot run tests. Make sure to call "configure" method before the "run" method`);
+        }
+    }
+    ensureIsInPlanningPhase(phase) {
+        if (phase !== 'planning') {
+            throw new Error(`Cannot import japa test file directly. It must be imported by calling the "japa.run" method`);
+        }
+    }
+    validateSuitesFilter(config) {
+        if (!config.filters.suites || !config.filters.suites.length) {
+            return;
+        }
+        if (!('suites' in config) || !config.suites.length) {
+            throw new Error(`Cannot apply suites filter. You have not configured any test suites`);
+        }
+        const suites = config.suites.map(({ name }) => name);
+        const unknownSuites = config.filters.suites.filter((suite) => !suites.includes(suite));
+        if (unknownSuites.length) {
+            throw new Error(`Cannot apply suites filter. "${unknownSuites[0]}" suite is not configured`);
+        }
+    }
+    validateSuitesForUniqueness(config) {
+        if (!('suites' in config)) {
+            return;
+        }
+        const suites = new Set();
+        config.suites.forEach(({ name }) => {
+            if (suites.has(name)) {
+                throw new Error(`Duplicate suite "${name}"`);
+            }
+            suites.add(name);
+        });
+        suites.clear();
+    }
+    validateActivatedReporters(config) {
+        const reportersList = config.reporters.list.map(({ name }) => name);
+        const unknownReporters = config.reporters.activated.filter((name) => !reportersList.includes(name));
+        if (unknownReporters.length) {
+            throw new Error(`Invalid reporter "${unknownReporters[0]}". Make sure to register it first inside the "reporters.list" array`);
+        }
+    }
+}
+export default new Validator();