poku 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-current Weslley Araújo (@wellwelwel)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,46 @@
+# Poku
+
+<img align="right" width="128" height="128" alt="Logo" src=".github/assets/readme/poku.svg">
+
+🖇️ A flexible and user-friendly **Test Runner** which allows parallel runs and high isolation level.
+
+> - **Poku** is designed to be highly intuitive.<br />
+> - Compatible with **ESM** and **CJS**, **Node.js** and **TypeScript** (_no-build_).<br />
+> - From **Node.js 6** to the **Latest** release.<br />
+> - Totally dependency-free.
+
+---
+
+## In progress
+
+🧑🏻‍🔧 Soon releasing version `1.x`.
+
+---
+
+## Install
+
+```bash
+npm install --save-dev poku
+```
+
+---
+
+## Usage
+
+```ts
+import { poku } from 'poku';
+
+await poku(['./test/unit/']);
+
+// 🧑🏻‍🔧 Soon documenting all options and Poku's usage variations.
+```
+
+---
+
+## TypeScript
+
+To run your tests without compile, just install `tsx` and it's done:
+
+```bash
+npm install --save-dev tsx
+```

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

@@ -0,0 +1 @@
+export type Code = 0 | 1;

package/lib/@types/code.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,36 @@
+export type Configs = {
+    /**
+     * By setting `true`, **Poku** won't exit the process and will return the exit code (`0` or `1`).
+     *
+     * You can combine this option with **Poku**'s `exit` method or just use the result, for example, in `process.exit(code)`.
+     *
+     * @default false
+     */
+    noExit?: boolean;
+    /**
+     * Customize `stdout` options.
+     */
+    log?: {
+        /**
+         * @default false
+         */
+        success?: boolean;
+        /**
+         * @default true
+         */
+        fail?: boolean;
+    };
+    /**
+     * This option overwrites all `log` settings
+     *
+     * @default false
+     */
+    quiet?: boolean;
+    /**
+     * Filter by path to match only the files that should be performed
+     *
+     * @default /\.test\./i
+     */
+    filter?: RegExp;
+    parallel?: boolean;
+};

package/lib/@types/poku.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/helpers/escape-reg-exp.d.ts

@@ -0,0 +1 @@
+export declare const escapeRegExp: (string: string) => string;

package/lib/helpers/escape-reg-exp.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeRegExp = void 0;
+const escapeRegExp = (string) => string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+exports.escapeRegExp = escapeRegExp;

package/lib/helpers/filter.d.ts

@@ -0,0 +1 @@
+export declare const filter: RegExp | null;

package/lib/helpers/filter.js

@@ -0,0 +1,8 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filter = void 0;
+const escape_reg_exp_js_1 = require("./escape-reg-exp.js");
+exports.filter = ((_a = process.env.FILTER) === null || _a === void 0 ? void 0 : _a.trim())
+    ? new RegExp((0, escape_reg_exp_js_1.escapeRegExp)(process.env.FILTER), 'i')
+    : null;

package/lib/helpers/force-array.d.ts

@@ -0,0 +1 @@
+export declare const forceArray: <T>(input: T | T[]) => T[];

package/lib/helpers/force-array.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.forceArray = void 0;
+const forceArray = (input) => {
+    if (Array.isArray(input))
+        return input;
+    return [input];
+};
+exports.forceArray = forceArray;

package/lib/helpers/format.d.ts

@@ -0,0 +1,8 @@
+export declare const format: {
+    counter: (current: number, total: number, pad?: string) => string;
+    bold: (value: string) => string;
+    underline: (value: string) => string;
+    info: (value: string) => string;
+    success: (value: string) => string;
+    fail: (value: string) => string;
+};

package/lib/helpers/format.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.format = void 0;
+const pad_js_1 = require("./pad.js");
+exports.format = {
+    counter: (current, total, pad = '0') => {
+        const totalDigits = String(total).length;
+        return (0, pad_js_1.padStart)(String(current), totalDigits, pad);
+    },
+    bold: (value) => `\x1b[1m${value}\x1b[0m`,
+    underline: (value) => `\x1b[4m${value}\x1b[0m`,
+    info: (value) => `\x1b[36m${value}\x1b[0m`,
+    success: (value) => `\x1b[32m${value}\x1b[0m`,
+    fail: (value) => `\x1b[31m${value}\x1b[0m`,
+};

