poku 2.2.4 → 2.4.0

package/README.md

@@ -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/bin/index.js

@@ -1,10 +1,6 @@
 #! /usr/bin/env node
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const node_process_1 = __importDefault(require("process"));
 const list_files_js_1 = require("../modules/helpers/list-files.js");
 const get_arg_js_1 = require("../parsers/get-arg.js");
 const files_js_1 = require("../configs/files.js");
@@ -12,18 +8,22 @@ const get_runtime_js_1 = require("../parsers/get-runtime.js");
 const format_js_1 = require("../services/format.js");
 const kill_js_1 = require("../modules/helpers/kill.js");
 const env_js_1 = require("../modules/helpers/env.js");
-const map_tests_js_1 = require("../services/map-tests.js");
-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");
 (async () => {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
+    if ((0, get_arg_js_1.hasArg)('version') || (0, get_arg_js_1.hasArg)('v', '-')) {
+        const { VERSION } = require('../configs/poku.js');
+        write_js_1.Write.log(VERSION);
+        return;
+    }
     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'); 
+        
+        const includeArg = (0, get_arg_js_1.getArg)('include');
         if (includeArg !== undefined) {
             return includeArg.split(',');
         }
@@ -37,11 +37,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);
@@ -58,7 +60,29 @@ const options_js_1 = require("../parsers/options.js");
     if (dirs.length === 1) {
         files_js_1.states.isSinglePath = true;
     }
+    if ((0, get_arg_js_1.hasArg)('list-files')) {
+        const { listFiles } = require('../modules/helpers/list-files.js');
+        let total = 0;
+        write_js_1.Write.hr();
+        for (const dir of dirs) {
+            const files = await listFiles(dir, {
+                filter: typeof filter === 'string'
+                    ? new RegExp((0, list_files_js_1.escapeRegExp)(filter))
+                    : filter,
+                exclude: typeof exclude === 'string'
+                    ? new RegExp((0, list_files_js_1.escapeRegExp)(exclude))
+                    : exclude,
+            });
+            total += files.length;
+            write_js_1.Write.log(files.map((file) => `${(0, format_js_1.format)('-').dim()} ${file}`).join('\n'));
+        }
+        write_js_1.Write.hr();
+        write_js_1.Write.log(`Total test files: ${(0, format_js_1.format)(String(total)).bold()}`);
+        write_js_1.Write.hr();
+        return;
+    }
     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));
@@ -78,11 +102,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')
@@ -119,90 +145,10 @@ const options_js_1 = require("../parsers/options.js");
         write_js_1.Write.log(`${(0, format_js_1.format)('…').info().italic()} ${(0, format_js_1.format)('Options').bold()}`);
         console.dir(options, { depth: null, colors: true });
     }
-    const watchers = new Set();
-    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;
-        }
-        if (String(input).trim() === 'rs') {
-            for (const watcher of watchers) {
-                watcher.stop();
-            }
-            watchers.clear();
-            resultsClear();
-            startTests();
-        }
-    };
-    const resultsClear = () => {
-        files_js_1.fileResults.success.clear();
-        files_js_1.fileResults.fail.clear();
-    };
-    const startTests = () => {
-        if (isRunning || executing.size > 0) {
-            return;
-        }
-        isRunning = true;
-        Promise.all(tasks).then(() => {
-            (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();
-                    (0, map_tests_js_1.mapTests)('.', dirs, options.filter, options.exclude).then((mappedTests) => {
-                        for (const mappedTest of Array.from(mappedTests.keys())) {
-                            const currentWatcher = (0, watch_js_1.watch)(mappedTest, (file, event) => {
-                                if (event === 'change') {
-                                    const filePath = (0, map_tests_js_1.normalizePath)(file);
-                                    if (executing.has(filePath)) {
-                                        return;
-                                    }
-                                    executing.add(filePath);
-                                    resultsClear();
-                                    const tests = mappedTests.get(filePath);
-                                    if (!tests) {
-                                        return;
-                                    }
-                                    (0, poku_js_1.poku)(Array.from(tests), options).then(() => {
-                                        setTimeout(() => {
-                                            executing.delete(filePath);
-                                        }, interval);
-                                    });
-                                }
-                            });
-                            currentWatcher.then((watcher) => watchers.add(watcher));
-                        }
-                    });
-                    for (const dir of dirs) {
-                        const currentWatcher = (0, watch_js_1.watch)(dir, (file, event) => {
-                            if (event === 'change') {
-                                if (executing.has(file)) {
-                                    return;
-                                }
-                                executing.add(file);
-                                resultsClear();
-                                (0, poku_js_1.poku)(file, options).then(() => {
-                                    setTimeout(() => {
-                                        executing.delete(file);
-                                    }, interval);
-                                });
-                            }
-                        });
-                        currentWatcher.then((watcher) => watchers.add(watcher));
-                    }
-                    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);
-                }
-            })
-                .finally(() => {
-                isRunning = false;
-            });
-        });
-    };
-    startTests();
+    await Promise.all(tasks);
+    await (0, poku_js_1.poku)(dirs, options);
+    if (watchMode) {
+        const { startWatch } = require('./watch.js');
+        await startWatch(dirs, options);
+    }
 })();

