benchforge 0.1.9 → 0.2.4

package/dist/Formatters-BWj3d4sv.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Formatters-BWj3d4sv.mjs","names":[],"sources":["../src/report/Colors.ts","../src/report/Formatters.ts"],"sourcesContent":["import pico from \"picocolors\";\nimport type { Colors } from \"picocolors/types\";\n\nconst isTest = process.env.NODE_ENV === \"test\" || process.env.VITEST === \"true\";\n\n/** Picocolors instance that disables color in test environments */\nconst colors: Colors = pico.createColors(!isTest);\n\nexport default colors;\n","import {\n  type CIDirection,\n  type DifferenceCI,\n  flipCI,\n} from \"../stats/StatisticalUtils.ts\";\nimport colors from \"./Colors.ts\";\n\nconst { red, green } = colors;\n\nconst lowConfidence = 80;\n\n/** Format time in milliseconds with appropriate units */\nexport function timeMs(ms: unknown): string | null {\n  if (typeof ms !== \"number\") return null;\n  if (ms < 0.001) return `${(ms * 1000000).toFixed(0)}ns`;\n  if (ms < 0.01) return `${(ms * 1000).toFixed(1)}μs`;\n  if (ms >= 1000) return `${(ms / 1000).toFixed(2)}s`;\n  if (ms >= 10) return `${ms.toFixed(0)}ms`;\n  return `${ms.toFixed(2)}ms`;\n}\n\n/** Format integer with thousand separators */\nexport function integer(x: unknown): string | null {\n  if (typeof x !== \"number\") return null;\n  return new Intl.NumberFormat(\"en-US\").format(Math.round(x));\n}\n\n/** Format fraction as percentage (0.473 → 47.3%) */\nexport function percent(fraction: unknown, precision = 1): string | null {\n  if (typeof fraction !== \"number\") return null;\n  return `${Math.abs(fraction * 100).toFixed(precision)}%`;\n}\n\n/** Format percentage difference between two values */\nexport function diffPercent(main: unknown, base: unknown): string {\n  if (typeof main !== \"number\" || typeof base !== \"number\") return \" \";\n  const diff = main - base;\n  return coloredPercent(diff, base);\n}\n\n/** Format bytes with appropriate units. Use `space: true` for `1.5 KB` style. */\nexport function formatBytes(\n  bytes: unknown,\n  opts?: { space?: boolean },\n): string | null {\n  if (typeof bytes !== \"number\") return null;\n  const s = opts?.space ? \" \" : \"\";\n  const [kb, mb, gb] = [1024, 1024 ** 2, 1024 ** 3];\n  if (bytes < kb) return `${bytes.toFixed(0)}${s}B`;\n  if (bytes < mb) return `${(bytes / kb).toFixed(1)}${s}KB`;\n  if (bytes < gb) return `${(bytes / mb).toFixed(1)}${s}MB`;\n  return `${(bytes / gb).toFixed(1)}${s}GB`;\n}\n\n/** Format percentage difference with confidence interval.\n *  When higherIsBetter is true, flips the CI so positive = improvement. */\nexport function formatDiffWithCI(\n  value: unknown,\n  higherIsBetter?: boolean,\n): string | null {\n  if (!isDifferenceCI(value)) return null;\n  const ci = higherIsBetter ? flipCI(value) : value;\n  const suffix = value.ciLevel === \"sample\" ? \" *\" : \"\";\n  const text = diffCIText(ci.percent, ci.ci) + suffix;\n  return colorByDirection(text, ci.direction);\n}\n\n/** @return truncated string with ellipsis if over maxLen */\nexport function truncate(str: string, maxLen = 30): string {\n  return str.length > maxLen ? str.slice(0, maxLen - 3) + \"...\" : str;\n}\n\n/** @return signed percentage string (e.g. \"+1.2%\", \"-3.4%\") */\nexport function formatSignedPercent(v: number): string {\n  const sign = v >= 0 ? \"+\" : \"\";\n  return `${sign}${v.toFixed(1)}%`;\n}\n\n/** @return convergence percentage with color for low values */\nexport function formatConvergence(v: unknown): string {\n  if (typeof v !== \"number\") return \"—\";\n  const pct = `${Math.round(v)}%`;\n  return v < lowConfidence ? red(pct) : pct;\n}\n\n/** Format fraction as colored +/- percentage (positive = green, negative = red) */\nfunction coloredPercent(numerator: number, denominator: number): string {\n  const fraction = numerator / denominator;\n  if (!Number.isFinite(fraction)) return \" \";\n  const sign = fraction >= 0 ? \"+\" : \"-\";\n  const percentStr = `${sign}${percent(fraction)}`;\n  return fraction >= 0 ? green(percentStr) : red(percentStr);\n}\n\nfunction isDifferenceCI(x: unknown): x is DifferenceCI {\n  return typeof x === \"object\" && x !== null && \"ci\" in x && \"direction\" in x;\n}\n\n/** @return formatted \"pct [lo, hi]\" text for a diff with CI */\nfunction diffCIText(pct: number, ci: [number, number]): string {\n  const [lo, hi] = ci.map(formatSignedPercent);\n  return `${formatSignedPercent(pct)} [${lo}, ${hi}]`;\n}\n\n/** @return text colored green for faster/equivalent, red for slower */\nfunction colorByDirection(text: string, direction: CIDirection): string {\n  if (direction === \"faster\" || direction === \"equivalent\") return green(text);\n  if (direction === \"slower\") return red(text);\n  return text;\n}\n"],"mappings":"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"}

