poku 1.11.0 → 1.12.1

package/README.md

@@ -1,19 +1,19 @@
 [node-version-url]: https://github.com/nodejs/node
-[node-version-image]: https://img.shields.io/badge/Node.js->=%206.0.0-badc58
 [bun-version-url]: https://github.com/oven-sh/bun
-[bun-version-image]: https://img.shields.io/badge/Bun->=%200.5.3-f471b5
 [deno-version-url]: https://github.com/denoland/deno
-[deno-version-image]: https://img.shields.io/badge/Deno->=%201.30.0-70ffaf
 [typescript-url]: https://github.com/microsoft/TypeScript
-[typescript-version-image]: https://img.shields.io/badge/TypeScript->=%204.7.2-3077c6
-[ci-url]: https://github.com/wellwelwel/poku/actions/workflows/ci.yml?query=branch%3Amain
-[ci-image]: https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci.yml?event=push&style=flat&label=CI&branch=main
-[ql-url]: https://github.com/wellwelwel/poku/actions/workflows/codeql.yml?query=branch%3Amain
-[ql-image]: https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci-codeql.yml?event=push&style=flat&label=Code%20QL&branch=main
+[ci-linux-url]: https://github.com/wellwelwel/poku/actions/workflows/ci_coverage-linux.yml?query=branch%3Amain
+[ci-linux-image]: https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci_coverage-linux.yml?event=push&style=flat&label=&branch=main&logo=ubuntu&logoColor=white
+[ci-osx-url]: https://github.com/wellwelwel/poku/actions/workflows/ci_coverage-osx.yml?query=branch%3Amain
+[ci-osx-image]: https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci_coverage-osx.yml?event=push&style=flat&label=&branch=main&logo=apple&logoColor=white
+[ci-windows-url]: https://github.com/wellwelwel/poku/actions/workflows/ci_coverage-windows.yml?query=branch%3Amain
+[ci-windows-image]: https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci_coverage-windows.yml?event=push&style=flat&label=&branch=main&logo=windows&logoColor=white
+[ql-url]: https://github.com/wellwelwel/poku/actions/workflows/ci_codeql.yml?query=branch%3Amain
+[ql-image]: https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci_codeql.yml?event=push&style=flat&label=&branch=main&logo=github&logoColor=white
 [coverage-image]: https://img.shields.io/codecov/c/github/wellwelwel/poku?label=Coverage
 [coverage-url]: https://app.codecov.io/github/wellwelwel/poku
-[downloads-image]: https://img.shields.io/npm/dt/poku.svg?&color=FFC312&label=Downloads
-[downloads-url]: https://npmjs.org/package/poku
+[downloads-image]: https://img.shields.io/npm/dt/poku.svg?&label=Downloads&logo=npm&logoColor=white&color=1e90ff
+[downloads-url]: https://www.npmjs.com/package/poku
 [license-url]: https://github.com/wellwelwel/poku/blob/main/LICENSE
 [license-image]: https://img.shields.io/npm/l/poku.svg?maxAge=2592000&color=9c88ff&label=License
 
@@ -24,14 +24,12 @@
 
 **Poku** can show you _how simple testing can be_ 🌱
 
-[![Node.js Version][node-version-image]][node-version-url]
-[![Bun Version][bun-version-image]][bun-version-url]
-[![Deno Version][deno-version-image]][deno-version-url]
-[![TypeScript Version][typescript-version-image]][typescript-url]<br />
-[![GitHub Workflow Status (with event)][ci-image]][ci-url]
-[![GitHub Workflow Status (with event)][ql-image]][ql-url]
-[![Coverage][coverage-image]][coverage-url]
+[![GitHub Workflow Status (with event)][ci-linux-image]][ci-linux-url]
+[![GitHub Workflow Status (with event)][ci-osx-image]][ci-osx-url]
+[![GitHub Workflow Status (with event)][ci-windows-image]][ci-windows-url]
+[![GitHub Workflow Status (with event)][ql-image]][ql-url]<br />
 [![NPM Downloads][downloads-image]][downloads-url]
+[![Coverage][coverage-image]][coverage-url]
 [![License][license-image]][license-url]
 
 Enjoying **Poku**? Consider giving him a star ⭐️
