poku 4.0.0 → 4.0.1-canary.76cf2c4b

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

@@ -1,6 +1,6 @@
 import type { AssertionError } from 'node:assert';
 import type { ChildProcess, ChildProcessWithoutNullStreams } from 'node:child_process';
-import type { results } from '../configs/poku.js';
+import type { results, timespan } from '../configs/poku.js';
 import type { ProcessAssertionOptions } from './assert.js';
 import type { DescribeOptions } from './describe.js';
 import type { Configs, Runtime, Timespan } from './poku.js';
@@ -8,10 +8,15 @@ export type PluginContext = {
     readonly configs: Configs;
     readonly runtime: Runtime;
     readonly cwd: string;
+    readonly configFile: string | undefined;
+    readonly runAsOnly: boolean;
+    readonly results: typeof results;
+    readonly timespan: typeof timespan;
+    readonly reporter: ReturnType<ReporterPlugin>;
 };
 export type PokuPlugin = {
-    /** Unique name for the plugin */
-    name: string;
+    /** Plugin name */
+    name?: string;
     /** Modify the command array before spawning a test file process */
     runner?: (command: string[], file: string) => string[];
     /** Run before the test suite begins */

package/lib/bin/index.js

@@ -55,7 +55,7 @@ const write_js_1 = require("../services/write.js");
         const value = Number((0, get_arg_js_1.getArg)('timeout'));
         return Number.isNaN(value) ? configsFromFile?.timeout : value;
     })();
