@pokujs/dom 0.0.1 → 1.0.1

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/index.d.ts

@@ -0,0 +1,149 @@
+import { Screen } from '@testing-library/dom';
+
+type DomAdapter = 'happy-dom' | 'jsdom' | {
+    setupModule: string;
+};
+type RenderMetric = {
+    file: string;
+    componentName: string;
+    durationMs: number;
+};
+type MetricsSummary = {
+    totalCaptured: number;
+    totalReported: number;
+    topSlowest: RenderMetric[];
+};
+type MetricsOptions = {
+    enabled?: boolean;
+    topN?: number;
+    minDurationMs?: number;
+    reporter?: (summary: MetricsSummary) => void;
+};
+type TestingPluginOptions = {
+    dom?: DomAdapter;
+    domUrl?: string;
+    metrics?: boolean | MetricsOptions;
+};
+type NormalizedMetricsOptions = {
+    enabled: boolean;
+    topN: number;
+    minDurationMs: number;
+    reporter?: (summary: MetricsSummary) => void;
+};
+type RuntimeOptionArgPrefixes = {
+    metrics: string;
+    minMetricMs: string;
+    domUrl: string;
+    metricBatchSize: string;
+    metricFlushMs: string;
+};
+type RuntimeOptions = {
+    domUrl: string;
+    metricsEnabled: boolean;
+    minMetricMs: number;
+    metricBatchSize: number;
+    metricFlushMs: number;
+};
+type FrameworkDescriptor = {
+    pluginName: string;
+    packageTag: string;
+    runtimeArgBase: string;
+    metricMessageType: string;
+    metricBatchMessageType: string;
+    testFileExtensions?: string[];
+};
+
+declare const createRuntimeOptionArgPrefixes: (base: string) => RuntimeOptionArgPrefixes;
+declare const parseRuntimeOptions: (prefixes: RuntimeOptionArgPrefixes, argv?: string[]) => RuntimeOptions;
+
+type RuntimeSupport = {
+    supportsNodeLikeImport: boolean;
+    supportsDenoPreload: boolean;
+};
+type BuildRunnerCommandInput = {
+    runtime: string;
+    command: string[];
+    file: string;
+    domSetupPath: string;
+    runtimeOptionArgs: string[];
+    extensions: Set<string>;
+};
+type BuildRunnerCommandOutput = {
+    shouldHandle: boolean;
+    command: string[];
+};
+declare const isNodeRuntime: (runtime: string) => runtime is "node";
+declare const getRuntimeSupport: (runtime: string) => RuntimeSupport;
+declare const canHandleRuntime: (runtime: string) => boolean;
+declare const createDomSetupPathResolver: (packageTag: string, happyDomSetupPath: string, jsdomSetupPath: string) => (adapter: DomAdapter | undefined) => string;
+declare const buildRunnerCommand: ({ runtime, command, file, domSetupPath, runtimeOptionArgs, extensions, }: BuildRunnerCommandInput) => BuildRunnerCommandOutput;
+
+type InProcessSetupOptions = {
+    isolation: string | undefined;
+    runtime: string;
+    runtimeOptionArgs: string[];
+    domSetupPath: string;
+    packageTag: string;
+};
+declare const setupInProcessEnvironment: (options: InProcessSetupOptions) => Promise<(() => void) | undefined>;
+
+declare const isRenderMetricMessage: (message: unknown, metricMessageType: string) => message is {
+    type: string;
+    componentName?: string;
+    durationMs?: number;
+};
+declare const isRenderMetricBatchMessage: (message: unknown, metricBatchMessageType: string) => message is {
+    type: string;
+    metrics: Array<{
+        componentName?: string;
+        durationMs?: number;
+    }>;
+};
+declare const getComponentName: (componentName: unknown) => string;
+declare const buildRuntimeOptionArgs: (options: TestingPluginOptions, metricsOptions: NormalizedMetricsOptions, prefixes: RuntimeOptionArgPrefixes) => string[];
+declare const normalizeMetricsOptions: (metrics: boolean | MetricsOptions | undefined) => NormalizedMetricsOptions;
+declare const selectTopSlowestMetrics: (metrics: RenderMetric[], options: NormalizedMetricsOptions) => RenderMetric[];
+declare const createMetricsSummary: (metrics: RenderMetric[], options: NormalizedMetricsOptions) => MetricsSummary | null;
+declare const printMetricsSummary: (summary: MetricsSummary, packageTag: string) => void;
+
+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;
+};
+declare const createFrameworkTestingPluginFactory: (descriptor: FrameworkDescriptor, moduleUrl: string) => {
+    createTestingPlugin: (options?: TestingPluginOptions) => any;
+    resolveDomSetupPath: (adapter: DomAdapter | undefined) => string;
+    runtimeOptionArgPrefixes: RuntimeOptionArgPrefixes;
+    internals: FrameworkPluginInternals;
+};
+
+type SetupDomEnvironmentOptions = {
+    runtimeOptions: RuntimeOptions;
+    packageTag: string;
+    enableReactActEnvironment?: boolean;
+};
+declare const setupHappyDomEnvironment: (options: SetupDomEnvironmentOptions) => Promise<void>;
+declare const setupJsdomEnvironment: (options: SetupDomEnvironmentOptions) => Promise<void>;
+
+declare const getNow: () => number;
+type RenderMetricsEmitterOptions = {
+    runtimeOptions: RuntimeOptions;
+    metricsStateKey: symbol;
+    metricsBatchMessageType: string;
+};
+declare const createRenderMetricsEmitter: (options: RenderMetricsEmitterOptions) => {
+    emitRenderMetric: (componentName: string, durationMs: number) => void;
+    flushMetricBuffer: () => void;
+    clearMetricFlushTimer: () => void;
+};
+declare const createScreen: () => Screen;
+
+export { type BuildRunnerCommandInput, type BuildRunnerCommandOutput, type DomAdapter, type FrameworkDescriptor, type FrameworkPluginInternals, type InProcessSetupOptions, type MetricsOptions, type MetricsSummary, type NormalizedMetricsOptions, type RenderMetric, type RenderMetricsEmitterOptions, type RuntimeOptionArgPrefixes, type RuntimeOptions, type RuntimeSupport, type TestingPluginOptions, buildRunnerCommand, buildRuntimeOptionArgs, canHandleRuntime, createDomSetupPathResolver, createFrameworkTestingPluginFactory, createMetricsSummary, createRenderMetricsEmitter, createRuntimeOptionArgPrefixes, createScreen, getComponentName, getNow, getRuntimeSupport, isNodeRuntime, isRenderMetricBatchMessage, isRenderMetricMessage, normalizeMetricsOptions, parseRuntimeOptions, printMetricsSummary, selectTopSlowestMetrics, setupHappyDomEnvironment, setupInProcessEnvironment, setupJsdomEnvironment };

