poku 4.2.1 → 4.2.2-canary.7b82ad1d

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

@@ -95,4 +95,12 @@ export type InspectCLIResult = {
     PID: number;
     kill: () => Promise<void>;
 };
+export type ScopeHook = {
+    createHolder: () => {
+        scope: unknown;
+    };
+    runScoped: (holder: {
+        scope: unknown;
+    }, fn: (params?: Record<string, unknown>) => Promise<unknown> | unknown) => Promise<void>;
+};
 export {};

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

@@ -145,3 +145,4 @@ export type ConfigJSONFile = {
     testSkipPattern?: string;
 } & Omit<Configs, 'beforeEach' | 'afterEach' | 'noExit' | 'filter' | 'exclude' | 'plugins' | 'testNamePattern' | 'testSkipPattern'> & CliConfigs;
 export type ConfigFile = Omit<Configs, 'noExit'> & CliConfigs;
+export type TestCallback = (params?: Record<string, unknown>) => unknown | Promise<unknown>;

package/lib/configs/poku.js

@@ -21,7 +21,7 @@ exports.results = {
     skipped: 0,
     todo: 0,
 };
-exports.VERSION = '4.2.1';
+exports.VERSION = '4.2.2-canary.7b82ad1d';
 exports.deepOptions = [];
 exports.GLOBAL = {
     cwd: (0, node_process_1.cwd)(),

package/lib/modules/helpers/it/core.d.ts

@@ -1,11 +1,12 @@
+import type { TestCallback } from '../../../@types/poku.js';
 import { onlyIt, skip, todo } from '../modifiers.js';
 export declare const getTitle: (input: unknown) => string | undefined;
-export declare const getCallback: (input: unknown) => (() => unknown) | (() => Promise<unknown>) | undefined;
-export declare const itBase: (titleOrCb: string | (() => unknown | Promise<unknown>), callback?: () => unknown | Promise<unknown>) => Promise<void>;
-declare function itCore(title: string, cb: () => Promise<unknown>): Promise<void>;
-declare function itCore(title: string, cb: () => unknown): void;
-declare function itCore(cb: () => Promise<unknown>): Promise<void>;
-declare function itCore(cb: () => unknown): void;
+export declare const getCallback: (input: unknown) => TestCallback | undefined;
+export declare const itBase: (titleOrCb: string | TestCallback, callback?: TestCallback) => Promise<void>;
+declare function itCore(title: string, cb: TestCallback): Promise<void>;
+declare function itCore(title: string, cb: TestCallback): void;
+declare function itCore(cb: TestCallback): Promise<void>;
+declare function itCore(cb: TestCallback): void;
 export declare const it: typeof itCore & {
     todo: typeof todo;
     skip: typeof skip;

package/lib/modules/helpers/it/core.js

@@ -11,12 +11,12 @@ const indentation_js_1 = require("../../../configs/indentation.js");
 const poku_js_1 = require("../../../configs/poku.js");
 const get_arg_js_1 = require("../../../parsers/get-arg.js");
 const modifiers_js_1 = require("../modifiers.js");
+const SCOPE_HOOKS_KEY = Symbol.for('@pokujs/poku.test-scope-hooks');
 const getTitle = (input) => typeof input === 'string' ? input : undefined;
 exports.getTitle = getTitle;
-const getCallback = (input) => typeof input === 'function'
-    ? input
-    : undefined;
+const getCallback = (input) => typeof input === 'function' ? input : undefined;
 exports.getCallback = getCallback;
+const getScopeHook = () => globalThis[SCOPE_HOOKS_KEY];
 const itBase = async (titleOrCb, callback) => {
     try {
         const title = (0, exports.getTitle)(titleOrCb);
@@ -49,9 +49,16 @@ const itBase = async (titleOrCb, callback) => {
             poku_js_1.errorHoist.failed = false;
         start = node_process_1.default.hrtime();
         try {
-            const resultCb = cb();
-            if (resultCb instanceof Promise)
-                await resultCb;
+            const hooks = getScopeHook();
+            if (hooks) {
+                const holder = hooks.createHolder();
+                await hooks.runScoped(holder, (params) => cb(params));
+            }
+            else {
+                const resultCb = cb();
+                if (resultCb instanceof Promise)
+                    await resultCb;
+            }
         }
         catch (error) {
             node_process_1.default.exitCode = 1;

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

@@ -1,8 +1,8 @@
 export declare const test: {
-    (title: string, cb: () => Promise<unknown>): Promise<void>;
-    (title: string, cb: () => unknown): void;
-    (cb: () => Promise<unknown>): Promise<void>;
-    (cb: () => unknown): void;
+    (title: string, cb: import("../../@types/poku.js").TestCallback): Promise<void>;
+    (title: string, cb: import("../../@types/poku.js").TestCallback): void;
+    (cb: import("../../@types/poku.js").TestCallback): Promise<void>;
+    (cb: import("../../@types/poku.js").TestCallback): void;
 } & {
     todo: typeof import("./modifiers.js").todo;
     skip: typeof import("./modifiers.js").skip;

package/lib/modules/plugins.d.ts

@@ -4,7 +4,7 @@ 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';
+export type { ReporterPlugin, ReporterEvents, PokuPlugin, PluginContext, InspectCLIResult, ScopeHook, } from '../@types/plugin.js';
 /** 🐷 Auxiliary function to define a Poku plugin */
 export declare const definePlugin: (plugin: PokuPlugin) => PokuPlugin;
 /** 🐽 Auxiliary function to inspect a Poku CLI execution */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poku",
-  "version": "4.2.1",
+  "version": "4.2.2-canary.7b82ad1d",
   "description": "🐷 Poku makes testing easy for Node.js, Bun, Deno, and you at the same time.",
   "main": "./lib/modules/index.js",
   "exports": {