poku 1.15.1 → 1.17.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024-current Weslley Araújo (@wellwelwel)
+Copyright (c) 2024-current Weslley Araújo ([@wellwelwel](https://github.com/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

package/README.md

@@ -18,11 +18,11 @@
 [license-image]: https://img.shields.io/npm/l/poku.svg?maxAge=2592000&color=9c88ff&style=flat-square&label=License
 
 <div align="center">
-<img width="170" height="170" alt="Logo" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/poku.svg">
+<img width="125" height="125" alt="Logo" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/poku.svg">
 
 # Poku
 
-**Poku** can show you _how simple testing can be_ 🌱
+Enjoying **Poku**? Give him a star to show your support 🌟
 
 [![NPM Downloads][downloads-image]][downloads-url]
 [![Coverage][coverage-image]][coverage-url]
@@ -31,33 +31,30 @@
 [![GitHub Workflow Status (with event)][ci-osx-image]][ci-osx-url]
 [![GitHub Workflow Status (with event)][ci-windows-image]][ci-windows-url]
 
-Enjoying **Poku**? Give him a star to show your support ⭐️
-
 </div>
 
 ---
 
 ## Why does Poku exist?
 
-> **Poku** takes on the testers' difficulties by itself and lets you focus on the tests.
+**Poku** makes testing easy and takes on the testers' difficulties to _let you focus on your tests_:
 
 <img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> No configurations<br />
 <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Auto detect **ESM** and **CJS**<br />
 <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Auto detect **Typescript** files<br />
-<span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><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 />
+<span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><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] _(6+)_, [**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"> Easier and Less Verbose<br />
 <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> [**Node.js**][node-version-url] familiar **API**<br />
-<span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Easily test your server just by running it 🚀<br />
 <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Run **CJS** (**CommonJS**) files directly with [**Deno**][deno-version-url]<br />
-<span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Easily handle **services**, **servers**, **processes** and **ports**<br />
+<span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Easily handle, **servers**, **services**, **processes**, and **ports**<br />
 
 <img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Safety and Reliability<br />
 <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> High **isolation** level per file<br />
-<span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Performant and lightweight<br />
-<span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Compatible with **Coverage** tools<br />
-<span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> **Poku** doesn't use `eval` nor global state 🔐<br />
-<span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> _In other words, you can run your tests directly, without relying on **Poku**_<br />
+<span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> **Performant** and **lightweight**<br />
+<span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Compatible with **coverage** tools
+
+> 💡 **Poku** brings the [essence of **JavaScript** back to testing](https://poku.io/docs/philosophy), allowing to use your knowledge to create tests intuitively.
 
 ---
 
@@ -65,8 +62,6 @@ Enjoying **Poku**? Give him a star to show your support ⭐️
 
 ### Install
 
-[![Install Size](https://packagephobia.com/badge?p=poku)](https://packagephobia.com/result?p=poku)
-
 <table>
 <tr>
 <td><blockquote><b>Node.js</b</blockquote></td>
@@ -160,7 +155,7 @@ deno run npm:poku
 </tr>
 </table>
 
-That's it 🎉
+- That's it 🎉
 
 ---
 
@@ -172,22 +167,20 @@ That's it 🎉
 
 ### Essentials
 
-- **Test**
-  - [**poku**](https://poku.io/docs/category/poku) (_test runner_)
-  - [**assert**](https://poku.io/docs/documentation/assert) (_test assertion_)
-- **Background Services**
-  - [**startScript**](https://poku.io/docs/documentation/startScript) (_run `package.json` scripts in a background process_)
-  - [**startService**](https://poku.io/docs/documentation/startService) (_run files in a background process_)
+- [**poku**](https://poku.io/docs/category/poku) _(test runner)_
+- [**assert**](https://poku.io/docs/documentation/assert) _(test assertion)_
 
 ### Helpers
 
 - [**test**](https://poku.io/docs/documentation/helpers/test)
-- [**describe**](https://poku.io/docs/documentation/helpers/describe) and [**it**](https://poku.io/docs/documentation/helpers/it)
-- [**beforeEach**](https://poku.io/docs/category/beforeeach-and-aftereach) and [**afterEach**](https://poku.io/docs/category/beforeeach-and-aftereach)
-- **Processes**
-  - [**kill**](https://poku.io/docs/documentation/processes/kill) (_terminate Ports, Port Ranges and PIDs_)
-  - [**getPIDs**](https://poku.io/docs/documentation/processes/get-pids) (_get all processes IDs using ports and port ranges_)
-- _and much more_ ✨
+  , [**describe**](https://poku.io/docs/documentation/helpers/describe) and [**it**](https://poku.io/docs/documentation/helpers/it) _(organize, group, and isolate tests)_
+- [**beforeEach**](https://poku.io/docs/category/beforeeach-and-aftereach) and [**afterEach**](https://poku.io/docs/category/beforeeach-and-aftereach) _(hooks for test setup and teardown)_
+- [**watch**](https://poku.io/docs/documentation/poku/options/watch) _(watch test files for changes)_
+- [**startScript**](https://poku.io/docs/documentation/startScript) _(run **package.json** scripts in background)_
+- [**startService**](https://poku.io/docs/documentation/startService) _(run files in background)_
+- [**kill**](https://poku.io/docs/documentation/processes/kill) _(terminate ports, port ranges, and PIDs)_
+- [**getPIDs**](https://poku.io/docs/documentation/processes/get-pids) _(debug processes IDs using ports and port ranges)_
+- _and much more_ 👇🏻
 
 ---
 
@@ -199,15 +192,7 @@ To see the detailed documentation, please visit the [**Documentation**](https://
 
 ## Contributing
 
-> I'm continuously working to improve **Poku**. If you've got something interesting to share, feel free to submit a [**Pull Request**](https://github.com/wellwelwel/poku/compare). If you notice something wrong, I'd appreciate if you'd open an [**Issue**](https://github.com/wellwelwel/poku/issues/new).
-
-Please check the [**CONTRIBUTING.md**](./CONTRIBUTING.md) for instructions 🚀
-
----
-
-## Philosophy
-
-Please check the [**Philosophy**](https://poku.io/docs/philosophy) section from Documentation.
+See the [**Contributing Guide**](https://github.com/wellwelwel/poku/blob/main/CONTRIBUTING.md) and please follow our [**Code of Conduct**](https://github.com/wellwelwel/poku/blob/main/CODE_OF_CONDUCT.md) 🚀
 
 ---
 
@@ -215,7 +200,7 @@ Please check the [**Philosophy**](https://poku.io/docs/philosophy) section from
 
 [![GitHub Workflow Status (with event)][ql-image]][ql-url]
 
-Please check the [**SECURITY.md**](./SECURITY.md) and the section [**Is Poku Safe?**](https://poku.io/docs/security) from Documentation.
+Please check the [**SECURITY.md**](https://github.com/wellwelwel/poku/blob/main/SECURITY.md).
 
 ---
 
@@ -223,11 +208,11 @@ Please check the [**SECURITY.md**](./SECURITY.md) and the section [**Is Poku Saf
 
 ### Performance
 
-**Poku** is continuously tested ([**CI**](https://github.com/wellwelwel/poku/blob/main/.github/workflows/ci_benchmark.yml)) to ensure the following expectations:
+**Poku** is [continuously tested](https://github.com/wellwelwel/poku/blob/main/.github/workflows/ci_benchmark.yml) to ensure the following expectations:
 
-- [x] **~4x** faster than [**Jest**](https://github.com/jestjs/jest) (v29.7.0)
-- [x] **~3x** faster than [**Vitest**](https://github.com/vitest-dev/vitest) (v1.6.0)
-- [x] **~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.
 
@@ -235,18 +220,18 @@ Please check the [**SECURITY.md**](./SECURITY.md) and the section [**Is Poku Saf
 
 ### Installation Size
 
-<a href="https://pkg-size.dev/poku"><img src="https://pkg-size.dev/badge/install/125875" title="Install size for poku"></a>
+[![Install Size](https://packagephobia.com/badge?p=poku)](https://pkg-size.dev/poku)
 
-- [x] [~**175x** lighter than **Jest**](https://pkg-size.dev/jest)
-- [x] [~**302x** lighter than **Vitest**](https://pkg-size.dev/vitest)
-- [x] [~**44x** lighter than **Mocha** + **Chai**](https://pkg-size.dev/mocha%20chai)
+- [~**300x** lighter than **Vitest**](https://pkg-size.dev/vitest)
+- [~**170x** lighter than **Jest**](https://pkg-size.dev/jest)
+- [~**40x** lighter than **Mocha** + **Chai**](https://pkg-size.dev/mocha%20chai)
 
 ---
 
 ### Limitations
 
-- **Poku** community is gradually building up 🤝
-- Although it has no external dependencies, **Poku** is not _all-in-one_, so it doesn't have features such as _mocks_ and _spies_, where you can use your favorite packages or native solutions.
+- Although it has no external dependencies, **Poku** is not _all-in-one_, so it doesn't have features such as _mocks_, _spies_, _coverage reports_, etc., where you can use your favorite packages or native solutions.
+- **Poku** community is gradually building up.
 
 ---
 
@@ -260,4 +245,4 @@ Please check the [**SECURITY.md**](./SECURITY.md) and the section [**Is Poku Saf
 
 ## License
 
-Poku is under the [**MIT License**](./LICENSE).
+**Poku** is under the [**MIT License**](https://github.com/wellwelwel/poku/blob/main/LICENSE).

package/lib/bin/index.js

@@ -13,12 +13,15 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 const list_files_js_1 = require("../modules/list-files.js");
 const get_arg_js_1 = require("../helpers/get-arg.js");
-const poku_js_1 = require("../modules/poku.js");
-const processes_js_1 = require("../modules/processes.js");
+const files_js_1 = require("../configs/files.js");
 const get_runtime_js_1 = require("../helpers/get-runtime.js");
 const format_js_1 = require("../helpers/format.js");
 const logs_js_1 = require("../helpers/logs.js");
 const hr_js_1 = require("../helpers/hr.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/poku.js");
+const processes_js_1 = require("../modules/processes.js");
 (() => __awaiter(void 0, void 0, void 0, function* () {
     var _a;
     const dirs = (() => {
@@ -43,6 +46,7 @@ const hr_js_1 = require("../helpers/hr.js");
     const quiet = (0, get_arg_js_1.hasArg)('quiet');
     const debug = (0, get_arg_js_1.hasArg)('debug');
     const failFast = (0, get_arg_js_1.hasArg)('fail-fast');
+    const watchMode = (0, get_arg_js_1.hasArg)('watch');
     const concurrency = parallel
         ? Number((0, get_arg_js_1.getArg)('concurrency')) || undefined
         : undefined;
@@ -72,6 +76,7 @@ const hr_js_1 = require("../helpers/hr.js");
         debug,
         failFast,
         concurrency,
+        noExit: watchMode,
         deno: {
             allow: denoAllow,
             deny: denoDeny,
@@ -87,6 +92,53 @@ const hr_js_1 = require("../helpers/hr.js");
         (0, logs_js_1.write)(`${format_js_1.format.italic(format_js_1.format.info('…'))} ${format_js_1.format.bold('Options')}`);
         console.dir(options, { depth: null, colors: true });
     }
-    (0, poku_js_1.poku)(dirs, options);
+    yield (0, poku_js_1.poku)(dirs, options);
+    if (watchMode) {
+        const executing = new Set();
+        const interval = Number((0, get_arg_js_1.getArg)('watch-interval')) || 1500;
+        const resultsClear = () => {
+            files_js_1.fileResults.success.clear();
+            files_js_1.fileResults.fail.clear();
+        };
+        resultsClear();
+        (0, map_tests_js_1.mapTests)('.', dirs).then((mappedTests) => [
+            Array.from(mappedTests.keys()).forEach((mappedTest) => {
+                (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)(tests, options).then(() => {
+                            setTimeout(() => {
+                                executing.delete(filePath);
+                            }, interval);
+                        });
+                    }
+                });
+            }),
+        ]);
+        dirs.forEach((dir) => {
+            (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);
+                    });
+                }
+            });
+        });
+        (0, hr_js_1.hr)();
+        (0, logs_js_1.write)(`Watching: ${dirs.join(', ')}`);
+    }
 }))();
 /* c8 ignore stop */

package/lib/modules/each.d.ts

@@ -47,5 +47,5 @@ export declare const beforeEach: (callback: () => unknown, options?: EachOptions
  * after.reset();
  * ```
  */
-export declare const afterEach: (callback: () => unknown, options: Omit<EachOptions, 'immediate'>) => Control;
+export declare const afterEach: (callback: () => unknown, options?: Omit<EachOptions, 'immediate'>) => Control;
 export {};

package/lib/polyfills/fs.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { type Dirent, type Stats } from 'node:fs';
+export declare const readdir: (path: string, options: {
+    withFileTypes: true;
+}) => Promise<Dirent[]>;
+export declare const stat: (path: string) => Promise<Stats>;
+export declare const readFile: (path: string, encoding?: BufferEncoding) => Promise<string>;

package/lib/polyfills/fs.js

@@ -0,0 +1,35 @@
+"use strict";
+/* c8 ignore start */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readFile = exports.stat = exports.readdir = void 0;
+const node_fs_1 = require("fs");
+const readdir = (path, options) => new Promise((resolve, reject) => {
+    (0, node_fs_1.readdir)(path, options, (err, entries) => {
+        if (err)
+            reject(err);
+        else
+            resolve(entries);
+    });
+});
+exports.readdir = readdir;
+const stat = (path) => {
+    return new Promise((resolve, reject) => {
+        (0, node_fs_1.stat)(path, (err, stats) => {
+            if (err)
+                reject(err);
+            else
+                resolve(stats);
+        });
+    });
+};
+exports.stat = stat;
+const readFile = (path, encoding = 'utf-8') => new Promise((resolve, reject) => {
+    (0, node_fs_1.readFile)(path, encoding, (err, data) => {
+        if (err)
+            reject(err);
+        else
+            resolve(data);
+    });
+});
+exports.readFile = readFile;
+/* c8 ignore stop */

package/lib/services/map-tests.d.ts

@@ -0,0 +1,2 @@
+export declare const normalizePath: (filePath: string) => string;
+export declare const mapTests: (srcDir: string, testPaths: string[]) => Promise<Map<string, string[]>>;

package/lib/services/map-tests.js

@@ -0,0 +1,55 @@
+"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.mapTests = exports.normalizePath = void 0;
+/* c8 ignore next */
+const node_path_1 = require("path");
+const fs_js_1 = require("../polyfills/fs.js");
+const list_files_js_1 = require("../modules/list-files.js");
+const filter = /\.(js|cjs|mjs|ts|cts|mts)$/;
+const normalizePath = (filePath) => filePath
+    .replace(/(\.\/)/g, '')
+    .replace(/^\.+/, '')
+    .replace(/[/\\]+/g, node_path_1.sep)
+    .replace(/\\/g, '/');
+exports.normalizePath = normalizePath;
+/* c8 ignore next */
+const mapTests = (srcDir, testPaths) => __awaiter(void 0, void 0, void 0, function* () {
+    const allTestFiles = [];
+    const allSrcFiles = yield (0, list_files_js_1.listFiles)(srcDir, { filter });
+    const importMap = new Map();
+    for (const testPath of testPaths) {
+        const stats = yield (0, fs_js_1.stat)(testPath);
+        if (stats.isDirectory()) {
+            const testFiles = yield (0, list_files_js_1.listFiles)(testPath, { filter });
+            allTestFiles.push(...testFiles);
+        }
+        else if (stats.isFile() && filter.test(testPath))
+            allTestFiles.push(testPath);
+    }
+    for (const testFile of allTestFiles) {
+        const content = yield (0, fs_js_1.readFile)(testFile, 'utf-8');
+        for (const srcFile of allSrcFiles) {
+            const relativePath = (0, exports.normalizePath)((0, node_path_1.relative)((0, node_path_1.dirname)(testFile), srcFile));
+            const normalizedSrcFile = (0, exports.normalizePath)(srcFile);
+            /* c8 ignore start */
+            if (content.includes(relativePath.replace(filter, '')) ||
+                content.includes(normalizedSrcFile)) {
+                if (!importMap.has(normalizedSrcFile))
+                    importMap.set(normalizedSrcFile, []);
+                importMap.get(normalizedSrcFile).push((0, exports.normalizePath)(testFile));
+            }
+            /* c8 ignore stop */
+        }
+    }
+    return importMap;
+});
+exports.mapTests = mapTests;

package/lib/services/watch.d.ts

@@ -0,0 +1,18 @@
+export type WatchCallback = (file: string, event: string) => void;
+declare class Watcher {
+    private rootDir;
+    private files;
+    private fileWatchers;
+    private dirWatchers;
+    private callback;
+    constructor(rootDir: string, callback: WatchCallback);
+    private watchFile;
+    private unwatchFiles;
+    private watchFiles;
+    private watchDirectory;
+    start(): Promise<void>;
+    stop(): void;
+    private unwatchDirectories;
+}
+export declare const watch: (path: string, callback: WatchCallback) => Promise<Watcher>;
+export {};

package/lib/services/watch.js

@@ -0,0 +1,122 @@
+"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.watch = void 0;
+/* c8 ignore next */
+const node_fs_1 = require("fs");
+const node_path_1 = require("path");
+const fs_js_1 = require("../polyfills/fs.js");
+const list_files_js_1 = require("../modules/list-files.js");
+class Watcher {
+    constructor(rootDir, callback) {
+        this.files = [];
+        this.fileWatchers = new Map();
+        this.dirWatchers = new Map();
+        this.rootDir = rootDir;
+        this.callback = callback;
+    }
+    watchFile(filePath) {
+        /* c8 ignore next */
+        if (this.fileWatchers.has(filePath))
+            return;
+        const watcher = (0, node_fs_1.watch)(filePath, (eventType) => {
+            this.callback(filePath, eventType);
+        });
+        /* c8 ignore start */
+        watcher.on('error', () => {
+            return;
+        });
+        /* c8 ignore stop */
+        this.fileWatchers.set(filePath, watcher);
+    }
+    unwatchFiles() {
+        for (const [filePath, watcher] of this.fileWatchers) {
+            watcher.close();
+            this.fileWatchers.delete(filePath);
+        }
+    }
+    watchFiles(filePaths) {
+        this.unwatchFiles();
+        for (const filePath of filePaths) {
+            this.watchFile(filePath);
+        }
+    }
+    watchDirectory(dir) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.dirWatchers.has(dir))
+                return;
+            const watcher = (0, node_fs_1.watch)(dir, (_, filename) => __awaiter(this, void 0, void 0, function* () {
+                if (filename) {
+                    const fullPath = (0, node_path_1.join)(dir, filename);
+                    this.files = yield (0, list_files_js_1.listFiles)(this.rootDir);
+                    this.watchFiles(this.files);
+                    try {
+                        const stats = yield (0, fs_js_1.stat)(fullPath);
+                        if (stats.isDirectory())
+                            yield this.watchDirectory(fullPath);
+                        /* c8 ignore start */
+                    }
+                    catch (_a) { }
+                    /* c8 ignore stop */
+                }
+            }));
+            /* c8 ignore start */
+            watcher.on('error', () => {
+                return;
+            });
+            /* c8 ignore stop */
+            this.dirWatchers.set(dir, watcher);
+            const entries = yield (0, fs_js_1.readdir)(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    const fullPath = (0, node_path_1.join)(dir, entry.name);
+                    yield this.watchDirectory(fullPath);
+                }
+            }
+        });
+    }
+    start() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const stats = yield (0, fs_js_1.stat)(this.rootDir);
+                if (stats.isDirectory()) {
+                    this.files = yield (0, list_files_js_1.listFiles)(this.rootDir);
+                    this.watchFiles(this.files);
+                    yield this.watchDirectory(this.rootDir);
+                }
+                else
+                    this.watchFile(this.rootDir);
+                /* c8 ignore start */
+            }
+            catch (err) {
+                throw new Error(`Path does not exist or is not accessible: ${this.rootDir}`);
+            }
+            /* c8 ignore stop */
+        });
+    }
+    stop() {
+        this.unwatchFiles();
+        this.unwatchDirectories();
+    }
+    unwatchDirectories() {
+        for (const [dirPath, watcher] of this.dirWatchers) {
+            watcher.close();
+            this.dirWatchers.delete(dirPath);
+        }
+    }
+}
+/* c8 ignore next */
+const watch = (path, callback) => __awaiter(void 0, void 0, void 0, function* () {
+    const watcher = new Watcher(path, callback);
+    yield watcher.start();
+    return watcher;
+});
+exports.watch = watch;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poku",
-  "version": "1.15.1",
+  "version": "1.17.0",
   "description": "🐷 Poku makes testing easy for Node.js, Bun, Deno and you at the same time.",
   "main": "./lib/index.js",
   "scripts": {
@@ -70,6 +70,7 @@
     "run",
     "queue",
     "queuing",
+    "watch",
     "nodejs",
     "node",
     "cli-app",
@@ -126,7 +127,7 @@
     "@types/node": "^20.14.2",
     "@typescript-eslint/eslint-plugin": "^7.13.0",
     "@typescript-eslint/parser": "^7.13.0",
-    "c8": "^10.1.0",
+    "c8": "^10.1.2",
     "esbuild": "^0.21.5",
     "eslint": "^8.57.0",
     "eslint-config-prettier": "^9.1.0",
@@ -136,7 +137,7 @@
     "packages-update": "^2.0.0",
     "prettier": "^3.3.2",
     "shx": "^0.3.4",
-    "tsx": "4.15.2",
+    "tsx": "4.15.4",
     "typescript": "^5.4.5"
   }
 }