benchforge 0.1.11 → 0.2.4

package/src/viewer/shell.css

@@ -0,0 +1,357 @@
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+:root {
+  --tab-bar-bg: #f8f8f8;
+  --tab-border: #ccc;
+  --tab-color: #999;
+  --tab-active-color: #222;
+  --tab-accent: #5f61d8;
+  --body-bg: #fff;
+  --source-bg: #fff;
+  --source-color: #333;
+  --source-highlight: #fffbdd;
+  --source-line-color: #999;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme="light"]) {
+    --tab-bar-bg: #1e1e1e;
+    --tab-border: #555;
+    --tab-color: #999;
+    --tab-active-color: #fff;
+    --tab-accent: #7b7dea;
+    --body-bg: #181818;
+    --source-bg: #1e1e1e;
+    --source-color: #d4d4d4;
+    --source-highlight: #3a3a00;
+    --source-line-color: #666;
+  }
+}
+
+:root[data-theme="dark"] {
+  --tab-bar-bg: #1e1e1e;
+  --tab-border: #555;
+  --tab-color: #999;
+  --tab-active-color: #fff;
+  --tab-accent: #7b7dea;
+  --body-bg: #181818;
+  --source-bg: #1e1e1e;
+  --source-color: #d4d4d4;
+  --source-highlight: #3a3a00;
+  --source-line-color: #666;
+}
+
+html, body {
+  height: 100%;
+  background: var(--body-bg);
+  font-family: system-ui, sans-serif;
+  color: var(--source-color);
+}
+
+body { display: flex; flex-direction: column; }
+#app { display: contents; }
+
+.tab-bar {
+  display: flex;
+  align-items: center;
+  gap: 0;
+  padding: 6px 8px;
+  background: var(--tab-bar-bg);
+  flex-shrink: 0;
+  position: relative;
+  z-index: 10;
+}
+
+.tab-bar::after {
+  content: "";
+  position: absolute;
+  bottom: 0;
+  left: 0;
+  right: 0;
+  height: 1px;
+  background: var(--tab-border);
+}
+
+.tab {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  padding: 5px 12px;
+  background: transparent;
+  border: none;
+  border-radius: 0;
+  color: var(--tab-color);
+  cursor: pointer;
+  position: relative;
+  font-size: 13px;
+  font-family: system-ui, sans-serif;
+  white-space: nowrap;
+}
+
+.tab:hover:not(:disabled) { color: var(--tab-active-color); }
+
+.tab:disabled {
+  opacity: 0.4;
+  cursor: not-allowed;
+}
+
+.tab.active {
+  color: var(--tab-accent);
+  font-weight: 600;
+  padding-bottom: calc(5px + 6px + 0.5px);
+  margin-bottom: calc(-1 * (6px + 0.5px));
+  position: relative;
+  z-index: 1;
+  border-bottom: 2px solid var(--tab-accent);
+}
+
+.tab .tab-close {
+  width: 16px;
+  height: 16px;
+  padding: 0;
+  border: none;
+  background: transparent;
+  color: inherit;
+  cursor: pointer;
+  opacity: 0;
+  font-size: 16px;
+  line-height: 1;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.tab:hover .tab-close { opacity: 0.6; }
+.tab .tab-close:hover { opacity: 1; }
+
+.tab-spacer { flex: 1; }
+
+.theme-toggle { display: flex; align-items: center; gap: 2px; margin-right: 8px; }
+
+.theme-btn {
+  background: none;
+  border: none;
+  cursor: pointer;
+  padding: 4px;
+  border-radius: 4px;
+  color: var(--tab-color);
+  opacity: 0.6;
+  display: flex;
+  align-items: center;
+}
+.theme-btn:hover { opacity: 1; }
+.theme-btn.active {
+  color: var(--tab-accent);
+  opacity: 1;
+  background: color-mix(in srgb, var(--tab-accent) 15%, transparent);
+}
+
+.archive-btn {
+  font-size: 12px;
+  color: var(--tab-color);
+  opacity: 0.8;
+}
+.archive-btn:hover { opacity: 1; }
+
+.tab-content {
+  flex: 1;
+  position: relative;
+  min-height: 0;
+}
+
+#speedscope-iframe,
+#time-speedscope-iframe {
+  width: 100%;
+  height: calc(100% - 20px);
+  border: none;
+  position: absolute;
+  top: 20px;
+  left: 0;
+}
+
+.source-panel {
+  position: absolute;
+  top: 0; left: 0; right: 0; bottom: 0;
+  overflow: auto;
+  background: var(--source-bg);
+  padding: 0 24px 16px;
+  display: none;
+}
+
+.source-panel.active { display: block; }
+
+.source-header {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  padding: 10px 0;
+  border-bottom: 1px solid var(--tab-border);
+  margin-bottom: 8px;
+  font-family: system-ui, sans-serif;
+  font-size: 13px;
+}
+
+.source-path {
+  color: var(--tab-color);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  flex: 1;
+}
+
+.source-editor-link {
+  color: var(--tab-accent);
+  text-decoration: none;
+  white-space: nowrap;
+  font-size: 12px;
+}
+.source-editor-link:hover { text-decoration: underline; }
+
+.source-code pre {
+  margin: 0;
+  counter-reset: line;
+  font-family: ui-monospace, "SF Mono", "Cascadia Code", Menlo, Consolas, monospace;
+  font-size: 13px;
+  line-height: 1.6;
+  white-space: normal;
+}
+
+.source-code code {
+  white-space: normal;
+}
+
+.source-code .line {
+  display: block;
+  counter-increment: line;
+  padding: 0 16px 0 60px;
+  position: relative;
+  white-space: pre;
+}
+
+.source-code .line::before {
+  content: counter(line);
+  position: absolute;
+  left: 0;
+  width: 48px;
+  text-align: right;
+  color: var(--source-line-color);
+  font-size: 12px;
+  user-select: none;
+  padding-right: 8px;
+}
+
+.source-code .line.highlighted {
+  background: var(--source-highlight);
+}
+
+.source-code .line .gutter.heat {
+  background: rgba(234, 179, 8, calc(var(--heat, 0) * 0.18));
+}
+
+.source-code .line .gutter {
+  display: inline-block;
+  width: 64px;
+  text-align: right;
+  font-size: 11px;
+  padding-right: 8px;
+  user-select: none;
+  opacity: 0.85;
+}
+
+.source-code .line .gutter:last-of-type {
+  margin-right: 8px;
+}
+
+.source-code .line .gutter-count { color: #888; }
+.source-code .line .gutter-alloc { color: #b45309; }
+.source-code .line .gutter-time  { color: #2563eb; }
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme="light"]) .source-code .line .gutter.heat {
+    background: rgba(234, 179, 8, calc(var(--heat, 0) * 0.12));
+  }
+  :root:not([data-theme="light"]) .source-code .line .gutter-count { color: #aaa; }
+  :root:not([data-theme="light"]) .source-code .line .gutter-alloc { color: #fbbf24; }
+  :root:not([data-theme="light"]) .source-code .line .gutter-time  { color: #60a5fa; }
+}
+
+:root[data-theme="dark"] .source-code .line .gutter.heat {
+  background: rgba(234, 179, 8, calc(var(--heat, 0) * 0.12));
+}
+:root[data-theme="dark"] .source-code .line .gutter-count { color: #aaa; }
+:root[data-theme="dark"] .source-code .line .gutter-alloc { color: #fbbf24; }
+:root[data-theme="dark"] .source-code .line .gutter-time  { color: #60a5fa; }
+
+/* Shiki dual-theme wiring */
+.shiki { color: var(--shiki-light); background-color: var(--shiki-light-bg); }
+.shiki span { color: var(--shiki-light); }
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme="light"]) .shiki { color: var(--shiki-dark); background-color: var(--shiki-dark-bg); }
+  :root:not([data-theme="light"]) .shiki span { color: var(--shiki-dark); }
+}
+
+:root[data-theme="dark"] .shiki { color: var(--shiki-dark); background-color: var(--shiki-dark-bg); }
+:root[data-theme="dark"] .shiki span { color: var(--shiki-dark); }
+
+.source-placeholder {
+  color: var(--tab-color);
+  font-family: system-ui, sans-serif;
+  font-size: 14px;
+  padding-top: 16px;
+}
+
+.source-placeholder code {
+  background: var(--tab-border);
+  padding: 2px 6px;
+  border-radius: 3px;
+  font-size: 13px;
+}
+
+/* Drop zone (hosted viewer mode) */
+
+.drop-zone {
+  position: fixed;
+  inset: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: var(--body-bg);
+  z-index: 100;
+}
+
+.drop-zone.drag-over { background: var(--tab-bar-bg); }
+
+.drop-zone-content {
+  text-align: center;
+  color: var(--source-color);
+}
+
+.drop-zone-content h2 { margin: 16px 0 8px; font-size: 24px; }
+.drop-zone-content p { color: var(--tab-color); margin: 8px 0; }
+
+.drop-zone-content code {
+  background: var(--tab-border);
+  padding: 2px 6px;
+  border-radius: 3px;
+  font-size: 13px;
+}
+
+.drop-zone-divider {
+  color: var(--tab-color);
+  margin: 16px 0;
+  font-size: 13px;
+}
+
+.drop-zone-browse {
+  display: inline-block;
+  padding: 8px 20px;
+  background: var(--tab-accent);
+  color: white;
+  border-radius: 6px;
+  cursor: pointer;
+  font-size: 14px;
+}
+
+.drop-zone-browse:hover { opacity: 0.9; }
+p.drop-zone-error { color: #ef4444; margin-top: 5em; }

package/src/viewer/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "jsxImportSource": "preact",
+    "lib": ["ESNext", "DOM", "DOM.Iterable"],
+    "isolatedDeclarations": false
+  },
+  "include": ["**/*.ts", "**/*.tsx"],
+  "exclude": []
+}

package/dist/BrowserHeapSampler-B6asLKWQ.mjs

@@ -1,202 +0,0 @@
-import { t as aggregateGcStats } from "./GcStats-wX7Xyblu.mjs";
-import { chromium } from "playwright";
-
-//#region src/browser/BrowserGcStats.ts
-/** Parse CDP trace events (MinorGC/MajorGC) into GcEvent[] */
-function parseGcTraceEvents(traceEvents) {
-	return traceEvents.flatMap((e) => {
-		if (e.ph !== "X") return [];
-		const type = gcType(e.name);
-		if (!type) return [];
-		const durUs = e.dur ?? 0;
-		const heapBefore = e.args?.usedHeapSizeBefore ?? 0;
-		const heapAfter = e.args?.usedHeapSizeAfter ?? 0;
-		return [{
-			type,
-			pauseMs: durUs / 1e3,
-			collected: Math.max(0, heapBefore - heapAfter)
-		}];
-	});
-}
-/** Parse CDP trace events and aggregate into GcStats */
-function browserGcStats(traceEvents) {
-	return aggregateGcStats(parseGcTraceEvents(traceEvents));
-}
-function gcType(name) {
-	if (name === "MinorGC") return "scavenge";
-	if (name === "MajorGC") return "mark-compact";
-}
-
-//#endregion
-//#region src/browser/BrowserHeapSampler.ts
-/** Run browser benchmark, auto-detecting page API mode.
-*  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, chromeArgs, timeout = 60 } = params;
-	const { gcStats: collectGc } = params;
-	const { samplingInterval = 32768 } = params.heapOptions ?? {};
-	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);
-		const cdp = await page.context().newCDPSession(page);
-		const pageErrors = [];
-		page.on("pageerror", (err) => pageErrors.push(err.message));
-		const traceEvents = collectGc ? await startGcTracing(cdp) : [];
-		const lapMode = await setupLapMode(page, cdp, params, samplingInterval, timeout, pageErrors);
-		await page.goto(url, { waitUntil: "load" });
-		const hasBench = await page.evaluate(() => typeof globalThis.__bench === "function");
-		let result;
-		if (hasBench) {
-			lapMode.cancel();
-			lapMode.promise.catch(() => {});
-			result = await runBenchLoop(page, cdp, params, samplingInterval);
-		} else {
-			result = await lapMode.promise;
-			lapMode.cancel();
-		}
-		if (collectGc) result = {
-			...result,
-			gcStats: await collectTracing(cdp, traceEvents)
-		};
-		return result;
-	} finally {
-		await browser.close();
-		await server.close();
-	}
-}
-/** 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);
-}
-/** Start CDP GC tracing, returns the event collector array. */
-async function startGcTracing(cdp) {
-	const events = [];
-	cdp.on("Tracing.dataCollected", ({ value }) => {
-		for (const e of value) events.push(e);
-	});
-	await cdp.send("Tracing.start", { traceConfig: { includedCategories: ["v8", "v8.gc"] } });
-	return events;
-}
-/** Inject __start/__lap as in-page functions, expose __done for results collection.
-*  __start/__lap are pure in-page (zero CDP overhead). First __start() triggers
-*  instrument start. __done() stops instruments and collects timing data. */
-async function setupLapMode(page, cdp, params, samplingInterval, timeout, pageErrors) {
-	const { heapSample } = params;
-	const { promise, resolve, reject } = Promise.withResolvers();
-	let instrumentsStarted = false;
-	await page.exposeFunction("__benchInstrumentStart", async () => {
-		if (instrumentsStarted) return;
-		instrumentsStarted = true;
-		if (heapSample) await cdp.send("HeapProfiler.startSampling", heapSamplingParams(samplingInterval));
-	});
-	await page.exposeFunction("__benchCollect", async (samples, wallTimeMs) => {
-		let heapProfile;
-		if (heapSample && instrumentsStarted) heapProfile = (await cdp.send("HeapProfiler.stopSampling")).profile;
-		resolve({
-			samples,
-			heapProfile,
-			wallTimeMs
-		});
-	});
-	await page.addInitScript(injectLapFunctions);
-	const timer = setTimeout(() => {
-		const lines = [`Timed out after ${timeout}s`];
-		if (pageErrors.length) lines.push("Page JS errors:", ...pageErrors.map((e) => `  ${e}`));
-		else lines.push("Page did not call __done() or define window.__bench");
-		reject(new Error(lines.join("\n")));
-	}, timeout * 1e3);
-	return {
-		promise,
-		cancel: () => clearTimeout(timer)
-	};
-}
-/** Bench function mode: run window.__bench in a timed iteration loop. */
-async function runBenchLoop(page, cdp, params, samplingInterval) {
-	const { heapSample } = params;
-	const maxTime = params.maxTime ?? 642;
-	const maxIter = params.maxIterations ?? Number.MAX_SAFE_INTEGER;
-	if (heapSample) await cdp.send("HeapProfiler.startSampling", heapSamplingParams(samplingInterval));
-	const { samples, totalMs } = await page.evaluate(async ({ maxTime, maxIter }) => {
-		const bench = globalThis.__bench;
-		const samples = [];
-		const startAll = performance.now();
-		const deadline = startAll + maxTime;
-		for (let i = 0; i < maxIter && performance.now() < deadline; i++) {
-			const t0 = performance.now();
-			await bench();
-			samples.push(performance.now() - t0);
-		}
-		return {
-			samples,
-			totalMs: performance.now() - startAll
-		};
-	}, {
-		maxTime,
-		maxIter
-	});
-	let heapProfile;
-	if (heapSample) heapProfile = (await cdp.send("HeapProfiler.stopSampling")).profile;
-	return {
-		samples,
-		heapProfile,
-		wallTimeMs: totalMs
-	};
-}
-/** Stop CDP tracing and parse GC events into GcStats. */
-async function collectTracing(cdp, traceEvents) {
-	const complete = new Promise((resolve) => cdp.once("Tracing.tracingComplete", () => resolve()));
-	await cdp.send("Tracing.end");
-	await complete;
-	return browserGcStats(traceEvents);
-}
-function heapSamplingParams(samplingInterval) {
-	return {
-		samplingInterval,
-		includeObjectsCollectedByMajorGC: true,
-		includeObjectsCollectedByMinorGC: true
-	};
-}
-/** In-page timing functions injected via addInitScript (zero CDP overhead).
-*  __start/__lap collect timestamps, __done delegates to exposed __benchCollect. */
-function injectLapFunctions() {
-	const g = globalThis;
-	g.__benchSamples = [];
-	g.__benchLastTime = 0;
-	g.__benchFirstStart = 0;
-	g.__start = () => {
-		const now = performance.now();
-		g.__benchLastTime = now;
-		if (!g.__benchFirstStart) {
-			g.__benchFirstStart = now;
-			return g.__benchInstrumentStart();
-		}
-	};
-	g.__lap = () => {
-		const now = performance.now();
-		g.__benchSamples.push(now - g.__benchLastTime);
-		g.__benchLastTime = now;
-	};
-	g.__done = () => {
-		const wall = g.__benchFirstStart ? performance.now() - g.__benchFirstStart : 0;
-		return g.__benchCollect(g.__benchSamples.slice(), wall);
-	};
-}
-
-//#endregion
-export { profileBrowser, profileBrowser as profileBrowserHeap };
-//# sourceMappingURL=BrowserHeapSampler-B6asLKWQ.mjs.map

package/dist/BrowserHeapSampler-B6asLKWQ.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"BrowserHeapSampler-B6asLKWQ.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\n/** Parse CDP trace events and aggregate into GcStats */\nexport function browserGcStats(traceEvents: TraceEvent[]): GcStats {\n  return aggregateGcStats(parseGcTraceEvents(traceEvents));\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","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/** 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\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/** 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/** 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\nfunction heapSamplingParams(samplingInterval: number) {\n  return {\n    samplingInterval,\n    includeObjectsCollectedByMajorGC: true,\n    includeObjectsCollectedByMinorGC: true,\n  };\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\nexport { profileBrowser as profileBrowserHeap };\n"],"mappings":"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"}