package/lib/bin/watch.js

@@ -0,0 +1,96 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startWatch = void 0;
+const map_tests_js_1 = require("../services/map-tests.js");
+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 node_process_1 = __importDefault(require("process"));
+const format_js_1 = require("../services/format.js");
+const get_arg_js_1 = require("../parsers/get-arg.js");
+const files_js_1 = require("../configs/files.js");
+const cpus_js_1 = require("../polyfills/cpus.js");
+const startWatch = async (dirs, options) => {
+    let isRunning = false;
+    const watchers = new Set();
+    const executing = new Set();
+    const interval = Number((0, get_arg_js_1.getArg)('watch-interval')) || 1500;
+    const setIsRunning = (value) => {
+        isRunning = value;
+    };
+    const resultsClear = () => {
+        files_js_1.fileResults.success.clear();
+        files_js_1.fileResults.fail.clear();
+    };
+    const listenStdin = async (input) => {
+        if (isRunning || executing.size > 0) {
+            return;
+        }
+        if (String(input).trim() === 'rs') {
+            for (const watcher of watchers) {
+                watcher.stop();
+            }
+            watchers.clear();
+            resultsClear();
+            await (0, poku_js_1.poku)(dirs, options);
+        }
+    };
+    node_process_1.default.stdin.removeListener('data', listenStdin);
+    node_process_1.default.removeListener('SIGINT', poku_js_1.onSigint);
+    resultsClear();
+    const mappedTests = await (0, map_tests_js_1.mapTests)('.', dirs, options.filter, options.exclude);
+    for (const mappedTest of Array.from(mappedTests.keys())) {
+        const currentWatcher = (0, watch_js_1.watch)(mappedTest, async (file, event) => {
+            var _a;
+            if (event === 'change') {
+                const filePath = (0, map_tests_js_1.normalizePath)(file);
+                if (executing.has(filePath) || isRunning || executing.size > 0) {
+                    return;
+                }
+                setIsRunning(true);
+                executing.add(filePath);
+                resultsClear();
+                const tests = mappedTests.get(filePath);
+                if (!tests) {
+                    return;
+                }
+                await (0, poku_js_1.poku)(Array.from(tests), {
+                    ...options,
+                    concurrency: (_a = options.concurrency) !== null && _a !== void 0 ? _a : Math.max(Math.floor((0, cpus_js_1.availableParallelism)() / 2), 1),
+                });
+                setTimeout(() => {
+                    executing.delete(filePath);
+                    setIsRunning(false);
+                }, interval);
+            }
+        });
+        currentWatcher.then((watcher) => watchers.add(watcher));
+    }
+    for (const dir of dirs) {
+        const currentWatcher = (0, watch_js_1.watch)(dir, (file, event) => {
+            if (event === 'change') {
+                if (executing.has(file) || isRunning || executing.size > 0) {
+                    return;
+                }
+                setIsRunning(true);
+                executing.add(file);
+                resultsClear();
+                (0, poku_js_1.poku)(file, options).then(() => {
+                    setTimeout(() => {
+                        executing.delete(file);
+                        setIsRunning(false);
+                    }, interval);
+                });
+            }
+        });
+        currentWatcher.then((watcher) => watchers.add(watcher));
+    }
+    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);
+};
+exports.startWatch = startWatch;

