benchforge 0.1.1 → 0.1.3

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-cYpHvc40.mjs";
-import { u as average } from "./TimingUtils-D4z1jpp2.mjs";
+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-JGOI6_Sc.mjs";
+import { o as average } from "./TimingUtils-ClclVQ7E.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 };

package/dist/runners/WorkerScript.d.mts

@@ -0,0 +1,39 @@
+import { a as MeasuredResults, i as BenchmarkSpec, o as HeapProfile, t as RunnerOptions } from "../BenchRunner-BLfGX2wQ.mjs";
+
+//#region src/runners/CreateRunner.d.ts
+type KnownRunner = "basic";
+//#endregion
+//#region src/runners/WorkerScript.d.ts
+/** Message sent to worker process to start a benchmark run. */
+interface RunMessage {
+  type: "run";
+  spec: BenchmarkSpec;
+  runnerName: KnownRunner;
+  options: RunnerOptions;
+  fnCode?: string;
+  modulePath?: string;
+  exportName?: string;
+  setupExportName?: string;
+  params?: unknown;
+  variantDir?: string;
+  variantId?: string;
+  caseData?: unknown;
+  caseId?: string;
+  casesModule?: string;
+}
+/** Message returned from worker process with benchmark results. */
+interface ResultMessage {
+  type: "result";
+  results: MeasuredResults[];
+  heapProfile?: HeapProfile;
+}
+/** Message returned from worker process when benchmark fails. */
+interface ErrorMessage {
+  type: "error";
+  error: string;
+  stack?: string;
+}
+type WorkerMessage = RunMessage | ResultMessage | ErrorMessage;
+//#endregion
+export { ErrorMessage, ResultMessage, RunMessage, WorkerMessage };
+//# sourceMappingURL=WorkerScript.d.mts.map

package/dist/runners/WorkerScript.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { c as createAdaptiveWrapper, i as createRunner, n as getElapsed, p as variantModuleUrl, r as getPerfNow, t as debugWorkerTiming } from "../TimingUtils-D4z1jpp2.mjs";
+import { a as createAdaptiveWrapper, d as variantModuleUrl, i as createRunner, n as getElapsed, r as getPerfNow, t as debugWorkerTiming } from "../TimingUtils-ClclVQ7E.mjs";
 
 //#region src/runners/WorkerScript.ts
 const workerStartTime = getPerfNow();

package/dist/{src-cYpHvc40.mjs → src-JGOI6_Sc.mjs}

@@ -1,4 +1,4 @@
-import { a as BasicRunner, c as createAdaptiveWrapper, d as bootstrapDifferenceCI, f as discoverVariants, i as createRunner, l as msToNs, n as getElapsed, o as computeStats, r as getPerfNow, s as checkConvergence, t as debugWorkerTiming, u as average } from "./TimingUtils-D4z1jpp2.mjs";
+import { a as createAdaptiveWrapper, c as BasicRunner, i as createRunner, l as computeStats, n as getElapsed, o as average, r as getPerfNow, s as bootstrapDifferenceCI, t as debugWorkerTiming, u as discoverVariants } from "./TimingUtils-ClclVQ7E.mjs";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
 import { execSync, fork, spawn } from "node:child_process";