package/lib/helpers/getFiles.d.ts

@@ -0,0 +1,2 @@
+import { Configs } from '../@types/poku.js';
+export declare const getFiles: (dirPath: string, files?: string[], configs?: Configs) => string[];

package/lib/helpers/getFiles.js

@@ -0,0 +1,24 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFiles = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const filter_js_1 = require("./filter.js");
+const getFiles = (dirPath, files = [], configs) => {
+    const currentFiles = fs_1.default.readdirSync(dirPath);
+    const filter = (filter_js_1.filter ? filter_js_1.filter : configs === null || configs === void 0 ? void 0 : configs.filter) || /\.test\./i;
+    for (const file of currentFiles) {
+        const fullPath = path_1.default.join(dirPath, file);
+        if (fs_1.default.statSync(fullPath).isDirectory()) {
+            (0, exports.getFiles)(fullPath, files, configs);
+        }
+        else if (filter.test(fullPath)) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+};
+exports.getFiles = getFiles;

package/lib/helpers/hr.d.ts

@@ -0,0 +1 @@
+export declare const hr: () => void;

package/lib/helpers/hr.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hr = void 0;
+const os_1 = require("os");
+const hr = () => {
+    const columns = process.stdout.columns;
+    const line = '_'.repeat(columns - 10 || 0);
+    console.log(`\x1b[2m${line}\x1b[0m${os_1.EOL}`);
+};
+exports.hr = hr;

package/lib/helpers/indentation.d.ts

@@ -0,0 +1,4 @@
+export declare const indentation: {
+    test: string;
+    stdio: string;
+};

package/lib/helpers/indentation.js

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

package/lib/helpers/logs.d.ts

@@ -0,0 +1,4 @@
+import { Configs } from '../@types/poku.js';
+export declare const isQuiet: (configs?: Configs) => boolean;
+export declare const showSuccesses: (configs?: Configs) => boolean;
+export declare const showFailures: (configs?: Configs) => boolean;

package/lib/helpers/logs.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showFailures = exports.showSuccesses = exports.isQuiet = void 0;
+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;
+const showSuccesses = (configs) => { var _a; return Boolean((_a = configs === null || configs === void 0 ? void 0 : configs.log) === null || _a === void 0 ? void 0 : _a.success); };
+exports.showSuccesses = showSuccesses;
+const showFailures = (configs) => { var _a, _b; return typeof ((_a = configs === null || configs === void 0 ? void 0 : configs.log) === null || _a === void 0 ? void 0 : _a.fail) === 'undefined' || Boolean((_b = configs === null || configs === void 0 ? void 0 : configs.log) === null || _b === void 0 ? void 0 : _b.fail); };
+exports.showFailures = showFailures;

package/lib/helpers/pad.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Custom implementations of `padStart` for compatibility with Node.js version 6.
+ */
+export declare const padStart: (str: string, targetLength: number, padString: string) => string;

package/lib/helpers/pad.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Custom implementations of `padStart` for compatibility with Node.js version 6.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.padStart = void 0;
+const padStart = (str, targetLength, padString) => {
+    padString = !padString ? ' ' : String(padString);
+    if (str.length >= targetLength)
+        return str;
+    const paddingLength = targetLength - str.length;
+    let fullPadString = padString.repeat(Math.ceil(paddingLength / padString.length));
+    fullPadString = fullPadString.slice(0, paddingLength);
+    return fullPadString + str;
+};
+exports.padStart = padStart;

package/lib/helpers/runner.d.ts

@@ -0,0 +1 @@
+export declare const runner: (filename: string) => "tsx" | "node";

package/lib/helpers/runner.js

@@ -0,0 +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.runner = void 0;
+const path_1 = __importDefault(require("path"));
+const runner = (filename) => path_1.default.extname(filename) === '.ts' ? 'tsx' : 'node';
+exports.runner = runner;

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+export { poku } from './modules/poku.js';
+export { exit } from './modules/exit.js';

package/lib/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exit = exports.poku = void 0;
+var poku_js_1 = require("./modules/poku.js");
+Object.defineProperty(exports, "poku", { enumerable: true, get: function () { return poku_js_1.poku; } });
+var exit_js_1 = require("./modules/exit.js");
+Object.defineProperty(exports, "exit", { enumerable: true, get: function () { return exit_js_1.exit; } });

package/lib/modules/exit.d.ts

@@ -0,0 +1,2 @@
+import { Code } from '../@types/code.js';
+export declare const exit: (code: Code, quiet?: boolean) => never;

package/lib/modules/exit.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exit = void 0;
+const hr_js_1 = require("../helpers/hr.js");
+const exit = (code, quiet) => {
+    !quiet &&
+        process.on('exit', (code) => {
+            console.log(`About to exit with code`, code);
+        });
+    !quiet && (0, hr_js_1.hr)();
+    if (code !== 0) {
+        !quiet && console.log('Some tests failed.');
+        process.exit(1);
+    }
+    !quiet && console.log('All tests passed.');
+    process.exit(0);
+};
+exports.exit = exit;
+process.stdout.on('resize', hr_js_1.hr);
+process.on('unhandledRejection', (reason) => {
+    console.log('unhandledRejection', reason);
+    process.exit(1);
+});
+process.on('uncaughtException', (err) => {
+    console.log('uncaughtException', err);
+    process.exit(1);
+});

package/lib/modules/poku.d.ts

@@ -0,0 +1,6 @@
+import { Code } from '../@types/code.js';
+import { Configs } from '../@types/poku.js';
+export declare function poku(targetDirs: string | string[], configs?: Configs): Promise<void>;
+export declare function poku(targetDirs: string | string[], configs: Configs & {
+    noExit: true;
+}): Promise<Code>;

package/lib/modules/poku.js

@@ -0,0 +1,44 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.poku = void 0;
+const force_array_js_1 = require("../helpers/force-array.js");
+const runTests_js_1 = require("../services/runTests.js");
+const exit_js_1 = require("./exit.js");
+function poku(targetDirs, configs) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let code = 0;
+        const dirs = (0, force_array_js_1.forceArray)(targetDirs);
+        if (configs === null || configs === void 0 ? void 0 : configs.parallel) {
+            for (const dir of dirs) {
+                (0, runTests_js_1.runTestsParallel)(dir, configs).then((result) => {
+                    if (!result)
+                        code = 1;
+                });
+            }
+            process.on('beforeExit', () => {
+                if (configs === null || configs === void 0 ? void 0 : configs.noExit)
+                    return code;
+                (0, exit_js_1.exit)(code, configs === null || configs === void 0 ? void 0 : configs.quiet);
+            });
+            return;
+        }
+        for (const dir of dirs) {
+            const result = yield (0, runTests_js_1.runTests)(dir, configs);
+            if (!result)
+                code = 1;
+        }
+        if (configs === null || configs === void 0 ? void 0 : configs.noExit)
+            return code;
+        (0, exit_js_1.exit)(code, configs === null || configs === void 0 ? void 0 : configs.quiet);
+    });
+}
+exports.poku = poku;