-    const sequential = (0, get_arg_js_1.hasArg)('sequential');
+    const sequential = (0, get_arg_js_1.hasArg)('sequential') || configsFromFile?.sequential;
     if (dirs.length === 1)
         poku_js_1.states.isSinglePath = true;
     if ((0, get_arg_js_1.hasArg)('listFiles')) {

package/lib/configs/poku.js

@@ -12,7 +12,7 @@ exports.results = {
     skipped: 0,
     todo: 0,
 };
-exports.VERSION = '4.0.0';
+exports.VERSION = '4.0.1-canary.76cf2c4b';
 exports.deepOptions = [];
 exports.GLOBAL = {
     cwd: (0, node_process_1.cwd)(),

package/lib/modules/essentials/poku.js

@@ -41,6 +41,11 @@ async function poku(targetPaths, configs) {
             configs: poku_js_1.GLOBAL.configs,
             runtime: poku_js_1.GLOBAL.runtime,
             cwd: poku_js_1.GLOBAL.cwd,
+            configFile: poku_js_1.GLOBAL.configFile,
+            runAsOnly: poku_js_1.GLOBAL.runAsOnly,
+            results: poku_js_1.results,
+            timespan: poku_js_1.timespan,
+            reporter: poku_js_1.GLOBAL.reporter,
         };
         for (const plugin of plugins)
             if (plugin.setup)

package/lib/modules/index.d.ts

@@ -17,7 +17,7 @@ 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 { Configs, ConfigFile } from '../@types/poku.js';
 export type { StartServiceOptions, StartScriptOptions, } from '../@types/background-process.js';
 export type { WaitForExpectedResultOptions, WaitForPortOptions, } from '../@types/wait-for.js';
 export type { Configs as ListFilesConfigs } from '../@types/list-files.js';

package/lib/modules/plugins.d.ts

@@ -2,6 +2,8 @@ import type { SpawnOptionsWithoutStdio } from 'node:child_process';
 import type { InspectCLIResult, PokuPlugin } from '../@types/plugin.js';
 export { createReporter } from '../builders/reporter.js';
 export { findFileFromStack } from '../parsers/find-file-from-stack.js';
+export { onSigint } from './essentials/poku.js';
+export { reporter as reporterRegistry } from '../services/reporter.js';
 export type { ReporterPlugin, ReporterEvents, PokuPlugin, PluginContext, InspectCLIResult, } from '../@types/plugin.js';
 /** 🐷 Auxiliary function to define a Poku plugin */
 export declare const definePlugin: (plugin: PokuPlugin) => PokuPlugin;

package/lib/modules/plugins.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.inspectPoku = exports.definePlugin = exports.findFileFromStack = exports.createReporter = void 0;
+exports.inspectPoku = exports.definePlugin = exports.reporterRegistry = exports.onSigint = exports.findFileFromStack = exports.createReporter = void 0;
 const node_child_process_1 = require("node:child_process");
 const node_process_1 = require("node:process");
 const kill_js_1 = require("../modules/helpers/kill.js");
@@ -10,6 +10,10 @@ var reporter_js_1 = require("../builders/reporter.js");
 Object.defineProperty(exports, "createReporter", { enumerable: true, get: function () { return reporter_js_1.createReporter; } });
 var find_file_from_stack_js_1 = require("../parsers/find-file-from-stack.js");
 Object.defineProperty(exports, "findFileFromStack", { enumerable: true, get: function () { return find_file_from_stack_js_1.findFileFromStack; } });
+var poku_js_1 = require("./essentials/poku.js");
+Object.defineProperty(exports, "onSigint", { enumerable: true, get: function () { return poku_js_1.onSigint; } });
+var reporter_js_2 = require("../services/reporter.js");
+Object.defineProperty(exports, "reporterRegistry", { enumerable: true, get: function () { return reporter_js_2.reporter; } });
 /** 🐷 Auxiliary function to define a Poku plugin */
 const definePlugin = (plugin) => plugin;
 exports.definePlugin = definePlugin;

package/lib/plugins/multi-suite/index.d.ts

@@ -0,0 +1,3 @@
+import type { ConfigFile } from '../../modules/index.js';
+import type { PokuPlugin } from '../../modules/plugins.js';
+export declare const multiSuite: (suites: ConfigFile[]) => PokuPlugin;

package/lib/plugins/multi-suite/index.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.multiSuite = void 0;
+const node_process_1 = __importDefault(require("node:process"));
+const index_js_1 = require("../../modules/index.js");
+const plugins_js_1 = require("../../modules/plugins.js");
+const multiSuite = (suites) => ({
+    name: 'multi-suite',
+    setup: async (context) => {
+        const overallStart = new Date();
+        const overallHrtime = node_process_1.default.hrtime();
+        const onSignal = () => {
+            node_process_1.default.stdout.write('\u001B[?25h');
+            node_process_1.default.exit(1);
+        };
+        node_process_1.default.removeListener('SIGINT', plugins_js_1.onSigint);
+        node_process_1.default.once('SIGINT', onSignal);
+        let finalCode = 0;
+        for (const { include, envFile, kill: suiteKill, ...config } of suites) {
+            const dirs = include ? [].concat(include) : ['.'];
+            const tasks = [];
+            if (envFile)
+                tasks.push((0, index_js_1.envFile)(envFile));
+            if (suiteKill?.port?.length)
+                tasks.push(index_js_1.kill.port(suiteKill.port));
+            if (suiteKill?.range?.length) {
+                for (const [from, to] of suiteKill.range)
+                    tasks.push(index_js_1.kill.range(from, to));
+            }
+            if (suiteKill?.pid?.length)
+                tasks.push(index_js_1.kill.pid(suiteKill.pid));
+            if (tasks.length)
+                await Promise.all(tasks);
+            const { reporter: suiteReporterConfig } = config;
+            const suiteBase = typeof suiteReporterConfig === 'function'
+                ? suiteReporterConfig(context.configs)
+                : typeof suiteReporterConfig === 'string' &&
+                    suiteReporterConfig in plugins_js_1.reporterRegistry
+                    ? plugins_js_1.reporterRegistry[suiteReporterConfig](context.configs)
+                    : context.reporter;
+            const suiteReporter = () => ({
+                ...suiteBase,
+                onRunResult() { },
+                onExit() { },
+            });
+            const code = await (0, index_js_1.poku)(dirs, {
+                plugins: config.plugins ?? [],
+                ...config,
+                reporter: suiteReporter,
+                noExit: true,
+            });
+            if (code !== 0)
+                finalCode = 1;
+        }
+        const elapsed = node_process_1.default.hrtime(overallHrtime);
+        context.timespan.started = overallStart;
+        context.timespan.duration = elapsed[0] * 1e3 + elapsed[1] / 1e6;
+        context.timespan.finished = new Date();
+        if (!context.configs.quiet) {
+            context.reporter.onRunResult({
+                code: finalCode,
+                timespan: context.timespan,
+                results: context.results,
+            });
+            context.reporter.onExit({
+                code: finalCode,
+                timespan: context.timespan,
+                results: context.results,
+            });
+        }
+        node_process_1.default.removeListener('SIGINT', onSignal);
+        node_process_1.default.exit(finalCode);
+    },
+});
+exports.multiSuite = multiSuite;

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "poku",
-  "version": "4.0.0",
+  "version": "4.0.1-canary.76cf2c4b",
   "description": "🐷 Poku makes testing easy for Node.js, Bun, Deno, and you at the same time.",
   "main": "./lib/modules/index.js",
   "exports": {
     ".": "./lib/modules/index.js",
-    "./plugins": "./lib/modules/plugins.js"
+    "./plugins": "./lib/modules/plugins.js",
+    "./plugins/multi-suite": "./lib/plugins/multi-suite/index.js"
   },
   "license": "MIT",
   "bin": {