@pokujs/dom 1.0.1 → 1.1.1

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,81 @@
+import { GlobalWindow } from 'happy-dom';
+const applyReactActEnvironment = (enabled) => {
+    if (!enabled)
+        return;
+    const reactGlobal = globalThis;
+    if (typeof reactGlobal.IS_REACT_ACT_ENVIRONMENT === 'undefined') {
+        reactGlobal.IS_REACT_ACT_ENVIRONMENT = true;
+    }
+};
+const defineGlobal = (key, value) => {
+    Object.defineProperty(globalThis, key, {
+        configurable: true,
+        writable: true,
+        value,
+    });
+};
+export const setupHappyDomEnvironment = async (options) => {
+    if (!globalThis.window || !globalThis.document) {
+        // Save native event primitives before installing Happy DOM globals.
+        // Deno's runtime calls globalThis.dispatchEvent('beforeunload') on exit
+        // using its own native Event constructor — if Happy DOM's dispatchEvent
+        // is installed instead, the type check inside it throws a TypeError.
+        const existingDispatchEvent = globalThis.dispatchEvent;
+        const existingEvent = globalThis.Event;
+        const existingCustomEvent = globalThis.CustomEvent;
+        const happyWindow = new GlobalWindow({ url: options.runtimeOptions.domUrl });
+        defineGlobal('window', happyWindow);
+        defineGlobal('document', happyWindow.document);
+        defineGlobal('navigator', happyWindow.navigator);
+        defineGlobal('HTMLElement', happyWindow.HTMLElement);
+        defineGlobal('Element', happyWindow.Element);
+        defineGlobal('Node', happyWindow.Node);
+        defineGlobal('Text', happyWindow.Text);
+        defineGlobal('SVGElement', happyWindow.SVGElement);
+        defineGlobal('MutationObserver', happyWindow.MutationObserver);
+        defineGlobal('requestAnimationFrame', happyWindow.requestAnimationFrame);
+        defineGlobal('cancelAnimationFrame', happyWindow.cancelAnimationFrame);
+        // Prefer the runtime's native Event constructors so that Deno's internal
+        // event dispatch (e.g. beforeunload) continues to work correctly.
+        defineGlobal('Event', typeof existingEvent === 'function' ? existingEvent : happyWindow.Event);
+        defineGlobal('CustomEvent', typeof existingCustomEvent === 'function' ? existingCustomEvent : happyWindow.CustomEvent);
+        if (typeof existingDispatchEvent === 'function') {
+            globalThis.dispatchEvent = existingDispatchEvent;
+        }
+        else {
+            globalThis.dispatchEvent = happyWindow.dispatchEvent.bind(happyWindow);
+        }
+    }
+    applyReactActEnvironment(Boolean(options.enableReactActEnvironment));
+};
+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

@@ -1,149 +1,8 @@
-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 };
+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';