@pokujs/dom 0.0.1 → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lojhan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,150 @@
+<div align="center">
+<img height="180" alt="Poku Logo" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/poku.svg">
+
+# @pokujs/dom
+
+Shared DOM testing core for Poku framework adapters.
+
+</div>
+
+---
+
+@pokujs/dom centralizes cross-framework testing infrastructure used by adapter libraries such as @pokujs/react and @pokujs/vue.
+
+Use this package when building or maintaining framework adapters that need:
+
+- Runtime command injection for Node, Bun, and Deno.
+- In-process test environment setup.
+- Metrics normalization and reporting.
+- happy-dom/jsdom environment bootstrap.
+- Shared testing runtime primitives.
+
+## Installation
+
+```bash
+npm i @pokujs/dom
+```
+
+## Usage
+
+### 1) Build runtime option prefixes and parse flags
+
+```ts
+import {
+  createRuntimeOptionArgPrefixes,
+  parseRuntimeOptions,
+} from '@pokujs/dom';
+
+const prefixes = createRuntimeOptionArgPrefixes('poku-react');
+const runtimeOptions = parseRuntimeOptions(prefixes);
+```
+
+### 2) Create a framework plugin factory
+
+```ts
+import {
+  createFrameworkTestingPluginFactory,
+  type FrameworkDescriptor,
+} from '@pokujs/dom';
+
+const descriptor: FrameworkDescriptor = {
+  pluginName: 'react-testing',
+  packageTag: '@pokujs/react',
+  runtimeArgBase: 'poku-react',
+  metricMessageType: 'POKU_REACT_RENDER_METRIC',
+  metricBatchMessageType: 'POKU_REACT_RENDER_METRIC_BATCH',
+};
+
+const { createTestingPlugin } = createFrameworkTestingPluginFactory(
+  descriptor,
+  import.meta.url
+);
+
+export const createReactTestingPlugin = createTestingPlugin;
+```
+
+### 3) Reuse DOM setup helpers
+
+```ts
+import { setupHappyDomEnvironment, setupJsdomEnvironment } from '@pokujs/dom';
+```
+
+### 4) Reuse shared testing runtime helpers
+
+```ts
+import {
+  createRenderMetricsEmitter,
+  createScreen,
+  getNow,
+} from '@pokujs/dom';
+```
+
+## Contracts
+
+Adapter packages should follow these contracts.
+
+### FrameworkDescriptor contract
+
+- pluginName: Plugin registration name.
+- packageTag: Human-readable package tag for messages.
+- runtimeArgBase: Prefix base used to generate runtime CLI flags.
+- metricMessageType: IPC type for single render metrics.
+- metricBatchMessageType: IPC type for batch render metrics.
+- testFileExtensions (optional): Test file extensions the runner should intercept.
+
+### Runtime options contract
+
+parseRuntimeOptions returns:
+
+- domUrl: DOM URL used by happy-dom/jsdom setup.
+- metricsEnabled: Whether metrics collection is active.
+- minMetricMs: Drop metrics below this threshold.
+- metricBatchSize: Batch size before immediate flush.
+- metricFlushMs: Flush interval while buffering.
+
+### Metrics contract
+
+createMetricsSummary returns either null or:
+
+- totalCaptured: Number of collected metrics.
+- totalReported: Number of top metrics reported.
+- topSlowest: Sorted metrics by duration descending.
+
+### Testing runtime contract
+
+createRenderMetricsEmitter provides:
+
+- emitRenderMetric(componentName, durationMs)
+- flushMetricBuffer()
+- clearMetricFlushTimer()
+
+These APIs are framework-agnostic. Adapter packages remain responsible for framework-specific semantics such as act, nextTick, render lifecycle, and hook/composable harness behavior.
+
+## Release and CI/CD
+
+This package includes:
+
+- CI build and lint workflows.
+- Node, Bun, and Deno compatibility workflows.
+- CodeQL workflow and config.
+- Release Please + npm publish workflow.
+
+## Development
+
+```bash
+npm ci
+npm run check
+npm run build
+```
+
+## Testing
+
+```bash
+npm test
+npm run test:bun
+npm run test:deno
+```
+
+## License
+
+MIT

package/dist/dom-env.d.ts

@@ -0,0 +1,9 @@
+import type { RuntimeOptions } from './types.ts';
+type SetupDomEnvironmentOptions = {
+    runtimeOptions: RuntimeOptions;
+    packageTag: string;
+    enableReactActEnvironment?: boolean;
+};
+export declare const setupHappyDomEnvironment: (options: SetupDomEnvironmentOptions) => Promise<void>;
+export declare const setupJsdomEnvironment: (options: SetupDomEnvironmentOptions) => Promise<void>;
+export {};

package/dist/dom-env.js

