benchforge 0.1.4 → 0.1.7

package/dist/{BrowserHeapSampler-DQwmmuDu.mjs → BrowserHeapSampler-DCeL42RE.mjs}

@@ -36,10 +36,12 @@ async function profileBrowser(params) {
 	const { url, headless = true, chromeArgs, timeout = 60 } = params;
 	const { gcStats: collectGc } = params;
 	const { samplingInterval = 32768 } = params.heapOptions ?? {};
-	const browser = await chromium.launch({
+	const server = await chromium.launchServer({
 		headless,
 		args: chromeArgs
 	});
+	pipeChromeOutput(server);
+	const browser = await chromium.connect(server.wsEndpoint());
 	try {
 		const page = await browser.newPage();
 		page.setDefaultTimeout(timeout * 1e3);
@@ -66,6 +68,7 @@ async function profileBrowser(params) {
 		return result;
 	} finally {
 		await browser.close();
+		await server.close();
 	}
 }
 /** Inject __start/__lap as in-page functions, expose __done for results collection.
@@ -181,7 +184,19 @@ async function collectTracing(cdp, traceEvents) {
 	await complete;
 	return browserGcStats(traceEvents);
 }
+/** Forward Chrome's stdout/stderr to the terminal so V8 flag output is visible. */
+function pipeChromeOutput(server) {
+	const proc = server.process();
+	const pipe = (stream) => stream?.on("data", (chunk) => {
+		for (const line of chunk.toString().split("\n")) {
+			const text = line.trim();
+			if (text) process.stderr.write(`[chrome] ${text}\n`);
+		}
+	});
+	pipe(proc.stdout);
+	pipe(proc.stderr);
+}
 
 //#endregion
 export { profileBrowser, profileBrowser as profileBrowserHeap };
-//# sourceMappingURL=BrowserHeapSampler-DQwmmuDu.mjs.map
+//# sourceMappingURL=BrowserHeapSampler-DCeL42RE.mjs.map

package/dist/BrowserHeapSampler-DCeL42RE.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserHeapSampler-DCeL42RE.mjs","names":[],"sources":["../src/browser/BrowserGcStats.ts","../src/browser/BrowserHeapSampler.ts"],"sourcesContent":["import {\n  aggregateGcStats,\n  type GcEvent,\n  type GcStats,\n} from \"../runners/GcStats.ts\";\n\n/** CDP trace event from Tracing.dataCollected */\nexport interface TraceEvent {\n  cat: string;\n  name: string;\n  ph: string;\n  dur?: number; // microseconds\n  args?: Record<string, any>;\n}\n\n/** Parse CDP trace events (MinorGC/MajorGC) into GcEvent[] */\nexport function parseGcTraceEvents(traceEvents: TraceEvent[]): GcEvent[] {\n  return traceEvents.flatMap(e => {\n    if (e.ph !== \"X\") return [];\n    const type = gcType(e.name);\n    if (!type) return [];\n    const durUs = e.dur ?? 0;\n    const heapBefore: number = e.args?.usedHeapSizeBefore ?? 0;\n    const heapAfter: number = e.args?.usedHeapSizeAfter ?? 0;\n    return [\n      {\n        type,\n        pauseMs: durUs / 1000,\n        collected: Math.max(0, heapBefore - heapAfter),\n      },\n    ];\n  });\n}\n\nfunction gcType(name: string): GcEvent[\"type\"] | undefined {\n  if (name === \"MinorGC\") return \"scavenge\";\n  if (name === \"MajorGC\") return \"mark-compact\";\n  return undefined;\n}\n\n/** Parse CDP trace events and aggregate into GcStats */\nexport function browserGcStats(traceEvents: TraceEvent[]): GcStats {\n  return aggregateGcStats(parseGcTraceEvents(traceEvents));\n}\n","import {\n  type BrowserServer,\n  type CDPSession,\n  chromium,\n  type Page,\n} from \"playwright\";\nimport type {\n  HeapProfile,\n  HeapSampleOptions,\n} from \"../heap-sample/HeapSampler.ts\";\nimport type { GcStats } from \"../runners/GcStats.ts\";\nimport { browserGcStats, type TraceEvent } from \"./BrowserGcStats.ts\";\n\nexport interface BrowserProfileParams {\n  url: string;\n  heapSample?: boolean;\n  heapOptions?: HeapSampleOptions;\n  gcStats?: boolean;\n  headless?: boolean;\n  chromeArgs?: string[];\n  timeout?: number; // seconds\n  maxTime?: number; // ms, bench function iteration time limit\n  maxIterations?: number; // exact iteration count (bench function mode)\n}\n\nexport interface BrowserProfileResult {\n  heapProfile?: HeapProfile;\n  gcStats?: GcStats;\n  /** Wall-clock ms (lap mode: first start to done, bench function: total loop) */\n  wallTimeMs?: number;\n  /** Per-iteration timing samples (ms) from bench function or lap mode */\n  samples?: number[];\n}\n\ninterface LapModeHandle {\n  promise: Promise<BrowserProfileResult>;\n  cancel: () => void;\n}\n\n/** Run browser benchmark, auto-detecting page API mode.\n *  Bench function (window.__bench): CLI controls iteration and timing.\n *  Lap mode (__start/__lap/__done): page controls the measured region. */\nexport async function profileBrowser(\n  params: BrowserProfileParams,\n): Promise<BrowserProfileResult> {\n  const { url, headless = true, chromeArgs, timeout = 60 } = params;\n  const { gcStats: collectGc } = params;\n  const { samplingInterval = 32768 } = params.heapOptions ?? {};\n\n  const server = await chromium.launchServer({ headless, args: chromeArgs });\n  pipeChromeOutput(server);\n  const browser = await chromium.connect(server.wsEndpoint());\n  try {\n    const page = await browser.newPage();\n    page.setDefaultTimeout(timeout * 1000);\n    const cdp = await page.context().newCDPSession(page);\n\n    const pageErrors: string[] = [];\n    page.on(\"pageerror\", err => pageErrors.push(err.message));\n\n    const traceEvents = collectGc ? await startGcTracing(cdp) : [];\n    const lapMode = await setupLapMode(\n      page,\n      cdp,\n      params,\n      samplingInterval,\n      timeout,\n      pageErrors,\n    );\n\n    await page.goto(url, { waitUntil: \"load\" });\n    const hasBench = await page.evaluate(\n      () => typeof (globalThis as any).__bench === \"function\",\n    );\n\n    let result: BrowserProfileResult;\n    if (hasBench) {\n      lapMode.cancel();\n      lapMode.promise.catch(() => {}); // suppress unused rejection\n      result = await runBenchLoop(page, cdp, params, samplingInterval);\n    } else {\n      result = await lapMode.promise;\n      lapMode.cancel();\n    }\n\n    if (collectGc) {\n      result = { ...result, gcStats: await collectTracing(cdp, traceEvents) };\n    }\n    return result;\n  } finally {\n    await browser.close();\n    await server.close();\n  }\n}\n\n/** Inject __start/__lap as in-page functions, expose __done for results collection.\n *  __start/__lap are pure in-page (zero CDP overhead). First __start() triggers\n *  instrument start. __done() stops instruments and collects timing data. */\nasync function setupLapMode(\n  page: Page,\n  cdp: CDPSession,\n  params: BrowserProfileParams,\n  samplingInterval: number,\n  timeout: number,\n  pageErrors: string[],\n): Promise<LapModeHandle> {\n  const { heapSample } = params;\n  const { promise, resolve, reject } =\n    Promise.withResolvers<BrowserProfileResult>();\n  let instrumentsStarted = false;\n\n  await page.exposeFunction(\"__benchInstrumentStart\", async () => {\n    if (instrumentsStarted) return;\n    instrumentsStarted = true;\n    if (heapSample) {\n      await cdp.send(\n        \"HeapProfiler.startSampling\",\n        heapSamplingParams(samplingInterval),\n      );\n    }\n  });\n\n  await page.exposeFunction(\n    \"__benchCollect\",\n    async (samples: number[], wallTimeMs: number) => {\n      let heapProfile: HeapProfile | undefined;\n      if (heapSample && instrumentsStarted) {\n        const result = await cdp.send(\"HeapProfiler.stopSampling\");\n        heapProfile = result.profile as unknown as HeapProfile;\n      }\n      resolve({ samples, heapProfile, wallTimeMs });\n    },\n  );\n\n  await page.addInitScript(injectLapFunctions);\n\n  const timer = setTimeout(() => {\n    const lines = [`Timed out after ${timeout}s`];\n    if (pageErrors.length) {\n      lines.push(\"Page JS errors:\", ...pageErrors.map(e => `  ${e}`));\n    } else {\n      lines.push(\"Page did not call __done() or define window.__bench\");\n    }\n    reject(new Error(lines.join(\"\\n\")));\n  }, timeout * 1000);\n\n  return { promise, cancel: () => clearTimeout(timer) };\n}\n\n/** In-page timing functions injected via addInitScript (zero CDP overhead).\n *  __start/__lap collect timestamps, __done delegates to exposed __benchCollect. */\nfunction injectLapFunctions(): void {\n  const g = globalThis as any;\n  g.__benchSamples = [];\n  g.__benchLastTime = 0;\n  g.__benchFirstStart = 0;\n\n  g.__start = () => {\n    const now = performance.now();\n    g.__benchLastTime = now;\n    if (!g.__benchFirstStart) {\n      g.__benchFirstStart = now;\n      return g.__benchInstrumentStart();\n    }\n  };\n\n  g.__lap = () => {\n    const now = performance.now();\n    g.__benchSamples.push(now - g.__benchLastTime);\n    g.__benchLastTime = now;\n  };\n\n  g.__done = () => {\n    const wall = g.__benchFirstStart\n      ? performance.now() - g.__benchFirstStart\n      : 0;\n    return g.__benchCollect(g.__benchSamples.slice(), wall);\n  };\n}\n\nfunction heapSamplingParams(samplingInterval: number) {\n  return {\n    samplingInterval,\n    includeObjectsCollectedByMajorGC: true,\n    includeObjectsCollectedByMinorGC: true,\n  };\n}\n\n/** Start CDP GC tracing, returns the event collector array. */\nasync function startGcTracing(cdp: CDPSession): Promise<TraceEvent[]> {\n  const events: TraceEvent[] = [];\n  cdp.on(\"Tracing.dataCollected\", ({ value }) => {\n    for (const e of value) events.push(e as unknown as TraceEvent);\n  });\n  await cdp.send(\"Tracing.start\", {\n    traceConfig: { includedCategories: [\"v8\", \"v8.gc\"] },\n  });\n  return events;\n}\n\n/** Bench function mode: run window.__bench in a timed iteration loop. */\nasync function runBenchLoop(\n  page: Page,\n  cdp: CDPSession,\n  params: BrowserProfileParams,\n  samplingInterval: number,\n): Promise<BrowserProfileResult> {\n  const { heapSample } = params;\n  const maxTime = params.maxTime ?? 642;\n  const maxIter = params.maxIterations ?? Number.MAX_SAFE_INTEGER;\n\n  if (heapSample) {\n    await cdp.send(\n      \"HeapProfiler.startSampling\",\n      heapSamplingParams(samplingInterval),\n    );\n  }\n\n  const { samples, totalMs } = await page.evaluate(\n    async ({ maxTime, maxIter }) => {\n      const bench = (globalThis as any).__bench;\n      const samples: number[] = [];\n      const startAll = performance.now();\n      const deadline = startAll + maxTime;\n      for (let i = 0; i < maxIter && performance.now() < deadline; i++) {\n        const t0 = performance.now();\n        await bench();\n        samples.push(performance.now() - t0);\n      }\n      return { samples, totalMs: performance.now() - startAll };\n    },\n    { maxTime, maxIter },\n  );\n\n  let heapProfile: HeapProfile | undefined;\n  if (heapSample) {\n    const result = await cdp.send(\"HeapProfiler.stopSampling\");\n    heapProfile = result.profile as unknown as HeapProfile;\n  }\n\n  return { samples, heapProfile, wallTimeMs: totalMs };\n}\n\n/** Stop CDP tracing and parse GC events into GcStats. */\nasync function collectTracing(\n  cdp: CDPSession,\n  traceEvents: TraceEvent[],\n): Promise<GcStats> {\n  const complete = new Promise<void>(resolve =>\n    cdp.once(\"Tracing.tracingComplete\", () => resolve()),\n  );\n  await cdp.send(\"Tracing.end\");\n  await complete;\n  return browserGcStats(traceEvents);\n}\n\n/** Forward Chrome's stdout/stderr to the terminal so V8 flag output is visible. */\nfunction pipeChromeOutput(server: BrowserServer): void {\n  const proc = server.process();\n  const pipe = (stream: NodeJS.ReadableStream | null) =>\n    stream?.on(\"data\", (chunk: Buffer) => {\n      for (const line of chunk.toString().split(\"\\n\")) {\n        const text = line.trim();\n        if (text) process.stderr.write(`[chrome] ${text}\\n`);\n      }\n    });\n  pipe(proc.stdout);\n  pipe(proc.stderr);\n}\n\nexport { profileBrowser as profileBrowserHeap };\n"],"mappings":"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"}

package/dist/bin/benchforge.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { g as runDefaultBench } from "../src-B06_i1RD.mjs";
+import { g as runDefaultBench } from "../src-BpTzMiyo.mjs";
 
 //#region src/bin/benchforge.ts
 await runDefaultBench();

package/dist/index.d.mts

@@ -308,8 +308,9 @@ declare const cliOptions: {
   };
   readonly "chrome-args": {
     readonly type: "string";
+    readonly array: true;
     readonly requiresArg: true;
-    readonly describe: "extra Chromium flags (space-separated)";
+    readonly describe: "extra Chromium flags";
   };
 };
 /** @return yargs with standard benchmark options */

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-B06_i1RD.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-BpTzMiyo.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/{src-B06_i1RD.mjs → src-BpTzMiyo.mjs}