@@ -843,14 +843,11 @@ function injectDiffColumns(reportGroups) {
 
 //#endregion
 //#region src/cli/CliArgs.ts
-const defaultTime = .642;
 const defaultAdaptiveMaxTime = 20;
-const defaultPauseInterval = 0;
-const defaultPauseDuration = 100;
 const cliOptions = {
 	time: {
 		type: "number",
-		default: defaultTime,
+		default: .642,
 		requiresArg: true,
 		describe: "test duration in seconds"
 	},
@@ -892,17 +889,17 @@ const cliOptions = {
 	adaptive: {
 		type: "boolean",
 		default: false,
-		describe: "use adaptive sampling mode"
+		describe: "adaptive sampling (experimental)"
 	},
 	"min-time": {
 		type: "number",
 		default: 1,
-		describe: "minimum time in seconds before adaptive convergence can stop"
+		describe: "minimum time before adaptive convergence can stop"
 	},
 	convergence: {
 		type: "number",
 		default: 95,
-		describe: "confidence threshold (0-100)"
+		describe: "adaptive confidence threshold (0-100)"
 	},
 	warmup: {
 		type: "number",
@@ -945,12 +942,12 @@ const cliOptions = {
 	},
 	"pause-interval": {
 		type: "number",
-		default: defaultPauseInterval,
+		default: 0,
 		describe: "iterations between pauses for V8 optimization (0 to disable)"
 	},
 	"pause-duration": {
 		type: "number",
-		default: defaultPauseDuration,
+		default: 100,
 		describe: "pause duration in ms for V8 optimization"
 	},
 	batches: {
@@ -1012,6 +1009,11 @@ const cliOptions = {
 		type: "number",
 		default: 60,
 		describe: "browser page timeout in seconds"
+	},
+	"chrome-args": {
+		type: "string",
+		requiresArg: true,
+		describe: "extra Chromium flags (space-separated)"
 	}
 };
 /** @return yargs with standard benchmark options */
@@ -1056,10 +1058,13 @@ function browserGcStats(traceEvents) {
 *  Bench function (window.__bench): CLI controls iteration and timing.
 *  Lap mode (__start/__lap/__done): page controls the measured region. */
 async function profileBrowser(params) {
-	const { url, headless = true, timeout = 60 } = params;
+	const { url, headless = true, chromeArgs, timeout = 60 } = params;
 	const { gcStats: collectGc } = params;
 	const { samplingInterval = 32768 } = params.heapOptions ?? {};
-	const browser = await chromium.launch({ headless });
+	const browser = await chromium.launch({
+		headless,
+		args: chromeArgs
+	});
 	try {
 		const page = await browser.newPage();
 		page.setDefaultTimeout(timeout * 1e3);
@@ -2072,13 +2077,12 @@ function formatConvergence(v) {
 
 //#endregion
 //#region src/StandardSections.ts
-/** Section: mean, p50, p99 timing with convergence */
+/** Section: mean, p50, p99 timing */
 const timeSection = {
 	extract: (results) => ({
 		mean: results.time?.avg,
 		p50: results.time?.p50,
-		p99: results.time?.p99,
-		convergence: results.convergence?.confidence
+		p99: results.time?.p99
 	}),
 	columns: () => [{
 		groupTitle: "time",
@@ -2102,11 +2106,7 @@ const timeSection = {
 				comparable: true
 			}
 		]
-	}, { columns: [{
-		key: "convergence",
-		title: "conv%",
-		formatter: formatConvergence
-	}] }]
+	}]
 };
 /** Section: GC time as fraction of total benchmark time (Node performance hooks) */
 const gcSection = {
@@ -2654,7 +2654,6 @@ function mergeResults(results) {
 	const allSamples = results.flatMap((r) => r.samples);
 	const allWarmup = results.flatMap((r) => r.warmupSamples || []);
 	const time = computeStats(allSamples);
-	const convergence = checkConvergence(allSamples.map((s) => s * msToNs));
 	let offset = 0;
 	const allPausePoints = results.flatMap((r) => {
 		const pts = (r.pausePoints ?? []).map((p) => ({
@@ -2670,7 +2669,6 @@ function mergeResults(results) {
 		warmupSamples: allWarmup.length ? allWarmup : void 0,
 		time,
 		totalTime: results.reduce((sum, r) => sum + (r.totalTime || 0), 0),
-		convergence,
 		pausePoints: allPausePoints.length ? allPausePoints : void 0
 	};
 }
@@ -2717,6 +2715,7 @@ async function browserBenchExports(args) {
 			stackDepth: args["heap-depth"]
 		},
 		headless: args.headless,
+		chromeArgs: args["chrome-args"]?.split(/\s+/).filter(Boolean),
 		timeout: args.timeout,
 		gcStats: args["gc-stats"],
 		maxTime: iterations ? Number.MAX_SAFE_INTEGER : time * 1e3,
@@ -3086,4 +3085,4 @@ function getMostRecentModifiedDate(dir) {
 
 //#endregion
 export { timeSection as A, parseCliArgs as B, adaptiveSection as C, gcStatsSection as D, gcSection as E, generateHtmlReport as F, truncate as G, formatBytes as H, formatDateWithTimezone as I, loadCaseData as J, isStatefulVariant as K, prepareHtmlData as L, formatConvergence as M, filterMatrix as N, optSection as O, parseMatrixFilter as P, exportPerfettoTrace as R, reportMatrixResults as S, cpuSection as T, integer as U, reportResults as V, timeMs as W, loadCasesModule as Y, runDefaultMatrixBench as _, cliToMatrixOptions as a, gcStatsColumns as b, exportReports as c, matrixToReportGroups as d, parseBenchArgs as f, runDefaultBench as g, runBenchmarks as h, benchExports as i, totalTimeSection as j, runsSection as k, hasField as l, reportOptStatus as m, getBaselineVersion as n, defaultMatrixReport as o, printHeapReports as p, runMatrix as q, getCurrentGitVersion as r, defaultReport as s, formatGitVersion as t, matrixBenchExports as u, runMatrixSuite as v, buildGenericSections as w, heapTotalColumn as x, gcPauseColumn as y, defaultCliArgs as z };
-//# sourceMappingURL=src-cYpHvc40.mjs.map
+//# sourceMappingURL=src-JGOI6_Sc.mjs.map