@pokujs/dom 1.0.1 → 1.1.1

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,60 @@
+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';
+// Once tsx is registered in a Node.js process it cannot be safely deregistered
+// and re-registered (tsx's hook worker re-instantiation fails with an invalid
+// URL scheme). Under isolation:'none' everything runs in the same process for
+// its lifetime, so keeping the loader registered permanently is correct.
+const TSX_LOADER_REGISTERED_KEY = Symbol.for('@pokujs/dom.tsx-loader-registered');
+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 g = globalThis;
+    if (g[TSX_LOADER_REGISTERED_KEY])
+        return () => { };
+    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');
+        }
+        mod.register();
+        g[TSX_LOADER_REGISTERED_KEY] = true;
+        return () => { };
+    }
+    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,+EAA+E;AAC/E,8EAA8E;AAC9E,8EAA8E;AAC9E,yEAAyE;AACzE,MAAM,yBAAyB,GAAG,MAAM,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;AAGlF,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,EAAuB,EAAE;IAC9E,MAAM,CAAC,GAAG,UAA+B,CAAC;IAE1C,IAAI,CAAC,CAAC,yBAAyB,CAAC;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAElD,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,GAAG,CAAC,QAAQ,EAAE,CAAC;QACf,CAAC,CAAC,yBAAyB,CAAC,GAAG,IAAI,CAAC;QACpC,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAClB,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;