@@ -0,0 +1,59 @@
+import { GlobalRegistrator } from '@happy-dom/global-registrator';
+const applyReactActEnvironment = (enabled) => {
+    if (!enabled)
+        return;
+    const reactGlobal = globalThis;
+    if (typeof reactGlobal.IS_REACT_ACT_ENVIRONMENT === 'undefined') {
+        reactGlobal.IS_REACT_ACT_ENVIRONMENT = true;
+    }
+};
+export const setupHappyDomEnvironment = async (options) => {
+    if (!globalThis.window || !globalThis.document) {
+        GlobalRegistrator.register({
+            url: options.runtimeOptions.domUrl,
+        });
+        const nativeDispatchEvent = globalThis.window.dispatchEvent;
+        if (typeof nativeDispatchEvent === 'function') {
+            globalThis.dispatchEvent = nativeDispatchEvent.bind(globalThis.window);
+        }
+    }
+    applyReactActEnvironment(Boolean(options.enableReactActEnvironment));
+};
+const defineGlobal = (key, value) => {
+    Object.defineProperty(globalThis, key, {
+        configurable: true,
+        writable: true,
+        value,
+    });
+};
+export const setupJsdomEnvironment = async (options) => {
+    if (!globalThis.window || !globalThis.document) {
+        let mod;
+        try {
+            mod = await import('jsdom');
+        }
+        catch {
+            throw new Error(`[${options.packageTag}] DOM adapter "jsdom" requires the "jsdom" package. Install it with "npm install --save-dev jsdom".`);
+        }
+        const { JSDOM } = mod;
+        const dom = new JSDOM('', {
+            url: options.runtimeOptions.domUrl,
+            pretendToBeVisual: true,
+        });
+        defineGlobal('window', dom.window);
+        defineGlobal('document', dom.window.document);
+        defineGlobal('navigator', dom.window.navigator);
+        defineGlobal('HTMLElement', dom.window.HTMLElement);
+        defineGlobal('Element', dom.window.Element);
+        defineGlobal('Node', dom.window.Node);
+        defineGlobal('Text', dom.window.Text);
+        defineGlobal('SVGElement', dom.window.SVGElement);
+        defineGlobal('Event', dom.window.Event);
+        defineGlobal('CustomEvent', dom.window.CustomEvent);
+        defineGlobal('MutationObserver', dom.window.MutationObserver);
+        defineGlobal('requestAnimationFrame', dom.window.requestAnimationFrame);
+        defineGlobal('cancelAnimationFrame', dom.window.cancelAnimationFrame);
+    }
+    applyReactActEnvironment(Boolean(options.enableReactActEnvironment));
+};
+//# sourceMappingURL=dom-env.js.map

package/dist/dom-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-env.js","sourceRoot":"","sources":["../src/dom-env.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './types.ts';
+export * from './runtime-options.ts';
+export * from './plugin-command.ts';
+export * from './plugin-setup.ts';
+export * from './plugin-metrics.ts';
+export * from './plugin-factory.ts';
+export * from './dom-env.ts';
+export * from './testing-core.ts';

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from "./types.js";
+export * from "./runtime-options.js";
+export * from "./plugin-command.js";
+export * from "./plugin-setup.js";
+export * from "./plugin-metrics.js";
+export * from "./plugin-factory.js";
+export * from "./dom-env.js";
+export * from "./testing-core.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC"}

package/dist/plugin-command.d.ts

@@ -0,0 +1,22 @@
+import type { DomAdapter } from './types.ts';
+export type RuntimeSupport = {
+    supportsNodeLikeImport: boolean;
+    supportsDenoPreload: boolean;
+};
+export type BuildRunnerCommandInput = {
+    runtime: string;
+    command: string[];
+    file: string;
+    domSetupPath: string;
+    runtimeOptionArgs: string[];
+    extensions: Set<string>;
+};
+export type BuildRunnerCommandOutput = {
+    shouldHandle: boolean;
+    command: string[];
+};
+export declare const isNodeRuntime: (runtime: string) => runtime is "node";
+export declare const getRuntimeSupport: (runtime: string) => RuntimeSupport;
+export declare const canHandleRuntime: (runtime: string) => boolean;
+export declare const createDomSetupPathResolver: (packageTag: string, happyDomSetupPath: string, jsdomSetupPath: string) => (adapter: DomAdapter | undefined) => string;
+export declare const buildRunnerCommand: ({ runtime, command, file, domSetupPath, runtimeOptionArgs, extensions, }: BuildRunnerCommandInput) => BuildRunnerCommandOutput;

package/dist/plugin-command.js