package/dist/GcStats-wX7Xyblu.mjs

@@ -1,77 +0,0 @@
-//#region src/runners/GcStats.ts
-/** Parse a single --trace-gc-nvp stderr line */
-function parseGcLine(line) {
-	if (!line.includes("pause=")) return void 0;
-	const fields = parseNvpFields(line);
-	if (!fields.gc) return void 0;
-	const int = (k) => Number.parseInt(fields[k] || "0", 10);
-	const type = parseGcType(fields.gc);
-	const pauseMs = Number.parseFloat(fields.pause || "0");
-	const allocated = int("allocated");
-	const promoted = int("promoted");
-	const survived = int("new_space_survived") || int("survived");
-	const startSize = int("start_object_size");
-	const endSize = int("end_object_size");
-	const collected = startSize > endSize ? startSize - endSize : 0;
-	if (Number.isNaN(pauseMs)) return void 0;
-	return {
-		type,
-		pauseMs,
-		allocated,
-		collected,
-		promoted,
-		survived
-	};
-}
-/** Aggregate GC events into summary stats */
-function aggregateGcStats(events) {
-	let scavenges = 0;
-	let markCompacts = 0;
-	let gcPauseTime = 0;
-	let totalCollected = 0;
-	let hasNodeFields = false;
-	let totalAllocated = 0;
-	let totalPromoted = 0;
-	let totalSurvived = 0;
-	for (const e of events) {
-		if (e.type === "scavenge" || e.type === "minor-ms") scavenges++;
-		else if (e.type === "mark-compact") markCompacts++;
-		gcPauseTime += e.pauseMs;
-		totalCollected += e.collected;
-		if (e.allocated != null) {
-			hasNodeFields = true;
-			totalAllocated += e.allocated;
-			totalPromoted += e.promoted ?? 0;
-			totalSurvived += e.survived ?? 0;
-		}
-	}
-	return {
-		scavenges,
-		markCompacts,
-		totalCollected,
-		gcPauseTime,
-		...hasNodeFields && {
-			totalAllocated,
-			totalPromoted,
-			totalSurvived
-		}
-	};
-}
-/** Parse name=value pairs from trace-gc-nvp line */
-function parseNvpFields(line) {
-	const fields = {};
-	const matches = line.matchAll(/(\w+)=([^\s,]+)/g);
-	for (const [, key, value] of matches) fields[key] = value;
-	return fields;
-}
-/** Map V8 gc type codes to our types */
-function parseGcType(gcField) {
-	if (gcField === "s" || gcField === "scavenge") return "scavenge";
-	if (gcField === "mc" || gcField === "ms" || gcField === "mark-compact") return "mark-compact";
-	if (gcField === "mmc" || gcField === "minor-mc" || gcField === "minor-ms") return "minor-ms";
-	return "unknown";
-}
-
-//#endregion
-export { parseGcLine as n, aggregateGcStats as t };
-//# sourceMappingURL=GcStats-wX7Xyblu.mjs.map

