benchforge 0.1.8 → 0.1.11

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as MeasuredResults, i as BenchmarkSpec, n as BenchGroup, r as BenchSuite, t as RunnerOptions } from "./BenchRunner-CSKN9zPy.mjs";
+import { a as MeasuredResults, i as BenchmarkSpec, n as BenchGroup, o as HeapProfile, r as BenchSuite, t as RunnerOptions } from "./BenchRunner-BzyUfiyB.mjs";
 import { Alignment } from "table";
 import { Argv, InferredOptionTypes } from "yargs";
 import * as node_http0 from "node:http";
@@ -59,8 +59,6 @@ interface MatrixResults {
   name: string;
   variants: VariantResult[];
 }
-/** @return true if variant is a StatefulVariant (has setup + run) */
-declare function isStatefulVariant<T, S>(v: Variant<T, S>): v is StatefulVariant<T, S>;
 /** Options for runMatrix */
 interface RunMatrixOptions {
   iterations?: number;
@@ -81,6 +79,8 @@ interface RunMatrixOptions {
   heapInterval?: number;
   heapDepth?: number;
 }
+/** @return true if variant is a StatefulVariant (has setup + run) */
+declare function isStatefulVariant<T, S>(v: Variant<T, S>): v is StatefulVariant<T, S>;
 /** Run a BenchMatrix with inline variants or variantDir */
 declare function runMatrix<T>(matrix: BenchMatrix<T>, options?: RunMatrixOptions): Promise<MatrixResults>;
 //#endregion
@@ -104,7 +104,7 @@ interface ColumnFormat<T> {
   alignment?: Alignment;
   width?: number;
 }
-/** Table headers and configuration */
+/** Build formatted table with column groups and baselines */
 //#endregion
 //#region src/BenchmarkReport.d.ts
 /** Benchmark results with optional baseline for comparison */
@@ -138,8 +138,10 @@ declare function reportResults<S extends ReadonlyArray<ResultsMapper<any>>>(grou
 //#endregion
 //#region src/cli/CliArgs.d.ts
 type Configure<T> = (yargs: Argv) => Argv<T>;
-/** CLI args type inferred from cliOptions */
-type DefaultCliArgs = InferredOptionTypes<typeof cliOptions>;
+/** CLI args type inferred from cliOptions, plus optional file positional */
+type DefaultCliArgs = InferredOptionTypes<typeof cliOptions> & {
+  file?: string;
+};
 declare const cliOptions: {
   readonly time: {
     readonly type: "number";
@@ -217,11 +219,21 @@ declare const cliOptions: {
     readonly requiresArg: true;
     readonly describe: "export benchmark data to JSON file";
   };
-  readonly perfetto: {
+  readonly "export-perfetto": {
     readonly type: "string";
     readonly requiresArg: true;
     readonly describe: "export Perfetto trace file (view at ui.perfetto.dev)";
   };
+  readonly speedscope: {
+    readonly type: "boolean";
+    readonly default: false;
+    readonly describe: "open heap profile in speedscope (via npx)";
+  };
+  readonly "export-speedscope": {
+    readonly type: "string";
+    readonly requiresArg: true;
+    readonly describe: "export heap profile as speedscope JSON";
+  };
   readonly "trace-opt": {
     readonly type: "boolean";
     readonly default: false;
@@ -286,6 +298,11 @@ declare const cliOptions: {
     readonly default: false;
     readonly describe: "verbose output with file:// paths and line numbers";
   };
+  readonly "heap-raw": {
+    readonly type: "boolean";
+    readonly default: false;
+    readonly describe: "dump every raw heap sample (ordinal, size, stack)";
+  };
   readonly "heap-user-only": {
     readonly type: "boolean";
     readonly default: false;
@@ -422,13 +439,14 @@ interface CallFrame {
   fn: string;
   url: string;
   line: number;
-  col: number;
+  col?: number;
 }
 type UserCodeFilter = (site: CallFrame) => boolean;
 interface HeapReportOptions {
   topN: number;
   stackDepth?: number;
   verbose?: boolean;
+  raw?: boolean;
   userOnly?: boolean;
   isUserCode?: UserCodeFilter;
   totalAll?: number;
@@ -451,16 +469,29 @@ interface MatrixReportOptions {
   sections?: ResultsMapper[];
   variantTitle?: string;
 }
-/** Format matrix results as one table per case */
-declare function reportMatrixResults(results: MatrixResults, options?: MatrixReportOptions): string;
 /** GC statistics columns - derived from gcStatsSection for consistency */
 declare const gcStatsColumns: ExtraColumn[];
 /** GC pause time column */
 declare const gcPauseColumn: ExtraColumn;
 /** Heap sampling total bytes column */
 declare const heapTotalColumn: ExtraColumn;
+/** Format matrix results as one table per case */
+declare function reportMatrixResults(results: MatrixResults, options?: MatrixReportOptions): string;
 //#endregion
 //#region src/cli/RunBenchCLI.d.ts
+interface ExportOptions {
+  results: ReportGroup[];
+  args: DefaultCliArgs;
+  sections?: any[];
+  suiteName?: string;
+  currentVersion?: GitVersion;
+  baselineVersion?: GitVersion;
+}
+interface MatrixExportOptions {
+  sections?: any[];
+  currentVersion?: GitVersion;
+  baselineVersion?: GitVersion;
+}
 /** Parse CLI with custom configuration */
 declare function parseBenchArgs<T = DefaultCliArgs>(configureArgs?: Configure<T>): T & DefaultCliArgs;
 /** Run suite with CLI arguments */
@@ -477,14 +508,6 @@ declare function runDefaultBench(suite?: BenchSuite, configureArgs?: Configure<a
 declare function reportOptStatus(groups: ReportGroup[]): void;
 /** @return true if any result has the specified field with a defined value */
 declare function hasField(results: ReportGroup[], field: keyof MeasuredResults): boolean;
-interface ExportOptions {
-  results: ReportGroup[];
-  args: DefaultCliArgs;
-  sections?: any[];
-  suiteName?: string;
-  currentVersion?: GitVersion;
-  baselineVersion?: GitVersion;
-}
 /** Export reports (HTML, JSON, Perfetto) based on CLI args */
 declare function exportReports(options: ExportOptions): Promise<void>;
 /** Run matrix suite with CLI arguments.
@@ -499,11 +522,6 @@ declare function defaultMatrixReport(results: MatrixResults[], reportOptions?: M
 declare function runDefaultMatrixBench(suite: MatrixSuite, configureArgs?: Configure<any>, reportOptions?: MatrixReportOptions): Promise<void>;
 /** Convert MatrixResults to ReportGroup[] for export compatibility */
 declare function matrixToReportGroups(results: MatrixResults[]): ReportGroup[];
-interface MatrixExportOptions {
-  sections?: any[];
-  currentVersion?: GitVersion;
-  baselineVersion?: GitVersion;
-}
 /** Run matrix benchmarks, display table, and generate exports */
 declare function matrixBenchExports(suite: MatrixSuite, args: DefaultCliArgs, reportOptions?: MatrixReportOptions, exportOptions?: MatrixExportOptions): Promise<void>;
 //#endregion
@@ -593,6 +611,43 @@ interface BenchmarkResult {
 /** Export benchmark results to Perfetto-compatible trace file */
 declare function exportPerfettoTrace(groups: ReportGroup[], outputPath: string, args: DefaultCliArgs): void;
 //#endregion
+//#region src/export/SpeedscopeExport.d.ts
+/** speedscope file format (https://www.speedscope.app/file-format-schema.json) */
+interface SpeedscopeFile {
+  $schema: "https://www.speedscope.app/file-format-schema.json";
+  shared: {
+    frames: SpeedscopeFrame[];
+  };
+  profiles: SpeedscopeProfile[];
+  name?: string;
+  exporter?: string;
+}
+interface SpeedscopeFrame {
+  name: string;
+  file?: string;
+  line?: number;
+  col?: number;
+}
+interface SpeedscopeProfile {
+  type: "sampled";
+  name: string;
+  unit: "bytes";
+  startValue: number;
+  endValue: number;
+  samples: number[][];
+  weights: number[];
+}
+/** Export heap profiles from benchmark results to speedscope JSON format.
+*  Creates one speedscope profile per benchmark that has a heapProfile.
+*  @returns resolved output path, or undefined if no profiles were found */
+declare function exportSpeedscope(groups: ReportGroup[], outputPath: string): string | undefined;
+/** Export to a temp file and open in speedscope via npx */
+declare function exportAndLaunchSpeedscope(groups: ReportGroup[]): void;
+/** Launch speedscope viewer on a file via npx */
+declare function launchSpeedscope(filePath: string): void;
+/** Convert a single HeapProfile to speedscope format (for standalone use) */
+declare function heapProfileToSpeedscope(name: string, profile: HeapProfile): SpeedscopeFile;
+//#endregion
 //#region src/HtmlDataPrep.d.ts
 interface PrepareHtmlOptions {
   cliArgs?: Record<string, unknown>;
@@ -622,13 +677,13 @@ interface MatrixFilter {
   case?: string;
   variant?: string;
 }
-/** Parse filter string: "case/variant", "case/", "/variant", or "case" */
-declare function parseMatrixFilter(filter: string): MatrixFilter;
 /** Filtered matrix with explicit case and variant lists */
 interface FilteredMatrix<T = unknown> extends BenchMatrix<T> {
   filteredCases?: string[];
   filteredVariants?: string[];
 }
+/** Parse filter string: "case/variant", "case/", "/variant", or "case" */
+declare function parseMatrixFilter(filter: string): MatrixFilter;
 /** Apply filter to a matrix, merging with existing filters via intersection */
 declare function filterMatrix<T>(matrix: FilteredMatrix<T>, filter?: MatrixFilter): Promise<FilteredMatrix<T>>;
 //#endregion
@@ -638,13 +693,9 @@ interface TimeStats {
   p50?: number;
   p99?: number;
 }
-/** Section: mean, p50, p99 timing */
-declare const timeSection: ResultsMapper<TimeStats>;
 interface GcSectionStats {
   gc?: number;
 }
-/** Section: GC time as fraction of total benchmark time (Node performance hooks) */
-declare const gcSection: ResultsMapper<GcSectionStats>;
 interface GcStatsInfo {
   allocPerIter?: number;
   collected?: number;
@@ -653,42 +704,46 @@ interface GcStatsInfo {
   promoPercent?: number;
   pausePerIter?: number;
 }
-/** Section: detailed GC stats from --trace-gc-nvp (allocation, promotion, pauses) */
-declare const gcStatsSection: ResultsMapper<GcStatsInfo>;
 interface CpuStats {
   cpuCacheMiss?: number;
   cpuStall?: number;
 }
-/** Section: CPU L1 cache miss rate and stall rate (requires @mitata/counters) */
-declare const cpuSection: ResultsMapper<CpuStats>;
 interface RunStats {
   runs?: number;
 }
-/** Section: number of sample iterations */
-declare const runsSection: ResultsMapper<RunStats>;
-/** Section: total sampling duration in seconds (brackets if >= 30s) */
-declare const totalTimeSection: ResultsMapper<{
-  totalTime?: number;
-}>;
 interface AdaptiveStats {
   median?: number;
   mean?: number;
   p99?: number;
   convergence?: number;
 }
+interface OptStats {
+  tiers?: string;
+  deopt?: number;
+}
+/** Section: mean, p50, p99 timing */
+declare const timeSection: ResultsMapper<TimeStats>;
+/** Section: GC time as fraction of total benchmark time (Node performance hooks) */
+declare const gcSection: ResultsMapper<GcSectionStats>;
+/** Section: detailed GC stats from --trace-gc-nvp (allocation, promotion, pauses) */
+declare const gcStatsSection: ResultsMapper<GcStatsInfo>;
+/** Section: CPU L1 cache miss rate and stall rate (requires @mitata/counters) */
+declare const cpuSection: ResultsMapper<CpuStats>;
+/** Section: number of sample iterations */
+declare const runsSection: ResultsMapper<RunStats>;
+/** Section: total sampling duration in seconds (brackets if >= 30s) */
+declare const totalTimeSection: ResultsMapper<{
+  totalTime?: number;
+}>;
 /** Section: median, mean, p99, and convergence for adaptive mode */
 declare const adaptiveSection: ResultsMapper<AdaptiveStats>;
+/** Section: V8 optimization tier distribution and deopt count */
+declare const optSection: ResultsMapper<OptStats>;
 /** Build generic sections based on CLI flags */
 declare function buildGenericSections(args: {
   "gc-stats"?: boolean;
   "heap-sample"?: boolean;
 }): ResultsMapper[];
-interface OptStats {
-  tiers?: string;
-  deopt?: number;
-}
-/** Section: V8 optimization tier distribution and deopt count */
-declare const optSection: ResultsMapper<OptStats>;
 //#endregion
 //#region src/StatisticalUtils.d.ts
 /** @return mean of values */
@@ -703,10 +758,13 @@ declare function formatConvergence(v: unknown): string;
 declare function timeMs(ms: unknown): string | null;
 /** Format integer with thousand separators */
 declare function integer(x: unknown): string | null;
-/** Format bytes with appropriate units (B, KB, MB, GB) */
-declare function formatBytes(bytes: unknown): string | null;
+/** Format bytes with appropriate units (B, KB, MB, GB).
+*  Use `space: true` for human-readable console output (`1.5 KB`). */
+declare function formatBytes(bytes: unknown, opts?: {
+  space?: boolean;
+}): string | null;
 /** @return truncated string with ellipsis if over maxLen */
 declare function truncate(str: string, maxLen?: number): string;
 //#endregion
-export { type AnyVariant, type BenchGroup, type BenchMatrix, type BenchSuite, BenchmarkGroup, BenchmarkJsonData, type BenchmarkReport, BenchmarkResult, type BenchmarkSpec, BenchmarkSuite, type CaseResult, type CasesModule, type Configure, type DefaultCliArgs, type ExportOptions, type ExtraColumn, type FilteredMatrix, type GitVersion, type HtmlReportOptions, type LoadedCase, type MatrixDefaults, type MatrixExportOptions, type MatrixFilter, type MatrixReportOptions, type MatrixResults, type MatrixSuite, type MeasuredResults, type PrepareHtmlOptions, type ReportColumnGroup, type ReportData, type ReportGroup, type ResultsMapper, type RunMatrixOptions, type RunnerOptions, type StatefulVariant, type UnknownRecord, type Variant, type VariantFn, type VariantResult, adaptiveSection, average, benchExports, buildGenericSections, cliToMatrixOptions, cpuSection, defaultCliArgs, defaultMatrixReport, defaultReport, exportPerfettoTrace, exportReports, filterMatrix, formatBytes, formatConvergence, formatDateWithTimezone, formatGitVersion, gcPauseColumn, gcSection, gcStatsColumns, gcStatsSection, generateHtmlReport, getBaselineVersion, getCurrentGitVersion, hasField, heapTotalColumn, integer, isStatefulVariant, loadCaseData, loadCasesModule, matrixBenchExports, matrixToReportGroups, optSection, parseBenchArgs, parseCliArgs, parseMatrixFilter, prepareHtmlData, printHeapReports, reportMatrixResults, reportOptStatus, reportResults, runBenchmarks, runDefaultBench, runDefaultMatrixBench, runMatrix, runMatrixSuite, runsSection, timeMs, timeSection, totalTimeSection, truncate };
+export { type AnyVariant, type BenchGroup, type BenchMatrix, type BenchSuite, BenchmarkGroup, BenchmarkJsonData, type BenchmarkReport, BenchmarkResult, type BenchmarkSpec, BenchmarkSuite, type CaseResult, type CasesModule, type Configure, type DefaultCliArgs, type ExportOptions, type ExtraColumn, type FilteredMatrix, type GitVersion, type HtmlReportOptions, type LoadedCase, type MatrixDefaults, type MatrixExportOptions, type MatrixFilter, type MatrixReportOptions, type MatrixResults, type MatrixSuite, type MeasuredResults, type PrepareHtmlOptions, type ReportColumnGroup, type ReportData, type ReportGroup, type ResultsMapper, type RunMatrixOptions, type RunnerOptions, type StatefulVariant, type UnknownRecord, type Variant, type VariantFn, type VariantResult, adaptiveSection, average, benchExports, buildGenericSections, cliToMatrixOptions, cpuSection, defaultCliArgs, defaultMatrixReport, defaultReport, exportAndLaunchSpeedscope, exportPerfettoTrace, exportReports, exportSpeedscope, filterMatrix, formatBytes, formatConvergence, formatDateWithTimezone, formatGitVersion, gcPauseColumn, gcSection, gcStatsColumns, gcStatsSection, generateHtmlReport, getBaselineVersion, getCurrentGitVersion, hasField, heapProfileToSpeedscope, heapTotalColumn, integer, isStatefulVariant, launchSpeedscope, loadCaseData, loadCasesModule, matrixBenchExports, matrixToReportGroups, optSection, parseBenchArgs, parseCliArgs, parseMatrixFilter, prepareHtmlData, printHeapReports, reportMatrixResults, reportOptStatus, reportResults, runBenchmarks, runDefaultBench, runDefaultMatrixBench, runMatrix, runMatrixSuite, runsSection, timeMs, timeSection, totalTimeSection, truncate };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { A as timeSection, B as parseCliArgs, C as adaptiveSection, D as gcStatsSection, E as gcSection, F as generateHtmlReport, G as truncate, H as formatBytes, I as formatDateWithTimezone, J as loadCaseData, K as isStatefulVariant, L as prepareHtmlData, M as formatConvergence, N as filterMatrix, O as optSection, P as parseMatrixFilter, R as exportPerfettoTrace, S as reportMatrixResults, T as cpuSection, U as integer, V as reportResults, W as timeMs, Y as loadCasesModule, _ as runDefaultMatrixBench, a as cliToMatrixOptions, b as gcStatsColumns, c as exportReports, d as matrixToReportGroups, f as parseBenchArgs, g as runDefaultBench, h as runBenchmarks, i as benchExports, j as totalTimeSection, k as runsSection, l as hasField, m as reportOptStatus, n as getBaselineVersion, o as defaultMatrixReport, p as printHeapReports, q as runMatrix, r as getCurrentGitVersion, s as defaultReport, t as formatGitVersion, u as matrixBenchExports, v as runMatrixSuite, w as buildGenericSections, x as heapTotalColumn, y as gcPauseColumn, z as defaultCliArgs } from "./src-HfimYuW_.mjs";
-import { o as average } from "./TimingUtils-ClclVQ7E.mjs";
+import { $ as loadCasesModule, A as timeSection, B as heapProfileToSpeedscope, C as adaptiveSection, D as gcStatsSection, E as gcSection, F as generateHtmlReport, G as reportResults, H as exportPerfettoTrace, I as formatDateWithTimezone, J as timeMs, K as formatBytes, L as prepareHtmlData, M as formatConvergence, N as filterMatrix, O as optSection, P as parseMatrixFilter, Q as loadCaseData, R as exportAndLaunchSpeedscope, S as reportMatrixResults, T as cpuSection, U as defaultCliArgs, V as launchSpeedscope, W as parseCliArgs, X as isStatefulVariant, Y as truncate, Z as runMatrix, _ as runDefaultMatrixBench, a as cliToMatrixOptions, b as gcStatsColumns, c as exportReports, d as matrixToReportGroups, f as parseBenchArgs, g as runDefaultBench, h as runBenchmarks, i as benchExports, j as totalTimeSection, k as runsSection, l as hasField, m as reportOptStatus, n as getBaselineVersion, o as defaultMatrixReport, p as printHeapReports, q as integer, r as getCurrentGitVersion, s as defaultReport, t as formatGitVersion, u as matrixBenchExports, v as runMatrixSuite, w as buildGenericSections, x as heapTotalColumn, y as gcPauseColumn, z as exportSpeedscope } from "./src-B-DDaCa9.mjs";
+import { o as average } from "./TimingUtils-DwOwkc8G.mjs";
 
-export { adaptiveSection, average, benchExports, buildGenericSections, cliToMatrixOptions, cpuSection, defaultCliArgs, defaultMatrixReport, defaultReport, exportPerfettoTrace, exportReports, filterMatrix, formatBytes, formatConvergence, formatDateWithTimezone, formatGitVersion, gcPauseColumn, gcSection, gcStatsColumns, gcStatsSection, generateHtmlReport, getBaselineVersion, getCurrentGitVersion, hasField, heapTotalColumn, integer, isStatefulVariant, loadCaseData, loadCasesModule, matrixBenchExports, matrixToReportGroups, optSection, parseBenchArgs, parseCliArgs, parseMatrixFilter, prepareHtmlData, printHeapReports, reportMatrixResults, reportOptStatus, reportResults, runBenchmarks, runDefaultBench, runDefaultMatrixBench, runMatrix, runMatrixSuite, runsSection, timeMs, timeSection, totalTimeSection, truncate };
+export { adaptiveSection, average, benchExports, buildGenericSections, cliToMatrixOptions, cpuSection, defaultCliArgs, defaultMatrixReport, defaultReport, exportAndLaunchSpeedscope, exportPerfettoTrace, exportReports, exportSpeedscope, filterMatrix, formatBytes, formatConvergence, formatDateWithTimezone, formatGitVersion, gcPauseColumn, gcSection, gcStatsColumns, gcStatsSection, generateHtmlReport, getBaselineVersion, getCurrentGitVersion, hasField, heapProfileToSpeedscope, heapTotalColumn, integer, isStatefulVariant, launchSpeedscope, loadCaseData, loadCasesModule, matrixBenchExports, matrixToReportGroups, optSection, parseBenchArgs, parseCliArgs, parseMatrixFilter, prepareHtmlData, printHeapReports, reportMatrixResults, reportOptStatus, reportResults, runBenchmarks, runDefaultBench, runDefaultMatrixBench, runMatrix, runMatrixSuite, runsSection, timeMs, timeSection, totalTimeSection, truncate };

package/dist/runners/WorkerScript.d.mts

@@ -1,4 +1,4 @@
-import { a as MeasuredResults, i as BenchmarkSpec, o as HeapProfile, t as RunnerOptions } from "../BenchRunner-CSKN9zPy.mjs";
+import { a as MeasuredResults, i as BenchmarkSpec, o as HeapProfile, t as RunnerOptions } from "../BenchRunner-BzyUfiyB.mjs";
 
 //#region src/runners/CreateRunner.d.ts
 type KnownRunner = "basic";

package/dist/runners/WorkerScript.mjs

@@ -1,61 +1,9 @@
 #!/usr/bin/env node
-import { a as createAdaptiveWrapper, d as variantModuleUrl, i as createRunner, n as getElapsed, r as getPerfNow, t as debugWorkerTiming } from "../TimingUtils-ClclVQ7E.mjs";
+import { a as createAdaptiveWrapper, d as variantModuleUrl, i as createRunner, n as getElapsed, r as getPerfNow, t as debugWorkerTiming } from "../TimingUtils-DwOwkc8G.mjs";
 
 //#region src/runners/WorkerScript.ts
 const workerStartTime = getPerfNow();
 const maxLifetime = 300 * 1e3;
-/**
-* Worker process for isolated benchmark execution.
-* Uses eval() safely in isolated child process with trusted code.
-*/
-process.on("message", async (message) => {
-	if (message.type !== "run") return;
-	logTiming(`Processing ${message.spec.name} with ${message.runnerName}`);
-	try {
-		const start = getPerfNow();
-		const baseRunner = await createRunner(message.runnerName);
-		const runner = message.options.adaptive ? createAdaptiveWrapper(baseRunner, message.options) : baseRunner;
-		logTiming("Runner created in", getElapsed(start));
-		const benchStart = getPerfNow();
-		if (message.options.heapSample) {
-			const { withHeapSampling } = await import("../HeapSampler-B8dtKHn1.mjs");
-			const { result: results, profile: heapProfile } = await withHeapSampling({
-				samplingInterval: message.options.heapInterval,
-				stackDepth: message.options.heapDepth
-			}, async () => {
-				const { fn, params } = await resolveBenchmarkFn(message);
-				return runner.runBench({
-					...message.spec,
-					fn
-				}, message.options, params);
-			});
-			logTiming("Benchmark execution took", getElapsed(benchStart));
-			sendAndExit({
-				type: "result",
-				results,
-				heapProfile
-			}, 0);
-		} else {
-			const { fn, params } = await resolveBenchmarkFn(message);
-			const results = await runner.runBench({
-				...message.spec,
-				fn
-			}, message.options, params);
-			logTiming("Benchmark execution took", getElapsed(benchStart));
-			sendAndExit({
-				type: "result",
-				results
-			}, 0);
-		}
-	} catch (error) {
-		sendAndExit(createErrorMessage(error), 1);
-	}
-});
-setTimeout(() => {
-	console.error("WorkerScript: Maximum lifetime exceeded, exiting");
-	process.exit(1);
-}, maxLifetime);
-process.stdin.pause();
 /** Log timing with consistent format */
 const logTiming = debugWorkerTiming ? _logTiming : () => {};
 function _logTiming(operation, duration) {
@@ -104,13 +52,6 @@ async function importVariantModule(message) {
 		params: void 0
 	};
 }
-/** Load case data from a cases module */
-async function loadCaseFromModule(casesModuleUrl, caseId) {
-	logTiming(`Loading case '${caseId}' from ${casesModuleUrl}`);
-	const module = await import(casesModuleUrl);
-	if (typeof module.loadCase === "function") return module.loadCase(caseId);
-	return { data: caseId };
-}
 /** Import benchmark function and optionally run setup */
 async function importBenchmarkWithSetup(message) {
 	const { modulePath, exportName, setupExportName, params } = message;
@@ -129,6 +70,19 @@ async function importBenchmarkWithSetup(message) {
 		params
 	};
 }
+/** Reconstruct function from string code */
+function reconstructFunction(fnCode) {
+	const fn = eval(`(${fnCode})`);
+	if (typeof fn !== "function") throw new Error("Reconstructed code is not a function");
+	return fn;
+}
+/** Load case data from a cases module */
+async function loadCaseFromModule(casesModuleUrl, caseId) {
+	logTiming(`Loading case '${caseId}' from ${casesModuleUrl}`);
+	const module = await import(casesModuleUrl);
+	if (typeof module.loadCase === "function") return module.loadCase(caseId);
+	return { data: caseId };
+}
 /** Get named or default export from module */
 function getModuleExport(module, exportName, modulePath) {
 	const fn = exportName ? module[exportName] : module.default || module;
@@ -138,12 +92,6 @@ function getModuleExport(module, exportName, modulePath) {
 	}
 	return fn;
 }
-/** Reconstruct function from string code */
-function reconstructFunction(fnCode) {
-	const fn = eval(`(${fnCode})`);
-	if (typeof fn !== "function") throw new Error("Reconstructed code is not a function");
-	return fn;
-}
 /** Create error message from exception */
 function createErrorMessage(error) {
 	return {
@@ -152,6 +100,58 @@ function createErrorMessage(error) {
 		stack: error instanceof Error ? error.stack : void 0
 	};
 }
+/**
+* Worker process for isolated benchmark execution.
+* Uses eval() safely in isolated child process with trusted code.
+*/
+process.on("message", async (message) => {
+	if (message.type !== "run") return;
+	logTiming(`Processing ${message.spec.name} with ${message.runnerName}`);
+	try {
+		const start = getPerfNow();
+		const baseRunner = await createRunner(message.runnerName);
+		const runner = message.options.adaptive ? createAdaptiveWrapper(baseRunner, message.options) : baseRunner;
+		logTiming("Runner created in", getElapsed(start));
+		const benchStart = getPerfNow();
+		if (message.options.heapSample) {
+			const { withHeapSampling } = await import("../HeapSampler-B8dtKHn1.mjs");
+			const { result: results, profile: heapProfile } = await withHeapSampling({
+				samplingInterval: message.options.heapInterval,
+				stackDepth: message.options.heapDepth
+			}, async () => {
+				const { fn, params } = await resolveBenchmarkFn(message);
+				return runner.runBench({
+					...message.spec,
+					fn
+				}, message.options, params);
+			});
+			logTiming("Benchmark execution took", getElapsed(benchStart));
+			sendAndExit({
+				type: "result",
+				results,
+				heapProfile
+			}, 0);
+		} else {
+			const { fn, params } = await resolveBenchmarkFn(message);
+			const results = await runner.runBench({
+				...message.spec,
+				fn
+			}, message.options, params);
+			logTiming("Benchmark execution took", getElapsed(benchStart));
+			sendAndExit({
+				type: "result",
+				results
+			}, 0);
+		}
+	} catch (error) {
+		sendAndExit(createErrorMessage(error), 1);
+	}
+});
+setTimeout(() => {
+	console.error("WorkerScript: Maximum lifetime exceeded, exiting");
+	process.exit(1);
+}, maxLifetime);
+process.stdin.pause();
 
 //#endregion
 export {  };

package/dist/runners/WorkerScript.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"WorkerScript.mjs","names":[],"sources":["../../src/runners/WorkerScript.ts"],"sourcesContent":["#!/usr/bin/env node\nimport type { BenchmarkFunction, BenchmarkSpec } from \"../Benchmark.ts\";\nimport type { HeapProfile } from \"../heap-sample/HeapSampler.ts\";\nimport type { MeasuredResults } from \"../MeasuredResults.ts\";\nimport { variantModuleUrl } from \"../matrix/VariantLoader.ts\";\nimport {\n  type AdaptiveOptions,\n  createAdaptiveWrapper,\n} from \"./AdaptiveWrapper.ts\";\nimport type { RunnerOptions } from \"./BenchRunner.ts\";\nimport { createRunner, type KnownRunner } from \"./CreateRunner.ts\";\nimport { debugWorkerTiming, getElapsed, getPerfNow } from \"./TimingUtils.ts\";\n\nconst workerStartTime = getPerfNow();\nconst maxLifetime = 5 * 60 * 1000; // 5 minutes\n\n/** Message sent to worker process to start a benchmark run. */\nexport interface RunMessage {\n  type: \"run\";\n  spec: BenchmarkSpec;\n  runnerName: KnownRunner;\n  options: RunnerOptions;\n  fnCode?: string; // Made optional - either fnCode or modulePath is required\n  modulePath?: string; // Path to module for dynamic import\n  exportName?: string; // Export name from module\n  setupExportName?: string; // Setup function export name - called once, result passed to fn\n  params?: unknown;\n  // Variant directory mode (BenchMatrix)\n  variantDir?: string; // Directory URL containing variant .ts files\n  variantId?: string; // Variant filename (without .ts)\n  caseData?: unknown; // Data to pass to variant\n  caseId?: string; // Case identifier\n  casesModule?: string; // URL to cases module (exports cases[] and loadCase())\n}\n\n/** Message returned from worker process with benchmark results. */\nexport interface ResultMessage {\n  type: \"result\";\n  results: MeasuredResults[];\n  heapProfile?: HeapProfile;\n}\n\n/** Message returned from worker process when benchmark fails. */\nexport interface ErrorMessage {\n  type: \"error\";\n  error: string;\n  stack?: string;\n}\n\nexport type WorkerMessage = RunMessage | ResultMessage | ErrorMessage;\n\n/**\n * Worker process for isolated benchmark execution.\n * Uses eval() safely in isolated child process with trusted code.\n */\nprocess.on(\"message\", async (message: RunMessage) => {\n  if (message.type !== \"run\") return;\n\n  logTiming(`Processing ${message.spec.name} with ${message.runnerName}`);\n\n  try {\n    const start = getPerfNow();\n    const baseRunner = await createRunner(message.runnerName);\n\n    const runner = (message.options as any).adaptive\n      ? createAdaptiveWrapper(baseRunner, message.options as AdaptiveOptions)\n      : baseRunner;\n\n    logTiming(\"Runner created in\", getElapsed(start));\n\n    const benchStart = getPerfNow();\n\n    // Run with heap sampling if enabled (covers module import + execution)\n    if (message.options.heapSample) {\n      const { withHeapSampling } = await import(\n        \"../heap-sample/HeapSampler.ts\"\n      );\n      const heapOpts = {\n        samplingInterval: message.options.heapInterval,\n        stackDepth: message.options.heapDepth,\n      };\n      const { result: results, profile: heapProfile } = await withHeapSampling(\n        heapOpts,\n        async () => {\n          const { fn, params } = await resolveBenchmarkFn(message);\n          return runner.runBench(\n            { ...message.spec, fn },\n            message.options,\n            params,\n          );\n        },\n      );\n      logTiming(\"Benchmark execution took\", getElapsed(benchStart));\n      sendAndExit({ type: \"result\", results, heapProfile }, 0);\n    } else {\n      const { fn, params } = await resolveBenchmarkFn(message);\n      const results = await runner.runBench(\n        { ...message.spec, fn },\n        message.options,\n        params,\n      );\n      logTiming(\"Benchmark execution took\", getElapsed(benchStart));\n      sendAndExit({ type: \"result\", results }, 0);\n    }\n  } catch (error) {\n    sendAndExit(createErrorMessage(error), 1);\n  }\n});\n\n// Exit after 5 minutes to prevent zombie processes\nsetTimeout(() => {\n  console.error(\"WorkerScript: Maximum lifetime exceeded, exiting\");\n  process.exit(1);\n}, maxLifetime);\n\nprocess.stdin.pause();\n\n/** Log timing with consistent format */\nconst logTiming = debugWorkerTiming ? _logTiming : () => {};\nfunction _logTiming(operation: string, duration?: number) {\n  if (duration === undefined) {\n    console.log(`[Worker] ${operation}`);\n  } else {\n    console.log(`[Worker] ${operation} ${duration.toFixed(1)}ms`);\n  }\n}\n\n/** Send message and exit with duration log */\nfunction sendAndExit(msg: ResultMessage | ErrorMessage, exitCode: number) {\n  process.send!(msg, undefined, undefined, (err: Error | null): void => {\n    if (err) {\n      const kind = msg.type === \"result\" ? \"results\" : \"error message\";\n      console.error(`[Worker] Error sending ${kind}:`, err);\n    }\n    const suffix = exitCode === 0 ? \"\" : \" (error)\";\n    logTiming(`Total worker duration${suffix}:`, getElapsed(workerStartTime));\n    process.exit(exitCode);\n  });\n}\n\ninterface BenchmarkImportResult {\n  fn: BenchmarkFunction;\n  params: unknown;\n}\n\n/** Resolve benchmark function from message (variant dir, module path, or fnCode) */\nasync function resolveBenchmarkFn(\n  message: RunMessage,\n): Promise<BenchmarkImportResult> {\n  if (message.variantDir && message.variantId) {\n    return importVariantModule(message);\n  }\n  if (message.modulePath) {\n    return importBenchmarkWithSetup(message);\n  }\n  return { fn: reconstructFunction(message.fnCode!), params: message.params };\n}\n\n/** Import variant from directory and prepare benchmark function */\nasync function importVariantModule(\n  message: RunMessage,\n): Promise<BenchmarkImportResult> {\n  const { variantDir, variantId, caseId, casesModule } = message;\n  let { caseData } = message;\n  const moduleUrl = variantModuleUrl(variantDir!, variantId!);\n  logTiming(`Importing variant ${variantId} from ${variantDir}`);\n\n  if (casesModule && caseId) {\n    caseData = (await loadCaseFromModule(casesModule, caseId)).data;\n  }\n\n  const module = await import(moduleUrl);\n  const { setup, run } = module;\n\n  if (typeof run !== \"function\") {\n    throw new Error(`Variant '${variantId}' must export 'run' function`);\n  }\n\n  // Stateful variant: setup returns state, run receives state\n  if (typeof setup === \"function\") {\n    logTiming(`Calling setup for ${variantId}`);\n    const state = await setup(caseData);\n    return { fn: () => run(state), params: undefined };\n  }\n\n  // Stateless variant: run receives caseData directly\n  return { fn: () => run(caseData), params: undefined };\n}\n\n/** Load case data from a cases module */\nasync function loadCaseFromModule(\n  casesModuleUrl: string,\n  caseId: string,\n): Promise<{ data: unknown; metadata?: Record<string, unknown> }> {\n  logTiming(`Loading case '${caseId}' from ${casesModuleUrl}`);\n  const module = await import(casesModuleUrl);\n  if (typeof module.loadCase === \"function\") {\n    return module.loadCase(caseId);\n  }\n  return { data: caseId };\n}\n\n/** Import benchmark function and optionally run setup */\nasync function importBenchmarkWithSetup(\n  message: RunMessage,\n): Promise<BenchmarkImportResult> {\n  const { modulePath, exportName, setupExportName, params } = message;\n  logTiming(\n    `Importing from ${modulePath}${exportName ? ` (${exportName})` : \"\"}`,\n  );\n  const module = await import(modulePath!);\n\n  const fn = getModuleExport(module, exportName, modulePath!);\n\n  if (setupExportName) {\n    logTiming(`Calling setup: ${setupExportName}`);\n    const setupFn = getModuleExport(module, setupExportName, modulePath!);\n    const setupResult = await setupFn(params);\n    return { fn, params: setupResult };\n  }\n\n  return { fn, params };\n}\n\n/** Get named or default export from module */\nfunction getModuleExport(\n  module: any,\n  exportName: string | undefined,\n  modulePath: string,\n): BenchmarkFunction {\n  const fn = exportName ? module[exportName] : module.default || module;\n  if (typeof fn !== \"function\") {\n    const name = exportName || \"default\";\n    throw new Error(`Export '${name}' from ${modulePath} is not a function`);\n  }\n  return fn;\n}\n\n/** Reconstruct function from string code */\nfunction reconstructFunction(fnCode: string): BenchmarkFunction {\n  // biome-ignore lint/security/noGlobalEval: Necessary for worker process isolation, code is from trusted source\n  const fn = eval(`(${fnCode})`); // eslint-disable-line no-eval\n  if (typeof fn !== \"function\") {\n    throw new Error(\"Reconstructed code is not a function\");\n  }\n  return fn;\n}\n\n/** Create error message from exception */\nfunction createErrorMessage(error: unknown): ErrorMessage {\n  return {\n    type: \"error\",\n    error: error instanceof Error ? error.message : String(error),\n    stack: error instanceof Error ? error.stack : undefined,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"WorkerScript.mjs","names":[],"sources":["../../src/runners/WorkerScript.ts"],"sourcesContent":["#!/usr/bin/env node\nimport type { BenchmarkFunction, BenchmarkSpec } from \"../Benchmark.ts\";\nimport type { HeapProfile } from \"../heap-sample/HeapSampler.ts\";\nimport type { MeasuredResults } from \"../MeasuredResults.ts\";\nimport { variantModuleUrl } from \"../matrix/VariantLoader.ts\";\nimport {\n  type AdaptiveOptions,\n  createAdaptiveWrapper,\n} from \"./AdaptiveWrapper.ts\";\nimport type { RunnerOptions } from \"./BenchRunner.ts\";\nimport { createRunner, type KnownRunner } from \"./CreateRunner.ts\";\nimport { debugWorkerTiming, getElapsed, getPerfNow } from \"./TimingUtils.ts\"; // 5 minutes\n\n/** Message sent to worker process to start a benchmark run. */\nexport interface RunMessage {\n  type: \"run\";\n  spec: BenchmarkSpec;\n  runnerName: KnownRunner;\n  options: RunnerOptions;\n  fnCode?: string; // Made optional - either fnCode or modulePath is required\n  modulePath?: string; // Path to module for dynamic import\n  exportName?: string; // Export name from module\n  setupExportName?: string; // Setup function export name - called once, result passed to fn\n  params?: unknown;\n  // Variant directory mode (BenchMatrix)\n  variantDir?: string; // Directory URL containing variant .ts files\n  variantId?: string; // Variant filename (without .ts)\n  caseData?: unknown; // Data to pass to variant\n  caseId?: string; // Case identifier\n  casesModule?: string; // URL to cases module (exports cases[] and loadCase())\n}\n\n/** Message returned from worker process with benchmark results. */\nexport interface ResultMessage {\n  type: \"result\";\n  results: MeasuredResults[];\n  heapProfile?: HeapProfile;\n}\n\n/** Message returned from worker process when benchmark fails. */\nexport interface ErrorMessage {\n  type: \"error\";\n  error: string;\n  stack?: string;\n}\n\nexport type WorkerMessage = RunMessage | ResultMessage | ErrorMessage;\n\ninterface BenchmarkImportResult {\n  fn: BenchmarkFunction;\n  params: unknown;\n}\n\nconst workerStartTime = getPerfNow();\nconst maxLifetime = 5 * 60 * 1000;\n\n/** Log timing with consistent format */\nconst logTiming = debugWorkerTiming ? _logTiming : () => {};\nfunction _logTiming(operation: string, duration?: number) {\n  if (duration === undefined) {\n    console.log(`[Worker] ${operation}`);\n  } else {\n    console.log(`[Worker] ${operation} ${duration.toFixed(1)}ms`);\n  }\n}\n\n/** Send message and exit with duration log */\nfunction sendAndExit(msg: ResultMessage | ErrorMessage, exitCode: number) {\n  process.send!(msg, undefined, undefined, (err: Error | null): void => {\n    if (err) {\n      const kind = msg.type === \"result\" ? \"results\" : \"error message\";\n      console.error(`[Worker] Error sending ${kind}:`, err);\n    }\n    const suffix = exitCode === 0 ? \"\" : \" (error)\";\n    logTiming(`Total worker duration${suffix}:`, getElapsed(workerStartTime));\n    process.exit(exitCode);\n  });\n}\n\n/** Resolve benchmark function from message (variant dir, module path, or fnCode) */\nasync function resolveBenchmarkFn(\n  message: RunMessage,\n): Promise<BenchmarkImportResult> {\n  if (message.variantDir && message.variantId) {\n    return importVariantModule(message);\n  }\n  if (message.modulePath) {\n    return importBenchmarkWithSetup(message);\n  }\n  return { fn: reconstructFunction(message.fnCode!), params: message.params };\n}\n\n/** Import variant from directory and prepare benchmark function */\nasync function importVariantModule(\n  message: RunMessage,\n): Promise<BenchmarkImportResult> {\n  const { variantDir, variantId, caseId, casesModule } = message;\n  let { caseData } = message;\n  const moduleUrl = variantModuleUrl(variantDir!, variantId!);\n  logTiming(`Importing variant ${variantId} from ${variantDir}`);\n\n  if (casesModule && caseId) {\n    caseData = (await loadCaseFromModule(casesModule, caseId)).data;\n  }\n\n  const module = await import(moduleUrl);\n  const { setup, run } = module;\n\n  if (typeof run !== \"function\") {\n    throw new Error(`Variant '${variantId}' must export 'run' function`);\n  }\n\n  // Stateful variant: setup returns state, run receives state\n  if (typeof setup === \"function\") {\n    logTiming(`Calling setup for ${variantId}`);\n    const state = await setup(caseData);\n    return { fn: () => run(state), params: undefined };\n  }\n\n  // Stateless variant: run receives caseData directly\n  return { fn: () => run(caseData), params: undefined };\n}\n\n/** Import benchmark function and optionally run setup */\nasync function importBenchmarkWithSetup(\n  message: RunMessage,\n): Promise<BenchmarkImportResult> {\n  const { modulePath, exportName, setupExportName, params } = message;\n  logTiming(\n    `Importing from ${modulePath}${exportName ? ` (${exportName})` : \"\"}`,\n  );\n  const module = await import(modulePath!);\n\n  const fn = getModuleExport(module, exportName, modulePath!);\n\n  if (setupExportName) {\n    logTiming(`Calling setup: ${setupExportName}`);\n    const setupFn = getModuleExport(module, setupExportName, modulePath!);\n    const setupResult = await setupFn(params);\n    return { fn, params: setupResult };\n  }\n\n  return { fn, params };\n}\n\n/** Reconstruct function from string code */\nfunction reconstructFunction(fnCode: string): BenchmarkFunction {\n  // biome-ignore lint/security/noGlobalEval: Necessary for worker process isolation, code is from trusted source\n  const fn = eval(`(${fnCode})`); // eslint-disable-line no-eval\n  if (typeof fn !== \"function\") {\n    throw new Error(\"Reconstructed code is not a function\");\n  }\n  return fn;\n}\n\n/** Load case data from a cases module */\nasync function loadCaseFromModule(\n  casesModuleUrl: string,\n  caseId: string,\n): Promise<{ data: unknown; metadata?: Record<string, unknown> }> {\n  logTiming(`Loading case '${caseId}' from ${casesModuleUrl}`);\n  const module = await import(casesModuleUrl);\n  if (typeof module.loadCase === \"function\") {\n    return module.loadCase(caseId);\n  }\n  return { data: caseId };\n}\n\n/** Get named or default export from module */\nfunction getModuleExport(\n  module: any,\n  exportName: string | undefined,\n  modulePath: string,\n): BenchmarkFunction {\n  const fn = exportName ? module[exportName] : module.default || module;\n  if (typeof fn !== \"function\") {\n    const name = exportName || \"default\";\n    throw new Error(`Export '${name}' from ${modulePath} is not a function`);\n  }\n  return fn;\n}\n\n/** Create error message from exception */\nfunction createErrorMessage(error: unknown): ErrorMessage {\n  return {\n    type: \"error\",\n    error: error instanceof Error ? error.message : String(error),\n    stack: error instanceof Error ? error.stack : undefined,\n  };\n}\n\n/**\n * Worker process for isolated benchmark execution.\n * Uses eval() safely in isolated child process with trusted code.\n */\nprocess.on(\"message\", async (message: RunMessage) => {\n  if (message.type !== \"run\") return;\n\n  logTiming(`Processing ${message.spec.name} with ${message.runnerName}`);\n\n  try {\n    const start = getPerfNow();\n    const baseRunner = await createRunner(message.runnerName);\n\n    const runner = (message.options as any).adaptive\n      ? createAdaptiveWrapper(baseRunner, message.options as AdaptiveOptions)\n      : baseRunner;\n\n    logTiming(\"Runner created in\", getElapsed(start));\n\n    const benchStart = getPerfNow();\n\n    // Run with heap sampling if enabled (covers module import + execution)\n    if (message.options.heapSample) {\n      const { withHeapSampling } = await import(\n        \"../heap-sample/HeapSampler.ts\"\n      );\n      const heapOpts = {\n        samplingInterval: message.options.heapInterval,\n        stackDepth: message.options.heapDepth,\n      };\n      const { result: results, profile: heapProfile } = await withHeapSampling(\n        heapOpts,\n        async () => {\n          const { fn, params } = await resolveBenchmarkFn(message);\n          return runner.runBench(\n            { ...message.spec, fn },\n            message.options,\n            params,\n          );\n        },\n      );\n      logTiming(\"Benchmark execution took\", getElapsed(benchStart));\n      sendAndExit({ type: \"result\", results, heapProfile }, 0);\n    } else {\n      const { fn, params } = await resolveBenchmarkFn(message);\n      const results = await runner.runBench(\n        { ...message.spec, fn },\n        message.options,\n        params,\n      );\n      logTiming(\"Benchmark execution took\", getElapsed(benchStart));\n      sendAndExit({ type: \"result\", results }, 0);\n    }\n  } catch (error) {\n    sendAndExit(createErrorMessage(error), 1);\n  }\n});\n\n// Exit after 5 minutes to prevent zombie processes\nsetTimeout(() => {\n  console.error(\"WorkerScript: Maximum lifetime exceeded, exiting\");\n  process.exit(1);\n}, maxLifetime);\n\nprocess.stdin.pause();\n"],"mappings":"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"}