package/dist/index.js

@@ -0,0 +1,587 @@
+// src/runtime-options.ts
+var DEFAULT_DOM_URL = "http://localhost:3000/";
+var DEFAULT_METRIC_BATCH_SIZE = 50;
+var DEFAULT_METRIC_FLUSH_MS = 50;
+var toNumber = (value) => {
+  if (!value) return NaN;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : NaN;
+};
+var findValueByPrefix = (argv, prefix) => {
+  const match = argv.find((arg) => arg.startsWith(prefix));
+  return match ? match.slice(prefix.length) : void 0;
+};
+var parsePositiveInteger = (value, fallback) => {
+  const numeric = toNumber(value);
+  if (!Number.isFinite(numeric) || numeric <= 0) return fallback;
+  return Math.floor(numeric);
+};
+var parseNonNegativeNumber = (value, fallback) => {
+  const numeric = toNumber(value);
+  if (!Number.isFinite(numeric) || numeric < 0) return fallback;
+  return numeric;
+};
+var createRuntimeOptionArgPrefixes = (base) => ({
+  metrics: `--${base}-metrics=`,
+  minMetricMs: `--${base}-min-metric-ms=`,
+  domUrl: `--${base}-dom-url=`,
+  metricBatchSize: `--${base}-metric-batch-size=`,
+  metricFlushMs: `--${base}-metric-flush-ms=`
+});
+var 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
+  };
+};
+
+// src/plugin-command.ts
+import { existsSync } from "fs";
+import { extname, resolve } from "path";
+var isTsxImport = (arg) => arg === "--import=tsx" || arg === "--loader=tsx";
+var isNodeRuntime = (runtime) => runtime === "node";
+var isBunRuntime = (runtime) => runtime === "bun";
+var isDenoRuntime = (runtime) => runtime === "deno";
+var getRuntimeSupport = (runtime) => ({
+  supportsNodeLikeImport: isNodeRuntime(runtime) || isBunRuntime(runtime),
+  supportsDenoPreload: isDenoRuntime(runtime)
+});
+var canHandleRuntime = (runtime) => {
+  const support = getRuntimeSupport(runtime);
+  return support.supportsNodeLikeImport || support.supportsDenoPreload;
+};
+var 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}"
+Check the "dom.setupModule" option in your poku.config.js.`
+      );
+    }
+    return customPath;
+  };
+};
+var 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 = /* @__PURE__ */ 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
+    ]
+  };
+};
+
+// src/plugin-setup.ts
+import { pathToFileURL } from "url";
+import { createRequire } from "module";
+var TSX_LOADER_MODULE = "tsx/esm/api";
+var appendMissingRuntimeArgs = (runtimeOptionArgs) => {
+  for (const arg of runtimeOptionArgs) {
+    if (process.argv.includes(arg)) continue;
+    process.argv.push(arg);
+  }
+};
+var loadDomSetupModule = async (domSetupPath) => {
+  await import(pathToFileURL(domSetupPath).href);
+};
+var registerNodeTsxLoader = async (packageTag) => {
+  const requireFromCwd = createRequire(`${process.cwd()}/`);
+  try {
+    const resolvedModulePath = requireFromCwd.resolve(TSX_LOADER_MODULE);
+    const mod = await import(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 }
+    );
+  }
+};
+var setupInProcessEnvironment = async (options) => {
+  if (options.isolation !== "none") return void 0;
+  if (!canHandleRuntime(options.runtime)) return void 0;
+  let cleanupNodeTsxLoader;
+  if (isNodeRuntime(options.runtime)) {
+    cleanupNodeTsxLoader = await registerNodeTsxLoader(options.packageTag);
+  }
+  appendMissingRuntimeArgs(options.runtimeOptionArgs);
+  await loadDomSetupModule(options.domSetupPath);
+  return cleanupNodeTsxLoader;
+};
+
+// src/plugin-metrics.ts
+var DEFAULT_TOP_N = 5;
+var DEFAULT_MIN_DURATION_MS = 0;
+var isRenderMetricMessage = (message, metricMessageType) => {
+  if (!message || typeof message !== "object") return false;
+  return message.type === metricMessageType;
+};
+var isRenderMetricBatchMessage = (message, metricBatchMessageType) => {
+  if (!message || typeof message !== "object") return false;
+  const record = message;
+  return record.type === metricBatchMessageType && Array.isArray(record.metrics);
+};
+var getComponentName = (componentName) => typeof componentName === "string" && componentName.length > 0 ? componentName : "AnonymousComponent";
+var 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);
+};
+var 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;
+};
+var 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;
+};
+var 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;
+};
+var selectTopSlowestMetrics = (metrics, options) => [...metrics].sort((a, b) => b.durationMs - a.durationMs).slice(0, options.topN);
+var 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
+  };
+};
+var printMetricsSummary = (summary, packageTag) => {
+  const lines = summary.topSlowest.map(
+    (metric) => `  - ${metric.componentName} in ${metric.file}: ${metric.durationMs.toFixed(2)}ms`
+  );
+  console.log(`
+[${packageTag}] Slowest component renders`);
+  for (const line of lines) console.log(line);
+};
+
+// src/plugin-factory.ts
+import { definePlugin } from "poku/plugins";
+import { dirname, resolve as resolve2 } from "path";
+import { fileURLToPath } from "url";
+import { existsSync as existsSync2 } from "fs";
+var createFrameworkTestingPluginFactory = (descriptor, moduleUrl) => {
+  const currentDir = dirname(fileURLToPath(moduleUrl));
+  const resolveSetupModulePath = (baseName) => {
+    const jsPath = resolve2(currentDir, `${baseName}.js`);
+    if (existsSync2(jsPath)) return jsPath;
+    return resolve2(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 = 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 durationMs2 = Number(metric.durationMs) || 0;
+              metrics.push({
+                file,
+                componentName: getComponentName(metric.componentName),
+                durationMs: durationMs2
+              });
+            }
+            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 = void 0;
+        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
+  };
+};
+
+// src/dom-env.ts
+import { GlobalRegistrator } from "@happy-dom/global-registrator";
+var applyReactActEnvironment = (enabled) => {
+  if (!enabled) return;
+  const reactGlobal = globalThis;
+  if (typeof reactGlobal.IS_REACT_ACT_ENVIRONMENT === "undefined") {
+    reactGlobal.IS_REACT_ACT_ENVIRONMENT = true;
+  }
+};
+var 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));
+};
+var defineGlobal = (key, value) => {
+  Object.defineProperty(globalThis, key, {
+    configurable: true,
+    writable: true,
+    value
+  });
+};
+var 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));
+};
+
+// src/testing-core.ts
+import { getQueriesForElement } from "@testing-library/dom";
+var getNow = typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now.bind(performance) : Date.now.bind(Date);
+var getMetricsRuntimeState = (stateKey) => {
+  const stateGlobal = globalThis;
+  if (!stateGlobal[stateKey]) {
+    stateGlobal[stateKey] = {
+      metricBuffer: [],
+      metricFlushTimer: void 0,
+      metricsChannelClosed: false,
+      listenersRegistered: false
+    };
+  }
+  return stateGlobal[stateKey];
+};
+var createRenderMetricsEmitter = (options) => {
+  const { runtimeOptions, metricsStateKey, metricsBatchMessageType } = options;
+  const metricsState = getMetricsRuntimeState(metricsStateKey);
+  const clearMetricFlushTimer = () => {
+    if (!metricsState.metricFlushTimer) return;
+    clearTimeout(metricsState.metricFlushTimer);
+    metricsState.metricFlushTimer = void 0;
+  };
+  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 = void 0;
+      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
+  };
+};
+var 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;
+    }
+  });
+};
+export {
+  buildRunnerCommand,
+  buildRuntimeOptionArgs,
+  canHandleRuntime,
+  createDomSetupPathResolver,
+  createFrameworkTestingPluginFactory,
+  createMetricsSummary,
+  createRenderMetricsEmitter,
+  createRuntimeOptionArgPrefixes,
+  createScreen,
+  getComponentName,
+  getNow,
+  getRuntimeSupport,
+  isNodeRuntime,
+  isRenderMetricBatchMessage,
+  isRenderMetricMessage,
+  normalizeMetricsOptions,
+  parseRuntimeOptions,
+  printMetricsSummary,
+  selectTopSlowestMetrics,
+  setupHappyDomEnvironment,
+  setupInProcessEnvironment,
+  setupJsdomEnvironment
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime-options.ts","../src/plugin-command.ts","../src/plugin-setup.ts","../src/plugin-metrics.ts","../src/plugin-factory.ts","../src/dom-env.ts","../src/testing-core.ts"],"sourcesContent":["import type {\n  RuntimeOptionArgPrefixes,\n  RuntimeOptions,\n} from './types.ts';\n\nconst DEFAULT_DOM_URL = 'http://localhost:3000/';\nconst DEFAULT_METRIC_BATCH_SIZE = 50;\nconst DEFAULT_METRIC_FLUSH_MS = 50;\n\nconst toNumber = (value: string | undefined) => {\n  if (!value) return NaN;\n  const parsed = Number(value);\n  return Number.isFinite(parsed) ? parsed : NaN;\n};\n\nconst findValueByPrefix = (argv: string[], prefix: string) => {\n  const match = argv.find((arg) => arg.startsWith(prefix));\n  return match ? match.slice(prefix.length) : undefined;\n};\n\nconst parsePositiveInteger = (value: string | undefined, fallback: number) => {\n  const numeric = toNumber(value);\n  if (!Number.isFinite(numeric) || numeric <= 0) return fallback;\n  return Math.floor(numeric);\n};\n\nconst parseNonNegativeNumber = (value: string | undefined, fallback: number) => {\n  const numeric = toNumber(value);\n  if (!Number.isFinite(numeric) || numeric < 0) return fallback;\n  return numeric;\n};\n\nexport const createRuntimeOptionArgPrefixes = (\n  base: string\n): RuntimeOptionArgPrefixes => ({\n  metrics: `--${base}-metrics=`,\n  minMetricMs: `--${base}-min-metric-ms=`,\n  domUrl: `--${base}-dom-url=`,\n  metricBatchSize: `--${base}-metric-batch-size=`,\n  metricFlushMs: `--${base}-metric-flush-ms=`,\n});\n\nexport const parseRuntimeOptions = (\n  prefixes: RuntimeOptionArgPrefixes,\n  argv: string[] = process.argv\n): RuntimeOptions => {\n  const metricsEnabled =\n    findValueByPrefix(argv, prefixes.metrics) === '1' ||\n    findValueByPrefix(argv, prefixes.metrics) === 'true';\n\n  const domUrl =\n    findValueByPrefix(argv, prefixes.domUrl)?.trim() || DEFAULT_DOM_URL;\n\n  const minMetricMs = parseNonNegativeNumber(\n    findValueByPrefix(argv, prefixes.minMetricMs),\n    0\n  );\n\n  const metricBatchSize = parsePositiveInteger(\n    findValueByPrefix(argv, prefixes.metricBatchSize),\n    DEFAULT_METRIC_BATCH_SIZE\n  );\n\n  const metricFlushMs = parsePositiveInteger(\n    findValueByPrefix(argv, prefixes.metricFlushMs),\n    DEFAULT_METRIC_FLUSH_MS\n  );\n\n  return {\n    domUrl,\n    metricsEnabled,\n    minMetricMs,\n    metricBatchSize,\n    metricFlushMs,\n  };\n};\n","import type { DomAdapter } from './types.ts';\nimport { existsSync } from 'node:fs';\nimport { extname, resolve } from 'node:path';\n\nexport type RuntimeSupport = {\n  supportsNodeLikeImport: boolean;\n  supportsDenoPreload: boolean;\n};\n\nexport type BuildRunnerCommandInput = {\n  runtime: string;\n  command: string[];\n  file: string;\n  domSetupPath: string;\n  runtimeOptionArgs: string[];\n  extensions: Set<string>;\n};\n\nexport type BuildRunnerCommandOutput = {\n  shouldHandle: boolean;\n  command: string[];\n};\n\nconst isTsxImport = (arg: string) =>\n  arg === '--import=tsx' || arg === '--loader=tsx';\n\nexport const isNodeRuntime = (runtime: string) => runtime === 'node';\nconst isBunRuntime = (runtime: string) => runtime === 'bun';\nconst isDenoRuntime = (runtime: string) => runtime === 'deno';\n\nexport const getRuntimeSupport = (runtime: string): RuntimeSupport => ({\n  supportsNodeLikeImport: isNodeRuntime(runtime) || isBunRuntime(runtime),\n  supportsDenoPreload: isDenoRuntime(runtime),\n});\n\nexport const canHandleRuntime = (runtime: string) => {\n  const support = getRuntimeSupport(runtime);\n  return support.supportsNodeLikeImport || support.supportsDenoPreload;\n};\n\nexport const createDomSetupPathResolver = (\n  packageTag: string,\n  happyDomSetupPath: string,\n  jsdomSetupPath: string\n) => {\n  return (adapter: DomAdapter | undefined) => {\n    if (!adapter || adapter === 'happy-dom') return happyDomSetupPath;\n    if (adapter === 'jsdom') return jsdomSetupPath;\n\n    const customPath = resolve(process.cwd(), adapter.setupModule);\n\n    if (!existsSync(customPath)) {\n      throw new Error(\n        `[${packageTag}] Custom DOM setup module not found: \"${customPath}\"\\n` +\n          'Check the \"dom.setupModule\" option in your poku.config.js.'\n      );\n    }\n\n    return customPath;\n  };\n};\n\nexport const buildRunnerCommand = ({\n  runtime,\n  command,\n  file,\n  domSetupPath,\n  runtimeOptionArgs,\n  extensions,\n}: BuildRunnerCommandInput): BuildRunnerCommandOutput => {\n  const support = getRuntimeSupport(runtime);\n\n  if (!support.supportsNodeLikeImport && !support.supportsDenoPreload) {\n    return { shouldHandle: false, command };\n  }\n\n  if (!extensions.has(extname(file))) {\n    return { shouldHandle: false, command };\n  }\n\n  const fileIndex = command.lastIndexOf(file);\n  if (fileIndex === -1) return { shouldHandle: false, command };\n\n  const nodeImportFlag = `--import=${domSetupPath}`;\n  const denoPreloadFlag = `--preload=${domSetupPath}`;\n  const beforeFile: string[] = [];\n  const afterFile: string[] = [];\n\n  let hasTsx = false;\n  let hasNodeLikeDomSetup = false;\n  let hasDenoDomSetup = false;\n  const existingArgs = new Set<string>();\n\n  for (let index = 1; index < command.length; index += 1) {\n    const arg = command[index];\n    if (typeof arg !== 'string') continue;\n\n    existingArgs.add(arg);\n\n    if (index < fileIndex) {\n      beforeFile.push(arg);\n\n      if (isTsxImport(arg)) hasTsx = true;\n      else if (arg === nodeImportFlag) hasNodeLikeDomSetup = true;\n      else if (arg === denoPreloadFlag) hasDenoDomSetup = true;\n      continue;\n    }\n\n    if (index > fileIndex) {\n      afterFile.push(arg);\n    }\n  }\n\n  const extraImports: string[] = [];\n  if (isNodeRuntime(runtime) && !hasTsx) extraImports.push('--import=tsx');\n  if (support.supportsNodeLikeImport && !hasNodeLikeDomSetup) {\n    extraImports.push(nodeImportFlag);\n  }\n  if (support.supportsDenoPreload && !hasDenoDomSetup) {\n    extraImports.push(denoPreloadFlag);\n  }\n\n  const runtimeArgsToInject: string[] = [];\n  for (const runtimeOptionArg of runtimeOptionArgs) {\n    if (existingArgs.has(runtimeOptionArg)) continue;\n    runtimeArgsToInject.push(runtimeOptionArg);\n  }\n\n  return {\n    shouldHandle: true,\n    command: [\n      runtime,\n      ...beforeFile,\n      ...extraImports,\n      file,\n      ...runtimeArgsToInject,\n      ...afterFile,\n    ],\n  };\n};\n","import { pathToFileURL } from 'node:url';\nimport { createRequire } from 'node:module';\nimport { canHandleRuntime, isNodeRuntime } from './plugin-command.ts';\n\ntype TsxEsmApiModule = {\n  register?: () => () => void;\n};\n\nconst TSX_LOADER_MODULE = 'tsx/esm/api';\n\nconst appendMissingRuntimeArgs = (runtimeOptionArgs: string[]) => {\n  for (const arg of runtimeOptionArgs) {\n    if (process.argv.includes(arg)) continue;\n    process.argv.push(arg);\n  }\n};\n\nconst loadDomSetupModule = async (domSetupPath: string) => {\n  await import(pathToFileURL(domSetupPath).href);\n};\n\nconst registerNodeTsxLoader = async (packageTag: string) => {\n  const requireFromCwd = createRequire(`${process.cwd()}/`);\n\n  try {\n    const resolvedModulePath = requireFromCwd.resolve(TSX_LOADER_MODULE);\n    const mod = (await import(pathToFileURL(resolvedModulePath).href)) as TsxEsmApiModule;\n    if (typeof mod.register !== 'function') {\n      throw new Error('Missing register() export from tsx loader API');\n    }\n\n    return mod.register();\n  } catch (error) {\n    throw new Error(\n      `[${packageTag}] isolation \"none\" in Node.js requires a working \"tsx\" installation to load .tsx/.jsx test files.`,\n      { cause: error }\n    );\n  }\n};\n\nexport type InProcessSetupOptions = {\n  isolation: string | undefined;\n  runtime: string;\n  runtimeOptionArgs: string[];\n  domSetupPath: string;\n  packageTag: string;\n};\n\nexport const setupInProcessEnvironment = async (\n  options: InProcessSetupOptions\n): Promise<(() => void) | undefined> => {\n  if (options.isolation !== 'none') return undefined;\n  if (!canHandleRuntime(options.runtime)) return undefined;\n\n  let cleanupNodeTsxLoader: (() => void) | undefined;\n\n  if (isNodeRuntime(options.runtime)) {\n    cleanupNodeTsxLoader = await registerNodeTsxLoader(options.packageTag);\n  }\n\n  appendMissingRuntimeArgs(options.runtimeOptionArgs);\n  await loadDomSetupModule(options.domSetupPath);\n\n  return cleanupNodeTsxLoader;\n};\n","import type {\n  MetricsOptions,\n  MetricsSummary,\n  NormalizedMetricsOptions,\n  RenderMetric,\n  RuntimeOptionArgPrefixes,\n  TestingPluginOptions,\n} from './types.ts';\n\nconst DEFAULT_TOP_N = 5;\nconst DEFAULT_MIN_DURATION_MS = 0;\n\nexport const isRenderMetricMessage = (\n  message: unknown,\n  metricMessageType: string\n): message is { type: string; componentName?: string; durationMs?: number } => {\n  if (!message || typeof message !== 'object') return false;\n  return (message as Record<string, unknown>).type === metricMessageType;\n};\n\nexport const isRenderMetricBatchMessage = (\n  message: unknown,\n  metricBatchMessageType: string\n): message is {\n  type: string;\n  metrics: Array<{ componentName?: string; durationMs?: number }>;\n} => {\n  if (!message || typeof message !== 'object') return false;\n\n  const record = message as Record<string, unknown>;\n  return (\n    record.type === metricBatchMessageType && Array.isArray(record.metrics)\n  );\n};\n\nexport const getComponentName = (componentName: unknown) =>\n  typeof componentName === 'string' && componentName.length > 0\n    ? componentName\n    : 'AnonymousComponent';\n\nconst getPositiveIntegerOrDefault = (value: unknown, fallback: number) => {\n  const numeric =\n    typeof value === 'number'\n      ? value\n      : typeof value === 'string' && value.trim().length > 0\n        ? Number(value.trim())\n        : NaN;\n\n  if (!Number.isFinite(numeric) || numeric <= 0) return fallback;\n  return Math.floor(numeric);\n};\n\nconst getNonNegativeNumberOrDefault = (value: unknown, fallback: number) => {\n  const numeric =\n    typeof value === 'number'\n      ? value\n      : typeof value === 'string' && value.trim().length > 0\n        ? Number(value.trim())\n        : NaN;\n\n  if (!Number.isFinite(numeric) || numeric < 0) return fallback;\n  return numeric;\n};\n\nexport const buildRuntimeOptionArgs = (\n  options: TestingPluginOptions,\n  metricsOptions: NormalizedMetricsOptions,\n  prefixes: RuntimeOptionArgPrefixes\n) => {\n  const args: string[] = [];\n\n  if (options.domUrl) {\n    args.push(`${prefixes.domUrl}${options.domUrl}`);\n  }\n\n  if (metricsOptions.enabled) {\n    args.push(`${prefixes.metrics}1`);\n    args.push(`${prefixes.minMetricMs}${metricsOptions.minDurationMs}`);\n  }\n\n  return args;\n};\n\nexport const normalizeMetricsOptions = (\n  metrics: boolean | MetricsOptions | undefined\n): NormalizedMetricsOptions => {\n  if (metrics === true) {\n    return {\n      enabled: true,\n      topN: DEFAULT_TOP_N,\n      minDurationMs: DEFAULT_MIN_DURATION_MS,\n    };\n  }\n\n  if (!metrics) {\n    return {\n      enabled: false,\n      topN: DEFAULT_TOP_N,\n      minDurationMs: DEFAULT_MIN_DURATION_MS,\n    };\n  }\n\n  const normalized: NormalizedMetricsOptions = {\n    enabled: metrics.enabled ?? true,\n    topN: getPositiveIntegerOrDefault(metrics.topN, DEFAULT_TOP_N),\n    minDurationMs: getNonNegativeNumberOrDefault(\n      metrics.minDurationMs,\n      DEFAULT_MIN_DURATION_MS\n    ),\n  };\n\n  if (metrics.reporter) normalized.reporter = metrics.reporter;\n\n  return normalized;\n};\n\nexport const selectTopSlowestMetrics = (\n  metrics: RenderMetric[],\n  options: NormalizedMetricsOptions\n) =>\n  [...metrics]\n    .sort((a, b) => b.durationMs - a.durationMs)\n    .slice(0, options.topN);\n\nexport const createMetricsSummary = (\n  metrics: RenderMetric[],\n  options: NormalizedMetricsOptions\n): MetricsSummary | null => {\n  if (!options.enabled || metrics.length === 0) return null;\n\n  const topSlowest = selectTopSlowestMetrics(metrics, options);\n  if (topSlowest.length === 0) return null;\n\n  return {\n    totalCaptured: metrics.length,\n    totalReported: topSlowest.length,\n    topSlowest,\n  };\n};\n\nexport const printMetricsSummary = (\n  summary: MetricsSummary,\n  packageTag: string\n) => {\n  const lines = summary.topSlowest.map(\n    (metric) =>\n      `  - ${metric.componentName} in ${metric.file}: ${metric.durationMs.toFixed(2)}ms`\n  );\n\n  console.log(`\\n[${packageTag}] Slowest component renders`);\n  for (const line of lines) console.log(line);\n};\n","import type {\n  DomAdapter,\n  FrameworkDescriptor,\n  MetricsSummary,\n  RenderMetric,\n  TestingPluginOptions,\n} from './types.ts';\nimport { definePlugin } from 'poku/plugins';\nimport { dirname, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { existsSync } from 'node:fs';\nimport {\n  buildRunnerCommand,\n  canHandleRuntime,\n  createDomSetupPathResolver,\n} from './plugin-command.ts';\nimport {\n  buildRuntimeOptionArgs,\n  createMetricsSummary,\n  getComponentName,\n  isRenderMetricBatchMessage,\n  isRenderMetricMessage,\n  normalizeMetricsOptions,\n  printMetricsSummary,\n  selectTopSlowestMetrics,\n} from './plugin-metrics.ts';\nimport { setupInProcessEnvironment } from './plugin-setup.ts';\nimport { createRuntimeOptionArgPrefixes } from './runtime-options.ts';\n\nexport type FrameworkPluginInternals = {\n  buildRunnerCommand: typeof buildRunnerCommand;\n  canHandleRuntime: typeof canHandleRuntime;\n  buildRuntimeOptionArgs: typeof buildRuntimeOptionArgs;\n  normalizeMetricsOptions: typeof normalizeMetricsOptions;\n  selectTopSlowestMetrics: typeof selectTopSlowestMetrics;\n  createMetricsSummary: typeof createMetricsSummary;\n  getComponentName: typeof getComponentName;\n  isRenderMetricMessage: typeof isRenderMetricMessage;\n  isRenderMetricBatchMessage: typeof isRenderMetricBatchMessage;\n  resolveDomSetupPath: (adapter: DomAdapter | undefined) => string;\n};\n\nexport const createFrameworkTestingPluginFactory = (\n  descriptor: FrameworkDescriptor,\n  moduleUrl: string\n) => {\n  const currentDir = dirname(fileURLToPath(moduleUrl));\n  const resolveSetupModulePath = (baseName: string) => {\n    const jsPath = resolve(currentDir, `${baseName}.js`);\n    if (existsSync(jsPath)) return jsPath;\n    return resolve(currentDir, `${baseName}.ts`);\n  };\n\n  const happyDomSetupPath = resolveSetupModulePath('dom-setup-happy');\n  const jsdomSetupPath = resolveSetupModulePath('dom-setup-jsdom');\n  const resolveDomSetupPath = createDomSetupPathResolver(\n    descriptor.packageTag,\n    happyDomSetupPath,\n    jsdomSetupPath\n  );\n\n  const prefixes = createRuntimeOptionArgPrefixes(descriptor.runtimeArgBase);\n  const extensions = new Set(descriptor.testFileExtensions ?? ['.tsx', '.jsx']);\n\n  const createTestingPlugin = (options: TestingPluginOptions = {}) => {\n    let metrics: RenderMetric[] = [];\n    let cleanupNodeTsxLoader: (() => void) | undefined;\n    const domSetupPath = resolveDomSetupPath(options.dom);\n    const metricsOptions = normalizeMetricsOptions(options.metrics);\n    const runtimeOptionArgs = buildRuntimeOptionArgs(\n      options,\n      metricsOptions,\n      prefixes\n    );\n\n    return definePlugin({\n      name: descriptor.pluginName,\n      ipc: metricsOptions.enabled,\n\n      async setup(context: any) {\n        cleanupNodeTsxLoader = await setupInProcessEnvironment({\n          isolation: context.configs.isolation,\n          runtime: context.runtime,\n          runtimeOptionArgs,\n          domSetupPath,\n          packageTag: descriptor.packageTag,\n        });\n      },\n\n      runner(command: string[], file: string) {\n        const runtime = command[0];\n        if (!runtime) return command;\n\n        const result = buildRunnerCommand({\n          runtime,\n          command,\n          file,\n          domSetupPath,\n          runtimeOptionArgs,\n          extensions,\n        });\n\n        if (!result.shouldHandle) return command;\n        return result.command;\n      },\n\n      onTestProcess(child: any, file: string) {\n        if (!metricsOptions.enabled) return;\n\n        const maybePruneMetrics = () => {\n          if (metrics.length > metricsOptions.topN * 10) {\n            metrics = selectTopSlowestMetrics(metrics, metricsOptions);\n          }\n        };\n\n        child.on('message', (message: unknown) => {\n          if (\n            isRenderMetricBatchMessage(\n              message,\n              descriptor.metricBatchMessageType\n            )\n          ) {\n            for (const metric of message.metrics) {\n              const durationMs = Number(metric.durationMs) || 0;\n\n              metrics.push({\n                file,\n                componentName: getComponentName(metric.componentName),\n                durationMs,\n              });\n            }\n\n            maybePruneMetrics();\n            return;\n          }\n\n          if (!isRenderMetricMessage(message, descriptor.metricMessageType)) {\n            return;\n          }\n\n          const durationMs = Number(message.durationMs) || 0;\n\n          metrics.push({\n            file,\n            componentName: getComponentName(message.componentName),\n            durationMs,\n          });\n\n          maybePruneMetrics();\n        });\n      },\n\n      teardown() {\n        cleanupNodeTsxLoader?.();\n        cleanupNodeTsxLoader = undefined;\n\n        const summary = createMetricsSummary(metrics, metricsOptions);\n        if (!summary) return;\n\n        if (metricsOptions.reporter) {\n          metricsOptions.reporter(summary as MetricsSummary);\n          return;\n        }\n\n        printMetricsSummary(summary, descriptor.packageTag);\n      },\n    });\n  };\n\n  const internals: FrameworkPluginInternals = {\n    buildRunnerCommand,\n    canHandleRuntime,\n    buildRuntimeOptionArgs,\n    normalizeMetricsOptions,\n    selectTopSlowestMetrics,\n    createMetricsSummary,\n    getComponentName,\n    isRenderMetricMessage,\n    isRenderMetricBatchMessage,\n    resolveDomSetupPath,\n  };\n\n  return {\n    createTestingPlugin,\n    resolveDomSetupPath,\n    runtimeOptionArgPrefixes: prefixes,\n    internals,\n  };\n};\n","import { GlobalRegistrator } from '@happy-dom/global-registrator';\nimport type { RuntimeOptions } from './types.ts';\n\ntype SetupDomEnvironmentOptions = {\n  runtimeOptions: RuntimeOptions;\n  packageTag: string;\n  enableReactActEnvironment?: boolean;\n};\n\ntype ReactActGlobal = typeof globalThis & {\n  IS_REACT_ACT_ENVIRONMENT?: boolean;\n};\n\nconst applyReactActEnvironment = (enabled: boolean) => {\n  if (!enabled) return;\n  const reactGlobal = globalThis as ReactActGlobal;\n  if (typeof reactGlobal.IS_REACT_ACT_ENVIRONMENT === 'undefined') {\n    reactGlobal.IS_REACT_ACT_ENVIRONMENT = true;\n  }\n};\n\nexport const setupHappyDomEnvironment = async (\n  options: SetupDomEnvironmentOptions\n) => {\n  if (!globalThis.window || !globalThis.document) {\n    GlobalRegistrator.register({\n      url: options.runtimeOptions.domUrl,\n    });\n\n    const nativeDispatchEvent = globalThis.window.dispatchEvent;\n    if (typeof nativeDispatchEvent === 'function') {\n      globalThis.dispatchEvent = nativeDispatchEvent.bind(globalThis.window);\n    }\n  }\n\n  applyReactActEnvironment(Boolean(options.enableReactActEnvironment));\n};\n\nconst defineGlobal = (key: keyof typeof globalThis, value: unknown) => {\n  Object.defineProperty(globalThis, key, {\n    configurable: true,\n    writable: true,\n    value,\n  });\n};\n\nexport const setupJsdomEnvironment = async (\n  options: SetupDomEnvironmentOptions\n) => {\n  if (!globalThis.window || !globalThis.document) {\n    let mod: typeof import('jsdom');\n\n    try {\n      mod = await import('jsdom');\n    } catch {\n      throw new Error(\n        `[${options.packageTag}] DOM adapter \"jsdom\" requires the \"jsdom\" package. Install it with \"npm install --save-dev jsdom\".`\n      );\n    }\n\n    const { JSDOM } = mod;\n    const dom = new JSDOM('', {\n      url: options.runtimeOptions.domUrl,\n      pretendToBeVisual: true,\n    });\n\n    defineGlobal('window', dom.window as unknown as Window & typeof globalThis);\n    defineGlobal('document', dom.window.document);\n    defineGlobal('navigator', dom.window.navigator);\n    defineGlobal('HTMLElement', dom.window.HTMLElement);\n    defineGlobal('Element', dom.window.Element);\n    defineGlobal('Node', dom.window.Node);\n    defineGlobal('Text', dom.window.Text);\n    defineGlobal('SVGElement', dom.window.SVGElement);\n    defineGlobal('Event', dom.window.Event);\n    defineGlobal('CustomEvent', dom.window.CustomEvent);\n    defineGlobal('MutationObserver', dom.window.MutationObserver);\n    defineGlobal('requestAnimationFrame', dom.window.requestAnimationFrame);\n    defineGlobal('cancelAnimationFrame', dom.window.cancelAnimationFrame);\n  }\n\n  applyReactActEnvironment(Boolean(options.enableReactActEnvironment));\n};\n","import type { Screen } from '@testing-library/dom';\nimport { getQueriesForElement } from '@testing-library/dom';\nimport type { RuntimeOptions } from './types.ts';\n\nexport const getNow: () => number =\n  typeof performance !== 'undefined' && typeof performance.now === 'function'\n    ? performance.now.bind(performance)\n    : Date.now.bind(Date);\n\ntype QueuedRenderMetric = {\n  componentName: string;\n  durationMs: number;\n};\n\ntype MetricsRuntimeState = {\n  metricBuffer: QueuedRenderMetric[];\n  metricFlushTimer: ReturnType<typeof setTimeout> | undefined;\n  metricsChannelClosed: boolean;\n  listenersRegistered: boolean;\n};\n\ntype RuntimeStateGlobal = typeof globalThis & {\n  [symbol: symbol]: MetricsRuntimeState | undefined;\n};\n\nexport type RenderMetricsEmitterOptions = {\n  runtimeOptions: RuntimeOptions;\n  metricsStateKey: symbol;\n  metricsBatchMessageType: string;\n};\n\nconst getMetricsRuntimeState = (\n  stateKey: symbol\n): MetricsRuntimeState => {\n  const stateGlobal = globalThis as RuntimeStateGlobal;\n\n  if (!stateGlobal[stateKey]) {\n    stateGlobal[stateKey] = {\n      metricBuffer: [],\n      metricFlushTimer: undefined,\n      metricsChannelClosed: false,\n      listenersRegistered: false,\n    };\n  }\n\n  return stateGlobal[stateKey]!;\n};\n\nexport const createRenderMetricsEmitter = (\n  options: RenderMetricsEmitterOptions\n) => {\n  const { runtimeOptions, metricsStateKey, metricsBatchMessageType } = options;\n  const metricsState = getMetricsRuntimeState(metricsStateKey);\n\n  const clearMetricFlushTimer = () => {\n    if (!metricsState.metricFlushTimer) return;\n    clearTimeout(metricsState.metricFlushTimer);\n    metricsState.metricFlushTimer = undefined;\n  };\n\n  const flushMetricBuffer = () => {\n    if (!runtimeOptions.metricsEnabled || typeof process.send !== 'function') {\n      return;\n    }\n\n    if (process.connected === false) {\n      metricsState.metricBuffer.length = 0;\n      metricsState.metricsChannelClosed = true;\n      return;\n    }\n\n    if (\n      metricsState.metricsChannelClosed ||\n      metricsState.metricBuffer.length === 0\n    ) {\n      return;\n    }\n\n    const payload = metricsState.metricBuffer.splice(\n      0,\n      metricsState.metricBuffer.length\n    );\n\n    try {\n      process.send({\n        type: metricsBatchMessageType,\n        metrics: payload,\n      });\n    } catch {\n      metricsState.metricsChannelClosed = true;\n      metricsState.metricBuffer.length = 0;\n    }\n  };\n\n  const scheduleMetricFlush = () => {\n    if (metricsState.metricFlushTimer) return;\n\n    metricsState.metricFlushTimer = setTimeout(() => {\n      metricsState.metricFlushTimer = undefined;\n      flushMetricBuffer();\n    }, runtimeOptions.metricFlushMs);\n\n    metricsState.metricFlushTimer.unref?.();\n  };\n\n  if (runtimeOptions.metricsEnabled && !metricsState.listenersRegistered) {\n    metricsState.listenersRegistered = true;\n\n    process.on('beforeExit', () => {\n      clearMetricFlushTimer();\n      flushMetricBuffer();\n    });\n\n    process.on('disconnect', () => {\n      clearMetricFlushTimer();\n      metricsState.metricBuffer.length = 0;\n      metricsState.metricsChannelClosed = true;\n    });\n  }\n\n  const emitRenderMetric = (componentName: string, durationMs: number) => {\n    if (\n      !runtimeOptions.metricsEnabled ||\n      typeof process.send !== 'function'\n    ) {\n      return;\n    }\n\n    if (process.connected === false || metricsState.metricsChannelClosed) {\n      metricsState.metricBuffer.length = 0;\n      metricsState.metricsChannelClosed = true;\n      clearMetricFlushTimer();\n      return;\n    }\n\n    const safeDuration =\n      Number.isFinite(durationMs) && durationMs >= 0 ? durationMs : 0;\n\n    if (safeDuration < runtimeOptions.minMetricMs) return;\n\n    metricsState.metricBuffer.push({\n      componentName,\n      durationMs: safeDuration,\n    });\n\n    if (metricsState.metricBuffer.length >= runtimeOptions.metricBatchSize) {\n      clearMetricFlushTimer();\n      flushMetricBuffer();\n      return;\n    }\n\n    scheduleMetricFlush();\n  };\n\n  return {\n    emitRenderMetric,\n    flushMetricBuffer,\n    clearMetricFlushTimer,\n  };\n};\n\nexport const createScreen = (): Screen => {\n  return new Proxy({} as Screen, {\n    get(_target, prop) {\n      const baseScreenQueries = getQueriesForElement(document.body);\n      const value = Reflect.get(baseScreenQueries, prop, baseScreenQueries);\n      return typeof value === 'function'\n        ? value.bind(baseScreenQueries)\n        : value;\n    },\n  }) as Screen;\n};\n"],"mappings":"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","names":["resolve","existsSync","resolve","existsSync","durationMs"]}

package/package.json

@@ -1,11 +1,91 @@
 {
   "name": "@pokujs/dom",
-  "version": "0.0.1",
+  "version": "1.0.1",
+  "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": "tsup src/index.ts --format esm --dts --target node20 --sourcemap --clean --tsconfig tsconfig.tsup.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",
+    "tsup": "^8.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2"
   }
 }

package/index.js

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