@@ -937,8 +937,9 @@ const cliOptions = {
 	},
 	"chrome-args": {
 		type: "string",
+		array: true,
 		requiresArg: true,
-		describe: "extra Chromium flags (space-separated)"
+		describe: "extra Chromium flags"
 	}
 };
 /** @return yargs with standard benchmark options */
@@ -2428,14 +2429,11 @@ function defaultReport(groups, args) {
 }
 /** Build report sections based on CLI options */
 function buildReportSections(adaptive, gcStats, hasCpuData, hasOptData) {
-	const sections = adaptive ? [
-		adaptiveSection,
-		runsSection,
-		totalTimeSection
-	] : [timeSection, runsSection];
+	const sections = adaptive ? [adaptiveSection, totalTimeSection] : [timeSection];
 	if (gcStats) sections.push(gcStatsSection);
 	if (hasCpuData) sections.push(cpuSection);
 	if (hasOptData) sections.push(optSection);
+	sections.push(runsSection);
 	return sections;
 }
 /** Run benchmarks, display table, and optionally generate HTML report */
@@ -2450,7 +2448,7 @@ async function browserBenchExports(args) {
 	warnBrowserFlags(args);
 	let profileBrowser;
 	try {
-		({profileBrowser} = await import("./BrowserHeapSampler-DQwmmuDu.mjs"));
+		({profileBrowser} = await import("./BrowserHeapSampler-DCeL42RE.mjs"));
 	} catch {
 		throw new Error("playwright is required for browser benchmarking (--url).\n\nQuick start:  npx benchforge-browser --url <your-url>\n\nOr install manually:\n  npm install playwright\n  npx playwright install chromium");
 	}
@@ -2464,25 +2462,31 @@ async function browserBenchExports(args) {
 			stackDepth: args["heap-depth"]
 		},
 		headless: args.headless,
-		chromeArgs: args["chrome-args"]?.split(/\s+/).filter(Boolean),
+		chromeArgs: args["chrome-args"]?.flatMap((a) => a.split(/\s+/)).map(stripQuotes).filter(Boolean),
 		timeout: args.timeout,
 		gcStats: args["gc-stats"],
 		maxTime: iterations ? Number.MAX_SAFE_INTEGER : time * 1e3,
 		maxIterations: iterations
 	});