package/lib/services/runTestFile.d.ts

@@ -0,0 +1,2 @@
+import { Configs } from '../@types/poku.js';
+export declare const runTestFile: (filePath: string, configs?: Configs) => Promise<boolean>;

package/lib/services/runTestFile.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTestFile = void 0;
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const runner_js_1 = require("../helpers/runner.js");
+const indentation_js_1 = require("../helpers/indentation.js");
+const format_js_1 = require("../helpers/format.js");
+const logs_js_1 = require("../helpers/logs.js");
+const runTestFile = (filePath, configs) => new Promise((resolve) => {
+    let output = '';
+    const showLogs = !(0, logs_js_1.isQuiet)(configs);
+    const showSuccess = (0, logs_js_1.showSuccesses)(configs);
+    const showFailure = (0, logs_js_1.showFailures)(configs);
+    const log = () => console.log(`${indentation_js_1.indentation.stdio}${output === null || output === void 0 ? void 0 : output.trim()}`);
+    const fileRelative = path_1.default.relative(process.cwd(), filePath);
+    showLogs &&
+        console.log(`${indentation_js_1.indentation.test}${format_js_1.format.info('→')} ${fileRelative}`);
+    const child = (0, child_process_1.spawn)((0, runner_js_1.runner)(filePath), [filePath], {
+        stdio: ['inherit', 'pipe', 'pipe'],
+        env: process.env,
+    });
+    child.stdout.on('data', (data) => {
+        output += data.toString();
+    });
+    child.stderr.on('data', (data) => {
+        output += data.toString();
+    });
+    child.on('close', (code) => {
+        if (showLogs &&
+            ((code === 0 && showSuccess) || (code !== 0 && showFailure)))
+            log();
+        resolve(code === 0);
+    });
+    child.on('error', (err) => {
+        console.log(`Failed to start test: ${filePath}`, err);
+        resolve(false);
+    });
+});
+exports.runTestFile = runTestFile;