@@ -0,0 +1,94 @@
+import { existsSync } from 'node:fs';
+import { extname, resolve } from 'node:path';
+const isTsxImport = (arg) => arg === '--import=tsx' || arg === '--loader=tsx';
+export const isNodeRuntime = (runtime) => runtime === 'node';
+const isBunRuntime = (runtime) => runtime === 'bun';
+const isDenoRuntime = (runtime) => runtime === 'deno';
+export const getRuntimeSupport = (runtime) => ({
+    supportsNodeLikeImport: isNodeRuntime(runtime) || isBunRuntime(runtime),
+    supportsDenoPreload: isDenoRuntime(runtime),
+});
+export const canHandleRuntime = (runtime) => {
+    const support = getRuntimeSupport(runtime);
+    return support.supportsNodeLikeImport || support.supportsDenoPreload;
+};
+export const createDomSetupPathResolver = (packageTag, happyDomSetupPath, jsdomSetupPath) => {
+    return (adapter) => {
+        if (!adapter || adapter === 'happy-dom')
+            return happyDomSetupPath;
+        if (adapter === 'jsdom')
+            return jsdomSetupPath;
+        const customPath = resolve(process.cwd(), adapter.setupModule);
+        if (!existsSync(customPath)) {
+            throw new Error(`[${packageTag}] Custom DOM setup module not found: "${customPath}"\n` +
+                'Check the "dom.setupModule" option in your poku.config.js.');
+        }
+        return customPath;
+    };
+};
+export const buildRunnerCommand = ({ runtime, command, file, domSetupPath, runtimeOptionArgs, extensions, }) => {
+    const support = getRuntimeSupport(runtime);
+    if (!support.supportsNodeLikeImport && !support.supportsDenoPreload) {
+        return { shouldHandle: false, command };
+    }
+    if (!extensions.has(extname(file))) {
+        return { shouldHandle: false, command };
+    }
+    const fileIndex = command.lastIndexOf(file);
+    if (fileIndex === -1)
+        return { shouldHandle: false, command };
+    const nodeImportFlag = `--import=${domSetupPath}`;
+    const denoPreloadFlag = `--preload=${domSetupPath}`;
+    const beforeFile = [];
+    const afterFile = [];
+    let hasTsx = false;
+    let hasNodeLikeDomSetup = false;
+    let hasDenoDomSetup = false;
+    const existingArgs = new Set();
+    for (let index = 1; index < command.length; index += 1) {
+        const arg = command[index];
+        if (typeof arg !== 'string')
+            continue;
+        existingArgs.add(arg);
+        if (index < fileIndex) {
+            beforeFile.push(arg);
+            if (isTsxImport(arg))
+                hasTsx = true;
+            else if (arg === nodeImportFlag)
+                hasNodeLikeDomSetup = true;
+            else if (arg === denoPreloadFlag)
+                hasDenoDomSetup = true;
+            continue;
+        }
+        if (index > fileIndex) {
+            afterFile.push(arg);
+        }
+    }
+    const extraImports = [];
+    if (isNodeRuntime(runtime) && !hasTsx)
+        extraImports.push('--import=tsx');
+    if (support.supportsNodeLikeImport && !hasNodeLikeDomSetup) {
+        extraImports.push(nodeImportFlag);
+    }
+    if (support.supportsDenoPreload && !hasDenoDomSetup) {
+        extraImports.push(denoPreloadFlag);
+    }
+    const runtimeArgsToInject = [];
+    for (const runtimeOptionArg of runtimeOptionArgs) {
+        if (existingArgs.has(runtimeOptionArg))
+            continue;
+        runtimeArgsToInject.push(runtimeOptionArg);
+    }
+    return {
+        shouldHandle: true,
+        command: [
+            runtime,
+            ...beforeFile,
+            ...extraImports,
+            file,
+            ...runtimeArgsToInject,
+            ...afterFile,
+        ],
+    };
+};
+//# sourceMappingURL=plugin-command.js.map

package/dist/plugin-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-command.js","sourceRoot":"","sources":["../src/plugin-command.ts"],"names":[],"mappings":"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"}

package/dist/plugin-factory.d.ts

@@ -0,0 +1,21 @@
+import type { DomAdapter, FrameworkDescriptor, TestingPluginOptions } from './types.ts';
+import { buildRunnerCommand, canHandleRuntime } from './plugin-command.ts';
+import { buildRuntimeOptionArgs, createMetricsSummary, getComponentName, isRenderMetricBatchMessage, isRenderMetricMessage, normalizeMetricsOptions, selectTopSlowestMetrics } from './plugin-metrics.ts';
+export type FrameworkPluginInternals = {
+    buildRunnerCommand: typeof buildRunnerCommand;
+    canHandleRuntime: typeof canHandleRuntime;
+    buildRuntimeOptionArgs: typeof buildRuntimeOptionArgs;
+    normalizeMetricsOptions: typeof normalizeMetricsOptions;
+    selectTopSlowestMetrics: typeof selectTopSlowestMetrics;
+    createMetricsSummary: typeof createMetricsSummary;
+    getComponentName: typeof getComponentName;
+    isRenderMetricMessage: typeof isRenderMetricMessage;
+    isRenderMetricBatchMessage: typeof isRenderMetricBatchMessage;
+    resolveDomSetupPath: (adapter: DomAdapter | undefined) => string;
+};
+export declare const createFrameworkTestingPluginFactory: (descriptor: FrameworkDescriptor, moduleUrl: string) => {
+    createTestingPlugin: (options?: TestingPluginOptions) => any;
+    resolveDomSetupPath: (adapter: DomAdapter | undefined) => string;
+    runtimeOptionArgPrefixes: import("./types.ts").RuntimeOptionArgPrefixes;
+    internals: FrameworkPluginInternals;
+};

package/dist/plugin-factory.js

