poku 2.6.2 → 2.6.3-canary.402af07

package/lib/bin/help.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.help = void 0;
+const format_js_1 = require("../services/format.js");
+const write_js_1 = require("../services/write.js");
+const b = (text) => `${(0, format_js_1.format)(text).bold()}`;
+const i = (text) => `${(0, format_js_1.format)(text).italic()}`;
+const u = (text) => `${(0, format_js_1.format)(text).underline()}`;
+const d = (text) => `${(0, format_js_1.format)(text).dim()}`;
+const options = i('[--options]');
+const paths = i('[paths]');
+const bullet = d('●');
+const summary = [
+    ['--bun', 'Enforce tests to run through Bun.'],
+    ['--concurrency', 'Limit the number of tests running concurrently.'],
+    ['--config, -c', 'Specify a configuration file.'],
+    ['--debug, -d', 'Show detailed logs.'],
+    ['--deno', 'Enforce tests to run through Deno.'],
+    ['--denoAllow', 'Allow permissions for Deno.'],
+    ['--denoCjs', 'Support CommonJS in Deno.'],
+    ['--denoDeny', 'Deny permissions for Deno.'],
+    ['--enforce, -x', 'Validate options before running tests.'],
+    ['--envFile', 'Read and set an environment file.'],
+    ['--exclude', 'Exclude by path using Regex to match files.'],
+    ['--failFast', 'Stop tests at the first failure.'],
+    ['--filter', 'Filter by path using Regex to match files.'],
+    ['--help, -h', "Show Poku's CLI basic usage."],
+    ['--killPid', 'Terminate the specified processes.'],
+    ['--killPort', 'Terminate the specified ports.'],
+    ['--killRange', 'Terminate the specified port ranges.'],
+    ['--listFiles', 'Display all the files returned in the terminal.'],
+    ['--node', 'Enforce tests to run through Node.js.'],
+    ['--parallel, -p', 'Run tests files in parallel.'],
+    ['--platform', 'Enforce tests to run through a platform.'],
+    ['--quiet, -q', 'Run tests with no logs.'],
+    ['--version, -v', "Show Poku's installed version."],
+    ['--watch, -w', 'Watch for test events.'],
+    ['--watchInterval', 'Set an interval for watch events.'],
+];
+const sortedSummary = summary.sort(([a], [b]) => a.localeCompare(b));
+const largeEndPad = (() => Math.max(...summary.map(([start]) => start.length)))();
+const header = `
+🐷 ${(0, format_js_1.format)(' Poku — CLI Usage ').bg('brightMagenta')}
+
+› ${u(b('Usage:'))}
+
+  poku ${options} ${paths}
+  poku ${paths} ${options}
+
+› ${u(b('Ensuring platforms:'))}
+
+  poku ${b('--node')} ${options} ${paths}
+  poku ${b('--bun')} ${options} ${paths}
+  poku ${b('--deno')} ${options} ${paths}
+
+› ${u(b('Tips:'))}
+
+  ${bullet} All CLI options use camel case pattern (e.g.: ${b('--failFast')}).
+  ${bullet} Use ${b('=')} to set an option value (e.g.: ${b('--concurrency=4')}).
+  ${bullet} If you're seeing this, ${u('feel special')} ✨
+`;
+const main = `
+🐽 ${(0, format_js_1.format)(' Poku — Options ').bg('brightMagenta')}
+
+› ${u(b('Summary:'))}
+
+${sortedSummary
+    .map(([command, description]) => `${command.padEnd(largeEndPad)}  ${d(description)}`)
+    .join('\n')}
+
+› ${u(b('Notes:'))}
+
+  ${bullet} For Glob support, see:
+    ${u('https://poku.io/docs/documentation/poku/include-files#by-extending-glob-patterns-from-shell')}
+
+  ${bullet} Avoid conflicts for environments with multiple platforms:
+    ${u('https://poku.io/docs/tutorials/cross-platform')}
+`;
+const footer = `
+${b('Documentation:')} ${u('https://poku.io')}
+
+${bullet} ${b('Poku')} is made with ${b('love')} and ${b('care')} in every detail.
+${bullet} Give him a ${b('star')} to show your support 🌟
+`;
+const help = () => {
+    write_js_1.Write.hr();
+    write_js_1.Write.log(header.trim());
+    write_js_1.Write.hr();
+    write_js_1.Write.log(main.trim());
+    write_js_1.Write.hr();
+    write_js_1.Write.log(footer.trim());
+    write_js_1.Write.hr();
+};
+exports.help = help;