package/lib/configs/poku.d.ts

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

package/lib/configs/poku.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.results = void 0;
+exports.VERSION = exports.results = void 0;
 exports.results = {
     success: 0,
     fail: 0,
-    skipped: 0,
+    skip: 0,
+    todo: 0,
 };
+exports.VERSION = '2.4.0';

package/lib/modules/essentials/poku.js

@@ -17,14 +17,12 @@ const onSigint = () => {
     node_process_1.default.stdout.write('\u001B[?25h');
 };
 exports.onSigint = onSigint;
-
 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);
     
     if (!(configs === null || configs === void 0 ? void 0 : configs.parallel)) {
@@ -45,7 +43,6 @@ async function poku(targetPaths, configs) {
         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;
     }
     
     if (showLogs) {

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

@@ -1,6 +1,10 @@
 import type { DescribeOptions } from '../../@types/describe.js';
-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,11 +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");
-async function describe(arg1, arg2) {
+const todo_js_1 = require("./it/todo.js");
+async function describeCore(arg1, arg2) {
     let title;
     let cb;
     let options;
@@ -51,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/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`);

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,12 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.it = it;
+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");
-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;
@@ -60,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

@@ -54,7 +54,7 @@ const getAllFiles = async (dirPath, files = new Set(), configs) => {
         const fullPath = isFullPath ? dirPath : (0, node_path_1.join)(dirPath, file);
         const stat = await (0, fs_js_1.stat)(fullPath);
         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)) {

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

@@ -1,2 +1,2 @@
 /** By default **Poku** only shows outputs generated from itself. This helper allows you to use an alternative to `console.log` with **Poku**. */
-export declare const log: (message: string) => void;
+export declare const log: (...args: unknown[]) => void;

package/lib/modules/helpers/log.js

@@ -1,7 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.log = void 0;
+const assert_js_1 = require("../../parsers/assert.js");
 const write_js_1 = require("../../services/write.js");
 /** By default **Poku** only shows outputs generated from itself. This helper allows you to use an alternative to `console.log` with **Poku**. */
-const log = (message) => write_js_1.Write.log(`\x1b[0m${message}\x1b[0m`);
+const log = (...args) => {
+    const parsedMessages = args
+        .map((arg) => (0, assert_js_1.parseResultType)(arg))
+        .join(' ')
+        .split('\n')
+        .map((line) => `\x1b[0m${line}\x1b[0m`)
+        .join('\n');
+    write_js_1.Write.log(parsedMessages);
+};
 exports.log = log;

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,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.test = void 0;
-const it_js_1 = require("./it.js");
-exports.test = it_js_1.it;
+const core_js_1 = require("./it/core.js");
+exports.test = core_js_1.it;

package/lib/modules/index.d.ts

@@ -4,7 +4,7 @@ export { assert } from './essentials/assert.js';
 export { strict } from './essentials/strict.js';
 export { test } from './helpers/test.js';
 export { describe } from './helpers/describe.js';
-export { it } from './helpers/it.js';
+export { it } from './helpers/it/core.js';
 export { envFile } from './helpers/env.js';
 export { skip } from './helpers/skip.js';
 export { beforeEach, afterEach } from './helpers/each.js';
@@ -16,6 +16,7 @@ export { getPIDs } from './helpers/get-pids.js';
 export { exit } from './helpers/exit.js';
 export { log } from './helpers/log.js';
 export { listFiles } from './helpers/list-files.js';
+export { VERSION as version } from '../configs/poku.js';
 export type { Code } from '../@types/code.js';
 export type { Configs } from '../@types/poku.js';
 export type { DockerComposeConfigs, DockerfileConfigs, } from '../@types/container.js';

package/lib/modules/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defineConfig = exports.listFiles = exports.log = exports.exit = exports.getPIDs = exports.kill = exports.sleep = exports.waitForPort = exports.waitForExpectedResult = exports.startService = exports.startScript = exports.docker = exports.afterEach = exports.beforeEach = exports.skip = exports.envFile = exports.it = exports.describe = exports.test = exports.strict = exports.assert = exports.poku = void 0;
+exports.defineConfig = exports.version = exports.listFiles = exports.log = exports.exit = exports.getPIDs = exports.kill = exports.sleep = exports.waitForPort = exports.waitForExpectedResult = exports.startService = exports.startScript = exports.docker = exports.afterEach = exports.beforeEach = exports.skip = exports.envFile = exports.it = exports.describe = exports.test = exports.strict = exports.assert = exports.poku = void 0;
 var poku_js_1 = require("./essentials/poku.js");
 Object.defineProperty(exports, "poku", { enumerable: true, get: function () { return poku_js_1.poku; } });
 var assert_js_1 = require("./essentials/assert.js");
@@ -11,8 +11,8 @@ var test_js_1 = require("./helpers/test.js");
 Object.defineProperty(exports, "test", { enumerable: true, get: function () { return test_js_1.test; } });
 var describe_js_1 = require("./helpers/describe.js");
 Object.defineProperty(exports, "describe", { enumerable: true, get: function () { return describe_js_1.describe; } });
-var it_js_1 = require("./helpers/it.js");
-Object.defineProperty(exports, "it", { enumerable: true, get: function () { return it_js_1.it; } });
+var core_js_1 = require("./helpers/it/core.js");
+Object.defineProperty(exports, "it", { enumerable: true, get: function () { return core_js_1.it; } });
 var env_js_1 = require("./helpers/env.js");
 Object.defineProperty(exports, "envFile", { enumerable: true, get: function () { return env_js_1.envFile; } });
 var skip_js_1 = require("./helpers/skip.js");
@@ -39,6 +39,8 @@ var log_js_1 = require("./helpers/log.js");
 Object.defineProperty(exports, "log", { enumerable: true, get: function () { return log_js_1.log; } });
 var list_files_js_1 = require("./helpers/list-files.js");
 Object.defineProperty(exports, "listFiles", { enumerable: true, get: function () { return list_files_js_1.listFiles; } });
+var poku_js_2 = require("../configs/poku.js");
+Object.defineProperty(exports, "version", { enumerable: true, get: function () { return poku_js_2.VERSION; } });
 /** 🐷 Auxiliary function to define the `poku` configurations */
 const defineConfig = (options) => options;
 exports.defineConfig = defineConfig;

package/lib/parsers/output.js

@@ -5,7 +5,8 @@ const poku_js_1 = require("../configs/poku.js");
 const regex = {
     newLine: /\n/,
     ansi: /u001b\[0m|\n/i,
-    skipped: /^"\\u001b\[94m\\u001b\[1mℹ/i,
+    skip: /\\u001b\[94m\\u001b\[1m◯/i,
+    todo: /\\u001b\[96m\\u001b\[1m●/i,
 };
 const isQuiet = (configs) => typeof (configs === null || configs === void 0 ? void 0 : configs.quiet) === 'boolean' && Boolean(configs === null || configs === void 0 ? void 0 : configs.quiet);
 exports.isQuiet = isQuiet;
@@ -14,8 +15,11 @@ exports.isDebug = isDebug;
 const parserOutput = (options) => {
     const { output, result, configs } = options;
     const normalizedOutput = JSON.stringify(output);
-    if (regex.skipped.test(normalizedOutput)) {
-        ++poku_js_1.results.skipped;
+    if (regex.skip.test(normalizedOutput)) {
+        ++poku_js_1.results.skip;
+    }
+    if (regex.todo.test(normalizedOutput)) {
+        ++poku_js_1.results.todo;
     }
     const debug = (0, exports.isDebug)(configs);
     const pad = (configs === null || configs === void 0 ? void 0 : configs.parallel) ? '  ' : '    ';

package/lib/services/format.d.ts

@@ -29,6 +29,7 @@ export declare class Formatter {
     success(): this;
     fail(): this;
     gray(): this;
+    cyan(): this;
     bg(color: keyof typeof backgroundColor): this;
     [Symbol.toPrimitive](): string;
 }

package/lib/services/format.js

@@ -67,6 +67,10 @@ class Formatter {
         this.parts += '\x1b[90m';
         return this;
     }
+    cyan() {
+        this.parts += '\x1b[96m';
+        return this;
+    }
     bg(color) {
         this.parts += `\x1b[${exports.backgroundColor[color]}m\x1b[1m`;
         return this;

package/lib/services/run-tests.js

@@ -65,7 +65,7 @@ const runTestsParallel = async (dir, configs) => {
     const testDir = (0, node_path_1.join)(cwd, dir);
     const files = await (0, list_files_js_1.listFiles)(testDir, configs);
     const filesByConcurrency = [];
-    const concurrencyLimit = (_a = configs === null || configs === void 0 ? void 0 : configs.concurrency) !== null && _a !== void 0 ? _a : Math.max(Math.floor((0, cpus_js_1.availableParallelism)() / 2), 1);
+    const concurrencyLimit = (_a = configs === null || configs === void 0 ? void 0 : configs.concurrency) !== null && _a !== void 0 ? _a : Math.max((0, cpus_js_1.availableParallelism)() - 1, 1);
     const concurrencyResults = [];
     const showLogs = !(0, output_js_1.isQuiet)(configs);
     if (concurrencyLimit > 0) {

package/lib/services/watch.js

@@ -62,18 +62,15 @@ class Watcher {
         }
     }
     async start() {
-        try {
-            const stats = await (0, fs_js_1.stat)(this.rootDir);
-            if (stats.isDirectory()) {
-                this.files = await (0, list_files_js_1.listFiles)(this.rootDir);
-                this.watchFiles(this.files);
-                await this.watchDirectory(this.rootDir);
-            }
-            else {
-                this.watchFile(this.rootDir);
-            }
+        const stats = await (0, fs_js_1.stat)(this.rootDir);
+        if (stats.isDirectory()) {
+            this.files = await (0, list_files_js_1.listFiles)(this.rootDir);
+            this.watchFiles(this.files);
+            await this.watchDirectory(this.rootDir);
+        }
+        else {
+            this.watchFile(this.rootDir);
         }
-        catch (_a) { }
     }
     stop() {
         this.unwatchFiles();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poku",
-  "version": "2.2.4",
+  "version": "2.4.0",
   "description": "🐷 Poku makes testing easy for Node.js, Bun, Deno, and you at the same time.",
   "main": "./lib/modules/index.js",
   "license": "MIT",
@@ -51,7 +51,7 @@
     "clear": "rm -rf lib ci coverage .temp test-src test-tests",
     "prebuild": "npm run clear",
     "build": "tsc && tsc -p tsconfig.test.json",
-    "postbuild": "tsx tools/compatibility/node.ts && tsx tools/compatibility/comments.ts && cp fixtures/server/package.json ci/fixtures/server/package.json && rm -f ./lib/@types/*.js ./lib/bin/*.ts && npm run build:deno && chmod +x lib/bin/index.js",
+    "postbuild": "tsx tools/compatibility/node.ts && tsx tools/compatibility/comments.ts && tsx tools/build/version.ts && cp fixtures/server/package.json ci/fixtures/server/package.json && rm -f ./lib/@types/*.js ./lib/bin/*.ts && npm run build:deno && chmod +x lib/bin/index.js",
     "build:deno": "tsc -p tsconfig.mjs.json",
     "postbuild:deno": "tsx tools/build/check-deno-polyfill.ts",
     "lint": "npx @biomejs/biome lint && prettier --check .",
@@ -62,13 +62,13 @@
   },
   "devDependencies": {
     "@biomejs/biome": "1.8.3",
-    "@types/node": "^20.14.12",
+    "@types/node": "^22.0.2",
     "c8": "^10.1.2",
     "jsonc.min": "^1.0.0",
-    "monocart-coverage-reports": "^2.9.3",
+    "monocart-coverage-reports": "^2.10.0",
     "packages-update": "^2.0.0",
     "prettier": "^3.3.3",
-    "tsx": "4.16.2",
+    "tsx": "4.16.5",
     "typescript": "^5.5.4"
   },
   "keywords": [

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

@@ -1,4 +0,0 @@
-export declare function it(message: string, cb: () => Promise<unknown>): Promise<void>;
-export declare function it(message: string, cb: () => unknown): void;
-export declare function it(cb: () => Promise<unknown>): Promise<void>;
-export declare function it(cb: () => unknown): void;