@@ -272,8 +270,8 @@ Please check the [**SECURITY.md**](./SECURITY.md) and the section [**Is Poku Saf
 
 ## Limitations
 
-- **Poku** is still a bit lonely, without an **active community** around him, but we can change it 🤝
-- Each file generates a sub-process during its execution. This can be reflected in projects with an extremely high volume of test files when run in parallel.
+- **Poku** community is gradually building up 🤝
+- Although it has no external dependencies, **Poku** is not _all-in-one_, so it doesn't have features such as _mocks_ and _spies_, where you can use your favorite packages or native solutions.
 
 ---
 

package/lib/{helpers/parseAsssetion.d.ts → @types/assert.d.ts}

@@ -6,4 +6,3 @@ export type ParseAssertionOptions = {
     throw?: boolean;
     hideDiff?: boolean;
 };
-export declare const parseAssertion: (cb: () => void | Promise<void>, options: ParseAssertionOptions) => Promise<void>;

package/lib/@types/assert.js

@@ -0,0 +1,4 @@
+"use strict";
+/* c8 ignore start */
+Object.defineProperty(exports, "__esModule", { value: true });
+/* c8 ignore stop */

package/lib/@types/background-process.js

@@ -1,2 +1,4 @@
 "use strict";
+/* c8 ignore start */
 Object.defineProperty(exports, "__esModule", { value: true });
+/* c8 ignore stop */

package/lib/@types/code.js

@@ -1,2 +1,4 @@
 "use strict";
+/* c8 ignore start */
 Object.defineProperty(exports, "__esModule", { value: true });
+/* c8 ignore stop */

package/lib/@types/list-files.d.ts

@@ -12,3 +12,7 @@ export type Configs = {
      */
     exclude?: RegExp | RegExp[];
 };
+export type FileResults = {
+    success: string[];
+    fail: string[];
+};

package/lib/@types/list-files.js

@@ -1,2 +1,4 @@
 "use strict";
+/* c8 ignore start */
 Object.defineProperty(exports, "__esModule", { value: true });
+/* c8 ignore stop */

package/lib/@types/poku.d.ts

@@ -56,6 +56,12 @@ export type Configs = {
      * @default false
      */
     failFast?: boolean;
+    /**
+     * Limits the number of tests running concurrently.
+     *
+     * @default 0
+     */
+    concurrency?: number;
     /**
      * You can use this option to run a **callback** or a **file** before each test file on your suite.
      *

package/lib/@types/poku.js

@@ -1,2 +1,4 @@
 "use strict";
+/* c8 ignore start */
 Object.defineProperty(exports, "__esModule", { value: true });
+/* c8 ignore stop */

package/lib/@types/runner.js

@@ -1,2 +1,4 @@
 "use strict";
+/* c8 ignore start */
 Object.defineProperty(exports, "__esModule", { value: true });
+/* c8 ignore stop */

package/lib/bin/index.js

@@ -1,5 +1,6 @@
 #! /usr/bin/env node
 "use strict";
+/* c8 ignore start */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -11,7 +12,6 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 var _a, _b;
 Object.defineProperty(exports, "__esModule", { value: true });
-/* c8 ignore start */
 const list_files_js_1 = require("../modules/list-files.js");
 const get_arg_js_1 = require("../helpers/get-arg.js");
 const index_js_1 = require("../index.js");
@@ -26,6 +26,7 @@ const exclude = (0, get_arg_js_1.getArg)('exclude');
 const killPort = (0, get_arg_js_1.getArg)('kill-port');
 const killRange = (0, get_arg_js_1.getArg)('kill-range');
 const killPID = (0, get_arg_js_1.getArg)('kill-pid');
+const concurrency = Number((0, get_arg_js_1.getArg)('concurrency')) || undefined;
 const parallel = (0, get_arg_js_1.hasArg)('parallel');
 const quiet = (0, get_arg_js_1.hasArg)('quiet');
 const debug = (0, get_arg_js_1.hasArg)('debug');
@@ -58,6 +59,7 @@ if ((0, get_arg_js_1.hasArg)('log-success'))
         quiet,
         debug,
         failFast,
+        concurrency,
     });
 }))();
 /* c8 ignore stop */

package/lib/configs/each.js

@@ -1,4 +1,5 @@
 "use strict";