package/lib/bin/index.js

@@ -18,6 +18,11 @@ const options_js_1 = require("../parsers/options.js");
         write_js_1.Write.log(VERSION);
         return;
     }
+    if ((0, get_arg_js_1.hasArg)('help') || (0, get_arg_js_1.hasArg)('h', '-')) {
+        const { help } = require('./help.js');
+        help();
+        return;
+    }
     const enforce = (0, get_arg_js_1.hasArg)('enforce') || (0, get_arg_js_1.hasArg)('x', '-');
     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);

package/lib/configs/poku.js

@@ -7,4 +7,4 @@ exports.results = {
     skip: 0,
     todo: 0,
 };
-exports.VERSION = '2.6.2';
+exports.VERSION = '2.6.3-canary.402af07';

package/lib/modules/essentials/strict.js

@@ -1,9 +1,10 @@
 "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("assert/strict"));
 const assert_js_1 = require("../../builders/assert.js");
-exports.strict = (0, assert_js_1.createAssert)(strict_1.default);
+const get_runtime_js_1 = require("../../parsers/get-runtime.js");
+
+const nodeAssert = !get_runtime_js_1.nodeVersion || get_runtime_js_1.nodeVersion >= 16
+    ? require("assert/strict")
+    : require("assert");
+exports.strict = (0, assert_js_1.createAssert)(nodeAssert);

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

@@ -1,7 +1,7 @@
 export declare function todo(message: string): void;
-export declare function todo(message: string, _cb?: () => Promise<unknown>): Promise<void>;
-export declare function todo(message: string, _cb?: () => unknown): void;
-export declare function skip(message: string, _cb: () => Promise<unknown>): Promise<void>;
-export declare function skip(message: string, _cb: () => unknown): void;
-export declare function skip(_cb: () => Promise<unknown>): Promise<void>;
-export declare function skip(_cb: () => unknown): void;
+export declare function todo(message: string, cb?: () => Promise<unknown>): Promise<void>;
+export declare function todo(message: string, cb?: () => unknown): void;
+export declare function skip(message: string, cb: () => Promise<unknown>): Promise<void>;
+export declare function skip(message: string, cb: () => unknown): void;
+export declare function skip(cb: () => Promise<unknown>): Promise<void>;
+export declare function skip(cb: () => unknown): void;

package/lib/modules/helpers/modifiers.js

@@ -7,30 +7,8 @@ const indentation_js_1 = require("../../configs/indentation.js");
 const format_js_1 = require("../../services/format.js");
 async function todo(message, _cb) {
     write_js_1.Write.log(`${indentation_js_1.indentation.hasDescribe ? '  ' : ''}${(0, format_js_1.format)(`● ${message}`).cyan().bold()}`);
-    
-    if (typeof _cb === 'function') {
-        const isAsync = _cb.constructor.name === 'AsyncFunction';
-        if (isAsync)
-            return await Promise.resolve();
-        return;
-    }
-    
 }
 async function skip(messageOrCb, _cb) {
-    const message = (typeof messageOrCb === 'string' && messageOrCb) || 'Skipping';
+    const message = typeof messageOrCb === 'string' ? messageOrCb : 'Skipping';
     write_js_1.Write.log(`${indentation_js_1.indentation.hasDescribe ? '  ' : ''}${(0, format_js_1.format)(`◯ ${message}`).info().bold()}`);
-    
-    if (typeof messageOrCb === 'function') {
-        const isAsync = messageOrCb.constructor.name === 'AsyncFunction';
-        if (isAsync)
-            return await Promise.resolve();
-        return;
-    }
-    if (typeof _cb === 'function') {
-        const isAsync = _cb.constructor.name === 'AsyncFunction';
-        if (isAsync)
-            return await Promise.resolve();
-        return;
-    }
-    
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poku",
-  "version": "2.6.2",
+  "version": "2.6.3-canary.402af07",
   "description": "🐷 Poku makes testing easy for Node.js, Bun, Deno, and you at the same time.",
   "main": "./lib/modules/index.js",
   "license": "MIT",
@@ -64,7 +64,7 @@
     "packages-update": "^2.0.0",
     "prettier": "^3.3.3",
     "tsx": "4.19.0",
-    "typescript": "^5.5.4"
+    "typescript": "^5.6.2"
   },
   "keywords": [
     "🐷",