poku 2.2.3 → 2.3.0

package/README.md

@@ -7,7 +7,7 @@ Enjoying **Poku**? Give him a star to show your support 🌟
 
 [![NPM Downloads](https://img.shields.io/npm/v/poku.svg?label=&color=70a1ff&logo=npm&logoColor=white)](https://www.npmjs.com/package/poku)
 [![NPM Downloads](https://img.shields.io/npm/dt/poku.svg?label=&logo=npm&logoColor=white&color=45aaf2)](https://www.npmjs.com/package/poku)
-[![Coverage](https://img.shields.io/codecov/c/github/wellwelwel/poku?label=&logo=codecov&logoColor=white&color=98cc00)](https://app.codecov.io/github/wellwelwel/poku)<br />
+[![Coverage](https://img.shields.io/codecov/c/github/wellwelwel/poku?label=&logo=codecov&logoColor=white&color=98cc00)](https://github.com/wellwelwel/poku/tree/main/.nycrc)<br />
 [![GitHub Workflow Status (Linux)](https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci_coverage-linux.yml?event=push&label=&branch=main&logo=ubuntu&logoColor=8897a9&color=dfe4ea)](https://github.com/wellwelwel/poku/actions/workflows/ci_coverage-linux.yml?query=branch%3Amain)
 [![GitHub Workflow Status (OSX)](https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci_coverage-osx.yml?event=push&label=&branch=main&logo=apple&logoColor=8897a9&color=dfe4ea)](https://github.com/wellwelwel/poku/actions/workflows/ci_coverage-osx.yml?query=branch%3Amain)
 [![GitHub Workflow Status (Windows)](https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci_coverage-windows.yml?event=push&label=&branch=main&logo=data:image/svg+xml;base64,PHN2ZyByb2xlPSJpbWciIHZpZXdCb3g9IjAgMCAxMjggMTI4IiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjx0aXRsZT5XaW5kb3dzIDExPC90aXRsZT48cGF0aCBmaWxsPSIjODg5N2E5IiBkPSJNMTI2IDEuNjM3bC02NyA5LjgzNHY0OS44MzFsNjctLjUzNHpNMS42NDcgNjYuNzA5bC4wMDMgNDIuNDA0IDUwLjc5MSA2Ljk4My0uMDQtNDkuMDU3em01Ni44Mi42OGwuMDk0IDQ5LjQ2NSA2Ny4zNzYgOS41MDkuMDE2LTU4Ljg2M3pNMS42MSAxOS4yOTdsLjA0NyA0Mi4zODMgNTAuNzkxLS4yODktLjAyMy00OS4wMTZ6Ij48L3BhdGg+PC9zdmc+&color=dfe4ea)](https://github.com/wellwelwel/poku/actions/workflows/ci_coverage-windows.yml?query=branch%3Amain)
@@ -29,7 +29,7 @@ Enjoying **Poku**? Give him a star to show your support 🌟
 <img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Run **CommonJS** files directly with [**Deno**][deno-version-url]<br />
 <img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Auto detect **ESM**, **CJS**, and **TypeScript** files<br />
 <img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Run the **same test suite** for [**Node.js**][node-version-url], [**Bun**][bun-version-url], and [**Deno**][deno-version-url]<br />
-<img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Easily handle **servers**, **processes**, **ports**, and **containers** ✨
+<img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Easily handle **servers**, **processes**, **ports**, and even **containers** ✨
 
 ---
 
@@ -37,20 +37,43 @@ Enjoying **Poku**? Give him a star to show your support 🌟
 
 ### <img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Install
 
+<table>
+<tr>
+<td width="225">
+
 ```bash
 # Node.js
 npm i -D poku
+```
+
+</td>
+<td width="225">
 
+```bash
 # TypeScript (Node.js)
 npm i -D poku tsx
+```
 
+</td>
+<td width="225">
+
+```bash
 # Bun
 bun add -d poku
+```
+
+</td>
+<td width="225">
 
-# Deno
+```bash
+# Deno (optional)
 deno add npm:poku
 ```
 
+</td>
+</tr>
+</table>
+
 ---
 
 ### <img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Test
@@ -220,8 +243,8 @@ To see the detailed documentation, please visit the [**Documentation**](https://
 
 - [Avoiding conflicts in environments with multiple platforms installed](https://poku.io/docs/tutorials/cross-platform#recommendations).
 - [Properly running asynchronous tests on the same file](https://poku.io/docs/examples/promises).
-- [Migrating from version **1.x** to version **2.x**](https://github.com/wellwelwel/poku/issues/533).
 - [Using **Poku** without installing on **Deno** and alternatives to **JSR**](https://github.com/wellwelwel/poku/discussions/565).
+- [Migrating from version **1.x** to version **2.x**](https://github.com/wellwelwel/poku/issues/533).
 
 ---
 
@@ -231,9 +254,9 @@ To see the detailed documentation, please visit the [**Documentation**](https://
 
 **Poku** is [continuously tested](https://github.com/wellwelwel/poku/blob/main/.github/workflows/ci_benchmark.yml) to ensure the following expectations for basic usage:
 
-- \>=**4x** faster than [**Jest**](https://github.com/jestjs/jest) (v29.7.0)
-- \>=**3x** faster than [**Vitest**](https://github.com/vitest-dev/vitest) (v1.6.0)
-- \>=**1x** faster than [**Mocha**](https://github.com/mochajs/mocha) (v10.4.0) + [**Chai**](https://github.com/chaijs/chai) (v5.1.1)
+- ~**4x** faster than [**Jest**](https://github.com/jestjs/jest) (v29.7.0)
+- ~**3x** faster than [**Vitest**](https://github.com/vitest-dev/vitest) (v1.6.0)
+- ~**1x** faster than [**Mocha**](https://github.com/mochajs/mocha) (v10.4.0) + [**Chai**](https://github.com/chaijs/chai) (v5.1.1)
 
 > You can see how the tests are run and compared in the [benchmark](https://github.com/wellwelwel/poku/tree/main/benchmark) directory.
 

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

@@ -83,6 +83,9 @@ export type FinalResults = {
     time: string;
     started: Date;
 };
+export type States = {
+    isSinglePath?: boolean;
+};
 type cliConfigs = {
     /** By default, **Poku** searches for _`.test.`_ and `.spec.` files, but you can customize it. */
     include?: string | string[];

package/lib/bin/index.js

@@ -17,13 +17,15 @@ const watch_js_1 = require("../services/watch.js");
 const poku_js_1 = require("../modules/essentials/poku.js");
 const write_js_1 = require("../services/write.js");
 const options_js_1 = require("../parsers/options.js");
+const cpus_js_1 = require("../polyfills/cpus.js");
 (async () => {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
     const configFile = (0, get_arg_js_1.getArg)('config') || (0, get_arg_js_1.getArg)('c', '-');
     const defaultConfigs = await (0, options_js_1.getConfigs)(configFile);
     const dirs = (() => {
         var _a;
-        const includeArg = (0, get_arg_js_1.getArg)('include'); // deprecated
+        
+        const includeArg = (0, get_arg_js_1.getArg)('include');
         if (includeArg !== undefined) {
             return includeArg.split(',');
         }
@@ -37,11 +39,13 @@ const options_js_1 = require("../parsers/options.js");
     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 denoAllow = (_c = (0, get_arg_js_1.argToArray)('deno-allow')) !== null && _c !== void 0 ? _c : (_d = defaultConfigs === null || defaultConfigs === void 0 ? void 0 : defaultConfigs.deno) === null || _d === void 0 ? void 0 : _d.allow;
     const denoDeny = (_e = (0, get_arg_js_1.argToArray)('deno-deny')) !== null && _e !== void 0 ? _e : (_f = defaultConfigs === null || defaultConfigs === void 0 ? void 0 : defaultConfigs.deno) === null || _f === void 0 ? void 0 : _f.deny;
     const denoCJS = ((_g = (0, get_arg_js_1.getArg)('deno-cjs')) === null || _g === void 0 ? void 0 : _g.split(',').map((a) => a.trim()).filter((a) => a)) ||
         (0, get_arg_js_1.hasArg)('deno-cjs') ||
         ((_h = defaultConfigs === null || defaultConfigs === void 0 ? void 0 : defaultConfigs.deno) === null || _h === void 0 ? void 0 : _h.cjs);
+    
     const parallel = (0, get_arg_js_1.hasArg)('parallel') || (0, get_arg_js_1.hasArg)('p', '-') || (defaultConfigs === null || defaultConfigs === void 0 ? void 0 : defaultConfigs.parallel);
     const quiet = (0, get_arg_js_1.hasArg)('quiet') || (0, get_arg_js_1.hasArg)('q', '-') || (defaultConfigs === null || defaultConfigs === void 0 ? void 0 : defaultConfigs.quiet);
     const debug = (0, get_arg_js_1.hasArg)('debug') || (0, get_arg_js_1.hasArg)('d', '-') || (defaultConfigs === null || defaultConfigs === void 0 ? void 0 : defaultConfigs.debug);
@@ -55,7 +59,11 @@ const options_js_1 = require("../parsers/options.js");
         const value = Number((0, get_arg_js_1.getArg)('concurrency'));
         return Number.isNaN(value) ? defaultConfigs === null || defaultConfigs === void 0 ? void 0 : defaultConfigs.concurrency : value;
     })();
+    if (dirs.length === 1) {
+        files_js_1.states.isSinglePath = true;
+    }
     const tasks = [];
+    
     if (killPort || ((_j = defaultConfigs === null || defaultConfigs === void 0 ? void 0 : defaultConfigs.kill) === null || _j === void 0 ? void 0 : _j.port)) {
         const ports = (killPort === null || killPort === void 0 ? void 0 : killPort.split(',').map(Number)) || ((_k = defaultConfigs === null || defaultConfigs === void 0 ? void 0 : defaultConfigs.kill) === null || _k === void 0 ? void 0 : _k.port) || [];
         tasks.push(kill_js_1.kill.port(ports));
@@ -75,11 +83,13 @@ const options_js_1 = require("../parsers/options.js");
         const PIDs = (killPID === null || killPID === void 0 ? void 0 : killPID.split(',').map(Number)) || ((_q = defaultConfigs === null || defaultConfigs === void 0 ? void 0 : defaultConfigs.kill) === null || _q === void 0 ? void 0 : _q.pid) || [];
         tasks.push(kill_js_1.kill.pid(PIDs));
     }
+    
     if (hasEnvFile || (defaultConfigs === null || defaultConfigs === void 0 ? void 0 : defaultConfigs.envFile)) {
         const envFilePath = (_r = (0, get_arg_js_1.getArg)('env-file')) !== null && _r !== void 0 ? _r : defaultConfigs === null || defaultConfigs === void 0 ? void 0 : defaultConfigs.envFile;
         tasks.push((0, env_js_1.envFile)(envFilePath));
     }
     const options = {
+        
         platform: (0, get_runtime_js_1.platformIsValid)(platform)
             ? platform
             : (0, get_arg_js_1.hasArg)('node')
@@ -120,6 +130,7 @@ const options_js_1 = require("../parsers/options.js");
     const executing = new Set();
     const interval = Number((0, get_arg_js_1.getArg)('watch-interval')) || 1500;
     let isRunning = false;
+    
     const listenStdin = (input) => {
         if (isRunning || executing.size > 0) {
             return;
@@ -133,6 +144,7 @@ const options_js_1 = require("../parsers/options.js");
             startTests();
         }
     };
+    
     const resultsClear = () => {
         files_js_1.fileResults.success.clear();
         files_js_1.fileResults.fail.clear();
@@ -146,6 +158,7 @@ const options_js_1 = require("../parsers/options.js");
             (0, poku_js_1.poku)(dirs, options)
                 .then(() => {
                 if (watchMode) {
+                    
                     node_process_1.default.stdin.removeListener('data', listenStdin);
                     node_process_1.default.removeListener('SIGINT', poku_js_1.onSigint);
                     resultsClear();
@@ -163,7 +176,10 @@ const options_js_1 = require("../parsers/options.js");
                                     if (!tests) {
                                         return;
                                     }
-                                    (0, poku_js_1.poku)(Array.from(tests), options).then(() => {
+                                    (0, poku_js_1.poku)(Array.from(tests), {
+                                        ...options,
+                                        concurrency: concurrency !== null && concurrency !== void 0 ? concurrency : Math.max(Math.floor((0, cpus_js_1.availableParallelism)() / 2), 1),
+                                    }).then(() => {
                                         setTimeout(() => {
                                             executing.delete(filePath);
                                         }, interval);
@@ -192,6 +208,7 @@ const options_js_1 = require("../parsers/options.js");
                     }
                     write_js_1.Write.hr();
                     write_js_1.Write.log(`${(0, format_js_1.format)('Watching:').bold()} ${(0, format_js_1.format)(dirs.join(', ')).underline()}`);
+                    
                     node_process_1.default.stdin.setEncoding('utf-8');
                     node_process_1.default.stdin.on('data', listenStdin);
                 }

package/lib/configs/files.d.ts

@@ -1,4 +1,5 @@
 import type { FileResults } from '../@types/list-files.js';
-import type { FinalResults } from '../@types/poku.js';
+import type { FinalResults, States } from '../@types/poku.js';
+export declare const states: States;
 export declare const fileResults: FileResults;
 export declare const finalResults: FinalResults;

package/lib/configs/files.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.finalResults = exports.fileResults = void 0;
+exports.finalResults = exports.fileResults = exports.states = void 0;
+exports.states = {};
 exports.fileResults = {
     success: new Map(),
     fail: new Map(),

package/lib/configs/poku.d.ts

@@ -1,5 +1,6 @@
 export declare const results: {
     success: number;
     fail: number;
-    skipped: number;
+    skip: number;
+    todo: number;
 };

package/lib/configs/poku.js

@@ -4,5 +4,6 @@ exports.results = void 0;
 exports.results = {
     success: 0,
     fail: 0,
-    skipped: 0,
+    skip: 0,
+    todo: 0,
 };

package/lib/modules/essentials/assert.js

@@ -4,8 +4,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.assert = void 0;
-/* c8 ignore next */ // ?
 const node_assert_1 = __importDefault(require("assert"));
 const assert_js_1 = require("../../services/assert.js");
-/* c8 ignore next */ // ?
 exports.assert = (0, assert_js_1.createAssert)(node_assert_1.default);

package/lib/modules/essentials/poku.js

@@ -12,22 +12,19 @@ const exit_js_1 = require("../helpers/exit.js");
 const format_js_1 = require("../../services/format.js");
 const output_js_1 = require("../../parsers/output.js");
 const files_js_1 = require("../../configs/files.js");
-const indentation_js_1 = require("../../configs/indentation.js");
-/* c8 ignore next 3 */
+
 const onSigint = () => {
     node_process_1.default.stdout.write('\u001B[?25h');
 };
 exports.onSigint = onSigint;
-/* c8 ignore next */
 node_process_1.default.once('SIGINT', exports.onSigint);
 async function poku(targetPaths, configs) {
     let code = 0;
     files_js_1.finalResults.started = new Date();
     const start = node_process_1.default.hrtime();
-    const prepareDirs = Array.prototype.concat(targetPaths);
-    const dirs = prepareDirs.length > 0 ? prepareDirs : ['.'];
+    const dirs = Array.prototype.concat(targetPaths);
     const showLogs = !(0, output_js_1.isQuiet)(configs);
-    // Sequential
+    
     if (!(configs === null || configs === void 0 ? void 0 : configs.parallel)) {
         for (const dir of dirs) {
             const result = await (0, run_tests_js_1.runTests)(dir, configs);
@@ -44,10 +41,10 @@ async function poku(targetPaths, configs) {
         const end = node_process_1.default.hrtime(start);
         const total = (end[0] * 1e3 + end[1] / 1e6).toFixed(6);
         files_js_1.finalResults.time = total;
+        showLogs && (0, format_js_1.showTestResults)();
         (0, exit_js_1.exit)(code, configs === null || configs === void 0 ? void 0 : configs.quiet);
-        return;
     }
-    // Parallel
+    
     if (showLogs) {
         write_js_1.Write.hr();
         write_js_1.Write.log(`${(0, format_js_1.format)('Running the Test Suite in Parallel').bold()}\n`);
@@ -72,17 +69,7 @@ async function poku(targetPaths, configs) {
         const total = (end[0] * 1e3 + end[1] / 1e6).toFixed(6);
         files_js_1.finalResults.time = total;
     }
-    showLogs && write_js_1.Write.hr();
-    if (showLogs && files_js_1.fileResults.success.size > 0) {
-        write_js_1.Write.log(Array.from(files_js_1.fileResults.success)
-            .map(([file, time]) => `${indentation_js_1.indentation.test}${(0, format_js_1.format)('✔').success()} ${(0, format_js_1.format)(`${file} ${(0, format_js_1.format)(`› ${time}ms`).success()}`).dim()}`)
-            .join('\n'));
-    }
-    if (showLogs && files_js_1.fileResults.fail.size > 0) {
-        write_js_1.Write.log(Array.from(files_js_1.fileResults.fail)
-            .map(([file, time]) => `${indentation_js_1.indentation.test}${(0, format_js_1.format)('✘').fail()} ${(0, format_js_1.format)(`${file} ${(0, format_js_1.format)(`› ${time}ms`).fail()}`).dim()}`)
-            .join('\n'));
-    }
+    showLogs && (0, format_js_1.showTestResults)();
     if (configs === null || configs === void 0 ? void 0 : configs.noExit) {
         return code;
     }

package/lib/modules/essentials/strict.js

@@ -4,8 +4,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.strict = void 0;
-/* c8 ignore next */ // ?
 const strict_1 = __importDefault(require("assert/strict"));
 const assert_js_1 = require("../../services/assert.js");
-/* c8 ignore next */ // ?
 exports.strict = (0, assert_js_1.createAssert)(strict_1.default);

package/lib/modules/helpers/container.js

@@ -6,5 +6,4 @@ const container_js_1 = require("../../services/container.js");
 const dockerfile = (configs) => new container_js_1.DockerContainer(configs);
 /** A minimal API to assist tests that require containers or tests that run inside containers using a **docker-compose.yml**. */
 const compose = (configs) => new container_js_1.DockerCompose(configs);
-/* c8 ignore next */ // ?
 exports.docker = { dockerfile, compose };

package/lib/modules/helpers/describe.d.ts

@@ -1,7 +1,10 @@
 import type { DescribeOptions } from '../../@types/describe.js';
-/** On **Poku**, `describe` also can be used just as a pretty `console.log` to title your test suites in the terminal */
-export declare function describe(title: string, cb: () => Promise<unknown>): Promise<void>;
-export declare function describe(title: string, cb: () => unknown): void;
-export declare function describe(cb: () => Promise<unknown>): Promise<void>;
-export declare function describe(cb: () => unknown): unknown;
-export declare function describe(title: string, options?: DescribeOptions): void;
+declare function describeCore(title: string, cb: () => Promise<unknown>): Promise<void>;
+declare function describeCore(title: string, cb: () => unknown): void;
+declare function describeCore(cb: () => Promise<unknown>): Promise<void>;
+declare function describeCore(cb: () => unknown): unknown;
+declare function describeCore(title: string, options?: DescribeOptions): void;
+export declare const describe: typeof describeCore & {
+    todo: (message: string, _cb?: () => unknown) => void;
+};
+export {};

package/lib/modules/helpers/describe.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.describe = describe;
+exports.describe = void 0;
 const node_process_1 = require("process");
 const format_js_1 = require("../../services/format.js");
 const write_js_1 = require("../../services/write.js");
 const indentation_js_1 = require("../../configs/indentation.js");
-/* c8 ignore next */ // ?
-async function describe(arg1, arg2) {
+const todo_js_1 = require("./it/todo.js");
+async function describeCore(arg1, arg2) {
     let title;
     let cb;
     let options;
@@ -28,7 +28,7 @@ async function describe(arg1, arg2) {
     if (title) {
         indentation_js_1.indentation.hasDescribe = true;
         const { background, icon } = options || {};
-        const message = `${cb ? (0, format_js_1.format)('◌').dim() : icon || '☰'} ${cb ? (0, format_js_1.format)(isPoku ? `${title} › ${(0, format_js_1.format)(`${FILE}`).italic().gray()}` : title).dim() : (0, format_js_1.format)(title).bold() || ''}`;
+        const message = `${cb ? (0, format_js_1.format)('◌').dim() : icon || '☰'} ${cb ? (0, format_js_1.format)(isPoku ? `${title} › ${(0, format_js_1.format)(`${FILE}`).italic().gray()}` : title).dim() : (0, format_js_1.format)(title).bold()}`;
         const noBackground = !background;
         if (noBackground) {
             write_js_1.Write.log((0, format_js_1.format)(message).bold());
@@ -52,3 +52,6 @@ async function describe(arg1, arg2) {
         write_js_1.Write.log(`${(0, format_js_1.format)(`● ${title}`).success().bold()} ${(0, format_js_1.format)(`› ${total}ms`).success().dim()}`);
     }
 }
+exports.describe = Object.assign(describeCore, {
+    todo: todo_js_1.todo,
+});

package/lib/modules/helpers/each.d.ts

@@ -8,7 +8,7 @@ import type { Control, EachOptions } from '../../@types/each.js';
  * import { beforeEach } from 'poku';
  *
  * const before = beforeEach(() => {
- *   // prepare
+ *   
  * };
  *
  * before.pause();
@@ -26,7 +26,7 @@ export declare const beforeEach: (callback: () => unknown, options?: EachOptions
  * import { afterEach } from 'poku';
  *
  * const after = afterEach(() => {
- *   // cleanup
+ *   
  * };
  *
  * after.pause();

package/lib/modules/helpers/each.js

@@ -11,7 +11,7 @@ const each_js_1 = require("../../configs/each.js");
  * import { beforeEach } from 'poku';
  *
  * const before = beforeEach(() => {
- *   // prepare
+ *   
  * };
  *
  * before.pause();
@@ -47,7 +47,7 @@ exports.beforeEach = beforeEach;
  * import { afterEach } from 'poku';
  *
  * const after = afterEach(() => {
- *   // cleanup
+ *   
  * };
  *
  * after.pause();
@@ -55,7 +55,6 @@ exports.beforeEach = beforeEach;
  * after.reset();
  * ```
  */
-/* c8 ignore next */ // ?
 const afterEach = (callback) => {
     each_js_1.each.after.cb = () => {
         if (each_js_1.each.after.status) {

package/lib/modules/helpers/env.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.envFile = void 0;
-/* c8 ignore start */ // ?
 const fs_js_1 = require("../../polyfills/fs.js");
 const list_files_js_1 = require("./list-files.js");
 const env_js_1 = require("../../services/env.js");
@@ -10,7 +9,6 @@ const regex = {
 };
 /** Reads an environment file and sets the environment variables. */
 const envFile = async (filePath = '.env') => {
-    /* c8 ignore stop */
     const mapEnv = new Map();
     const env = await (0, fs_js_1.readFile)((0, list_files_js_1.sanitizePath)(filePath), 'utf8');
     const lines = env

package/lib/modules/helpers/exit.js

@@ -12,6 +12,30 @@ const files_js_1 = require("../../configs/files.js");
 const time_js_1 = require("../../parsers/time.js");
 const exit = (code, quiet) => {
     const isPoku = poku_js_1.results.success > 0 || poku_js_1.results.fail > 0;
+    const success = ` PASS › ${poku_js_1.results.success - poku_js_1.results.skip || 0} `;
+    const failure = ` FAIL › ${poku_js_1.results.fail} `;
+    const skips = ` SKIP › ${poku_js_1.results.skip} `;
+    const plans = ` TODO › ${poku_js_1.results.todo} `;
+    const inline = poku_js_1.results.skip === 0 || poku_js_1.results.todo === 0;
+    let message = '';
+    if (inline) {
+        message += `${(0, format_js_1.format)(success).bg('green')} ${(0, format_js_1.format)(failure).bg(poku_js_1.results.fail === 0 ? 'grey' : 'brightRed')}`;
+        if (poku_js_1.results.skip) {
+            message += ` ${(0, format_js_1.format)(skips).bg('brightBlue')}`;
+        }
+        if (poku_js_1.results.todo) {
+            message += ` ${(0, format_js_1.format)(plans).bg('brightBlue')}`;
+        }
+    }
+    else {
+        message += `${(0, format_js_1.format)(success).success().bold()}\n`;
+        message +=
+            poku_js_1.results.fail === 0
+                ? (0, format_js_1.format)(`${failure}\n`).bold()
+                : `${(0, format_js_1.format)(failure).fail().bold()}\n`;
+        message += `${(0, format_js_1.format)(skips).info().bold()}\n`;
+        message += `${(0, format_js_1.format)(plans).info().bold()}`;
+    }
     !quiet &&
         node_process_1.default.on('exit', (code) => {
             if (isPoku) {
@@ -20,7 +44,7 @@ const exit = (code, quiet) => {
                 write_js_1.Write.log(`    ${(0, format_js_1.format)('Duration ›').dim()} ${(0, format_js_1.format)(`${files_js_1.finalResults.time}ms`).bold().dim()} ${(0, format_js_1.format)(`(±${(0, time_js_1.parseTimeToSecs)(files_js_1.finalResults.time)} seconds)`).dim()}`);
                 write_js_1.Write.log(`  ${(0, format_js_1.format)(`Test Files › ${(0, format_js_1.format)(String(files_js_1.fileResults.success.size + files_js_1.fileResults.fail.size)).bold()}`).dim()}`);
                 write_js_1.Write.hr();
-                write_js_1.Write.log(`${(0, format_js_1.format)(` PASS › ${poku_js_1.results.success - poku_js_1.results.skipped} `).bg('green')} ${(0, format_js_1.format)(` FAIL › ${poku_js_1.results.fail} `).bg(poku_js_1.results.fail === 0 ? 'grey' : 'red')} ${poku_js_1.results.skipped > 0 ? (0, format_js_1.format)(` SKIPPED › ${poku_js_1.results.skipped} `).bg(poku_js_1.results.skipped === 0 ? 'grey' : 'blue') : ''}`);
+                write_js_1.Write.log(message);
                 write_js_1.Write.hr();
             }
             write_js_1.Write.log(`${(0, format_js_1.format)('Exited with code').dim()} ${(0, format_js_1.format)(String(code)).bold()[code === 0 ? 'success' : 'fail']()}\n`);
@@ -28,10 +52,12 @@ const exit = (code, quiet) => {
     node_process_1.default.exit(code === 0 ? 0 : 1);
 };
 exports.exit = exit;
+
 node_process_1.default.on('unhandledRejection', (reason) => {
     console.error('unhandledRejection', reason);
     node_process_1.default.exit(1);
 });
+
 node_process_1.default.on('uncaughtException', (err) => {
     console.error('uncaughtException', err);
     node_process_1.default.exit(1);

package/lib/modules/helpers/it/core.d.ts

@@ -0,0 +1,8 @@
+declare function itCore(message: string, cb: () => Promise<unknown>): Promise<void>;
+declare function itCore(message: string, cb: () => unknown): void;
+declare function itCore(cb: () => Promise<unknown>): Promise<void>;
+declare function itCore(cb: () => unknown): void;
+export declare const it: typeof itCore & {
+    todo: (message: string, _cb?: () => unknown) => void;
+};
+export {};

package/lib/modules/helpers/{it.js → it/core.js}

@@ -1,14 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.it = it;
-/* c8 ignore next */ // ?
+exports.it = void 0;
 const node_process_1 = require("process");
-const each_js_1 = require("../../configs/each.js");
-const indentation_js_1 = require("../../configs/indentation.js");
-const format_js_1 = require("../../services/format.js");
-const write_js_1 = require("../../services/write.js");
-/* c8 ignore next */ // ?
-async function it(...args) {
+const each_js_1 = require("../../../configs/each.js");
+const indentation_js_1 = require("../../../configs/indentation.js");
+const format_js_1 = require("../../../services/format.js");
+const write_js_1 = require("../../../services/write.js");
+const todo_js_1 = require("./todo.js");
+async function itCore(...args) {
     try {
         let message;
         let cb;
@@ -23,7 +22,7 @@ async function it(...args) {
         }
         if (message) {
             indentation_js_1.indentation.hasItOrTest = true;
-            write_js_1.Write.log(isPoku && !indentation_js_1.indentation.hasDescribe
+            write_js_1.Write.log(isPoku
                 ? `${indentation_js_1.indentation.hasDescribe ? '  ' : ''}${(0, format_js_1.format)(`◌ ${message} › ${(0, format_js_1.format)(`${FILE}`).italic().gray()}`).dim()}`
                 : `${indentation_js_1.indentation.hasDescribe ? '  ' : ''}${(0, format_js_1.format)(`◌ ${message}`).dim()}`);
         }
@@ -62,3 +61,6 @@ async function it(...args) {
         throw error;
     }
 }
+exports.it = Object.assign(itCore, {
+    todo: todo_js_1.todo,
+});

package/lib/modules/helpers/it/todo.d.ts

@@ -0,0 +1 @@
+export declare const todo: (message: string, _cb?: () => unknown) => void;

package/lib/modules/helpers/it/todo.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.todo = void 0;
+const write_js_1 = require("../../../services/write.js");
+const indentation_js_1 = require("../../../configs/indentation.js");
+const format_js_1 = require("../../../services/format.js");
+const todo = (message, _cb) => {
+    write_js_1.Write.log(`${indentation_js_1.indentation.hasDescribe ? '  ' : ''}${(0, format_js_1.format)(`● ${message}`).cyan().bold()}`);
+};
+exports.todo = todo;

package/lib/modules/helpers/list-files.js

@@ -5,6 +5,7 @@ exports.listFiles = exports.getAllFiles = exports.escapeRegExp = exports.isFile
 const node_process_1 = require("process");
 const node_path_1 = require("path");
 const fs_js_1 = require("../../polyfills/fs.js");
+const files_js_1 = require("../../configs/files.js");
 const regex = {
     sep: /[/\\]+/g,
     pathLevel: /(\.\.(\/|\\|$))+/g,
@@ -31,7 +32,14 @@ const envFilter = ((_a = node_process_1.env.FILTER) === null || _a === void 0 ?
     ? new RegExp((0, exports.escapeRegExp)(node_process_1.env.FILTER), 'i')
     : undefined;
 const getAllFiles = async (dirPath, files = new Set(), configs) => {
-    const currentFiles = await (0, fs_js_1.readdir)((0, exports.sanitizePath)(dirPath));
+    let isFullPath = false;
+    const currentFiles = await (async () => {
+        if (await (0, exports.isFile)(dirPath)) {
+            isFullPath = true;
+            return Array.prototype.concat((0, exports.sanitizePath)(dirPath));
+        }
+        return await (0, fs_js_1.readdir)((0, exports.sanitizePath)(dirPath));
+    })();
     const filter = envFilter
         ? envFilter
         : (configs === null || configs === void 0 ? void 0 : configs.filter) instanceof RegExp
@@ -43,13 +51,15 @@ const getAllFiles = async (dirPath, files = new Set(), configs) => {
             : [configs.exclude]
         : undefined;
     await Promise.all(currentFiles.map(async (file) => {
-        const fullPath = (0, node_path_1.join)(dirPath, file);
+        const fullPath = isFullPath ? dirPath : (0, node_path_1.join)(dirPath, file);
         const stat = await (0, fs_js_1.stat)(fullPath);
-        /* c8 ignore next 6 */
         if (fullPath.indexOf('node_modules') !== -1 ||
-            fullPath.indexOf('.git') === 0) {
+            fullPath.indexOf('.git/') !== -1) {
             return;
         }
+        if (isFullPath && (files_js_1.states === null || files_js_1.states === void 0 ? void 0 : files_js_1.states.isSinglePath)) {
+            return files.add(fullPath);
+        }
         if (exclude) {
             for (const pattern of exclude) {
                 if (pattern.test(fullPath)) {
@@ -67,6 +77,5 @@ const getAllFiles = async (dirPath, files = new Set(), configs) => {
     return files;
 };
 exports.getAllFiles = getAllFiles;
-/* c8 ignore next */ // ?
 const listFiles = async (targetDir, configs) => Array.from(await (0, exports.getAllFiles)((0, exports.sanitizePath)(targetDir), new Set(), configs));
 exports.listFiles = listFiles;

package/lib/modules/helpers/skip.js

@@ -4,13 +4,13 @@ exports.skip = void 0;
 const node_process_1 = require("process");
 const write_js_1 = require("../../services/write.js");
 const format_js_1 = require("../../services/format.js");
-const skip = (message) => {
+const skip = (message = 'Skipping') => {
     const isPoku = typeof (node_process_1.env === null || node_process_1.env === void 0 ? void 0 : node_process_1.env.FILE) === 'string' && (node_process_1.env === null || node_process_1.env === void 0 ? void 0 : node_process_1.env.FILE.length) > 0;
     const FILE = node_process_1.env.FILE;
     if (message) {
         write_js_1.Write.log((0, format_js_1.format)(isPoku
-            ? `ℹ ${message} ${(0, format_js_1.format)('›').dim()} ${(0, format_js_1.format)(`${FILE}`).italic().gray().dim()}`
-            : `ℹ ${message}`)
+            ? `◯ ${message} ${(0, format_js_1.format)('›').dim()} ${(0, format_js_1.format)(`${FILE}`).italic().gray().dim()}`
+            : `◯ ${message}`)
             .info()
             .bold());
     }

package/lib/modules/helpers/test.d.ts

@@ -1,2 +1,8 @@
-import { it } from './it.js';
-export declare const test: typeof it;
+export declare const test: {
+    (message: string, cb: () => Promise<unknown>): Promise<void>;
+    (message: string, cb: () => unknown): void;
+    (cb: () => Promise<unknown>): Promise<void>;
+    (cb: () => unknown): void;
+} & {
+    todo: (message: string, _cb?: () => unknown) => void;
+};

package/lib/modules/helpers/test.js

@@ -1,7 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.test = void 0;
-/* c8 ignore next */ // ?
-const it_js_1 = require("./it.js");
-/* c8 ignore next */ // ?
-exports.test = it_js_1.it;
+const core_js_1 = require("./it/core.js");
+exports.test = core_js_1.it;