poku 4.3.3-canary.7e1ba35c → 4.4.0

package/lib/modules/_shared.cjs

@@ -447,7 +447,7 @@ const states = getSharedState("states", {
 }), errorHoist = getSharedState("errorHoist", {
   depth: 0,
   failed: !1
-}), VERSION = "4.3.3-canary.7e1ba35c", deepOptions = getSharedState("deepOptions", []), GLOBAL = getSharedState("GLOBAL", {
+}), VERSION = "4.4.0", deepOptions = getSharedState("deepOptions", []), GLOBAL = getSharedState("GLOBAL", {
   cwd: cwd$1,
   configs: {
     filter: void 0,
@@ -864,14 +864,12 @@ const poku = (async (targetPaths, configs) => {
   if (typeof messageOrCb == "function") return itBase2(messageOrCb);
 }), SCOPE_HOOKS_KEY = /* @__PURE__ */ Symbol.for("@pokujs/poku.test-scope-hooks"), getScopeHook = () => globalThis[SCOPE_HOOKS_KEY], itBase = async (titleOrCb, callback) => {
   try {
-    const title = getTitle(titleOrCb), hasTitle = typeof title == "string", cb = getCallback(hasTitle ? callback : titleOrCb);
-    let success = !0, start, end;
+    const title = getTitle(titleOrCb), hasTitle = typeof title == "string", cb = getCallback(hasTitle ? callback : titleOrCb), insideDescribe = errorHoist.depth > 0;
+    let success = !0, start, end, onError;
     if (GLOBAL.reporter.onItStart({ title }), hasTitle && indentation.itDepth++, typeof each.before.cb == "function") {
       const beforeResult = each.before.cb();
       beforeResult instanceof Promise && await beforeResult;
     }
-    const insideDescribe = errorHoist.depth > 0;
-    let onError;
     insideDescribe ? errorHoist.failed = !1 : (onError = (error) => {
       const ctx = retryContext.stack?.[retryContext.stack.length - 1];
       ctx ? ctx.failed = !0 : (process$1.exitCode = 1, success = !1, error instanceof nodeAssert.AssertionError || console.error(error));
@@ -1147,18 +1145,14 @@ const regex = {
 }), killPID = async (PID) => {
   const PIDs = setPortsAndPIDs(PID);
   await Promise.all(
-    PIDs.map(async (p) => {
-      isWindows ? await killPID$1.windows(p) : await killPID$1.unix(p);
-    })
+    PIDs.map(
+      async (p) => isWindows ? killPID$1.windows(p) : killPID$1.unix(p)
+    )
   );
 }, killPIDs = async (PIDs) => {
   for (const PID of PIDs)
     PID && await killPID(PID);
-}, killPort = async (port) => {
-  await killPIDs(await getPIDs(port));
-}, killRange = async (startsAt, endsAt) => {
-  await killPIDs(await getPIDs.range(startsAt, endsAt));
-}, kill = {
+}, killPort = async (port) => killPIDs(await getPIDs(port)), killRange = async (startsAt, endsAt) => killPIDs(await getPIDs.range(startsAt, endsAt)), kill = {
   pid: killPID,
   port: killPort,
   range: killRange

package/lib/modules/_shared.d.cts

@@ -4,17 +4,8 @@ import { ChildProcess, ChildProcessWithoutNullStreams } from 'node:child_process
 type Code = 0 | 1;
 
 type Configs$1 = {
-    /**
-     * Filter by path to match only the files that should be performed.
-     *
-     * @default /\.(test|spec)\./i
-     */
+    /** @default /\.(test|spec)\./i */
     filter?: RegExp;
-    /**
-     * Exclude by path to match only the files that should be performed.
-     *
-     * @default undefined
-     */
     exclude?: RegExp | RegExp[];
 };
 
@@ -92,9 +83,8 @@ type PluginContext = {
     readonly reporter: ReturnType<ReporterPlugin>;
 };
 type PokuPlugin = {
-    /** Plugin name */
     name?: string;
-    /** Modify the command array before spawning a test file process */
+    /** Modify the command before spawning a test file process */
     runner?: (command: string[], file: string) => string[];
     /** Run before the test suite begins */
     setup?: (context: PluginContext) => void | Promise<void>;
@@ -198,104 +188,30 @@ type DenoOptions = {
 type Runtime = 'node' | 'bun' | 'deno';
 type Reporter = 'poku' | 'focus' | 'dot' | 'compact' | 'classic' | ReporterPlugin | CustomString;
 type Configs = {
-    /**
-     * By setting `true`, **Poku** won't exit the process and will return the exit code (`0` or `1`)
-     *
-     * @default false
-     */
-    noExit?: boolean;
-    /**
-     * This option overwrites all `log` settings
-     *
-     * @default false
-     */
-    debug?: boolean;
-    /**
-     * This option overwrites the `debug` settings
-     *
-     * @default false
-     */
-    quiet?: boolean;
-    /**
-     * Determines the mode of test execution
-     *
-     * @default false
-     */
+    /** Run tests sequentially */
     sequential?: boolean;
-    /**
-     * Controls process isolation for test files
-     *
-     * - `'process'` (default): each test file runs in a separate child process
-     * - `'none'`: all test files run in the same process (useful for debugging with `--inspect`)
-     *
-     * @default 'process'
-     */
     isolation?: 'none' | 'process' | CustomString;
-    /**
-     * Stops the tests at the first failure.
-     *
-     * @default false
-     */
+    /** Stop execution at the first error */
     failFast?: boolean;
-    /**
-     * Limits the number of tests running concurrently
-     *
-     * @default (availableParallelism() || cpus().lenght)
-     */
+    /** @default (availableParallelism() || cpus().lenght) */
     concurrency?: number;
-    /**
-     * Sets the maximum time in milliseconds that each test file is allowed to run
-     *
-     * @default undefined
-     */
+    /** Set a timeout for each test file */
     timeout?: number;
-    /**
-     * @default "poku"
-     */
+    /** @default "poku" */
     reporter?: Reporter;
-    /**
-     * You can use this option to run a **callback** or a **file** before each test file on your suite
-     *
-     * ```ts
-     * beforeEach(() => myFunc())
-     * ```
-     *
-     * ```ts
-     * beforeEach(async () => await myAsyncFunc())
-     * ```
-     */
+    /** Run a callback or a file before each test file */
     beforeEach?: () => unknown | Promise<unknown>;
-    /**
-     * You can use this option to run a **callback** or a **file** after each test file on your suite
-     *
-     * ```ts
-     * afterEach(() => myFunc())
-     * ```
-     *
-     * ```ts
-     * afterEach(async () => await myAsyncFunc())
-     * ```
-     */
+    /** Run a callback or a file after each test file */
     afterEach?: () => unknown | Promise<unknown>;
     deno?: DenoOptions;
-    /**
-     * Plugins to extend Poku's behavior
-     *
-     * @default undefined
-     */
     plugins?: PokuPlugin[];
-    /**
-     * Only run tests whose title matches the given regex pattern
-     *
-     * @default undefined
-     */
+    /** Only run tests whose title matches the given regex pattern */
     testNamePattern?: RegExp;
-    /**
-     * Skip tests whose title matches the given regex pattern
-     *
-     * @default undefined
-     */
+    /** Skip tests whose title matches the given regex pattern */
     testSkipPattern?: RegExp;
+    debug?: boolean;
+    quiet?: boolean;
+    noExit?: boolean;
 } & Configs$1;
 type Timespan = {
     started: Date;
@@ -303,17 +219,11 @@ type Timespan = {
     duration: number;
 };
 type CliConfigs = {
-    /** Default: searches for _`.test.`_ and `.spec.` files, but you can customize it */
     include?: string | string[];
-    /** Reads an environment file and sets the environment variables */
     envFile?: string;
-    /** Terminates the specified ports, port ranges and process IDs */
     kill?: {
-        /** Terminates the specified ports before running the test suite */
         port?: [number];
-        /** Terminates the specified port range before running the test suite */
         range?: [number, number][];
-        /** Terminates the specified processes before running the test suite */
         pid?: [number];
     };
 };

package/lib/modules/_shared.d.ts

@@ -4,17 +4,8 @@ import { ChildProcess, ChildProcessWithoutNullStreams } from 'node:child_process
 type Code = 0 | 1;
 
 type Configs$1 = {
-    /**
-     * Filter by path to match only the files that should be performed.
-     *
-     * @default /\.(test|spec)\./i
-     */
+    /** @default /\.(test|spec)\./i */
     filter?: RegExp;
-    /**
-     * Exclude by path to match only the files that should be performed.
-     *
-     * @default undefined
-     */
     exclude?: RegExp | RegExp[];
 };
 
@@ -92,9 +83,8 @@ type PluginContext = {
     readonly reporter: ReturnType<ReporterPlugin>;
 };
 type PokuPlugin = {
-    /** Plugin name */
     name?: string;
-    /** Modify the command array before spawning a test file process */
+    /** Modify the command before spawning a test file process */
     runner?: (command: string[], file: string) => string[];
     /** Run before the test suite begins */
     setup?: (context: PluginContext) => void | Promise<void>;
@@ -198,104 +188,30 @@ type DenoOptions = {
 type Runtime = 'node' | 'bun' | 'deno';
 type Reporter = 'poku' | 'focus' | 'dot' | 'compact' | 'classic' | ReporterPlugin | CustomString;
 type Configs = {
-    /**
-     * By setting `true`, **Poku** won't exit the process and will return the exit code (`0` or `1`)
-     *
-     * @default false
-     */
-    noExit?: boolean;
-    /**
-     * This option overwrites all `log` settings
-     *
-     * @default false
-     */
-    debug?: boolean;
-    /**
-     * This option overwrites the `debug` settings
-     *
-     * @default false
-     */
-    quiet?: boolean;
-    /**
-     * Determines the mode of test execution
-     *
-     * @default false
-     */
+    /** Run tests sequentially */
     sequential?: boolean;
-    /**
-     * Controls process isolation for test files
-     *
-     * - `'process'` (default): each test file runs in a separate child process
-     * - `'none'`: all test files run in the same process (useful for debugging with `--inspect`)
-     *
-     * @default 'process'
-     */
     isolation?: 'none' | 'process' | CustomString;
-    /**
-     * Stops the tests at the first failure.
-     *
-     * @default false
-     */
+    /** Stop execution at the first error */
     failFast?: boolean;
-    /**
-     * Limits the number of tests running concurrently
-     *
-     * @default (availableParallelism() || cpus().lenght)
-     */
+    /** @default (availableParallelism() || cpus().lenght) */
     concurrency?: number;
-    /**
-     * Sets the maximum time in milliseconds that each test file is allowed to run
-     *
-     * @default undefined
-     */
+    /** Set a timeout for each test file */
     timeout?: number;
-    /**
-     * @default "poku"
-     */
+    /** @default "poku" */
     reporter?: Reporter;
-    /**
-     * You can use this option to run a **callback** or a **file** before each test file on your suite
-     *
-     * ```ts
-     * beforeEach(() => myFunc())
-     * ```
-     *
-     * ```ts
-     * beforeEach(async () => await myAsyncFunc())
-     * ```
-     */
+    /** Run a callback or a file before each test file */
     beforeEach?: () => unknown | Promise<unknown>;
-    /**
-     * You can use this option to run a **callback** or a **file** after each test file on your suite
-     *
-     * ```ts
-     * afterEach(() => myFunc())
-     * ```
-     *
-     * ```ts
-     * afterEach(async () => await myAsyncFunc())
-     * ```
-     */
+    /** Run a callback or a file after each test file */
     afterEach?: () => unknown | Promise<unknown>;
     deno?: DenoOptions;
-    /**
-     * Plugins to extend Poku's behavior
-     *
-     * @default undefined
-     */
     plugins?: PokuPlugin[];
-    /**
-     * Only run tests whose title matches the given regex pattern
-     *
-     * @default undefined
-     */
+    /** Only run tests whose title matches the given regex pattern */
     testNamePattern?: RegExp;
-    /**
-     * Skip tests whose title matches the given regex pattern
-     *
-     * @default undefined
-     */
+    /** Skip tests whose title matches the given regex pattern */
     testSkipPattern?: RegExp;
+    debug?: boolean;
+    quiet?: boolean;
+    noExit?: boolean;
 } & Configs$1;
 type Timespan = {
     started: Date;
@@ -303,17 +219,11 @@ type Timespan = {
     duration: number;
 };
 type CliConfigs = {
-    /** Default: searches for _`.test.`_ and `.spec.` files, but you can customize it */
     include?: string | string[];
-    /** Reads an environment file and sets the environment variables */
     envFile?: string;
-    /** Terminates the specified ports, port ranges and process IDs */
     kill?: {
-        /** Terminates the specified ports before running the test suite */
         port?: [number];
-        /** Terminates the specified port range before running the test suite */
         range?: [number, number][];
-        /** Terminates the specified processes before running the test suite */
         pid?: [number];
     };
 };

package/lib/modules/_shared.js

@@ -441,7 +441,7 @@ const states = getSharedState("states", {
 }), errorHoist = getSharedState("errorHoist", {
   depth: 0,
   failed: !1
-}), VERSION = "4.3.3-canary.7e1ba35c", deepOptions = getSharedState("deepOptions", []), GLOBAL = getSharedState("GLOBAL", {
+}), VERSION = "4.4.0", deepOptions = getSharedState("deepOptions", []), GLOBAL = getSharedState("GLOBAL", {
   cwd: cwd$1,
   configs: {
     filter: void 0,
@@ -874,14 +874,12 @@ const poku = (async (targetPaths, configs) => {
   if (typeof messageOrCb == "function") return itBase2(messageOrCb);
 }), SCOPE_HOOKS_KEY = /* @__PURE__ */ Symbol.for("@pokujs/poku.test-scope-hooks"), getScopeHook = () => globalThis[SCOPE_HOOKS_KEY], itBase = async (titleOrCb, callback) => {
   try {
-    const title = getTitle(titleOrCb), hasTitle = typeof title == "string", cb = getCallback(hasTitle ? callback : titleOrCb);
-    let success = !0, start, end;
+    const title = getTitle(titleOrCb), hasTitle = typeof title == "string", cb = getCallback(hasTitle ? callback : titleOrCb), insideDescribe = errorHoist.depth > 0;
+    let success = !0, start, end, onError;
     if (GLOBAL.reporter.onItStart({ title }), hasTitle && indentation.itDepth++, typeof each.before.cb == "function") {
       const beforeResult = each.before.cb();
       beforeResult instanceof Promise && await beforeResult;
     }
-    const insideDescribe = errorHoist.depth > 0;
-    let onError;
     insideDescribe ? errorHoist.failed = !1 : (onError = (error) => {
       const ctx = retryContext.stack?.[retryContext.stack.length - 1];
       ctx ? ctx.failed = !0 : (process$1.exitCode = 1, success = !1, error instanceof AssertionError || console.error(error));
@@ -1157,18 +1155,14 @@ const regex = {
 }), killPID = async (PID) => {
   const PIDs = setPortsAndPIDs(PID);
   await Promise.all(
-    PIDs.map(async (p) => {
-      isWindows ? await killPID$1.windows(p) : await killPID$1.unix(p);
-    })
+    PIDs.map(
+      async (p) => isWindows ? killPID$1.windows(p) : killPID$1.unix(p)
+    )
   );
 }, killPIDs = async (PIDs) => {
   for (const PID of PIDs)
     PID && await killPID(PID);
-}, killPort = async (port) => {
-  await killPIDs(await getPIDs(port));
-}, killRange = async (startsAt, endsAt) => {
-  await killPIDs(await getPIDs.range(startsAt, endsAt));
-}, kill = {
+}, killPort = async (port) => killPIDs(await getPIDs(port)), killRange = async (startsAt, endsAt) => killPIDs(await getPIDs.range(startsAt, endsAt)), kill = {
   pid: killPID,
   port: killPort,
   range: killRange

package/lib/modules/index.d.cts

@@ -80,7 +80,6 @@ declare const it: It & {
     only: Modifier;
 };
 
-/** Reads an environment file and sets the environment variables. */
 declare const envFile: (filePath?: string) => Promise<void>;
 
 declare const skip: (message?: string) => never;
@@ -94,41 +93,7 @@ type EachOptions = {
     immediate?: boolean;
 };
 
-/**
- * Handle **global states** and **external** services before each `test` or `it`.
- *
- * ---
- *
- * ```ts
- * import { beforeEach } from 'poku';
- *
- * const before = beforeEach(() => {
- *   // prepare
- * };
- *
- * before.pause();
- * before.continue();
- * before.reset();
- * ```
- */
 declare const beforeEach: (callback: () => unknown, options?: EachOptions) => Control;
-/**
- * Handle **global states** and **external** services after each `test` or `it`.
- *
- * ---
- *
- * ```ts
- * import { afterEach } from 'poku';
- *
- * const after = afterEach(() => {
- *   // cleanup
- * };
- *
- * after.pause();
- * after.continue();
- * after.reset();
- * ```
- */
 declare const afterEach: (callback: () => unknown) => Control;
 
 type RetryConfig = {
@@ -141,115 +106,54 @@ declare function retry(config: number | RetryConfig, callback: () => unknown | P
 type Runner = 'npm' | 'bun' | 'deno' | 'yarn' | 'pnpm';
 
 type BackgroundProcessOptions = {
-    /**
-     * - Default: resolves in the first console output
-     * - String: waits for a specifc string on console output to resolve
-     * - Number: waits for time in milliseconds to resolve
-     *
-     * @default undefined
-     */
     startAfter?: string | number;
-    /**
-     * Stops the service for neither success nor failure after:
-     *
-     * @default 60000
-     */
     timeout?: number;
-    /** Shows the output from service */
     verbose?: boolean;
-    /**
-     * Specify a target path to start the process
-     *
-     * @default "./"
-     */
     cwd?: string | undefined;
 };
 type StartScriptOptions = {
-    /** By default, Poku will use `npm`. Change it as you want */
     readonly runner?: Runner;
 } & BackgroundProcessOptions;
 type StartServiceOptions = BackgroundProcessOptions;
 type End = (port?: number | number[]) => Promise<void>;
 
-/** Starts a file in a background process (useful for servers, APIs, etc.) */
 declare const startService: (file: string, options?: StartServiceOptions) => Promise<{
     end: End;
 }>;
-/**
- *
- * Starts a script (package.json) or task (deno.json) in a background process (useful for servers, APIs, etc.).
- *
- * ---
- *
- * By default it uses **npm**, but you can costumize it using the `runner` option.
- */
 declare const startScript: (script: string, options?: StartScriptOptions) => Promise<{
     end: End;
 }>;
 
 type WaitForExpectedResultOptions = {
-    /**
-     * Retry interval in milliseconds
-     *
-     * @default 100
-     */
+    /** @default 100 */
     interval?: number;
-    /**
-     * Timeout in milliseconds
-     *
-     * @default 60000
-     */
+    /** @default 60000 */
     timeout?: number;
-    /**
-     * Delays both the start and end by the defined milliseconds
-     *
-     * @default 0
-     */
     delay?: number;
-    /**
-     * Ensure strict comparisons
-     *
-     * - For **Bun** users, this option isn't necessary
-     *
-     * @default false
-     */
+    /** Ensure strict comparisons */
     strict?: boolean;
 };
 type WaitForPortOptions = {
-    /**
-     * Host to check the port on
-     *
-     * @default "localhost"
-     */
+    /** @default "localhost" */
     host?: string;
 } & Omit<WaitForExpectedResultOptions, 'strict'>;
 
-/** Wait until the defined milliseconds. */
-declare const sleep: (milliseconds: number) => Promise<void>;
-/** Wait until a result is equal the expected value. */
+declare const sleep: (milliseconds: number) => Promise<unknown>;
 declare const waitForExpectedResult: (callback: () => unknown | Promise<unknown>, expectedResult: unknown, options?: WaitForExpectedResultOptions) => Promise<void>;
-/** Wait until the defined port is active. */
 declare const waitForPort: (port: number, options?: WaitForPortOptions) => Promise<void>;
 
-/** Kill processes by PIDs, ports and port ranges. */
 declare const kill: {
-    /** Kill the specified process ID */
     pid: (PID: number | number[]) => Promise<void>;
-    /** Kill all processes listening on the specified port */
     port: (port: number | number[]) => Promise<void>;
-    /** Kill all processes listening on the specified range ports */
     range: (startsAt: number, endsAt: number) => Promise<void>;
 };
 
-/** Returns an array containing the ID of all processes listening to the specified port */
 declare const getPIDs: ((port: number | number[]) => Promise<number[]>) & {
-    /** Returns an array containing the ID of all processes listening to the specified port range */
     range: (startsAt: number, endsAt: number) => Promise<number[]>;
 };
 
 declare const exit: (code: Code, quiet?: boolean) => void;
 
-/** By default **Poku** only shows outputs generated from itself. This helper allows you to use an alternative to `console.log` with **Poku**. */
 declare const log: (...args: unknown[]) => void;
 
 declare const listFiles: (targetDir: string, configs?: Configs) => Promise<string[]>;

package/lib/modules/index.d.ts

@@ -80,7 +80,6 @@ declare const it: It & {
     only: Modifier;
 };
 
-/** Reads an environment file and sets the environment variables. */
 declare const envFile: (filePath?: string) => Promise<void>;
 
 declare const skip: (message?: string) => never;
@@ -94,41 +93,7 @@ type EachOptions = {
     immediate?: boolean;
 };
 
-/**
- * Handle **global states** and **external** services before each `test` or `it`.
- *
- * ---
- *
- * ```ts
- * import { beforeEach } from 'poku';
- *
- * const before = beforeEach(() => {
- *   // prepare
- * };
- *
- * before.pause();
- * before.continue();
- * before.reset();
- * ```
- */
 declare const beforeEach: (callback: () => unknown, options?: EachOptions) => Control;
-/**
- * Handle **global states** and **external** services after each `test` or `it`.
- *
- * ---
- *
- * ```ts
- * import { afterEach } from 'poku';
- *
- * const after = afterEach(() => {
- *   // cleanup
- * };
- *
- * after.pause();
- * after.continue();
- * after.reset();
- * ```
- */
 declare const afterEach: (callback: () => unknown) => Control;
 
 type RetryConfig = {
@@ -141,115 +106,54 @@ declare function retry(config: number | RetryConfig, callback: () => unknown | P
 type Runner = 'npm' | 'bun' | 'deno' | 'yarn' | 'pnpm';
 
 type BackgroundProcessOptions = {
-    /**
-     * - Default: resolves in the first console output
-     * - String: waits for a specifc string on console output to resolve
-     * - Number: waits for time in milliseconds to resolve
-     *
-     * @default undefined
-     */
     startAfter?: string | number;
-    /**
-     * Stops the service for neither success nor failure after:
-     *
-     * @default 60000
-     */
     timeout?: number;
-    /** Shows the output from service */
     verbose?: boolean;
-    /**
-     * Specify a target path to start the process
-     *
-     * @default "./"
-     */
     cwd?: string | undefined;
 };
 type StartScriptOptions = {
-    /** By default, Poku will use `npm`. Change it as you want */
     readonly runner?: Runner;
 } & BackgroundProcessOptions;
 type StartServiceOptions = BackgroundProcessOptions;
 type End = (port?: number | number[]) => Promise<void>;
 
-/** Starts a file in a background process (useful for servers, APIs, etc.) */
 declare const startService: (file: string, options?: StartServiceOptions) => Promise<{
     end: End;
 }>;
-/**
- *
- * Starts a script (package.json) or task (deno.json) in a background process (useful for servers, APIs, etc.).
- *
- * ---
- *
- * By default it uses **npm**, but you can costumize it using the `runner` option.
- */
 declare const startScript: (script: string, options?: StartScriptOptions) => Promise<{
     end: End;
 }>;
 
 type WaitForExpectedResultOptions = {
-    /**
-     * Retry interval in milliseconds
-     *
-     * @default 100
-     */
+    /** @default 100 */
     interval?: number;
-    /**
-     * Timeout in milliseconds
-     *
-     * @default 60000
-     */
+    /** @default 60000 */
     timeout?: number;
-    /**
-     * Delays both the start and end by the defined milliseconds
-     *
-     * @default 0
-     */
     delay?: number;
-    /**
-     * Ensure strict comparisons
-     *
-     * - For **Bun** users, this option isn't necessary
-     *
-     * @default false
-     */
+    /** Ensure strict comparisons */
     strict?: boolean;
 };
 type WaitForPortOptions = {
-    /**
-     * Host to check the port on
-     *
-     * @default "localhost"
-     */
+    /** @default "localhost" */
     host?: string;
 } & Omit<WaitForExpectedResultOptions, 'strict'>;
 
-/** Wait until the defined milliseconds. */
-declare const sleep: (milliseconds: number) => Promise<void>;
-/** Wait until a result is equal the expected value. */
+declare const sleep: (milliseconds: number) => Promise<unknown>;
 declare const waitForExpectedResult: (callback: () => unknown | Promise<unknown>, expectedResult: unknown, options?: WaitForExpectedResultOptions) => Promise<void>;
-/** Wait until the defined port is active. */
 declare const waitForPort: (port: number, options?: WaitForPortOptions) => Promise<void>;
 
-/** Kill processes by PIDs, ports and port ranges. */
 declare const kill: {
-    /** Kill the specified process ID */
     pid: (PID: number | number[]) => Promise<void>;
-    /** Kill all processes listening on the specified port */
     port: (port: number | number[]) => Promise<void>;
-    /** Kill all processes listening on the specified range ports */
     range: (startsAt: number, endsAt: number) => Promise<void>;
 };
 
-/** Returns an array containing the ID of all processes listening to the specified port */
 declare const getPIDs: ((port: number | number[]) => Promise<number[]>) & {
-    /** Returns an array containing the ID of all processes listening to the specified port range */
     range: (startsAt: number, endsAt: number) => Promise<number[]>;
 };
 
 declare const exit: (code: Code, quiet?: boolean) => void;
 
-/** By default **Poku** only shows outputs generated from itself. This helper allows you to use an alternative to `console.log` with **Poku**. */
 declare const log: (...args: unknown[]) => void;
 
 declare const listFiles: (targetDir: string, configs?: Configs) => Promise<string[]>;

package/lib/modules/plugins.d.cts

@@ -13,7 +13,6 @@ declare const reporter: Record<string, ReporterPlugin>;
 
 /** 🐷 Auxiliary function to define a Poku plugin */
 declare const definePlugin: (plugin: PokuPlugin) => PokuPlugin;
-/** 🐽 Auxiliary function to inspect a Poku CLI execution during plugin development */
 declare const inspectPoku: (options: {
     command: string;
     spawnOptions?: SpawnOptionsWithoutStdio;

package/lib/modules/plugins.d.ts

@@ -13,7 +13,6 @@ declare const reporter: Record<string, ReporterPlugin>;
 
 /** 🐷 Auxiliary function to define a Poku plugin */
 declare const definePlugin: (plugin: PokuPlugin) => PokuPlugin;
-/** 🐽 Auxiliary function to inspect a Poku CLI execution during plugin development */
 declare const inspectPoku: (options: {
     command: string;
     spawnOptions?: SpawnOptionsWithoutStdio;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poku",
-  "version": "4.3.3-canary.7e1ba35c",
+  "version": "4.4.0",
   "description": "🐷 Poku makes testing easy for Node.js, Bun, Deno, and you at the same time.",
   "license": "MIT",
   "type": "module",