+/* c8 ignore start */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.each = void 0;
 exports.each = {

package/lib/configs/files.d.ts

@@ -0,0 +1,2 @@
+import { FileResults } from '../@types/list-files.js';
+export declare const fileResults: FileResults;

package/lib/configs/files.js

@@ -0,0 +1,9 @@
+"use strict";
+/* c8 ignore start */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fileResults = void 0;
+exports.fileResults = {
+    success: [],
+    fail: [],
+};
+/* c8 ignore stop */

package/lib/{helpers → configs}/indentation.js

@@ -1,7 +1,9 @@
 "use strict";
+/* c8 ignore start */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.indentation = void 0;
 exports.indentation = {
     test: '  ',
     stdio: '      ',
 };
+/* c8 ignore stop */

package/lib/helpers/find-file.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.findFile = void 0;
-const node_os_1 = require("os");
 /* c8 ignore start */
+const node_os_1 = require("os");
 const findFile = (error) => {
     var _a;
     const stackLines = ((_a = error.stack) === null || _a === void 0 ? void 0 : _a.split(node_os_1.EOL)) || [];

package/lib/helpers/format.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getLargestStringLength = exports.format = exports.backgroundColor = void 0;
 /* c8 ignore start */
-const pad_js_1 = require("./pad.js");
+const pad_js_1 = require("../polyfills/pad.js");
 exports.backgroundColor = {
     white: 7,
     black: 40,

package/lib/helpers/get-arg.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getLastParam = exports.hasArg = exports.getArg = void 0;
+/* c8 ignore start */
 const node_process_1 = __importDefault(require("process"));
 const [, , ...args] = node_process_1.default.argv;
 const getArg = (arg) => {
@@ -20,3 +21,4 @@ const getLastParam = () => {
     return args[args.length - 1];
 };
 exports.getLastParam = getLastParam;
+/* c8 ignore stop */

package/lib/helpers/logs.js

@@ -5,3 +5,4 @@ const isQuiet = (configs) => typeof (configs === null || configs === void 0 ? vo
 exports.isQuiet = isQuiet;
 const isDebug = (configs) => Boolean(configs === null || configs === void 0 ? void 0 : configs.debug);
 exports.isDebug = isDebug;
+/* c8 ignore stop */

package/lib/helpers/parse-assertion.d.ts

@@ -0,0 +1,3 @@
+import { ParseAssertionOptions } from '../@types/assert.js';
+export declare const parseResultType: (type?: unknown) => string;
+export declare const parseAssertion: (cb: () => void | Promise<void>, options: ParseAssertionOptions) => Promise<void>;

package/lib/helpers/{parseAsssetion.js → parse-assertion.js}

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseAssertion = void 0;
+exports.parseAssertion = exports.parseResultType = void 0;
 const node_process_1 = __importDefault(require("process"));
 const node_path_1 = __importDefault(require("path"));
 const node_assert_1 = __importDefault(require("assert"));
@@ -21,6 +21,31 @@ const format_js_1 = require("./format.js");
 const hr_js_1 = require("./hr.js");
 const find_file_js_1 = require("./find-file.js");
 const each_js_1 = require("../configs/each.js");
+const object_js_1 = require("../polyfills/object.js");
+const get_runtime_js_1 = require("./get-runtime.js");
+const parseResultType = (type) => {
+    const recurse = (value) => {
+        if (typeof value === 'undefined')
+            return 'undefined';
+        if (typeof value === 'function' ||
+            typeof value === 'bigint' ||
+            value instanceof RegExp)
+            return String(value);
+        if (Array.isArray(value))
+            return value.map(recurse);
+        /* c8 ignore start */
+        if (value !== null && typeof value === 'object') {
+            if (!get_runtime_js_1.nodeVersion || get_runtime_js_1.nodeVersion >= 12)
+                return Object.fromEntries(Object.entries(value).map(([key, val]) => [key, recurse(val)]));
+            return (0, object_js_1.fromEntries)((0, object_js_1.entries)(value).map(([key, val]) => [key, recurse(val)]));
+        }
+        /* c8 ignore stop */
+        return value;
+    };
+    const result = recurse(type);
+    return typeof result === 'string' ? result : JSON.stringify(result, null, 2);
+};
+exports.parseResultType = parseResultType;
 const parseAssertion = (cb, options) => __awaiter(void 0, void 0, void 0, function* () {
     var _a, _b;
     const isPoku = typeof ((_a = node_process_1.default.env) === null || _a === void 0 ? void 0 : _a.FILE) === 'string' && ((_b = node_process_1.default.env) === null || _b === void 0 ? void 0 : _b.FILE.length) > 0;
@@ -69,14 +94,12 @@ const parseAssertion = (cb, options) => __awaiter(void 0, void 0, void 0, functi
             console.log(`${format_js_1.format.dim('      Code')} ${code}`);
             console.log(`${format_js_1.format.dim('  Operator')} ${operator}${node_os_1.EOL}`);
             if (!(options === null || options === void 0 ? void 0 : options.hideDiff)) {
+                const splitActual = (0, exports.parseResultType)(actual).split('\n');
+                const splitExpected = (0, exports.parseResultType)(expected).split('\n');
                 console.log(format_js_1.format.dim(`  ${(options === null || options === void 0 ? void 0 : options.actual) || 'Actual'}:`));
-                console.log(format_js_1.format.bold(typeof actual === 'function' || actual instanceof RegExp
-                    ? `  ${String(actual)}`
-                    : `  ${format_js_1.format.fail(JSON.stringify(actual))}`));
+                splitActual.forEach((line) => console.log(`  ${format_js_1.format.bold(format_js_1.format.fail(line))}`));
                 console.log(`${node_os_1.EOL}  ${format_js_1.format.dim(`${(options === null || options === void 0 ? void 0 : options.expected) || 'Expected'}:`)}`);
-                console.log(format_js_1.format.bold(`${typeof expected === 'function' || expected instanceof RegExp
-                    ? `  ${String(expected)}`
-                    : `  ${format_js_1.format.success(JSON.stringify(expected))}`}`));
+                splitExpected.forEach((line) => console.log(`  ${format_js_1.format.bold(format_js_1.format.success(line))}`));
             }
             if (options.throw) {
                 console.log(error);

package/lib/modules/assert-promise.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" />
 import * as nodeAssert from 'node:assert';
-import { ParseAssertionOptions } from '../helpers/parseAsssetion.js';
+import { ParseAssertionOptions } from '../@types/assert.js';
 declare function doesNotThrow(block: () => unknown, message?: string | ParseAssertionOptions['message']): Promise<void>;
 declare function doesNotThrow(block: () => unknown, error: nodeAssert.AssertPredicate, message?: ParseAssertionOptions['message']): Promise<void>;
 declare function throws(block: () => unknown, message?: ParseAssertionOptions['message']): Promise<void>;

package/lib/modules/assert-promise.js

@@ -34,55 +34,55 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.assertPromise = void 0;
 const nodeAssert = __importStar(require("assert"));
-const parseAsssetion_js_1 = require("../helpers/parseAsssetion.js");
+const parse_assertion_js_1 = require("../helpers/parse-assertion.js");
 const get_runtime_js_1 = require("../helpers/get-runtime.js");
 const ok = (value, message) => __awaiter(void 0, void 0, void 0, function* () {
-    yield (0, parseAsssetion_js_1.parseAssertion)(() => {
+    yield (0, parse_assertion_js_1.parseAssertion)(() => {
         nodeAssert.ok(value);
     }, { message });
 });
 const equal = (actual, expected, message) => __awaiter(void 0, void 0, void 0, function* () {
-    yield (0, parseAsssetion_js_1.parseAssertion)(() => {
+    yield (0, parse_assertion_js_1.parseAssertion)(() => {
         nodeAssert.equal(actual, expected);
     }, { message });
 });
 const deepEqual = (actual, expected, message) => __awaiter(void 0, void 0, void 0, function* () {
-    yield (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.deepEqual(actual, expected), {
+    yield (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.deepEqual(actual, expected), {
         message,
     });
 });
 const strictEqual = (actual, expected, message) => __awaiter(void 0, void 0, void 0, function* () {
-    yield (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.strictEqual(actual, expected), {
+    yield (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.strictEqual(actual, expected), {
         message,
     });
 });
 const deepStrictEqual = (actual, expected, message) => __awaiter(void 0, void 0, void 0, function* () {
-    yield (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.deepStrictEqual(actual, expected), {
+    yield (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.deepStrictEqual(actual, expected), {
         message,
     });
 });
 const notEqual = (actual, expected, message) => __awaiter(void 0, void 0, void 0, function* () {
-    yield (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.notEqual(actual, expected), {
+    yield (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.notEqual(actual, expected), {
         message,
     });
 });
 const notDeepEqual = (actual, expected, message) => __awaiter(void 0, void 0, void 0, function* () {
-    yield (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.notDeepEqual(actual, expected), {
+    yield (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.notDeepEqual(actual, expected), {
         message,
     });
 });
 const notStrictEqual = (actual, expected, message) => __awaiter(void 0, void 0, void 0, function* () {
-    yield (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.notStrictEqual(actual, expected), {
+    yield (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.notStrictEqual(actual, expected), {
         message,
     });
 });
 const notDeepStrictEqual = (actual, expected, message) => __awaiter(void 0, void 0, void 0, function* () {
-    yield (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.notDeepStrictEqual(actual, expected), {
+    yield (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.notDeepStrictEqual(actual, expected), {
         message,
     });
 });
 const ifError = (value, message) => __awaiter(void 0, void 0, void 0, function* () {
-    yield (0, parseAsssetion_js_1.parseAssertion)(() => {
+    yield (0, parse_assertion_js_1.parseAssertion)(() => {
         nodeAssert.ifError(value);
     }, {
         message,
@@ -92,7 +92,7 @@ const ifError = (value, message) => __awaiter(void 0, void 0, void 0, function*
     });
 });
 const fail = (message) => __awaiter(void 0, void 0, void 0, function* () {
-    yield (0, parseAsssetion_js_1.parseAssertion)(() => {
+    yield (0, parse_assertion_js_1.parseAssertion)(() => {
         nodeAssert.fail(message);
     }, {
         message,
@@ -102,7 +102,7 @@ const fail = (message) => __awaiter(void 0, void 0, void 0, function* () {
 });
 function doesNotThrow(block, errorOrMessage, message) {
     return __awaiter(this, void 0, void 0, function* () {
-        yield (0, parseAsssetion_js_1.parseAssertion)(() => {
+        yield (0, parse_assertion_js_1.parseAssertion)(() => {
             if (typeof errorOrMessage === 'function' ||
                 errorOrMessage instanceof RegExp ||
                 typeof errorOrMessage === 'object') {
@@ -125,7 +125,7 @@ function throws(block, errorOrMessage, message) {
         if (typeof errorOrMessage === 'function' ||
             errorOrMessage instanceof RegExp ||
             typeof errorOrMessage === 'object') {
-            yield (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.throws(block, errorOrMessage), {
+            yield (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.throws(block, errorOrMessage), {
                 message,
                 defaultMessage: 'Expected function to throw',
                 hideDiff: true,
@@ -133,7 +133,7 @@ function throws(block, errorOrMessage, message) {
         }
         else {
             const msg = typeof errorOrMessage !== 'undefined' ? errorOrMessage : message;
-            yield (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.throws(block, message), {
+            yield (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.throws(block, message), {
                 message: msg,
                 defaultMessage: 'Expected function to throw',
                 hideDiff: true,
@@ -143,7 +143,7 @@ function throws(block, errorOrMessage, message) {
 }
 function rejects(block, errorOrMessage, message) {
     return __awaiter(this, void 0, void 0, function* () {
-        yield (0, parseAsssetion_js_1.parseAssertion)(() => __awaiter(this, void 0, void 0, function* () {
+        yield (0, parse_assertion_js_1.parseAssertion)(() => __awaiter(this, void 0, void 0, function* () {
             if (typeof errorOrMessage === 'function' ||
                 errorOrMessage instanceof RegExp ||
                 typeof errorOrMessage === 'object') {
@@ -163,7 +163,7 @@ function rejects(block, errorOrMessage, message) {
 }
 function doesNotReject(block, errorOrMessage, message) {
     return __awaiter(this, void 0, void 0, function* () {
-        yield (0, parseAsssetion_js_1.parseAssertion)(() => __awaiter(this, void 0, void 0, function* () {
+        yield (0, parse_assertion_js_1.parseAssertion)(() => __awaiter(this, void 0, void 0, function* () {
             if (typeof errorOrMessage === 'function' ||
                 errorOrMessage instanceof RegExp ||
                 typeof errorOrMessage === 'object')
@@ -183,7 +183,7 @@ const match = (value, regExp, message) => __awaiter(void 0, void 0, void 0, func
     if (typeof get_runtime_js_1.nodeVersion === 'number' && get_runtime_js_1.nodeVersion < 12) {
         throw new Error('match is available from Node.js 12 or higher');
     }
-    yield (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert === null || nodeAssert === void 0 ? void 0 : nodeAssert.match(value, regExp), {
+    yield (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert === null || nodeAssert === void 0 ? void 0 : nodeAssert.match(value, regExp), {
         message,
         actual: 'Value',
         expected: 'RegExp',
@@ -196,7 +196,7 @@ const doesNotMatch = (value, regExp, message) => __awaiter(void 0, void 0, void
     if (typeof get_runtime_js_1.nodeVersion === 'number' && get_runtime_js_1.nodeVersion < 12) {
         throw new Error('doesNotMatch is available from Node.js 12 or higher');
     }
-    yield (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.doesNotMatch(value, regExp), {
+    yield (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.doesNotMatch(value, regExp), {
         message,
         actual: 'Value',
         expected: 'RegExp',

package/lib/modules/assert.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" />
 import * as nodeAssert from 'node:assert';
-import { ParseAssertionOptions } from '../helpers/parseAsssetion.js';
+import { ParseAssertionOptions } from '../@types/assert.js';
 declare function doesNotThrow(block: () => unknown, message?: string | ParseAssertionOptions['message']): void;
 declare function doesNotThrow(block: () => unknown, error: nodeAssert.AssertPredicate, message?: ParseAssertionOptions['message']): void;
 declare function throws(block: () => unknown, message?: ParseAssertionOptions['message']): void;

package/lib/modules/assert.js

@@ -34,49 +34,49 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.assert = void 0;
 const nodeAssert = __importStar(require("assert"));
-const parseAsssetion_js_1 = require("../helpers/parseAsssetion.js");
+const parse_assertion_js_1 = require("../helpers/parse-assertion.js");
 const get_runtime_js_1 = require("../helpers/get-runtime.js");
 const ok = (value, message) => {
-    (0, parseAsssetion_js_1.parseAssertion)(() => {
+    (0, parse_assertion_js_1.parseAssertion)(() => {
         nodeAssert.ok(value);
     }, { message });
 };
 const equal = (actual, expected, message) => {
-    (0, parseAsssetion_js_1.parseAssertion)(() => {
+    (0, parse_assertion_js_1.parseAssertion)(() => {
         nodeAssert.equal(actual, expected);
     }, { message });
 };
 const deepEqual = (actual, expected, message) => {
-    (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.deepEqual(actual, expected), { message });
+    (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.deepEqual(actual, expected), { message });
 };
 const strictEqual = (actual, expected, message) => {
-    (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.strictEqual(actual, expected), { message });
+    (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.strictEqual(actual, expected), { message });
 };
 const deepStrictEqual = (actual, expected, message) => {
-    (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.deepStrictEqual(actual, expected), {
+    (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.deepStrictEqual(actual, expected), {
         message,
     });
 };
 const notEqual = (actual, expected, message) => {
-    (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.notEqual(actual, expected), {
+    (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.notEqual(actual, expected), {
         message,
     });
 };
 const notDeepEqual = (actual, expected, message) => {
-    (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.notDeepEqual(actual, expected), { message });
+    (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.notDeepEqual(actual, expected), { message });
 };
 const notStrictEqual = (actual, expected, message) => {
-    (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.notStrictEqual(actual, expected), {
+    (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.notStrictEqual(actual, expected), {
         message,
     });
 };
 const notDeepStrictEqual = (actual, expected, message) => {
-    (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.notDeepStrictEqual(actual, expected), {
+    (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.notDeepStrictEqual(actual, expected), {
         message,
     });
 };
 const ifError = (value, message) => {
-    (0, parseAsssetion_js_1.parseAssertion)(() => {
+    (0, parse_assertion_js_1.parseAssertion)(() => {
         nodeAssert.ifError(value);
     }, {
         message,
@@ -86,7 +86,7 @@ const ifError = (value, message) => {
     });
 };
 const fail = (message) => {
-    (0, parseAsssetion_js_1.parseAssertion)(() => {
+    (0, parse_assertion_js_1.parseAssertion)(() => {
         nodeAssert.fail(message);
     }, {
         message,
@@ -95,7 +95,7 @@ const fail = (message) => {
     });
 };
 function doesNotThrow(block, errorOrMessage, message) {
-    (0, parseAsssetion_js_1.parseAssertion)(() => {
+    (0, parse_assertion_js_1.parseAssertion)(() => {
         if (typeof errorOrMessage === 'function' ||
             errorOrMessage instanceof RegExp ||
             typeof errorOrMessage === 'object') {
@@ -116,7 +116,7 @@ function throws(block, errorOrMessage, message) {
     if (typeof errorOrMessage === 'function' ||
         errorOrMessage instanceof RegExp ||
         typeof errorOrMessage === 'object') {
-        (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.throws(block, errorOrMessage), {
+        (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.throws(block, errorOrMessage), {
             message,
             defaultMessage: 'Expected function to throw',
             hideDiff: true,
@@ -124,7 +124,7 @@ function throws(block, errorOrMessage, message) {
     }
     else {
         const msg = typeof errorOrMessage !== 'undefined' ? errorOrMessage : message;
-        (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.throws(block, message), {
+        (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.throws(block, message), {
             message: msg,
             defaultMessage: 'Expected function to throw',
             hideDiff: true,
@@ -133,7 +133,7 @@ function throws(block, errorOrMessage, message) {
 }
 function rejects(block, errorOrMessage, message) {
     return __awaiter(this, void 0, void 0, function* () {
-        yield (0, parseAsssetion_js_1.parseAssertion)(() => __awaiter(this, void 0, void 0, function* () {
+        yield (0, parse_assertion_js_1.parseAssertion)(() => __awaiter(this, void 0, void 0, function* () {
             if (typeof errorOrMessage === 'function' ||
                 errorOrMessage instanceof RegExp ||
                 typeof errorOrMessage === 'object') {
@@ -153,7 +153,7 @@ function rejects(block, errorOrMessage, message) {
 }
 function doesNotReject(block, errorOrMessage, message) {
     return __awaiter(this, void 0, void 0, function* () {
-        yield (0, parseAsssetion_js_1.parseAssertion)(() => __awaiter(this, void 0, void 0, function* () {
+        yield (0, parse_assertion_js_1.parseAssertion)(() => __awaiter(this, void 0, void 0, function* () {
             if (typeof errorOrMessage === 'function' ||
                 errorOrMessage instanceof RegExp ||
                 typeof errorOrMessage === 'object')
@@ -173,7 +173,7 @@ const match = (value, regExp, message) => {
     if (typeof get_runtime_js_1.nodeVersion === 'number' && get_runtime_js_1.nodeVersion < 12) {
         throw new Error('match is available from Node.js 12 or higher');
     }
-    (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert === null || nodeAssert === void 0 ? void 0 : nodeAssert.match(value, regExp), {
+    (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert === null || nodeAssert === void 0 ? void 0 : nodeAssert.match(value, regExp), {
         message,
         actual: 'Value',
         expected: 'RegExp',
@@ -186,7 +186,7 @@ const doesNotMatch = (value, regExp, message) => {
     if (typeof get_runtime_js_1.nodeVersion === 'number' && get_runtime_js_1.nodeVersion < 12) {
         throw new Error('doesNotMatch is available from Node.js 12 or higher');
     }
-    (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.doesNotMatch(value, regExp), {
+    (0, parse_assertion_js_1.parseAssertion)(() => nodeAssert.doesNotMatch(value, regExp), {
         message,
         actual: 'Value',
         expected: 'RegExp',

package/lib/modules/create-service.js

@@ -36,7 +36,8 @@ const backgroundProcess = (runtime, args, file, options) => new Promise((resolve
             shell: runner_js_1.isWindows,
             cwd: (options === null || options === void 0 ? void 0 : options.cwd)
                 ? (0, list_files_js_1.sanitizePath)(node_path_1.default.normalize(options.cwd))
-                : undefined,
+                : /* c8 ignore next */
+                    undefined,
             env: node_process_1.default.env,
             /* c8 ignore next */
             detached: !runner_js_1.isWindows,

package/lib/modules/describe.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.describe = exports.log = void 0;
+/* c8 ignore start */
 const node_os_1 = require("os");
 const format_js_1 = require("../helpers/format.js");
 /**

package/lib/modules/each.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.afterEach = exports.beforeEach = void 0;
+/* c8 ignore next */
 const each_js_1 = require("../configs/each.js");
+/* c8 ignore stop */
 /**
  * - ✅ Handling **global** and **external** services (_preparing a database, for example_)
  * - ✅ It's made for **exclusive use** in combination with **Poku**'s **`assert`** methods

package/lib/modules/poku.d.ts

@@ -1,6 +1,3 @@
-/**
- * Both CLI, API, noExit, sequential and parallel runs are strictly tested, but these tests use deep child process for it
- */
 import { Code } from '../@types/code.js';
 import { Configs } from '../@types/poku.js';
 export declare function poku(targetPaths: string | string[], configs: Configs & {

package/lib/modules/poku.js

@@ -1,7 +1,5 @@
 "use strict";
-/**
- * Both CLI, API, noExit, sequential and parallel runs are strictly tested, but these tests use deep child process for it
- */
+/* c8 ignore start */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -13,7 +11,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.poku = void 0;
-/* c8 ignore start */
+/**
+ * Both CLI, API, noExit, sequential and parallel runs are strictly tested, but these tests use deep child process for it
+ */
 const node_os_1 = require("os");
 const force_array_js_1 = require("../helpers/force-array.js");
 const run_tests_js_1 = require("../services/run-tests.js");
@@ -21,8 +21,8 @@ const exit_js_1 = require("./exit.js");
 const format_js_1 = require("../helpers/format.js");
 const logs_js_1 = require("../helpers/logs.js");
 const hr_js_1 = require("../helpers/hr.js");
-const run_test_file_js_1 = require("../services/run-test-file.js");
-const indentation_js_1 = require("../helpers/indentation.js");
+const files_js_1 = require("../configs/files.js");
+const indentation_js_1 = require("../configs/indentation.js");
 function poku(targetPaths, configs) {
     return __awaiter(this, void 0, void 0, function* () {
         let code = 0;
@@ -62,12 +62,12 @@ function poku(targetPaths, configs) {
         }
         catch (_a) { }
         showLogs && (0, hr_js_1.hr)();
-        if (showLogs && run_test_file_js_1.fileResults.success.length > 0)
-            console.log(run_test_file_js_1.fileResults.success
+        if (showLogs && files_js_1.fileResults.success.length > 0)
+            console.log(files_js_1.fileResults.success
                 .map((current) => `${indentation_js_1.indentation.test}${format_js_1.format.success('✔')} ${format_js_1.format.dim(current)}`)
                 .join(node_os_1.EOL));
-        if (showLogs && run_test_file_js_1.fileResults.fail.length > 0)
-            console.log(run_test_file_js_1.fileResults.fail
+        if (showLogs && files_js_1.fileResults.fail.length > 0)
+            console.log(files_js_1.fileResults.fail
                 .map((current) => `${indentation_js_1.indentation.test}${format_js_1.format.fail('✘')} ${current}`)
                 .join(node_os_1.EOL));
         if (configs === null || configs === void 0 ? void 0 : configs.noExit)

package/lib/modules/test.js

@@ -10,11 +10,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.test = void 0;
+/* c8 ignore next */
 const each_js_1 = require("../configs/each.js");
 function test(cb) {
     return __awaiter(this, void 0, void 0, function* () {
         if (typeof each_js_1.each.before.cb === 'function' && each_js_1.each.before.test) {
             const beforeResult = each_js_1.each.before.cb();
+            /* c8 ignore next */
             if (beforeResult instanceof Promise)
                 yield beforeResult;
         }
@@ -24,6 +26,7 @@ function test(cb) {
             yield resultCb;
         if (typeof each_js_1.each.after.cb === 'function' && each_js_1.each.after.test) {
             const afterResult = each_js_1.each.after.cb();
+            /* c8 ignore next */
             if (afterResult instanceof Promise)
                 yield afterResult;
         }

package/lib/polyfills/object.d.ts

@@ -0,0 +1,10 @@
+export declare const entries: (obj: {
+    [key: string]: any;
+}) => [
+    string,
+    unknown
+][];
+export declare const fromEntries: (entries: [
+    string,
+    unknown
+][]) => Record<string, unknown>;

package/lib/polyfills/object.js

@@ -0,0 +1,23 @@
+"use strict";
+/* c8 ignore start */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromEntries = exports.entries = void 0;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const entries = (obj) => {
+    const ownProps = Object.keys(obj);
+    let i = ownProps.length;
+    const resArray = new Array(i);
+    // benchmark `while` outperformed `for`
+    while (i--)
+        resArray[i] = [ownProps[i], obj[ownProps[i]]];
+    return resArray;
+};
+exports.entries = entries;
+const fromEntries = (entries) => {
+    return entries.reduce((acc, [key, value]) => {
+        acc[key] = value;
+        return acc;
+    }, {});
+};
+exports.fromEntries = fromEntries;
+/* c8 ignore stop */

package/lib/services/run-test-file.d.ts

@@ -1,7 +1,2 @@
 import { Configs } from '../@types/poku.js';
-export type FileResults = {
-    success: string[];
-    fail: string[];
-};
-export declare const fileResults: FileResults;
 export declare const runTestFile: (filePath: string, configs?: Configs) => Promise<boolean>;

package/lib/services/run-test-file.js

@@ -12,24 +12,18 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runTestFile = exports.fileResults = void 0;
+exports.runTestFile = void 0;
 const node_process_1 = __importDefault(require("process"));
 const node_path_1 = __importDefault(require("path"));
 const node_os_1 = require("os");
 const node_child_process_1 = require("child_process");
 const runner_js_1 = require("../helpers/runner.js");
-const indentation_js_1 = require("../helpers/indentation.js");
+const indentation_js_1 = require("../configs/indentation.js");
 const format_js_1 = require("../helpers/format.js");
 const logs_js_1 = require("../helpers/logs.js");
 const remove_repeats_js_1 = require("../helpers/remove-repeats.js");
 const each_js_1 = require("./each.js");
-/* c8 ignore stop */
-/* c8 ignore start */
-exports.fileResults = {
-    success: [],
-    fail: [],
-};
-/* c8 ignore stop */
+const files_js_1 = require("../configs/files.js");
 const runTestFile = (filePath, configs) => new Promise((resolve) => __awaiter(void 0, void 0, void 0, function* () {
     const runtimeOptions = (0, runner_js_1.runner)(filePath, configs);
     const runtime = runtimeOptions.shift();
@@ -91,14 +85,14 @@ const runTestFile = (filePath, configs) => new Promise((resolve) => __awaiter(vo
             return false;
         const result = code === 0;
         if (result)
-            exports.fileResults.success.push(fileRelative);
+            files_js_1.fileResults.success.push(fileRelative);
         else
-            exports.fileResults.fail.push(fileRelative);
+            files_js_1.fileResults.fail.push(fileRelative);
         resolve(result);
     }));
     child.on('error', (err) => {
         console.log(`Failed to start test: ${filePath}`, err);
-        exports.fileResults.fail.push(fileRelative);
+        files_js_1.fileResults.fail.push(fileRelative);
         resolve(false);
     });
 }));

package/lib/services/run-tests.js

@@ -17,16 +17,18 @@ const node_process_1 = __importDefault(require("process"));
 const node_os_1 = require("os");
 const node_path_1 = __importDefault(require("path"));
 const runner_js_1 = require("../helpers/runner.js");
-const indentation_js_1 = require("../helpers/indentation.js");
+const indentation_js_1 = require("../configs/indentation.js");
 const list_files_js_1 = require("../modules/list-files.js");
 const hr_js_1 = require("../helpers/hr.js");
 const format_js_1 = require("../helpers/format.js");
 const run_test_file_js_1 = require("./run-test-file.js");
 const logs_js_1 = require("../helpers/logs.js");
+/* c8 ignore start */
 exports.results = {
     success: 0,
     fail: 0,
 };
+/* c8 ignore stop */
 const runTests = (dir, configs) => __awaiter(void 0, void 0, void 0, function* () {
     const cwd = node_process_1.default.cwd();
     const testDir = node_path_1.default.join(cwd, (0, list_files_js_1.sanitizePath)(dir));
@@ -73,22 +75,34 @@ const runTestsParallel = (dir, configs) => __awaiter(void 0, void 0, void 0, fun
     const cwd = node_process_1.default.cwd();
     const testDir = node_path_1.default.join(cwd, dir);
     const files = (0, list_files_js_1.isFile)(dir) ? [dir] : (0, list_files_js_1.listFiles)(testDir, undefined, configs);
+    const filesByConcurrency = [];
+    const concurrencyLimit = (configs === null || configs === void 0 ? void 0 : configs.concurrency) || 0;
+    const concurrencyResults = [];
+    if (concurrencyLimit > 0)
+        for (let i = 0; i < files.length; i += concurrencyLimit) {
+            filesByConcurrency.push(files.slice(i, i + concurrencyLimit));
+        }
+    else
+        filesByConcurrency.push(files);
     try {
-        const promises = files.map((filePath) => __awaiter(void 0, void 0, void 0, function* () {
-            if ((configs === null || configs === void 0 ? void 0 : configs.failFast) && exports.results.fail > 0)
-                return;
-            const testPassed = yield (0, run_test_file_js_1.runTestFile)(filePath, configs);
-            if (!testPassed) {
-                ++exports.results.fail;
-                if (configs === null || configs === void 0 ? void 0 : configs.failFast)
-                    throw `  ${format_js_1.format.fail('ℹ')} ${format_js_1.format.bold('fail-fast')} is enabled`;
-                return false;
-            }
-            ++exports.results.success;
-            return true;
-        }));
-        const concurrency = yield Promise.all(promises);
-        return concurrency.every((result) => result);
+        for (const fileGroup of filesByConcurrency) {
+            const promises = fileGroup.map((filePath) => __awaiter(void 0, void 0, void 0, function* () {
+                if ((configs === null || configs === void 0 ? void 0 : configs.failFast) && exports.results.fail > 0)
+                    return;
+                const testPassed = yield (0, run_test_file_js_1.runTestFile)(filePath, configs);
+                if (!testPassed) {
+                    ++exports.results.fail;
+                    if (configs === null || configs === void 0 ? void 0 : configs.failFast)
+                        throw `  ${format_js_1.format.fail('ℹ')} ${format_js_1.format.bold('fail-fast')} is enabled`;
+                    return false;
+                }
+                ++exports.results.success;
+                return true;
+            }));
+            const concurrency = yield Promise.all(promises);
+            concurrencyResults.push(concurrency);
+        }
+        return concurrencyResults.every((group) => group.every((result) => result));
     }
     catch (error) {
         (0, hr_js_1.hr)();

package/package.json

@@ -1,12 +1,19 @@
 {
   "name": "poku",
-  "version": "1.11.0",
+  "version": "1.12.1",
   "description": "🐷 Poku makes testing easy for Node.js, Bun & Deno at the same time.",
   "main": "./lib/index.js",
   "scripts": {
-    "test": "tsx src/bin/index.ts --parallel --debug --include=\"test/unit,test/integration,test/e2e\"",
-    "test:bun": "bun src/bin/index.ts --parallel --platform=bun --debug --include=\"test/unit,test/integration,test/e2e\"",
-    "test:c8": "c8 npm run test",
+    "test": "npm run test:parallel && npm run test:sequential",
+    "test:bun": "npm run test:bun:parallel && npm run test:bun:sequential",
+    "test:sequential": "tsx src/bin/index.ts --include=\"test/unit,test/integration,test/e2e\"",
+    "test:parallel": "npm run test:sequential -- --parallel",
+    "test:bun:sequential": "bun src/bin/index.ts --platform=\"bun\" --include=\"test/unit,test/integration,test/e2e\"",
+    "test:bun:parallel": "npm run test:bun:sequential -- --parallel",
+    "test:c8:sequential": "c8 tsx src/bin/index.ts --include=\"test/unit,test/integration,test/e2e\"",
+    "test:c8:parallel": "c8 tsx src/bin/index.ts --parallel --include=\"test/unit,test/integration,test/e2e\"",
+    "test:c8:sequential:options": "c8 tsx src/bin/index.ts --fast-fail --debug --exclude=\".bak\" --kill-port=\"4000\" --kill-range=\"4000-4001\" --include=\"test/unit,test/integration,test/e2e\"",
+    "test:c8:parallel:options": "c8 tsx src/bin/index.ts --parallel --concurrency=\"4\" --fast-fail --debug --exclude=\".bak\" --kill-port=\"4000\" --kill-range=\"4000-4001\" --include=\"test/unit,test/integration,test/e2e\"",
     "test:ci": "tsx ./test/ci.test.ts",
     "test:ci:node": "FILTER='node-' npm run test:ci",
     "test:ci:bun": "FILTER='bun-' npm run test:ci",
@@ -105,9 +112,9 @@
   ],
   "type": "commonjs",
   "devDependencies": {
-    "@types/node": "^20.12.11",
-    "@typescript-eslint/eslint-plugin": "^7.8.0",
-    "@typescript-eslint/parser": "^7.8.0",
+    "@types/node": "^20.12.12",
+    "@typescript-eslint/eslint-plugin": "^7.9.0",
+    "@typescript-eslint/parser": "^7.9.0",
     "c8": "^9.1.0",
     "eslint": "^8.57.0",
     "eslint-config-prettier": "^9.1.0",
@@ -117,7 +124,7 @@
     "packages-update": "^1.2.1",
     "prettier": "^3.2.5",
     "shx": "^0.3.4",
-    "tsx": "4.2.1",
+    "tsx": "4.10.5",
     "typescript": "^5.4.5"
   }
 }

package/lib/{helpers → polyfills}/pad.js

@@ -1,10 +1,10 @@
 "use strict";
+/* c8 ignore start */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.padStart = void 0;
 /**
  * Custom implementations of `padStart` for compatibility with Node.js version 6.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.padStart = void 0;
-/* c8 ignore start */
 const padStart = (str, targetLength, padString) => {
     padString = !padString ? ' ' : String(padString);
     if (str.length >= targetLength)