package/dist/{HeapSampler-B8dtKHn1.mjs → HeapSampler-Dq-hpXem.mjs}

@@ -1,6 +1,5 @@
 import { Session } from "node:inspector/promises";
-
-//#region src/heap-sample/HeapSampler.ts
+//#region src/profiling/node/HeapSampler.ts
 const defaultOptions = {
 	samplingInterval: 32768,
 	stackDepth: 64,
@@ -44,11 +43,12 @@ async function startSampling(session, opts) {
 		await session.post("HeapProfiler.startSampling", base);
 	}
 }
+/** Stop heap sampling and return the profile, casting past incomplete @types/node typings */
 async function stopSampling(session) {
 	const { profile } = await session.post("HeapProfiler.stopSampling");
 	return profile;
 }
-
 //#endregion
 export { withHeapSampling };
-//# sourceMappingURL=HeapSampler-B8dtKHn1.mjs.map
+
+//# sourceMappingURL=HeapSampler-Dq-hpXem.mjs.map

package/dist/HeapSampler-Dq-hpXem.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeapSampler-Dq-hpXem.mjs","names":[],"sources":["../src/profiling/node/HeapSampler.ts"],"sourcesContent":["import { Session } from \"node:inspector/promises\";\n\nexport interface HeapSampleOptions {\n  /** Bytes between samples (default 32768) */\n  samplingInterval?: number;\n\n  /** Max stack frames (default 64) */\n  stackDepth?: number;\n\n  /** Keep objects collected by minor GC (default true) */\n  includeMinorGC?: boolean;\n\n  /** Keep objects collected by major GC (default true) */\n  includeMajorGC?: boolean;\n}\n\n/** V8 call frame location within a profiled script */\nexport interface CallFrame {\n  /** Function name (empty string for anonymous) */\n  functionName: string;\n\n  /** Script URL or file path */\n  url: string;\n\n  /** Zero-based line number */\n  lineNumber: number;\n\n  /** Zero-based column number */\n  columnNumber?: number;\n}\n\n/** Node in the V8 sampling heap profile tree */\nexport interface ProfileNode {\n  /** Call site for this allocation node */\n  callFrame: CallFrame;\n\n  /** Bytes allocated directly at this node (not children) */\n  selfSize: number;\n\n  /** Unique node ID, links to {@link HeapSample.nodeId} */\n  id: number;\n\n  /** Child nodes in the call tree */\n  children?: ProfileNode[];\n}\n\n/** Individual heap allocation sample from V8's SamplingHeapProfiler */\nexport interface HeapSample {\n  /** Links to {@link ProfileNode.id} for stack lookup */\n  nodeId: number;\n\n  /** Allocation size in bytes */\n  size: number;\n\n  /** Monotonically increasing, gives temporal ordering */\n  ordinal: number;\n}\n\n/** V8 sampling heap profile tree with optional per-allocation samples */\nexport interface HeapProfile {\n  /** Root of the profile call tree */\n  head: ProfileNode;\n\n  /** Per-allocation samples, if collected */\n  samples?: HeapSample[];\n}\n\nconst defaultOptions: Required<HeapSampleOptions> = {\n  samplingInterval: 32768,\n  stackDepth: 64,\n  includeMinorGC: true,\n  includeMajorGC: true,\n};\n\n/** Run a function while sampling heap allocations, return profile */\nexport async function withHeapSampling<T>(\n  options: HeapSampleOptions,\n  fn: () => Promise<T> | T,\n): Promise<{ result: T; profile: HeapProfile }> {\n  const opts = { ...defaultOptions, ...options };\n  const session = new Session();\n  session.connect();\n\n  try {\n    await startSampling(session, opts);\n    const result = await fn();\n    const profile = await stopSampling(session);\n    return { result, profile };\n  } finally {\n    session.disconnect();\n  }\n}\n\n/** Start heap sampling, falling back if include-collected params aren't supported */\nasync function startSampling(\n  session: Session,\n  opts: Required<HeapSampleOptions>,\n): Promise<void> {\n  const { samplingInterval, stackDepth } = opts;\n  const base = { samplingInterval, stackDepth };\n  const params = {\n    ...base,\n    includeObjectsCollectedByMinorGC: opts.includeMinorGC,\n    includeObjectsCollectedByMajorGC: opts.includeMajorGC,\n  };\n  try {\n    await session.post(\"HeapProfiler.startSampling\", params);\n  } catch {\n    console.warn(\n      \"HeapProfiler: include-collected params not supported, falling back\",\n    );\n    await session.post(\"HeapProfiler.startSampling\", base);\n  }\n}\n\n/** Stop heap sampling and return the profile, casting past incomplete @types/node typings */\nasync function stopSampling(session: Session): Promise<HeapProfile> {\n  const { profile } = await session.post(\"HeapProfiler.stopSampling\");\n  return profile as unknown as HeapProfile;\n}\n"],"mappings":";;AAmEA,MAAM,iBAA8C;CAClD,kBAAkB;CAClB,YAAY;CACZ,gBAAgB;CAChB,gBAAgB;CACjB;;AAGD,eAAsB,iBACpB,SACA,IAC8C;CAC9C,MAAM,OAAO;EAAE,GAAG;EAAgB,GAAG;EAAS;CAC9C,MAAM,UAAU,IAAI,SAAS;AAC7B,SAAQ,SAAS;AAEjB,KAAI;AACF,QAAM,cAAc,SAAS,KAAK;AAGlC,SAAO;GAAE,QAFM,MAAM,IAAI;GAER,SADD,MAAM,aAAa,QAAQ;GACjB;WAClB;AACR,UAAQ,YAAY;;;;AAKxB,eAAe,cACb,SACA,MACe;CACf,MAAM,EAAE,kBAAkB,eAAe;CACzC,MAAM,OAAO;EAAE;EAAkB;EAAY;CAC7C,MAAM,SAAS;EACb,GAAG;EACH,kCAAkC,KAAK;EACvC,kCAAkC,KAAK;EACxC;AACD,KAAI;AACF,QAAM,QAAQ,KAAK,8BAA8B,OAAO;SAClD;AACN,UAAQ,KACN,qEACD;AACD,QAAM,QAAQ,KAAK,8BAA8B,KAAK;;;;AAK1D,eAAe,aAAa,SAAwC;CAClE,MAAM,EAAE,YAAY,MAAM,QAAQ,KAAK,4BAA4B;AACnE,QAAO"}