feat: add ALS-based test scope hooks foundation

package.json

@@ -75,6 +75,7 @@
     }
   },
   "dependencies": {
+    "@pokujs/scope-hooks": "^1.1.0",
     "@testing-library/dom": "^10.4.1"
   },
   "devDependencies": {
@@ -84,7 +85,7 @@
     "cross-env": "^10.1.0",
     "happy-dom": "^20.8.9",
     "jsdom": "^26.1.0",
-    "poku": "4.2.0",
+    "poku": "^4.3.0",
     "rimraf": "^6.0.1",
     "tsx": "^4.21.0",
     "typescript": "^6.0.2"

src/dom-env.ts

@@ -1,5 +1,6 @@
 import { GlobalWindow } from 'happy-dom';
 import type { RuntimeOptions } from './types.ts';
+import { registerScopeHooks } from './test-scope.ts';
 
 type SetupDomEnvironmentOptions = {
   runtimeOptions: RuntimeOptions;
@@ -30,6 +31,8 @@ const defineGlobal = (key: keyof typeof globalThis, value: unknown) => {
 export const setupHappyDomEnvironment = async (
   options: SetupDomEnvironmentOptions
 ) => {
+  registerScopeHooks();
+
   if (!globalThis.window || !globalThis.document) {
     // Save native event primitives before installing Happy DOM globals.
     // Deno's runtime calls globalThis.dispatchEvent('beforeunload') on exit
@@ -71,6 +74,8 @@ export const setupHappyDomEnvironment = async (
 export const setupJsdomEnvironment = async (
   options: SetupDomEnvironmentOptions
 ) => {
+  registerScopeHooks();
+
   if (!globalThis.window || !globalThis.document) {
     let mod: typeof import('jsdom');
 

src/index.ts

@@ -6,3 +6,4 @@ export * from './plugin-metrics.ts';
 export * from './plugin-factory.ts';
 export * from './dom-env.ts';
 export * from './testing-core.ts';
+export * from './test-scope.ts';

src/poku-plugins.d.ts

@@ -1,3 +1,14 @@
 declare module 'poku/plugins' {
   export const definePlugin: (plugin: any) => any;
-}
+
+  export type ScopeHookHolder = { scope: unknown };
+  export type ScopeHookProvider = {
+    name: string;
+    createHolder: () => ScopeHookHolder;
+    runScoped: (
+      holder: ScopeHookHolder,
+      fn: (params?: Record<string, unknown>) => Promise<unknown> | unknown
+    ) => Promise<void>;
+  };
+
+  }