@@ -0,0 +1,117 @@
+import { definePlugin } from 'poku/plugins';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { existsSync } from 'node:fs';
+import { buildRunnerCommand, canHandleRuntime, createDomSetupPathResolver, } from "./plugin-command.js";
+import { buildRuntimeOptionArgs, createMetricsSummary, getComponentName, isRenderMetricBatchMessage, isRenderMetricMessage, normalizeMetricsOptions, printMetricsSummary, selectTopSlowestMetrics, } from "./plugin-metrics.js";
+import { setupInProcessEnvironment } from "./plugin-setup.js";
+import { createRuntimeOptionArgPrefixes } from "./runtime-options.js";
+export const createFrameworkTestingPluginFactory = (descriptor, moduleUrl) => {
+    const currentDir = dirname(fileURLToPath(moduleUrl));
+    const resolveSetupModulePath = (baseName) => {
+        const jsPath = resolve(currentDir, `${baseName}.js`);
+        if (existsSync(jsPath))
+            return jsPath;
+        return resolve(currentDir, `${baseName}.ts`);
+    };
+    const happyDomSetupPath = resolveSetupModulePath('dom-setup-happy');
+    const jsdomSetupPath = resolveSetupModulePath('dom-setup-jsdom');
+    const resolveDomSetupPath = createDomSetupPathResolver(descriptor.packageTag, happyDomSetupPath, jsdomSetupPath);
+    const prefixes = createRuntimeOptionArgPrefixes(descriptor.runtimeArgBase);
+    const extensions = new Set(descriptor.testFileExtensions ?? ['.tsx', '.jsx']);
+    const createTestingPlugin = (options = {}) => {
+        let metrics = [];
+        let cleanupNodeTsxLoader;
+        const domSetupPath = resolveDomSetupPath(options.dom);
+        const metricsOptions = normalizeMetricsOptions(options.metrics);
+        const runtimeOptionArgs = buildRuntimeOptionArgs(options, metricsOptions, prefixes);
+        return definePlugin({
+            name: descriptor.pluginName,
+            ipc: metricsOptions.enabled,
+            async setup(context) {
+                cleanupNodeTsxLoader = await setupInProcessEnvironment({
+                    isolation: context.configs.isolation,
+                    runtime: context.runtime,
+                    runtimeOptionArgs,
+                    domSetupPath,
+                    packageTag: descriptor.packageTag,
+                });
+            },
+            runner(command, file) {
+                const runtime = command[0];
+                if (!runtime)
+                    return command;
+                const result = descriptor.commandBuilder
+                    ? descriptor.commandBuilder({ runtime, command, file, domSetupPath, runtimeOptionArgs })
+                    : buildRunnerCommand({ runtime, command, file, domSetupPath, runtimeOptionArgs, extensions });
+                if (!result.shouldHandle)
+                    return command;
+                return result.command;
+            },
+            onTestProcess(child, file) {
+                if (!metricsOptions.enabled)
+                    return;
+                const maybePruneMetrics = () => {
+                    if (metrics.length > metricsOptions.topN * 10) {
+                        metrics = selectTopSlowestMetrics(metrics, metricsOptions);
+                    }
+                };
+                child.on('message', (message) => {
+                    if (isRenderMetricBatchMessage(message, descriptor.metricBatchMessageType)) {
+                        for (const metric of message.metrics) {
+                            const durationMs = Number(metric.durationMs) || 0;
+                            metrics.push({
+                                file,
+                                componentName: getComponentName(metric.componentName),
+                                durationMs,
+                            });
+                        }
+                        maybePruneMetrics();
+                        return;
+                    }
+                    if (!isRenderMetricMessage(message, descriptor.metricMessageType)) {
+                        return;
+                    }
+                    const durationMs = Number(message.durationMs) || 0;
+                    metrics.push({
+                        file,
+                        componentName: getComponentName(message.componentName),
+                        durationMs,
+                    });
+                    maybePruneMetrics();
+                });
+            },
+            teardown() {
+                cleanupNodeTsxLoader?.();
+                cleanupNodeTsxLoader = undefined;
+                const summary = createMetricsSummary(metrics, metricsOptions);
+                if (!summary)
+                    return;
+                if (metricsOptions.reporter) {
+                    metricsOptions.reporter(summary);
+                    return;
+                }
+                printMetricsSummary(summary, descriptor.packageTag);
+            },
+        });
+    };
+    const internals = {
+        buildRunnerCommand,
+        canHandleRuntime,
+        buildRuntimeOptionArgs,
+        normalizeMetricsOptions,
+        selectTopSlowestMetrics,
+        createMetricsSummary,
+        getComponentName,
+        isRenderMetricMessage,
+        isRenderMetricBatchMessage,
+        resolveDomSetupPath,
+    };
+    return {
+        createTestingPlugin,
+        resolveDomSetupPath,
+        runtimeOptionArgPrefixes: prefixes,
+        internals,
+    };
+};
+//# sourceMappingURL=plugin-factory.js.map

package/dist/plugin-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-factory.js","sourceRoot":"","sources":["../src/plugin-factory.ts"],"names":[],"mappings":"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"}

package/dist/plugin-metrics.d.ts