package/dist/GcStats-wX7Xyblu.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"GcStats-wX7Xyblu.mjs","names":[],"sources":["../src/runners/GcStats.ts"],"sourcesContent":["/** GC statistics aggregated from V8 trace events.\n *  Node (--trace-gc-nvp) provides all fields.\n *  Browser (CDP Tracing) provides counts, collected, and pause only. */\nexport interface GcStats {\n  scavenges: number;\n  markCompacts: number;\n  totalCollected: number; // bytes freed\n  gcPauseTime: number; // total pause time (ms)\n  totalAllocated?: number; // bytes allocated (Node only)\n  totalPromoted?: number; // bytes promoted to old gen (Node only)\n  totalSurvived?: number; // bytes survived in young gen (Node only)\n}\n\n/** Single GC event. Node provides all fields; browser provides type, pauseMs, collected. */\nexport interface GcEvent {\n  type: \"scavenge\" | \"mark-compact\" | \"minor-ms\" | \"unknown\";\n  pauseMs: number;\n  collected: number;\n  allocated?: number; // Node only\n  promoted?: number; // Node only\n  survived?: number; // Node only\n}\n\n/** Parse a single --trace-gc-nvp stderr line */\nexport function parseGcLine(line: string): GcEvent | undefined {\n  // V8 format: [pid:addr:gen] N ms: pause=X gc=s ... allocated=N promoted=N ...\n  if (!line.includes(\"pause=\")) return undefined;\n\n  const fields = parseNvpFields(line);\n  if (!fields.gc) return undefined;\n\n  const int = (k: string) => Number.parseInt(fields[k] || \"0\", 10);\n  const type = parseGcType(fields.gc);\n  const pauseMs = Number.parseFloat(fields.pause || \"0\");\n  const allocated = int(\"allocated\");\n  const promoted = int(\"promoted\");\n  // V8 uses \"new_space_survived\" not \"survived\"\n  const survived = int(\"new_space_survived\") || int(\"survived\");\n  // Calculate collected from start/end object size if available\n  const startSize = int(\"start_object_size\");\n  const endSize = int(\"end_object_size\");\n  const collected = startSize > endSize ? startSize - endSize : 0;\n\n  if (Number.isNaN(pauseMs)) return undefined;\n\n  return { type, pauseMs, allocated, collected, promoted, survived };\n}\n\n/** Aggregate GC events into summary stats */\nexport function aggregateGcStats(events: GcEvent[]): GcStats {\n  let scavenges = 0;\n  let markCompacts = 0;\n  let gcPauseTime = 0;\n  let totalCollected = 0;\n  let hasNodeFields = false;\n  let totalAllocated = 0;\n  let totalPromoted = 0;\n  let totalSurvived = 0;\n\n  for (const e of events) {\n    if (e.type === \"scavenge\" || e.type === \"minor-ms\") scavenges++;\n    else if (e.type === \"mark-compact\") markCompacts++;\n    gcPauseTime += e.pauseMs;\n    totalCollected += e.collected;\n    if (e.allocated != null) {\n      hasNodeFields = true;\n      totalAllocated += e.allocated;\n      totalPromoted += e.promoted ?? 0;\n      totalSurvived += e.survived ?? 0;\n    }\n  }\n\n  return {\n    scavenges,\n    markCompacts,\n    totalCollected,\n    gcPauseTime,\n    ...(hasNodeFields && { totalAllocated, totalPromoted, totalSurvived }),\n  };\n}\n\n/** @return GcStats with all counters zeroed */\nexport function emptyGcStats(): GcStats {\n  return { scavenges: 0, markCompacts: 0, totalCollected: 0, gcPauseTime: 0 };\n}\n\n/** Parse name=value pairs from trace-gc-nvp line */\nfunction parseNvpFields(line: string): Record<string, string> {\n  const fields: Record<string, string> = {};\n  // Format: \"key=value, key=value, ...\" or \"key=value key=value\"\n  const matches = line.matchAll(/(\\w+)=([^\\s,]+)/g);\n  for (const [, key, value] of matches) {\n    fields[key] = value;\n  }\n  return fields;\n}\n\n/** Map V8 gc type codes to our types */\nfunction parseGcType(gcField: string): GcEvent[\"type\"] {\n  // V8 uses: s=scavenge, mc=mark-compact, mmc=minor-mc (young gen mark-compact)\n  if (gcField === \"s\" || gcField === \"scavenge\") return \"scavenge\";\n  if (gcField === \"mc\" || gcField === \"ms\" || gcField === \"mark-compact\")\n    return \"mark-compact\";\n  if (gcField === \"mmc\" || gcField === \"minor-mc\" || gcField === \"minor-ms\")\n    return \"minor-ms\";\n  return \"unknown\";\n}\n"],"mappings":";;AAwBA,SAAgB,YAAY,MAAmC;AAE7D,KAAI,CAAC,KAAK,SAAS,SAAS,CAAE,QAAO;CAErC,MAAM,SAAS,eAAe,KAAK;AACnC,KAAI,CAAC,OAAO,GAAI,QAAO;CAEvB,MAAM,OAAO,MAAc,OAAO,SAAS,OAAO,MAAM,KAAK,GAAG;CAChE,MAAM,OAAO,YAAY,OAAO,GAAG;CACnC,MAAM,UAAU,OAAO,WAAW,OAAO,SAAS,IAAI;CACtD,MAAM,YAAY,IAAI,YAAY;CAClC,MAAM,WAAW,IAAI,WAAW;CAEhC,MAAM,WAAW,IAAI,qBAAqB,IAAI,IAAI,WAAW;CAE7D,MAAM,YAAY,IAAI,oBAAoB;CAC1C,MAAM,UAAU,IAAI,kBAAkB;CACtC,MAAM,YAAY,YAAY,UAAU,YAAY,UAAU;AAE9D,KAAI,OAAO,MAAM,QAAQ,CAAE,QAAO;AAElC,QAAO;EAAE;EAAM;EAAS;EAAW;EAAW;EAAU;EAAU;;;AAIpE,SAAgB,iBAAiB,QAA4B;CAC3D,IAAI,YAAY;CAChB,IAAI,eAAe;CACnB,IAAI,cAAc;CAClB,IAAI,iBAAiB;CACrB,IAAI,gBAAgB;CACpB,IAAI,iBAAiB;CACrB,IAAI,gBAAgB;CACpB,IAAI,gBAAgB;AAEpB,MAAK,MAAM,KAAK,QAAQ;AACtB,MAAI,EAAE,SAAS,cAAc,EAAE,SAAS,WAAY;WAC3C,EAAE,SAAS,eAAgB;AACpC,iBAAe,EAAE;AACjB,oBAAkB,EAAE;AACpB,MAAI,EAAE,aAAa,MAAM;AACvB,mBAAgB;AAChB,qBAAkB,EAAE;AACpB,oBAAiB,EAAE,YAAY;AAC/B,oBAAiB,EAAE,YAAY;;;AAInC,QAAO;EACL;EACA;EACA;EACA;EACA,GAAI,iBAAiB;GAAE;GAAgB;GAAe;GAAe;EACtE;;;AASH,SAAS,eAAe,MAAsC;CAC5D,MAAM,SAAiC,EAAE;CAEzC,MAAM,UAAU,KAAK,SAAS,mBAAmB;AACjD,MAAK,MAAM,GAAG,KAAK,UAAU,QAC3B,QAAO,OAAO;AAEhB,QAAO;;;AAIT,SAAS,YAAY,SAAkC;AAErD,KAAI,YAAY,OAAO,YAAY,WAAY,QAAO;AACtD,KAAI,YAAY,QAAQ,YAAY,QAAQ,YAAY,eACtD,QAAO;AACT,KAAI,YAAY,SAAS,YAAY,cAAc,YAAY,WAC7D,QAAO;AACT,QAAO"}