package/lib/services/runTests.d.ts

@@ -0,0 +1,3 @@
+import { Configs } from '../@types/poku.js';
+export declare const runTests: (dir: string, configs?: Configs) => Promise<boolean>;
+export declare const runTestsParallel: (dir: string, configs?: Configs) => Promise<unknown>;

package/lib/services/runTests.js

@@ -0,0 +1,85 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTestsParallel = exports.runTests = void 0;
+const path_1 = __importDefault(require("path"));
+const os_1 = require("os");
+const runner_js_1 = require("../helpers/runner.js");
+const indentation_js_1 = require("../helpers/indentation.js");
+const getFiles_js_1 = require("../helpers/getFiles.js");
+const hr_js_1 = require("../helpers/hr.js");
+const format_js_1 = require("../helpers/format.js");
+const runTestFile_js_1 = require("./runTestFile.js");
+const logs_js_1 = require("../helpers/logs.js");
+const runTests = (dir, configs) => __awaiter(void 0, void 0, void 0, function* () {
+    const cwd = process.cwd();
+    const testDir = path_1.default.join(cwd, dir);
+    const currentDir = path_1.default.relative(cwd, testDir);
+    const files = (0, getFiles_js_1.getFiles)(testDir, undefined, configs);
+    const totalTests = files.length;
+    const showLogs = !(0, logs_js_1.isQuiet)(configs);
+    let passed = true;
+    if (showLogs) {
+        (0, hr_js_1.hr)();
+        console.log(`${format_js_1.format.bold('Directory:')} ${format_js_1.format.underline(currentDir)}${os_1.EOL}`);
+    }
+    for (let i = 0; i < files.length; i++) {
+        const filePath = files[i];
+        const fileRelative = path_1.default.relative(cwd, filePath);
+        const testPassed = yield (0, runTestFile_js_1.runTestFile)(filePath, configs);
+        const testNumber = i + 1;
+        const counter = format_js_1.format.counter(testNumber, totalTests);
+        const command = `${(0, runner_js_1.runner)(fileRelative)} ${fileRelative}`;
+        const nextLine = i + 1 !== files.length ? os_1.EOL : '';
+        const log = `${counter}/${totalTests} ${command}${nextLine}`;
+        if (testPassed) {
+            showLogs &&
+                console.log(`${indentation_js_1.indentation.test}${format_js_1.format.success('✔')} ${log}`);
+        }
+        else {
+            showLogs && console.log(`${indentation_js_1.indentation.test}${format_js_1.format.fail('✖')} ${log}`);
+            passed = false;
+        }
+    }
+    return passed;
+});
+exports.runTests = runTests;
+const runTestsParallel = (dir, configs) => {
+    const cwd = process.cwd();
+    const testDir = path_1.default.join(cwd, dir);
+    const files = (0, getFiles_js_1.getFiles)(testDir, undefined, configs);
+    const showLogs = !(0, logs_js_1.isQuiet)(configs);
+    let passed = true;
+    return new Promise((resolve) => {
+        for (let i = 0; i < files.length; i++) {
+            const filePath = files[i];
+            const fileRelative = path_1.default.relative(cwd, filePath);
+            (0, runTestFile_js_1.runTestFile)(filePath, configs).then((testPassed) => {
+                const command = `${(0, runner_js_1.runner)(fileRelative)} ${fileRelative}`;
+                const log = command;
+                if (testPassed) {
+                    showLogs &&
+                        console.log(`${indentation_js_1.indentation.test}${format_js_1.format.success('✔')} ${log}`);
+                }
+                else {
+                    showLogs &&
+                        console.log(`${indentation_js_1.indentation.test}${format_js_1.format.fail('✖')} ${log}`);
+                    passed = false;
+                }
+            });
+            resolve(passed);
+        }
+    });
+};
+exports.runTestsParallel = runTestsParallel;