@@ -0,0 +1,19 @@
+import type { MetricsOptions, MetricsSummary, NormalizedMetricsOptions, RenderMetric, RuntimeOptionArgPrefixes, TestingPluginOptions } from './types.ts';
+export declare const isRenderMetricMessage: (message: unknown, metricMessageType: string) => message is {
+    type: string;
+    componentName?: string;
+    durationMs?: number;
+};
+export declare const isRenderMetricBatchMessage: (message: unknown, metricBatchMessageType: string) => message is {
+    type: string;
+    metrics: Array<{
+        componentName?: string;
+        durationMs?: number;
+    }>;
+};
+export declare const getComponentName: (componentName: unknown) => string;
+export declare const buildRuntimeOptionArgs: (options: TestingPluginOptions, metricsOptions: NormalizedMetricsOptions, prefixes: RuntimeOptionArgPrefixes) => string[];
+export declare const normalizeMetricsOptions: (metrics: boolean | MetricsOptions | undefined) => NormalizedMetricsOptions;
+export declare const selectTopSlowestMetrics: (metrics: RenderMetric[], options: NormalizedMetricsOptions) => RenderMetric[];
+export declare const createMetricsSummary: (metrics: RenderMetric[], options: NormalizedMetricsOptions) => MetricsSummary | null;
+export declare const printMetricsSummary: (summary: MetricsSummary, packageTag: string) => void;

package/dist/plugin-metrics.js

@@ -0,0 +1,93 @@
+const DEFAULT_TOP_N = 5;
+const DEFAULT_MIN_DURATION_MS = 0;
+export const isRenderMetricMessage = (message, metricMessageType) => {
+    if (!message || typeof message !== 'object')
+        return false;
+    return message.type === metricMessageType;
+};
+export const isRenderMetricBatchMessage = (message, metricBatchMessageType) => {
+    if (!message || typeof message !== 'object')
+        return false;
+    const record = message;
+    return (record.type === metricBatchMessageType && Array.isArray(record.metrics));
+};
+export const getComponentName = (componentName) => typeof componentName === 'string' && componentName.length > 0
+    ? componentName
+    : 'AnonymousComponent';
+const getPositiveIntegerOrDefault = (value, fallback) => {
+    const numeric = typeof value === 'number'
+        ? value
+        : typeof value === 'string' && value.trim().length > 0
+            ? Number(value.trim())
+            : NaN;
+    if (!Number.isFinite(numeric) || numeric <= 0)
+        return fallback;
+    return Math.floor(numeric);
+};
+const getNonNegativeNumberOrDefault = (value, fallback) => {
+    const numeric = typeof value === 'number'
+        ? value
+        : typeof value === 'string' && value.trim().length > 0
+            ? Number(value.trim())
+            : NaN;
+    if (!Number.isFinite(numeric) || numeric < 0)
+        return fallback;
+    return numeric;
+};
+export const buildRuntimeOptionArgs = (options, metricsOptions, prefixes) => {
+    const args = [];
+    if (options.domUrl) {
+        args.push(`${prefixes.domUrl}${options.domUrl}`);
+    }
+    if (metricsOptions.enabled) {
+        args.push(`${prefixes.metrics}1`);
+        args.push(`${prefixes.minMetricMs}${metricsOptions.minDurationMs}`);
+    }
+    return args;
+};
+export const normalizeMetricsOptions = (metrics) => {
+    if (metrics === true) {
+        return {
+            enabled: true,
+            topN: DEFAULT_TOP_N,
+            minDurationMs: DEFAULT_MIN_DURATION_MS,
+        };
+    }
+    if (!metrics) {
+        return {
+            enabled: false,
+            topN: DEFAULT_TOP_N,
+            minDurationMs: DEFAULT_MIN_DURATION_MS,
+        };
+    }
+    const normalized = {
+        enabled: metrics.enabled ?? true,
+        topN: getPositiveIntegerOrDefault(metrics.topN, DEFAULT_TOP_N),
+        minDurationMs: getNonNegativeNumberOrDefault(metrics.minDurationMs, DEFAULT_MIN_DURATION_MS),
+    };
+    if (metrics.reporter)
+        normalized.reporter = metrics.reporter;
+    return normalized;
+};
+export const selectTopSlowestMetrics = (metrics, options) => [...metrics]
+    .sort((a, b) => b.durationMs - a.durationMs)
+    .slice(0, options.topN);
+export const createMetricsSummary = (metrics, options) => {
+    if (!options.enabled || metrics.length === 0)
+        return null;
+    const topSlowest = selectTopSlowestMetrics(metrics, options);
+    if (topSlowest.length === 0)
+        return null;
+    return {
+        totalCaptured: metrics.length,
+        totalReported: topSlowest.length,
+        topSlowest,
+    };
+};
+export const printMetricsSummary = (summary, packageTag) => {
+    const lines = summary.topSlowest.map((metric) => `  - ${metric.componentName} in ${metric.file}: ${metric.durationMs.toFixed(2)}ms`);
+    console.log(`\n[${packageTag}] Slowest component renders`);
+    for (const line of lines)
+        console.log(line);
+};
+//# sourceMappingURL=plugin-metrics.js.map

package/dist/plugin-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-metrics.js","sourceRoot":"","sources":["../src/plugin-metrics.ts"],"names":[],"mappings":"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"}

package/dist/plugin-setup.d.ts

@@ -0,0 +1,8 @@
+export type InProcessSetupOptions = {
+    isolation: string | undefined;
+    runtime: string;
+    runtimeOptionArgs: string[];
+    domSetupPath: string;
+    packageTag: string;
+};
+export declare const setupInProcessEnvironment: (options: InProcessSetupOptions) => Promise<(() => void) | undefined>;

