poku 3.0.2 → 3.0.3-canary.24dfb51d

package/README.md

@@ -18,13 +18,6 @@ Enjoying **Poku**? Give him a star to show your support 🌟
 
 </div>
 
-> [!IMPORTANT]
->
-> **Poku `v3`** is here! 🎉
->
-> - To check out what's changed, follow the [**Issue #801**](https://github.com/wellwelwel/poku/issues/801).
-> - For `v2` documentation, see the [**previous version's documentation**](https://poku.io/docs/2.x.x) and [**README**](https://github.com/wellwelwel/poku/tree/2.x.x?tab=readme-ov-file#readme).<br />
-
 ---
 
 ## Why does Poku exist?
@@ -245,12 +238,15 @@ To see the detailed documentation, please visit the [**Documentation**](https://
 
 ---
 
-### Common Issues
+### Common Issues (FAQ)
 
 - [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).
-- [Using **Poku** without installing on **Deno** and alternatives to **JSR**](https://github.com/wellwelwel/poku/discussions/565).
-- [Migrating from version **2.x** to version **3.x**](https://github.com/wellwelwel/poku/issues/801).
+- [Using **Poku** without installing it on **Deno**](https://github.com/wellwelwel/poku/discussions/565).
+- Migrating:
+  - [From version **3.x.x** to version **4.x.x (Canary)**](https://github.com/wellwelwel/poku/issues/1006).
+  - [From version **2.x.x** to version **3.x.x**](https://github.com/wellwelwel/poku/issues/801).
+  - [From version **1.x.x** to version **2.x.x**](https://github.com/wellwelwel/poku/issues/533).
 
 ---
 
@@ -260,9 +256,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)
-- ~**4x** faster than [**Vitest**](https://github.com/vitest-dev/vitest) (v3.0.6)
-- ~**1x** faster than [**Mocha**](https://github.com/mochajs/mocha) (v11.1.0) — _even with test file isolation_
+- ~**3.7x** faster than [**Jest**](https://github.com/jestjs/jest) (v30.2.0)
+- ~**3.2x** faster than [**Vitest**](https://github.com/vitest-dev/vitest) (v4.0.8)
+- ~**1.1x** _faster_ than [**Mocha**](https://github.com/mochajs/mocha) (v11.7.5) — _even with test file isolation_ 🚀
 
 > - You can see how the tests are run and compared in the [benchmark](https://github.com/wellwelwel/poku/tree/main/benchmark) directory.
 > - [Comparing **Poku** and native test runners _(discussion)_](https://github.com/wellwelwel/poku/discussions/740).
@@ -273,9 +269,9 @@ To see the detailed documentation, please visit the [**Documentation**](https://
 
 [![Install Size](https://packagephobia.com/badge?p=poku)](https://pkg-size.dev/poku)
 
-- [~**230x** lighter than **Vitest**](https://pkg-size.dev/vitest)
-- [~**130x** lighter than **Jest**](https://pkg-size.dev/jest)
-- [~**30x** lighter than **Mocha** + **Chai**](https://pkg-size.dev/mocha%20chai)
+- [~**206x** lighter than **Vitest**](https://pkg-size.dev/vitest@3.2.4)
+- [~**165x** lighter than **Jest**](https://pkg-size.dev/jest@30.0.5)
+- [~**52x** lighter than **Mocha**](https://pkg-size.dev/mocha@11.7.1)
 
 > **Poku** size ensures _cost-saving_ **CI** for services that charge for storage and usage.
 
@@ -297,10 +293,20 @@ See the [**Contributing Guide**](https://github.com/wellwelwel/poku/blob/main/CO
 
 ## Acknowledgements
 
-[![Contributors](https://img.shields.io/github/contributors/wellwelwel/poku?color=9c88ff)](https://github.com/wellwelwel/poku/graphs/contributors)
+### Contributors
+
+My thanks to everyone who has dedicated their time and effort to improving **Poku**.
 
 [![Contributors](https://opencollective.com/poku/contributors.svg?width=890&button=false)](https://opencollective.com/poku/contributors.svg?button=false)
 
+### Sponsors
+
+Really thanks to everyone who has supported and keeps supporting my work.
+
+> _Also for the private ones, who don't appear here_ 🕵
+
+[![Sponsors](https://wellwelwel.github.io/wellwelwel/sponsors.svg?v=1)](https://github.com/sponsors/wellwelwel)
+
 ---
 
 ## License

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

@@ -1,4 +1,4 @@
-import type { AssertionError } from "assert";
+import type { AssertionError } from 'node:assert';
 import type { results } from '../configs/poku.js';
 import type { ProcessAssertionOptions } from './assert.js';
 import type { DescribeOptions } from './describe.js';
@@ -54,6 +54,12 @@ export type Configs = {
      * @default "poku"
      */
     reporter?: Reporter;
+    /**
+     * By default, **Poku** runs in full isolation mode. Sharing resources allows IPC-based sharing of resources between test files.
+     *
+     * @default false
+     */
+    sharedResources?: boolean;
     /**
      * You can use this option to run a **callback** or a **file** before each test file on your suite.
      *
@@ -124,20 +130,22 @@ type Path = {
 };
 export type ReporterPlugin = (configs?: Configs) => {
     onRunStart: () => void;
-    onDescribeAsTitle: (title: string, options: DescribeOptions) => void;
+    onDescribeAsTitle: (title: string, options?: DescribeOptions) => void;
     onDescribeStart: (options: {
         title?: string;
     }) => void;
     onDescribeEnd: (options: {
-        title?: string;
         duration: number;
+        success?: boolean;
+        title?: string;
     }) => void;
     onItStart: (options: {
         title?: string;
     }) => void;
     onItEnd: (options: {
-        title?: string;
         duration: number;
+        success?: boolean;
+        title?: string;
     }) => void;
     onAssertionSuccess: (options: {
         message: string;

package/lib/@types/shared-resources.d.ts

@@ -0,0 +1,65 @@
+import type { Serializable } from 'node:child_process';
+import type EventEmitter from 'node:events';
+import type { SHARED_RESOURCE_MESSAGE_TYPES } from '../modules/helpers/shared-resources.js';
+export interface IPCEventEmitter extends EventEmitter {
+    send: (message: unknown, ...args: unknown[]) => boolean;
+}
+export interface SharedResourceEntry<T = unknown> {
+    state: T;
+    subscribers: Set<(state: T) => void>;
+}
+export type SharedResource = Record<string, unknown>;
+export type IPCGetMessage = {
+    type: typeof SHARED_RESOURCE_MESSAGE_TYPES.GET_RESOURCE;
+    name: string;
+    id: string;
+};
+export type IPCRemoteProcedureCallMessage = {
+    type: typeof SHARED_RESOURCE_MESSAGE_TYPES.REMOTE_PROCEDURE_CALL;
+    name: string;
+    id: string;
+    method: string | number | symbol;
+    args: unknown[];
+};
+export type IPCMessage = IPCGetMessage | IPCRemoteProcedureCallMessage;
+export type IPCResourceNotFoundMessage = {
+    type: typeof SHARED_RESOURCE_MESSAGE_TYPES.RESOURCE_NOT_FOUND;
+    name: string;
+};
+export type IPCResourceResultMessage<T = unknown> = {
+    type: typeof SHARED_RESOURCE_MESSAGE_TYPES.RESOURCE_RESULT;
+    name: string;
+    id: string;
+    value: T;
+    rpcs: MethodsOf<T>[];
+};
+export type IPCListenable<T> = IPCResourceResultMessage<T> | IPCResourceUpdatedMessage<T>;
+export type IPCResourceUpdatedMessage<T = unknown> = {
+    type: typeof SHARED_RESOURCE_MESSAGE_TYPES.RESOURCE_UPDATED;
+    name: string;
+    value: T;
+    rpcs: MethodsOf<T>[];
+};
+export type IPCRemoteProcedureCallResultMessage<T = unknown> = {
+    type: typeof SHARED_RESOURCE_MESSAGE_TYPES.REMOTE_PROCEDURE_CALL_RESULT;
+    id: string;
+    value?: T;
+    error?: string;
+};
+export type IPCResponse = IPCResourceResultMessage | IPCResourceUpdatedMessage | IPCRemoteProcedureCallResultMessage;
+export type RPCResult<TResult, TResource> = {
+    result: TResult;
+    latest: TResource;
+};
+export type MethodsToRPC<T> = {
+    [K in keyof T]: T[K] extends (...args: infer _) => Serializable ? (...args: Parameters<T[K]>) => ReturnType<T[K]> extends Promise<unknown> ? ReturnType<T[K]> : Promise<ReturnType<T[K]>> : T[K];
+};
+export type MethodsOf<T> = {
+    [K in keyof T]: T[K] extends (...args: infer _) => Serializable ? K : never;
+}[keyof T];
+export type ArgumentsOf<T> = T extends MethodsOf<infer U> ? U extends (...args: infer P) => Serializable ? P & {
+    length: number;
+} : never : never;
+export type ReturnTypeOf<T> = T extends MethodsOf<infer U> ? U extends (...args: infer _) => infer R ? R : never : never;
+export type Cleanup<T = SharedResourceEntry> = (state: T) => void | Promise<void>;
+export type Registry = Record<string, SharedResourceEntry>;

package/lib/bin/help.js

@@ -33,6 +33,7 @@ const summary = [
     ],
     ['--only', 'Enable selective execution of tests.'],
     ['--quiet, -q', 'Run tests with no logs.'],
+    ['--sharedResources', 'Share state and methods between isolated test files.'],
     ['--sequential', 'Run tests files sequentially.'],
     ['--version, -v', "Show Poku's installed version."],
     ['--watch, -w', 'Watch for test events.'],

package/lib/bin/index.js

@@ -1,5 +1,38 @@
 #! /usr/bin/env node
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 const poku_js_1 = require("../configs/poku.js");
 const poku_js_2 = require("../modules/essentials/poku.js");
@@ -17,7 +50,7 @@ const write_js_1 = require("../services/write.js");
         return;
     }
     if ((0, get_arg_js_1.hasArg)('help') || (0, get_arg_js_1.hasArg)('h', '-')) {
-        require('./help.js').help();
+        (await Promise.resolve().then(() => __importStar(require('./help.js')))).help();
         return;
     }
     const enforce = (0, get_arg_js_1.hasArg)('enforce') || (0, get_arg_js_1.hasArg)('x', '-');
@@ -57,10 +90,11 @@ const write_js_1 = require("../services/write.js");
         return Number.isNaN(value) ? configsFromFile?.concurrency : value;
     })();
     const sequential = (0, get_arg_js_1.hasArg)('sequential');
+    const sharedResources = (0, get_arg_js_1.hasArg)('sharedResources') || configsFromFile?.sharedResources;
     if (dirs.length === 1)
         poku_js_1.states.isSinglePath = true;
     if ((0, get_arg_js_1.hasArg)('listFiles')) {
-        const { listFiles } = require('../modules/helpers/list-files.js');
+        const { listFiles } = await Promise.resolve().then(() => __importStar(require('../modules/helpers/list-files.js')));
         const files = [];
         (0, write_js_1.hr)();
         for (const dir of dirs)
@@ -95,6 +129,7 @@ const write_js_1 = require("../services/write.js");
             deny: denoDeny,
             cjs: denoCJS,
         },
+        sharedResources,
         noExit: watchMode,
         reporter,
         beforeEach: 'beforeEach' in configsFromFile ? configsFromFile.beforeEach : undefined,
@@ -105,8 +140,7 @@ const write_js_1 = require("../services/write.js");
         poku_js_1.GLOBAL.envFile = (0, get_arg_js_1.getArg)('envFile') ?? configsFromFile?.envFile ?? '.env';
     }
     if (enforce)
-        require('../services/enforce.js').enforce();
-    
+        (await Promise.resolve().then(() => __importStar(require('../services/enforce.js')))).enforce();
     if (killPort || configsFromFile?.kill?.port) {
         const ports = killPort?.split(',').map(Number) || configsFromFile?.kill?.port || [];
         tasks.push(kill_js_1.kill.port(ports));
@@ -126,7 +160,6 @@ const write_js_1 = require("../services/write.js");
         const PIDs = killPID?.split(',').map(Number) || configsFromFile?.kill?.pid || [];
         tasks.push(kill_js_1.kill.pid(PIDs));
     }
-    
     poku_js_1.GLOBAL.envFile && tasks.push((0, env_js_1.envFile)(poku_js_1.GLOBAL.envFile));
     if (debug || configsFromFile?.debug) {
         (0, write_js_1.hr)();
@@ -140,7 +173,6 @@ const write_js_1 = require("../services/write.js");
     }
     await Promise.all(tasks);
     await (0, poku_js_2.poku)(dirs);
-    
     if (watchMode)
-        await require('./watch.js').startWatch(dirs);
+        require('./watch.js').startWatch(dirs); 
 })();

package/lib/bin/watch.js

@@ -4,7 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.startWatch = void 0;
-const node_process_1 = __importDefault(require("process"));
+const node_process_1 = __importDefault(require("node:process"));
 const poku_js_1 = require("../configs/poku.js");
 const poku_js_2 = require("../modules/essentials/poku.js");
 const get_arg_js_1 = require("../parsers/get-arg.js");

package/lib/builders/assert.d.ts

@@ -1,5 +1,5 @@
-import type assert from "assert";
-import type { AssertPredicate } from "assert";
+import type assert from 'node:assert';
+import type { AssertPredicate } from 'node:assert';
 import type { ProcessAssertionOptions } from '../@types/assert.js';
 export declare const createAssert: (nodeAssert: typeof assert) => ((value: unknown, message?: ProcessAssertionOptions["message"]) => void) & {
     ok: (value: unknown, message?: ProcessAssertionOptions["message"]) => void;

package/lib/builders/assert.js

@@ -78,8 +78,7 @@ const createAssert = (nodeAssert) => {
                 typeof errorOrMessage === 'object')
                 await nodeAssert.rejects(block, errorOrMessage, message);
             else {
-                const msg = typeof errorOrMessage === 'string' ? errorOrMessage : message;
-                await nodeAssert.rejects(block, msg);
+                await nodeAssert.rejects(block);
             }
         }, {
             message: typeof errorOrMessage === 'string' ? errorOrMessage : message,
@@ -95,7 +94,7 @@ const createAssert = (nodeAssert) => {
                 typeof errorOrMessage === 'object')
                 await nodeAssert.doesNotReject(block, errorOrMessage, message);
             else
-                await nodeAssert.doesNotReject(block, message);
+                await nodeAssert.doesNotReject(block);
         }, {
             message: typeof errorOrMessage === 'string' ? errorOrMessage : message,
             defaultMessage: 'Got unwanted rejection',

package/lib/configs/poku.d.ts

@@ -16,20 +16,22 @@ export declare const GLOBAL: {
     configsFromFile: ConfigFile | ConfigJSONFile;
     reporter: {
         onRunStart: () => void;
-        onDescribeAsTitle: (title: string, options: import("../@types/describe.js").DescribeOptions) => void;
+        onDescribeAsTitle: (title: string, options?: import("../@types/describe.js").DescribeOptions) => void;
         onDescribeStart: (options: {
             title?: string;
         }) => void;
         onDescribeEnd: (options: {
-            title?: string;
             duration: number;
+            success?: boolean;
+            title?: string;
         }) => void;
         onItStart: (options: {
             title?: string;
         }) => void;
         onItEnd: (options: {
-            title?: string;
             duration: number;
+            success?: boolean;
+            title?: string;
         }) => void;
         onAssertionSuccess: (options: {
             message: string;

package/lib/configs/poku.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GLOBAL = exports.deepOptions = exports.VERSION = exports.results = exports.timespan = exports.states = void 0;
-const node_process_1 = require("process");
+const node_process_1 = require("node:process");
 const get_runtime_js_1 = require("../parsers/get-runtime.js");
 const reporter_js_1 = require("../services/reporter.js");
 exports.states = Object.create(null);
@@ -12,7 +12,7 @@ exports.results = {
     skipped: 0,
     todo: 0,
 };
-exports.VERSION = '3.0.2';
+exports.VERSION = '3.0.3-canary.24dfb51d';
 exports.deepOptions = [];
 exports.GLOBAL = {
     cwd: (0, node_process_1.cwd)(),

package/lib/modules/essentials/assert.d.ts

@@ -1,4 +1,4 @@
-import nodeAssert from "assert";
+import nodeAssert from 'node:assert';
 export declare const assert: ((value: unknown, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]) => void) & {
     ok: (value: unknown, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]) => void;
     equal: (actual: unknown, expected: unknown, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]) => void;

package/lib/modules/essentials/assert.js

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

package/lib/modules/essentials/poku.js

@@ -5,8 +5,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.onSigint = void 0;
 exports.poku = poku;
-const node_path_1 = require("path");
-const node_process_1 = __importDefault(require("process"));
+const node_path_1 = require("node:path");
+const node_process_1 = __importDefault(require("node:process"));
 const poku_js_1 = require("../../configs/poku.js");
 const reporter_js_1 = require("../../services/reporter.js");
 const run_tests_js_1 = require("../../services/run-tests.js");

package/lib/modules/essentials/strict.d.ts

@@ -1,3 +1,4 @@
+import nodeAssert from 'node:assert/strict';
 export declare const strict: ((value: unknown, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]) => void) & {
     ok: (value: unknown, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]) => void;
     equal: (actual: unknown, expected: unknown, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]) => void;
@@ -7,15 +8,15 @@ export declare const strict: ((value: unknown, message?: import("../../@types/as
     doesNotMatch: (value: string, regExp: RegExp, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]) => void;
     doesNotReject: {
         (block: (() => Promise<unknown>) | Promise<unknown>, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]): Promise<void>;
-        (block: (() => Promise<unknown>) | Promise<unknown>, error: import("assert").AssertPredicate, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]): Promise<void>;
+        (block: (() => Promise<unknown>) | Promise<unknown>, error: nodeAssert.AssertPredicate, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]): Promise<void>;
     };
     throws: {
         (block: () => unknown, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]): void;
-        (block: () => unknown, error: import("assert").AssertPredicate, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]): void;
+        (block: () => unknown, error: nodeAssert.AssertPredicate, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]): void;
     };
     doesNotThrow: {
         (block: () => unknown, message?: string | import("../../@types/assert.js").ProcessAssertionOptions["message"]): void;
-        (block: () => unknown, error: import("assert").AssertPredicate, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]): void;
+        (block: () => unknown, error: nodeAssert.AssertPredicate, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]): void;
     };
     notEqual: (actual: unknown, expected: unknown, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]) => void;
     notDeepEqual: (actual: unknown, expected: unknown, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]) => void;
@@ -26,6 +27,6 @@ export declare const strict: ((value: unknown, message?: import("../../@types/as
     fail: (message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]) => never;
     rejects: {
         (block: (() => Promise<unknown>) | Promise<unknown>, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]): Promise<void>;
-        (block: (() => Promise<unknown>) | Promise<unknown>, error: import("assert").AssertPredicate, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]): Promise<void>;
+        (block: (() => Promise<unknown>) | Promise<unknown>, error: nodeAssert.AssertPredicate, message?: import("../../@types/assert.js").ProcessAssertionOptions["message"]): Promise<void>;
     };
 };

package/lib/modules/essentials/strict.js

@@ -1,11 +1,9 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.strict = void 0;
+const strict_1 = __importDefault(require("node:assert/strict"));
 const assert_js_1 = require("../../builders/assert.js");
-const poku_js_1 = require("../../configs/poku.js");
-const runtime_version_js_1 = require("../../parsers/runtime-version.js");
-
-const nodeAssert = poku_js_1.GLOBAL.runtime !== 'node' || runtime_version_js_1.runtimeVersion >= 16
-    ? require("assert/strict")
-    : require("assert");
-exports.strict = (0, assert_js_1.createAssert)(nodeAssert);
+exports.strict = (0, assert_js_1.createAssert)(strict_1.default);

package/lib/modules/helpers/create-service.js

@@ -4,9 +4,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.startScript = exports.startService = void 0;
-const node_child_process_1 = require("child_process");
-const node_path_1 = require("path");
-const node_process_1 = __importDefault(require("process"));
+const node_child_process_1 = require("node:child_process");
+const node_path_1 = require("node:path");
+const node_process_1 = __importDefault(require("node:process"));
 const get_runner_js_1 = require("../../parsers/get-runner.js");
 const os_js_1 = require("../../parsers/os.js");
 const write_js_1 = require("../../services/write.js");
@@ -21,7 +21,7 @@ const backgroundProcess = (runtime, args, file, options) => new Promise((resolve
             env: node_process_1.default.env,
             timeout: options?.timeout,
             cwd: options?.cwd ? (0, list_files_js_1.sanitizePath)((0, node_path_1.normalize)(options.cwd)) : undefined,
-            shell: os_js_1.isWindows,
+            shell: false,
             detached: !os_js_1.isWindows,
             windowsHide: os_js_1.isWindows,
         });

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

@@ -1,6 +1,6 @@
 import type { DescribeOptions } from '../../@types/describe.js';
 import { onlyDescribe, skip, todo } from './modifiers.js';
-export declare function describeBase(arg1: string | (() => unknown | Promise<unknown>), arg2?: (() => unknown | Promise<unknown>) | DescribeOptions): Promise<void>;
+export declare const describeBase: (titleOrCb: string | (() => unknown | Promise<unknown>), callbackOrOptions?: (() => unknown | Promise<unknown>) | DescribeOptions) => Promise<void>;
 declare function describeCore(message: string, cb: () => Promise<unknown>): Promise<void>;
 declare function describeCore(message: string, cb: () => unknown): void;
 declare function describeCore(cb: () => Promise<unknown>): Promise<void>;

package/lib/modules/helpers/describe.js

@@ -1,30 +1,28 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.describe = void 0;
-exports.describeBase = describeBase;
-const node_process_1 = require("process");
+exports.describe = exports.describeBase = void 0;
+const node_assert_1 = require("node:assert");
+const node_process_1 = __importDefault(require("node:process"));
 const poku_js_1 = require("../../configs/poku.js");
 const callback_js_1 = require("../../parsers/callback.js");
 const get_arg_js_1 = require("../../parsers/get-arg.js");
+const core_js_1 = require("./it/core.js");
 const modifiers_js_1 = require("./modifiers.js");
-async function describeBase(arg1, arg2) {
-    let title;
-    let cb;
-    let options;
+const getOptions = (input) => !input || typeof input !== 'object' ? undefined : input;
+const describeBase = async (titleOrCb, callbackOrOptions) => {
     const { reporter } = poku_js_1.GLOBAL;
-    if (typeof arg1 === 'string') {
-        title = arg1;
-        if (typeof arg2 === 'function')
-            cb = arg2;
-        else
-            options = arg2;
-    }
-    else if (typeof arg1 === 'function') {
-        cb = arg1;
-        options = arg2;
-    }
+    const title = (0, core_js_1.getTitle)(titleOrCb);
+    const hasTitle = typeof title === 'string';
+    const cb = hasTitle ? (0, core_js_1.getCallback)(callbackOrOptions) : (0, core_js_1.getCallback)(titleOrCb);
     const hasCB = typeof cb === 'function';
-    if (title) {
+    const options = hasCB ? undefined : getOptions(callbackOrOptions);
+    let success = true;
+    let start;
+    let end;
+    if (hasTitle) {
         if (hasCB)
             reporter.onDescribeStart({ title });
         else
@@ -32,33 +30,51 @@ async function describeBase(arg1, arg2) {
     }
     if (!hasCB)
         return;
-    const start = (0, node_process_1.hrtime)();
-    const resultCb = cb();
-    if (resultCb instanceof Promise)
-        await resultCb;
-    const end = (0, node_process_1.hrtime)(start);
+    const onError = (error) => {
+        node_process_1.default.exitCode = 1;
+        success = false;
+        if (!(error instanceof node_assert_1.AssertionError))
+            console.error(error);
+    };
+    node_process_1.default.once('uncaughtException', onError);
+    node_process_1.default.once('unhandledRejection', onError);
+    start = node_process_1.default.hrtime();
+    try {
+        const resultCb = cb();
+        if (resultCb instanceof Promise)
+            await resultCb;
+    }
+    catch (error) {
+        onError(error);
+    }
+    finally {
+        end = node_process_1.default.hrtime(start);
+        node_process_1.default.removeListener('uncaughtException', onError);
+        node_process_1.default.removeListener('unhandledRejection', onError);
+    }
     if (!title)
         return;
     const duration = end[0] * 1e3 + end[1] / 1e6;
-    reporter.onDescribeEnd({ title, duration });
+    reporter.onDescribeEnd({ title, duration, success });
     poku_js_1.GLOBAL.runAsOnly = false;
-}
+};
+exports.describeBase = describeBase;
 async function describeCore(messageOrCb, cbOrOptions) {
     if (typeof messageOrCb === 'string' && typeof cbOrOptions !== 'function')
-        return describeBase(messageOrCb, cbOrOptions);
+        return (0, exports.describeBase)(messageOrCb, cbOrOptions);
     if (get_arg_js_1.hasOnly) {
         const hasItOnly = (0, callback_js_1.checkOnly)(typeof messageOrCb === 'function' ? messageOrCb : cbOrOptions);
         if (!hasItOnly)
             return;
         if (typeof messageOrCb === 'string' && typeof cbOrOptions === 'function')
-            return describeBase(messageOrCb, cbOrOptions);
+            return (0, exports.describeBase)(messageOrCb, cbOrOptions);
         if (typeof messageOrCb === 'function')
-            return describeBase(messageOrCb);
+            return (0, exports.describeBase)(messageOrCb);
     }
     if (typeof messageOrCb === 'string' && typeof cbOrOptions === 'function')
-        return describeBase(messageOrCb, cbOrOptions);
+        return (0, exports.describeBase)(messageOrCb, cbOrOptions);
     if (typeof messageOrCb === 'function')
-        return describeBase(messageOrCb);
+        return (0, exports.describeBase)(messageOrCb);
 }
 exports.describe = Object.assign(describeCore, {
     todo: modifiers_js_1.todo,

package/lib/modules/helpers/env.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.envFile = void 0;
-const promises_1 = require("fs/promises");
-const node_process_1 = require("process");
+const promises_1 = require("node:fs/promises");
+const node_process_1 = require("node:process");
 const env_js_1 = require("../../services/env.js");
 const list_files_js_1 = require("./list-files.js");
 const regex = {

package/lib/modules/helpers/exit.js

@@ -4,8 +4,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.exit = void 0;
-const node_assert_1 = require("assert");
-const node_process_1 = __importDefault(require("process"));
+const node_assert_1 = require("node:assert");
+const node_process_1 = __importDefault(require("node:process"));
 const poku_js_1 = require("../../configs/poku.js");
 const exit = (code, quiet) => {
     const isPoku = poku_js_1.results.passed > 0 || poku_js_1.results.failed > 0;

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

@@ -1,8 +1,7 @@
 import { onlyIt, skip, todo } from '../modifiers.js';
-export declare function itBase(...args: [
-    string | (() => unknown | Promise<unknown>),
-    (() => unknown | Promise<unknown>)?
-]): Promise<void>;
+export declare const getTitle: (input: unknown) => string | undefined;
+export declare const getCallback: (input: unknown) => (() => unknown) | (() => Promise<unknown>) | undefined;
+export declare const itBase: (titleOrCb: string | (() => unknown | Promise<unknown>), callback?: () => unknown | Promise<unknown>) => Promise<void>;
 declare function itCore(title: string, cb: () => Promise<unknown>): Promise<void>;
 declare function itCore(title: string, cb: () => unknown): void;
 declare function itCore(cb: () => Promise<unknown>): Promise<void>;