package/lib/src/@types/code.d.ts

@@ -0,0 +1 @@
+export type Code = 0 | 1;

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

@@ -0,0 +1,36 @@
+export type Configs = {
+    /**
+     * By setting `true`, **Poku** won't exit the process and will return the exit code (`0` or `1`).
+     *
+     * You can combine this option with **Poku**'s `exit` method or just use the result, for example, in `process.exit(code)`.
+     *
+     * @default false
+     */
+    noExit?: boolean;
+    /**
+     * Customize `stdout` options.
+     */
+    log?: {
+        /**
+         * @default false
+         */
+        success?: boolean;
+        /**
+         * @default true
+         */
+        fail?: boolean;
+    };
+    /**
+     * This option overwrites all `log` settings
+     *
+     * @default false
+     */
+    quiet?: boolean;
+    /**
+     * Filter by path to match only the files that should be performed
+     *
+     * @default /\.test\./i
+     */
+    filter?: RegExp;
+    parallel?: boolean;
+};

package/lib/src/helpers/escape-reg-exp.d.ts

@@ -0,0 +1 @@
+export declare const escapeRegExp: (string: string) => string;

package/lib/src/helpers/filter.d.ts

@@ -0,0 +1 @@
+export declare const filter: RegExp | null;

package/lib/src/helpers/force-array.d.ts

@@ -0,0 +1 @@
+export declare const forceArray: <T>(input: T | T[]) => T[];

package/lib/src/helpers/format.d.ts

@@ -0,0 +1,8 @@
+export declare const format: {
+    counter: (current: number, total: number, pad?: string) => string;
+    bold: (value: string) => string;
+    underline: (value: string) => string;
+    info: (value: string) => string;
+    success: (value: string) => string;
+    fail: (value: string) => string;
+};

package/lib/src/helpers/getFiles.d.ts

@@ -0,0 +1,2 @@
+import { Configs } from '../@types/poku.js';
+export declare const getFiles: (dirPath: string, files?: string[], configs?: Configs) => string[];

package/lib/src/helpers/hr.d.ts

@@ -0,0 +1 @@
+export declare const hr: () => void;

package/lib/src/helpers/indentation.d.ts

@@ -0,0 +1,4 @@
+export declare const indentation: {
+    test: string;
+    stdio: string;
+};

package/lib/src/helpers/logs.d.ts

@@ -0,0 +1,4 @@
+import { Configs } from '../@types/poku.js';
+export declare const isQuiet: (configs?: Configs) => boolean;
+export declare const showSuccesses: (configs?: Configs) => boolean;
+export declare const showFailures: (configs?: Configs) => boolean;

package/lib/src/helpers/pad.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Custom implementations of `padStart` for compatibility with Node.js version 6.
+ */
+export declare const padStart: (str: string, targetLength: number, padString: string) => string;

package/lib/src/helpers/runner.d.ts

@@ -0,0 +1 @@
+export declare const runner: (filename: string) => "tsx" | "node";