package/dist/plugin-setup.js

@@ -0,0 +1,50 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { pathToFileURL } from 'node:url';
+import { createRequire } from 'node:module';
+import { canHandleRuntime, isNodeRuntime } from "./plugin-command.js";
+const TSX_LOADER_MODULE = 'tsx/esm/api';
+const appendMissingRuntimeArgs = (runtimeOptionArgs) => {
+    for (const arg of runtimeOptionArgs) {
+        if (process.argv.includes(arg))
+            continue;
+        process.argv.push(arg);
+    }
+};
+const loadDomSetupModule = async (domSetupPath) => {
+    await import(__rewriteRelativeImportExtension(pathToFileURL(domSetupPath).href));
+};
+const registerNodeTsxLoader = async (packageTag) => {
+    const requireFromCwd = createRequire(`${process.cwd()}/`);
+    try {
+        const resolvedModulePath = requireFromCwd.resolve(TSX_LOADER_MODULE);
+        const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(resolvedModulePath).href)));
+        if (typeof mod.register !== 'function') {
+            throw new Error('Missing register() export from tsx loader API');
+        }
+        return mod.register();
+    }
+    catch (error) {
+        throw new Error(`[${packageTag}] isolation "none" in Node.js requires a working "tsx" installation to load .tsx/.jsx test files.`, { cause: error });
+    }
+};
+export const setupInProcessEnvironment = async (options) => {
+    if (options.isolation !== 'none')
+        return undefined;
+    if (!canHandleRuntime(options.runtime))
+        return undefined;
+    let cleanupNodeTsxLoader;
+    if (isNodeRuntime(options.runtime)) {
+        cleanupNodeTsxLoader = await registerNodeTsxLoader(options.packageTag);
+    }
+    appendMissingRuntimeArgs(options.runtimeOptionArgs);
+    await loadDomSetupModule(options.domSetupPath);
+    return cleanupNodeTsxLoader;
+};
+//# sourceMappingURL=plugin-setup.js.map

package/dist/plugin-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-setup.js","sourceRoot":"","sources":["../src/plugin-setup.ts"],"names":[],"mappings":";;;;;;;;AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMtE,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAExC,MAAM,wBAAwB,GAAG,CAAC,iBAA2B,EAAE,EAAE;IAC/D,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QACzC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,KAAK,EAAE,YAAoB,EAAE,EAAE;IACxD,MAAM,MAAM,kCAAC,aAAa,CAAC,YAAY,CAAC,CAAC,IAAI,EAAC,CAAC;AACjD,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,KAAK,EAAE,UAAkB,EAAE,EAAE;IACzD,MAAM,cAAc,GAAG,aAAa,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAE1D,IAAI,CAAC;QACH,MAAM,kBAAkB,GAAG,cAAc,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACrE,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,kCAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC,IAAI,EAAC,CAAoB,CAAC;QACtF,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,IAAI,UAAU,mGAAmG,EACjH,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAUF,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,EAC5C,OAA8B,EACK,EAAE;IACrC,IAAI,OAAO,CAAC,SAAS,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IACnD,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAEzD,IAAI,oBAA8C,CAAC;IAEnD,IAAI,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,oBAAoB,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACzE,CAAC;IAED,wBAAwB,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpD,MAAM,kBAAkB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/C,OAAO,oBAAoB,CAAC;AAC9B,CAAC,CAAC"}

package/dist/runtime-options.d.ts

@@ -0,0 +1,3 @@
+import type { RuntimeOptionArgPrefixes, RuntimeOptions } from './types.ts';
+export declare const createRuntimeOptionArgPrefixes: (base: string) => RuntimeOptionArgPrefixes;
+export declare const parseRuntimeOptions: (prefixes: RuntimeOptionArgPrefixes, argv?: string[]) => RuntimeOptions;

package/dist/runtime-options.js

@@ -0,0 +1,48 @@
+const DEFAULT_DOM_URL = 'http://localhost:3000/';
+const DEFAULT_METRIC_BATCH_SIZE = 50;
+const DEFAULT_METRIC_FLUSH_MS = 50;
+const toNumber = (value) => {
+    if (!value)
+        return NaN;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : NaN;
+};
+const findValueByPrefix = (argv, prefix) => {
+    const match = argv.find((arg) => arg.startsWith(prefix));
+    return match ? match.slice(prefix.length) : undefined;
+};
+const parsePositiveInteger = (value, fallback) => {
+    const numeric = toNumber(value);
+    if (!Number.isFinite(numeric) || numeric <= 0)
+        return fallback;
+    return Math.floor(numeric);
+};
+const parseNonNegativeNumber = (value, fallback) => {
+    const numeric = toNumber(value);
+    if (!Number.isFinite(numeric) || numeric < 0)
+        return fallback;
+    return numeric;
+};
+export const createRuntimeOptionArgPrefixes = (base) => ({
+    metrics: `--${base}-metrics=`,
+    minMetricMs: `--${base}-min-metric-ms=`,
+    domUrl: `--${base}-dom-url=`,
+    metricBatchSize: `--${base}-metric-batch-size=`,
+    metricFlushMs: `--${base}-metric-flush-ms=`,
+});
+export const parseRuntimeOptions = (prefixes, argv = process.argv) => {
+    const metricsEnabled = findValueByPrefix(argv, prefixes.metrics) === '1' ||
+        findValueByPrefix(argv, prefixes.metrics) === 'true';
+    const domUrl = findValueByPrefix(argv, prefixes.domUrl)?.trim() || DEFAULT_DOM_URL;
+    const minMetricMs = parseNonNegativeNumber(findValueByPrefix(argv, prefixes.minMetricMs), 0);
+    const metricBatchSize = parsePositiveInteger(findValueByPrefix(argv, prefixes.metricBatchSize), DEFAULT_METRIC_BATCH_SIZE);
+    const metricFlushMs = parsePositiveInteger(findValueByPrefix(argv, prefixes.metricFlushMs), DEFAULT_METRIC_FLUSH_MS);
+    return {
+        domUrl,
+        metricsEnabled,
+        minMetricMs,
+        metricBatchSize,
+        metricFlushMs,
+    };
+};
+//# sourceMappingURL=runtime-options.js.map