-	const name = new URL(url).pathname.split("/").pop() || "browser";
+	const results = browserResultGroups(new URL(url).pathname.split("/").pop() || "browser", result);
+	printBrowserReport(result, results, args);
+	await exportReports({
+		results,
+		args
+	});
+}
+/** Print browser benchmark tables and heap reports */
+function printBrowserReport(result, results, args) {
 	const hasSamples = result.samples && result.samples.length > 0;
-	const results = browserResultGroups(name, result);
-	if (hasSamples || result.wallTimeMs != null) console.log(reportResults(results, [timeSection, runsSection]));
-	if (result.gcStats) console.log(reportResults(results, [browserGcStatsSection]));
+	const sections = [];
+	if (hasSamples || result.wallTimeMs != null) sections.push(timeSection);
+	if (result.gcStats) sections.push(browserGcStatsSection);
+	if (hasSamples || result.wallTimeMs != null) sections.push(runsSection);
+	if (sections.length > 0) console.log(reportResults(results, sections));
 	if (result.heapProfile) printHeapReports(results, {
 		...cliHeapReportOptions(args),
 		isUserCode: isBrowserUserCode
 	});
-	await exportReports({
-		results,
-		args
-	});
 }
 /** Wrap browser profile result as ReportGroup[] for the standard pipeline */
 function browserResultGroups(name, result) {
@@ -2760,6 +2764,14 @@ function matrixToReportGroups(results) {
 		};
 	})));
 }
+/** Strip matching surrounding quotes from a string.
+*
+* (Needed because --chrome-args values like --js-flags="--help" pass through
+* yargs and spawn() without shell processing.)
+*/
+function stripQuotes(s) {
+	return s.replace(/^(['"])(.*)\1$/s, "$2");
+}
 /** Sequential map - like Promise.all(arr.map(fn)) but runs one at a time */
 async function serialMap(arr, fn) {
 	const results = [];
@@ -2834,4 +2846,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-B06_i1RD.mjs.map
+//# sourceMappingURL=src-BpTzMiyo.mjs.map