package/lib/src/index.d.ts

@@ -0,0 +1,2 @@
+export { poku } from './modules/poku.js';
+export { exit } from './modules/exit.js';

package/lib/src/modules/exit.d.ts

@@ -0,0 +1,2 @@
+import { Code } from '../@types/code.js';
+export declare const exit: (code: Code, quiet?: boolean) => never;

package/lib/src/modules/poku.d.ts

@@ -0,0 +1,6 @@
+import { Code } from '../@types/code.js';
+import { Configs } from '../@types/poku.js';
+export declare function poku(targetDirs: string | string[], configs?: Configs): Promise<void>;
+export declare function poku(targetDirs: string | string[], configs: Configs & {
+    noExit: true;
+}): Promise<Code>;

package/lib/src/services/runTestFile.d.ts

@@ -0,0 +1,2 @@
+import { Configs } from '../@types/poku.js';
+export declare const runTestFile: (filePath: string, configs?: Configs) => Promise<boolean>;

package/lib/src/services/runTests.d.ts

@@ -0,0 +1,3 @@
+import { Configs } from '../@types/poku.js';
+export declare const runTests: (dir: string, configs?: Configs) => Promise<boolean>;
+export declare const runTestsParallel: (dir: string, configs?: Configs) => Promise<unknown>;

package/lib/test/ci.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/compatibility/node-06.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/compatibility/node-07.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/compatibility/node-08.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/compatibility/node-09.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/compatibility/node-10.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/compatibility/node-11.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/compatibility/node-12.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/compatibility/node-13.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/compatibility/node-14.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/compatibility/node-15.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/compatibility/node-16.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/compatibility/node-17.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/compatibility/node-18.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/compatibility/node-19.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/compatibility/node-20.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/compatibility/node-21.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/helpers/check-node.test.d.ts

@@ -0,0 +1 @@
+export declare const checkNode: (version: number) => Promise<number>;

package/lib/test/integration/code.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/integration/import.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/run.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/unit/pad.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/unit/runTestFile.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/unit/runTests.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "poku",
+  "version": "0.1.0",
+  "description": "🐷 This is Poku",
+  "main": "./lib/index.js",
+  "scripts": {
+    "test": "npx tsx --tsconfig ./tsconfig.test.json ./test/run.test.ts",
+    "test:docker": "cd ./test/docker && docker compose down; docker compose up --build --abort-on-container-exit",
+    "pretest:ci": "rm -rf ./ci; npx tsc -p tsconfig.test.json",
+    "test:ci": "npx tsx ./test/ci.test.ts",
+    "posttest:ci": "rm -rf ./ci",
+    "update": "npx npu; npm run init",
+    "prebuild": "rm -rf ./lib",
+    "build": "npx tsc",
+    "eslint:checker": "npx eslint . --ext .js,.ts",
+    "eslint:fix": "npx eslint . --fix --config ./.eslintrc.json",
+    "prettier:checker": "npx prettier --check .",
+    "prettier:fix": "npx prettier --write .github/workflows/*.yml ."
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wellwelwel/poku.git"
+  },
+  "keywords": [
+    "test",
+    "runner",
+    "isolate"
+  ],
+  "author": "https://github.com/wellwelwel",
+  "bugs": {
+    "url": "https://github.com/wellwelwel/poku/issues"
+  },
+  "engines": {
+    "node": ">=6.x"
+  },
+  "files": [
+    "lib"
+  ],
+  "type": "commonjs",
+  "devDependencies": {
+    "@types/node": "^20.11.17",
+    "@typescript-eslint/eslint-plugin": "^7.0.1",
+    "@typescript-eslint/parser": "^7.0.1",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-import-resolver-typescript": "^3.6.1",
+    "eslint-plugin-import": "^2.29.1",
+    "eslint-plugin-prettier": "^5.1.3",
+    "packages-update": "^1.2.1",
+    "prettier": "^3.2.5",
+    "tsx": "^4.7.1",
+    "typescript": "^5.3.3"
+  }
+}