package/dist/runtime-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-options.js","sourceRoot":"","sources":["../src/runtime-options.ts"],"names":[],"mappings":"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"}

package/dist/testing-core.d.ts

@@ -0,0 +1,14 @@
+import type { Screen } from '@testing-library/dom';
+import type { RuntimeOptions } from './types.ts';
+export declare const getNow: () => number;
+export type RenderMetricsEmitterOptions = {
+    runtimeOptions: RuntimeOptions;
+    metricsStateKey: symbol;
+    metricsBatchMessageType: string;
+};
+export declare const createRenderMetricsEmitter: (options: RenderMetricsEmitterOptions) => {
+    emitRenderMetric: (componentName: string, durationMs: number) => void;
+    flushMetricBuffer: () => void;
+    clearMetricFlushTimer: () => void;
+};
+export declare const createScreen: () => Screen;

package/dist/testing-core.js

@@ -0,0 +1,114 @@
+import { getQueriesForElement } from '@testing-library/dom';
+export const getNow = typeof performance !== 'undefined' && typeof performance.now === 'function'
+    ? performance.now.bind(performance)
+    : Date.now.bind(Date);
+const getMetricsRuntimeState = (stateKey) => {
+    const stateGlobal = globalThis;
+    if (!stateGlobal[stateKey]) {
+        stateGlobal[stateKey] = {
+            metricBuffer: [],
+            metricFlushTimer: undefined,
+            metricsChannelClosed: false,
+            listenersRegistered: false,
+        };
+    }
+    return stateGlobal[stateKey];
+};
+export const createRenderMetricsEmitter = (options) => {
+    const { runtimeOptions, metricsStateKey, metricsBatchMessageType } = options;
+    const metricsState = getMetricsRuntimeState(metricsStateKey);
+    const clearMetricFlushTimer = () => {
+        if (!metricsState.metricFlushTimer)
+            return;
+        clearTimeout(metricsState.metricFlushTimer);
+        metricsState.metricFlushTimer = undefined;
+    };
+    const flushMetricBuffer = () => {
+        if (!runtimeOptions.metricsEnabled || typeof process.send !== 'function') {
+            return;
+        }
+        if (process.connected === false) {
+            metricsState.metricBuffer.length = 0;
+            metricsState.metricsChannelClosed = true;
+            return;
+        }
+        if (metricsState.metricsChannelClosed ||
+            metricsState.metricBuffer.length === 0) {
+            return;
+        }
+        const payload = metricsState.metricBuffer.splice(0, metricsState.metricBuffer.length);
+        try {
+            process.send({
+                type: metricsBatchMessageType,
+                metrics: payload,
+            });
+        }
+        catch {
+            metricsState.metricsChannelClosed = true;
+            metricsState.metricBuffer.length = 0;
+        }
+    };
+    const scheduleMetricFlush = () => {
+        if (metricsState.metricFlushTimer)
+            return;
+        metricsState.metricFlushTimer = setTimeout(() => {
+            metricsState.metricFlushTimer = undefined;
+            flushMetricBuffer();
+        }, runtimeOptions.metricFlushMs);
+        metricsState.metricFlushTimer.unref?.();
+    };
+    if (runtimeOptions.metricsEnabled && !metricsState.listenersRegistered) {
+        metricsState.listenersRegistered = true;
+        process.on('beforeExit', () => {
+            clearMetricFlushTimer();
+            flushMetricBuffer();
+        });
+        process.on('disconnect', () => {
+            clearMetricFlushTimer();
+            metricsState.metricBuffer.length = 0;
+            metricsState.metricsChannelClosed = true;
+        });
+    }
+    const emitRenderMetric = (componentName, durationMs) => {
+        if (!runtimeOptions.metricsEnabled ||
+            typeof process.send !== 'function') {
+            return;
+        }
+        if (process.connected === false || metricsState.metricsChannelClosed) {
+            metricsState.metricBuffer.length = 0;
+            metricsState.metricsChannelClosed = true;
+            clearMetricFlushTimer();
+            return;
+        }
+        const safeDuration = Number.isFinite(durationMs) && durationMs >= 0 ? durationMs : 0;
+        if (safeDuration < runtimeOptions.minMetricMs)
+            return;
+        metricsState.metricBuffer.push({
+            componentName,
+            durationMs: safeDuration,
+        });
+        if (metricsState.metricBuffer.length >= runtimeOptions.metricBatchSize) {
+            clearMetricFlushTimer();
+            flushMetricBuffer();
+            return;
+        }
+        scheduleMetricFlush();
+    };
+    return {
+        emitRenderMetric,
+        flushMetricBuffer,
+        clearMetricFlushTimer,
+    };
+};
+export const createScreen = () => {
+    return new Proxy({}, {
+        get(_target, prop) {
+            const baseScreenQueries = getQueriesForElement(document.body);
+            const value = Reflect.get(baseScreenQueries, prop, baseScreenQueries);
+            return typeof value === 'function'
+                ? value.bind(baseScreenQueries)
+                : value;
+        },
+    });
+};
+//# sourceMappingURL=testing-core.js.map

package/dist/testing-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing-core.js","sourceRoot":"","sources":["../src/testing-core.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,62 @@
+export type DomAdapter = 'happy-dom' | 'jsdom' | {
+    setupModule: string;
+};
+export type RenderMetric = {
+    file: string;
+    componentName: string;
+    durationMs: number;
+};
+export type MetricsSummary = {
+    totalCaptured: number;
+    totalReported: number;
+    topSlowest: RenderMetric[];
+};
+export type MetricsOptions = {
+    enabled?: boolean;
+    topN?: number;
+    minDurationMs?: number;
+    reporter?: (summary: MetricsSummary) => void;
+};
+export type TestingPluginOptions = {
+    dom?: DomAdapter;
+    domUrl?: string;
+    metrics?: boolean | MetricsOptions;
+};
+export type NormalizedMetricsOptions = {
+    enabled: boolean;
+    topN: number;
+    minDurationMs: number;
+    reporter?: (summary: MetricsSummary) => void;
+};
+export type RuntimeOptionArgPrefixes = {
+    metrics: string;
+    minMetricMs: string;
+    domUrl: string;
+    metricBatchSize: string;
+    metricFlushMs: string;
+};
+export type RuntimeOptions = {
+    domUrl: string;
+    metricsEnabled: boolean;
+    minMetricMs: number;
+    metricBatchSize: number;
+    metricFlushMs: number;
+};
+export type FrameworkDescriptor = {
+    pluginName: string;
+    packageTag: string;
+    runtimeArgBase: string;
+    metricMessageType: string;
+    metricBatchMessageType: string;
+    testFileExtensions?: string[];
+    commandBuilder?: (input: {
+        runtime: string;
+        command: string[];
+        file: string;
+        domSetupPath: string;
+        runtimeOptionArgs: string[];
+    }) => {
+        shouldHandle: boolean;
+        command: string[];
+    };
+};

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,11 +1,90 @@
 {
   "name": "@pokujs/dom",
-  "version": "0.0.1",
+  "version": "1.1.0",
+  "private": false,
   "description": "Shared DOM testing core for Poku framework adapters.",
   "type": "module",
-  "main": "./index.js",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20.x.x",
+    "bun": ">=1.x.x",
+    "deno": ">=2.x.x",
+    "typescript": ">=6.x.x"
+  },
+  "scripts": {
+    "test": "npm run test:node",
+    "test:node": "node --import=tsx ./node_modules/poku/lib/bin/index.js tests --showLogs",
+    "test:bun": "bun ./node_modules/poku/lib/bin/index.js tests --showLogs",
+    "test:deno": "deno run -A npm:poku tests --showLogs",
+    "clean": "rimraf dist",
+    "build": "npm run clean && tsc -p tsconfig.dist.json",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit",
+    "lint": "npm run typecheck",
+    "check": "npm run typecheck && npm test",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "poku",
+    "dom",
+    "testing",
+    "happy-dom",
+    "jsdom"
+  ],
+  "author": "Lojhan",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pokujs/dom.git"
+  },
+  "homepage": "https://github.com/pokujs/dom#readme",
+  "bugs": {
+    "url": "https://github.com/pokujs/dom/issues"
+  },
   "license": "MIT",
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
+  },
+  "peerDependencies": {
+    "@happy-dom/global-registrator": ">=20",
+    "happy-dom": ">=20",
+    "jsdom": ">=22",
+    "poku": ">=4.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@happy-dom/global-registrator": {
+      "optional": true
+    },
+    "happy-dom": {
+      "optional": true
+    },
+    "jsdom": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@testing-library/dom": "^10.4.1"
+  },
+  "devDependencies": {
+    "@happy-dom/global-registrator": "^20.8.9",
+    "@types/jsdom": "^28.0.1",
+    "@types/node": "^25.5.0",
+    "cross-env": "^10.1.0",
+    "happy-dom": "^20.8.9",
+    "jsdom": "^26.1.0",
+    "poku": "4.2.0",
+    "rimraf": "^6.0.1",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2"
   }
 }

package/index.js

@@ -1 +0,0 @@
-// placeholder