traceperf 0.2.0 → 1.3.0

package/dist/esm/register.js

@@ -0,0 +1,98 @@
+/**
+ * `traceperf/auto`: instrument an app without changing its code.
+ *
+ *   node --require traceperf/auto server.js
+ *   node --import traceperf/auto server.mjs
+ *   NODE_OPTIONS="--require traceperf/auto" npm start
+ *
+ * Environment variables (all optional):
+ *   TRACEPERF_OUTPUT=calls.jsonl   append every request tree as JSON lines
+ *                                  (console trees are then off unless TRACEPERF_SILENT=0)
+ *   TRACEPERF_THRESHOLD=50         only print/record calls taking at least 50 ms
+ *   TRACEPERF_SAMPLE_RATE=0.1      track 10% of top-level calls
+ *   TRACEPERF_SILENT=1             no per-call console trees
+ *   TRACEPERF_SUMMARY=0            no stats + explanations on exit (default on)
+ *   TRACEPERF_DISABLE=http,fetch   skip targets (server, http, fetch, pg, mysql2, mongodb, ioredis)
+ *   TRACEPERF_IGNORE=^/health      regular expression of request paths not to track
+ *   TRACEPERF_QUIET=1              no "traceperf: tracking ..." line at startup
+ *   TRACEPERF_ENABLED=0            load nothing
+ */
+import './node-builtins.js'; // must stay first: see node-builtins.ts
+import tracePerf from './index.js';
+import { AUTO_TARGETS, autoInstrument } from './auto.js';
+import { explain, formatFindings } from './core/explain.js';
+import { jsonLinesExporter } from './core/exporters.js';
+import { loadNodeBuiltin } from './core/env.js';
+const env = (typeof process !== 'undefined' && process.env) || {};
+const flag = (value, fallback) => value === undefined || value === '' ? fallback : !/^(0|false|no|off)$/i.test(value);
+const num = (value) => (value === undefined || value === '' || !Number.isFinite(Number(value)) ? undefined : Number(value));
+const AUTO_KEY = Symbol.for('traceperf.auto');
+const g = globalThis;
+if (flag(env.TRACEPERF_ENABLED, true) && !g[AUTO_KEY]) {
+    g[AUTO_KEY] = true;
+    const fs = loadNodeBuiltin('fs');
+    const output = env.TRACEPERF_OUTPUT;
+    const threshold = num(env.TRACEPERF_THRESHOLD);
+    const sampleRate = num(env.TRACEPERF_SAMPLE_RATE);
+    tracePerf.setConfig({
+        silent: flag(env.TRACEPERF_SILENT, !!output),
+        trackMemory: false,
+        ...(threshold !== undefined ? { threshold } : {}),
+        ...(sampleRate !== undefined ? { sampleRate } : {}),
+    });
+    if (output && fs) {
+        tracePerf.use(jsonLinesExporter(line => fs.appendFileSync(output, line + '\n')));
+    }
+    // Keep the most recent trees for the exit summary
+    const recent = [];
+    const summary = flag(env.TRACEPERF_SUMMARY, true);
+    if (summary) {
+        tracePerf.onComplete(root => {
+            recent.push(root);
+            if (recent.length > 1000)
+                recent.shift();
+        });
+    }
+    const disable = (env.TRACEPERF_DISABLE || '').split(',').map(s => s.trim()).filter(Boolean);
+    const unknown = disable.filter(t => !AUTO_TARGETS.includes(t));
+    if (unknown.length)
+        process.stderr.write(`traceperf: unknown TRACEPERF_DISABLE target(s): ${unknown.join(', ')}\n`);
+    let ignore;
+    try {
+        ignore = env.TRACEPERF_IGNORE ? new RegExp(env.TRACEPERF_IGNORE) : undefined;
+    }
+    catch (_a) {
+        process.stderr.write('traceperf: TRACEPERF_IGNORE is not a valid regular expression; ignoring it\n');
+    }
+    const { instrumented } = autoInstrument(tracePerf, {
+        disable,
+        server: ignore ? { ignore: req => ignore.test(String(req.url || '').split('?')[0]) } : undefined,
+    });
+    if (!flag(env.TRACEPERF_QUIET, false)) {
+        process.stderr.write(`traceperf: tracking ${instrumented.join(', ') || 'nothing'}${output ? ` -> ${output}` : ''}\n`);
+    }
+    let printed = false;
+    const printSummary = () => {
+        if (printed || !summary)
+            return;
+        printed = true;
+        const stats = tracePerf.getStats();
+        if (Object.keys(stats).length === 0)
+            return;
+        process.stderr.write(`\ntraceperf summary\n\n${tracePerf.formatStats()}\n\n${formatFindings(explain(recent, { max: 10 }))}\n`);
+    };
+    process.once('exit', printSummary);
+    // Ctrl-C / kill: print, then exit as the signal would have, unless the app
+    // handles the signal itself (its exit then triggers the 'exit' summary)
+    for (const signal of ['SIGINT', 'SIGTERM']) {
+        const onSignal = () => {
+            if (process.listenerCount(signal) > 1)
+                return;
+            process.removeListener(signal, onSignal);
+            printSummary();
+            process.kill(process.pid, signal);
+        };
+        process.on(signal, onSignal);
+    }
+}
+//# sourceMappingURL=register.js.map

package/dist/esm/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/register.ts"],"names":[],"mappings":"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"}

package/dist/esm/report-html.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Self-contained HTML report: flame chart (one row per nesting level, one
+ * band per lane), statistics table and slowest calls. No scripts, no
+ * external assets - safe to attach to an issue or open from disk.
+ */
+import type { Call } from './cli.js';
+import type { LabelStats } from './core/stats.js';
+export declare function renderHtmlReport(calls: Call[], stats: Record<string, LabelStats>, options?: {
+    title?: string;
+    top?: number;
+}): string;

package/dist/esm/report-html.js

@@ -0,0 +1,106 @@
+const esc = (s) => String(s)
+    .replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+/** Stable colour per label (same label, same colour across reports) */
+function colorFor(label, failed) {
+    if (failed)
+        return '#d73a49';
+    let h = 0;
+    for (let i = 0; i < label.length; i++)
+        h = (h * 31 + label.charCodeAt(i)) >>> 0;
+    // Hues 40..320 only: red is reserved for errors
+    return `hsl(${40 + (h % 280)}, 55%, 58%)`;
+}
+const ms = (n) => (n >= 1000 ? `${(n / 1000).toFixed(2)} s` : `${n.toFixed(n < 10 ? 3 : 1)} ms`);
+export function renderHtmlReport(calls, stats, options = {}) {
+    var _a, _b;
+    const title = (_a = options.title) !== null && _a !== void 0 ? _a : 'traceperf report';
+    const top = (_b = options.top) !== null && _b !== void 0 ? _b : 20;
+    const width = 1200;
+    const rowH = 18;
+    const laneGap = 10;
+    const axisH = 22;
+    const start = calls.length ? Math.min(...calls.map(c => c.start)) : 0;
+    const end = calls.length ? Math.max(...calls.map(c => c.start + c.duration)) : 1;
+    const span = Math.max(end - start, 0.001);
+    const x = (t) => ((t - start) / span) * width;
+    // Vertical layout: each lane gets (max depth + 1) rows
+    const lanes = [...new Set(calls.map(c => c.lane))].sort((a, b) => a - b);
+    const laneTop = new Map();
+    let y = axisH;
+    for (const lane of lanes) {
+        laneTop.set(lane, y);
+        const depth = Math.max(...calls.filter(c => c.lane === lane).map(c => c.depth));
+        y += (depth + 1) * rowH + laneGap;
+    }
+    const height = y;
+    const rects = calls.map(c => {
+        const rx = x(c.start);
+        const rw = Math.max(1, x(c.start + c.duration) - rx);
+        const ry = laneTop.get(c.lane) + c.depth * rowH;
+        const tip = `${c.path}\n${ms(c.duration)} (self ${ms(c.selfDuration)})${c.error ? `\nerror: ${c.error}` : ''}`;
+        const text = rw > 40
+            ? `<text x="${(rx + 4).toFixed(1)}" y="${ry + 13}">${esc(c.label.length * 6.5 > rw - 8 ? `${c.label.slice(0, Math.max(1, Math.floor((rw - 14) / 6.5)))}…` : c.label)}</text>`
+            : '';
+        return `<g class="call"><title>${esc(tip)}</title><rect x="${rx.toFixed(1)}" y="${ry}" width="${rw.toFixed(1)}" height="${rowH - 2}" rx="2" fill="${colorFor(c.label, !!c.error)}"/>${text}</g>`;
+    }).join('\n');
+    const ticks = Array.from({ length: 6 }, (_, i) => {
+        const tx = (i / 5) * width;
+        return `<line x1="${tx}" x2="${tx}" y1="${axisH - 4}" y2="${height}" class="grid"/><text x="${Math.min(tx + 3, width - 60)}" y="14" class="axis">${esc(ms((span * i) / 5))}</text>`;
+    }).join('');
+    const statRows = Object.keys(stats)
+        .sort((a, b) => stats[b].total - stats[a].total)
+        .map(label => {
+        const s = stats[label];
+        return `<tr><td>${esc(label)}</td><td>${s.count}</td><td>${s.errors}</td><td>${s.total.toFixed(1)}</td><td>${s.mean.toFixed(3)}</td><td>${s.p50.toFixed(3)}</td><td>${s.p95.toFixed(3)}</td><td>${s.p99.toFixed(3)}</td><td>${s.max.toFixed(3)}</td><td>${s.selfMean.toFixed(3)}</td></tr>`;
+    }).join('\n');
+    const slowest = calls.slice().sort((a, b) => b.duration - a.duration).slice(0, top)
+        .map(c => `<tr><td>${esc(ms(c.duration))}</td><td>${esc(c.path)}${c.error ? ` <span class="err">✖ ${esc(c.error)}</span>` : ''}</td></tr>`).join('\n');
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>${esc(title)}</title>
+<style>
+  :root { color-scheme: light dark; --bg: #fff; --fg: #1f2328; --muted: #656d76; --grid: #d0d7de; --row: #f6f8fa; }
+  @media (prefers-color-scheme: dark) { :root { --bg: #0d1117; --fg: #e6edf3; --muted: #8b949e; --grid: #30363d; --row: #161b22; } }
+  body { margin: 0; padding: 24px 16px; background: var(--bg); color: var(--fg); font: 14px/1.5 system-ui, sans-serif; }
+  main { max-width: 1240px; margin: 0 auto; }
+  h1 { font-size: 20px; margin: 0 0 4px; } h2 { font-size: 16px; margin: 28px 0 8px; }
+  .meta { color: var(--muted); margin: 0 0 16px; }
+  .chart { overflow-x: auto; border: 1px solid var(--grid); border-radius: 6px; padding: 8px; }
+  svg { display: block; } svg text { font: 11px ui-monospace, monospace; fill: #0d1117; pointer-events: none; }
+  svg text.axis { fill: var(--muted); } line.grid { stroke: var(--grid); stroke-width: 1; }
+  g.call:hover rect { stroke: var(--fg); stroke-width: 1.5; }
+  table { border-collapse: collapse; width: 100%; font: 12px ui-monospace, monospace; }
+  th, td { text-align: right; padding: 4px 8px; border-bottom: 1px solid var(--grid); white-space: nowrap; }
+  th:first-child, td:first-child { text-align: left; } tbody tr:nth-child(odd) { background: var(--row); }
+  .slow td:first-child { width: 1%; } .slow td:last-child, .slow th:last-child { text-align: left; white-space: normal; width: auto; } .err { color: #d73a49; }
+  .wrap { overflow-x: auto; }
+</style>
+</head>
+<body>
+<main>
+<h1>${esc(title)}</h1>
+<p class="meta">${calls.length} calls · ${Object.keys(stats).length} labels · ${lanes.length} lane${lanes.length === 1 ? '' : 's'} · span ${esc(ms(span))}. Hover a bar for details.</p>
+<h2>Flame chart</h2>
+<div class="chart"><svg width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" role="img" aria-label="flame chart">
+${ticks}
+${rects}
+</svg></div>
+<h2>Statistics (ms)</h2>
+<div class="wrap"><table><thead><tr><th>label</th><th>calls</th><th>errors</th><th>total</th><th>mean</th><th>p50</th><th>p95</th><th>p99</th><th>max</th><th>self mean</th></tr></thead>
+<tbody>
+${statRows}
+</tbody></table></div>
+<h2>Slowest ${Math.min(top, calls.length)} calls</h2>
+<div class="wrap"><table class="slow"><thead><tr><th>duration</th><th>call</th></tr></thead>
+<tbody>
+${slowest}
+</tbody></table></div>
+</main>
+</body>
+</html>
+`;
+}
+//# sourceMappingURL=report-html.js.map

package/dist/esm/report-html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-html.js","sourceRoot":"","sources":["../../src/report-html.ts"],"names":[],"mappings":"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"}

package/dist/esm/types/index.d.ts

@@ -1,82 +1,6 @@
-export * from './config';
-export * from './logger';
+export * from './options.js';
+import type { TracePerfConfig } from './options.js';
 /**
- * Interface for TracePerf configuration
+ * @deprecated Use `TracePerfConfig`.
  */
-export interface ITracePerfConfig {
-    /** Tracking mode for balancing performance vs detail */
-    trackingMode?: string;
-    /** Whether to suppress console output */
-    silent?: boolean;
-    /** Whether to track memory usage */
-    trackMemory?: boolean;
-    /** Whether to enable nested function tracking */
-    enableNestedTracking?: boolean;
-    /** Minimum duration threshold in microseconds */
-    threshold?: number;
-    /** Sampling rate (0.0-1.0) for reducing overhead */
-    sampleRate?: number;
-}
-/**
- * Interface for tracking options
- */
-export interface ITrackOptions {
-    /** Custom label for the tracked function */
-    label?: string;
-    /** Override default tracking mode */
-    trackingMode?: string;
-    /** Override default silent setting */
-    silent?: boolean;
-    /** Override default memory tracking */
-    trackMemory?: boolean;
-    /** Override default nested tracking */
-    enableNestedTracking?: boolean;
-    /** Minimum duration threshold in microseconds */
-    threshold?: number;
-    /** Sampling rate (0.0-1.0) for reducing overhead */
-    sampleRate?: number;
-    /** Any other options */
-    [key: string]: any;
-}
-/**
- * Interface for execution trackers
- */
-export interface IExecutionTracker {
-    /**
-     * Track the execution of a function
-     *
-     * @param fn - The function to track
-     * @param options - Options for tracking
-     * @returns The return value of the tracked function
-     */
-    track<T>(fn: () => T, options?: ITrackOptions): T;
-    /**
-     * Create a trackable version of a function
-     *
-     * This is a helper method to create a tracked version of a function
-     * that can be used for nested function tracking.
-     *
-     * @param fn - The function to make trackable
-     * @param options - Options for tracking
-     * @returns A tracked version of the function
-     */
-    createTrackable<T extends (...args: any[]) => any>(fn: T, options?: Omit<ITrackOptions, 'label'> & {
-        label?: string;
-    }): (...args: Parameters<T>) => ReturnType<T>;
-    /**
-     * Get the current call stack
-     *
-     * @returns The current call stack
-     */
-    getCallStack(): string[];
-    /**
-     * Generate a visual representation of the execution flow
-     *
-     * @returns ASCII flow chart of the execution
-     */
-    generateFlowChart(): string;
-    /**
-     * Clear all execution records
-     */
-    clear(): void;
-}
+export type ITracePerfConfig = TracePerfConfig;

package/dist/esm/types/index.js

@@ -1,3 +1,2 @@
-export * from './config';
-export * from './logger';
+export * from './options.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/dist/esm/types/options.d.ts

@@ -0,0 +1,72 @@
+import type { ExecutionRecord, TracePerfPlugin, TrackingModeName } from '../core/records.js';
+import type { StatsOptions } from '../core/stats.js';
+/**
+ * Options for a single tracked function or call. Anything left out falls
+ * back to the instance configuration at the time of the call.
+ */
+export interface TrackOptions {
+    /** Label shown in output and stats (default: the function name) */
+    label?: string;
+    /** Tracking mode for this call */
+    trackingMode?: TrackingModeName;
+    /** Suppress console output for this call */
+    silent?: boolean;
+    /** Record the heap change for this call */
+    trackMemory?: boolean;
+    /** Only report this call if it takes at least this many milliseconds */
+    threshold?: number;
+    /** Fraction of calls to track (0.0 - 1.0) */
+    sampleRate?: number;
+    /** Include a short rendering of the arguments in output and records */
+    captureArgs?: boolean;
+    /** Attach tracked calls made inside this one as children (default true) */
+    enableNestedTracking?: boolean;
+    /** Attach this call to a specific parent execution */
+    parentExecutionId?: string | null;
+}
+/** Options for `track(fn, options)` */
+export interface TrackCallOptions extends TrackOptions {
+    /** `this` for the tracked function */
+    thisContext?: unknown;
+    /** Arguments passed to the tracked function */
+    args?: unknown[];
+}
+/** Options for `registerModule` / `trackObject` */
+export interface ModuleTrackOptions extends TrackOptions {
+    /** Prefix for each method label, e.g. "userService." */
+    prefix?: string;
+}
+/** Configuration for `createTracePerf()` / `new OptimizedPerformanceMonitor()` */
+export interface TracePerfConfig {
+    /** Detail level (default "balanced") */
+    trackingMode?: TrackingModeName;
+    /** Suppress console output (stats, hooks and exporters still run) */
+    silent?: boolean;
+    /** Record heap change per call (default true) */
+    trackMemory?: boolean;
+    /** Attach nested tracked calls to their caller (default true) */
+    enableNestedTracking?: boolean;
+    /** Only report calls taking at least this many milliseconds (default 0) */
+    threshold?: number;
+    /** Fraction of calls to track (default 1) */
+    sampleRate?: number;
+    /** Set to false to make every tracked function a plain pass-through */
+    enabled?: boolean;
+    /** Detailed mode flags calls whose synchronous part runs at least this long (ms, default 50; 0 disables) */
+    blockingThreshold?: number;
+    /** Collect per-label statistics (default true) */
+    stats?: boolean | StatsOptions;
+    /** Replace console output: called with each reported top-level tree */
+    reporter?: (root: ExecutionRecord) => void;
+    /** Plugins/exporters to register */
+    plugins?: TracePerfPlugin[];
+    /** Called with every finished top-level tree (also when silent) */
+    onComplete?: (root: ExecutionRecord) => void;
+    /**
+     * AsyncLocalStorage class to use for nesting across `await`. Detected
+     * automatically on Node.js, Bun, Deno and where it is a global; pass it
+     * explicitly on runtimes where it is only importable, e.g. Cloudflare
+     * Workers: `import { AsyncLocalStorage } from 'node:async_hooks'`.
+     */
+    asyncLocalStorage?: new () => any;
+}

package/dist/esm/types/options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=options.js.map

package/dist/esm/types/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/types/options.ts"],"names":[],"mappings":""}

package/dist/esm/watch.d.ts

@@ -0,0 +1,17 @@
+export interface WatchOptions {
+    top?: number;
+    sort?: 'p95' | 'p99' | 'mean' | 'total' | 'count' | 'max';
+    /** Calls/s is computed over this window (ms, default 10000) */
+    rateWindow?: number;
+    /** Show the arrival rate (only meaningful while following a live file; default true) */
+    showRate?: boolean;
+}
+/** Incremental state for `traceperf watch`; feed it text, render frames */
+export declare function createWatcher(options?: WatchOptions): {
+    /** Add newly appended text (may end mid-line) */
+    ingest(text: string, now?: number): void;
+    /** Forget everything (e.g. the file was truncated) */
+    reset(): void;
+    /** Render one frame as text */
+    frame(title: string, now?: number): string;
+};

package/dist/esm/watch.js

@@ -0,0 +1,87 @@
+/**
+ * traceperf watch: a live, top-style view of a JSON-lines log
+ * (from jsonLinesExporter) as the application writes it.
+ */
+import { StatsCollector } from './core/stats.js';
+function toRecord(label, duration, selfDuration, error) {
+    return {
+        id: '', label, parentId: null, startTime: 0, endTime: duration, startEpochMs: 0, duration,
+        selfDuration, syncDuration: duration, async: false, children: [], threshold: 0,
+        trackingMode: 'balanced', silent: true, ...(error ? { error: new Error(error) } : {}),
+    };
+}
+/** Incremental state for `traceperf watch`; feed it text, render frames */
+export function createWatcher(options = {}) {
+    var _a;
+    const stats = new StatsCollector({ reservoirSize: 2048, maxLabels: 5000 });
+    const window = (_a = options.rateWindow) !== null && _a !== void 0 ? _a : 10000;
+    const arrivals = [];
+    let pending = '';
+    let calls = 0;
+    let invalid = 0;
+    const visit = (node) => {
+        if (!node || typeof node.label !== 'string' || typeof node.durationMs !== 'number')
+            return;
+        stats.add(toRecord(node.label, node.durationMs, typeof node.selfMs === 'number' ? node.selfMs : node.durationMs, node.error));
+        calls++;
+        (node.children || []).forEach(visit);
+    };
+    return {
+        /** Add newly appended text (may end mid-line) */
+        ingest(text, now = Date.now()) {
+            var _a;
+            const lines = (pending + text).split('\n');
+            pending = (_a = lines.pop()) !== null && _a !== void 0 ? _a : '';
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const before = calls;
+                    visit(JSON.parse(line));
+                    for (let i = before; i < calls; i++)
+                        arrivals.push(now);
+                }
+                catch (_b) {
+                    invalid++;
+                }
+            }
+            while (arrivals.length && arrivals[0] < now - window)
+                arrivals.shift();
+        },
+        /** Forget everything (e.g. the file was truncated) */
+        reset() {
+            stats.reset();
+            arrivals.length = 0;
+            pending = '';
+            calls = 0;
+            invalid = 0;
+        },
+        /** Render one frame as text */
+        frame(title, now = Date.now()) {
+            var _a, _b;
+            while (arrivals.length && arrivals[0] < now - window)
+                arrivals.shift();
+            const sort = (_a = options.sort) !== null && _a !== void 0 ? _a : 'p95';
+            const all = stats.all();
+            const labels = Object.keys(all).sort((a, b) => all[b][sort] - all[a][sort])
+                .slice(0, Math.max(1, (_b = options.top) !== null && _b !== void 0 ? _b : 15));
+            const rate = arrivals.length / (window / 1000);
+            const rateText = options.showRate === false ? '' : `  |  ${rate.toFixed(1)} calls/s (last ${window / 1000}s)`;
+            const head = `${title}  |  ${calls.toLocaleString('en-US')} calls${rateText}  |  ${new Date(now).toISOString().slice(11, 19)}`
+                + (invalid ? `  |  ${invalid} invalid lines` : '');
+            if (labels.length === 0)
+                return `${head}\n\nwaiting for data...`;
+            const cols = [
+                ['calls', s => String(s.count)], ['errors', s => String(s.errors)], ['p50', s => s.p50.toFixed(2)],
+                ['p95', s => s.p95.toFixed(2)], ['p99', s => s.p99.toFixed(2)], ['max', s => s.max.toFixed(2)], ['total', s => s.total.toFixed(0)],
+            ];
+            const rows = labels.map(l => [l, ...cols.map(([, f]) => f(all[l]))]);
+            const header = ['label', ...cols.map(([n]) => (n === sort ? `${n}▼` : n))];
+            const widths = header.map((h, i) => Math.max(h.length, ...rows.map(r => r[i].length)));
+            const fmt = (cells) => cells.map((c, i) => (i === 0 ? c.padEnd(widths[i]) : c.padStart(widths[i]))).join('  ');
+            const footer = options.showRate === false ? 'times in ms' : 'times in ms - Ctrl+C to exit';
+            return [head, '', fmt(header), widths.map(w => '-'.repeat(w)).join('  '), ...rows.map(fmt), '', footer].join('\n');
+        },
+    };
+}
+//# sourceMappingURL=watch.js.map

package/dist/esm/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/watch.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,9 +1,17 @@
 import { OptimizedPerformanceMonitor, TrackingModes } from './core/optimized-performance-monitor';
-import { ITracePerfConfig } from './types';
+import { ITracePerfConfig, TrackOptions } from './types';
 declare const tracePerf: OptimizedPerformanceMonitor;
 export default tracePerf;
-export declare function createTracePerf(config?: Partial<ITracePerfConfig>): OptimizedPerformanceMonitor;
+export declare function createTracePerf(config?: ITracePerfConfig): OptimizedPerformanceMonitor;
+/**
+ * Method decorator bound to the default instance, see `OptimizedPerformanceMonitor.traced`.
+ */
+export declare function traced(options?: TrackOptions): import("./core").TracedDecorator;
 export * from './types';
 export * from './core';
+export * from './integrations';
+export * from './instrument';
+export * from './drivers';
+export * from './auto';
 export { OptimizedPerformanceMonitor };
 export { TrackingModes as TrackingMode };

package/dist/index.js

@@ -10,59 +10,56 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
 }));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TrackingMode = exports.OptimizedPerformanceMonitor = void 0;
 exports.createTracePerf = createTracePerf;
+exports.traced = traced;
 // Import optimized performance monitor from core
 const optimized_performance_monitor_1 = require("./core/optimized-performance-monitor");
 Object.defineProperty(exports, "OptimizedPerformanceMonitor", { enumerable: true, get: function () { return optimized_performance_monitor_1.OptimizedPerformanceMonitor; } });
 Object.defineProperty(exports, "TrackingMode", { enumerable: true, get: function () { return optimized_performance_monitor_1.TrackingModes; } });
-const typesExports = __importStar(require("./types"));
-// Create singleton instance
-const tracePerf = new optimized_performance_monitor_1.OptimizedPerformanceMonitor();
+// Create singleton instance, shared by the CommonJS and ESM builds of this
+// major version (so `--require traceperf/auto` and `import tp from
+// 'traceperf'` see the same instance and the same call trees)
+const DEFAULT_KEY = Symbol.for('traceperf.default.v1');
+const shared = globalThis;
+const tracePerf = shared[DEFAULT_KEY] || (shared[DEFAULT_KEY] = new optimized_performance_monitor_1.OptimizedPerformanceMonitor());
 // Export the singleton instance as the default export
 exports.default = tracePerf;
 // Export a function to create a new tracePerf instance
 function createTracePerf(config = {}) {
     return new optimized_performance_monitor_1.OptimizedPerformanceMonitor(config);
 }
+/**
+ * Method decorator bound to the default instance, see `OptimizedPerformanceMonitor.traced`.
+ */
+function traced(options = {}) {
+    // Call the prototype method: in CommonJS this function is also installed
+    // as tracePerf.traced, so tracePerf.traced(...) would recurse.
+    return optimized_performance_monitor_1.OptimizedPerformanceMonitor.prototype.traced.call(tracePerf, options);
+}
 // Export types and classes for advanced usage
 __exportStar(require("./types"), exports);
 __exportStar(require("./core"), exports);
-// Add CommonJS compatibility
+__exportStar(require("./integrations"), exports);
+__exportStar(require("./instrument"), exports);
+__exportStar(require("./drivers"), exports);
+__exportStar(require("./auto"), exports);
+// <cjs-compat>
+// CommonJS compatibility: make `require('traceperf')` return the singleton
+// itself (so `require('traceperf').track()` works) while still exposing every
+// named export declared in the type definitions. Stripped from the ESM build.
 if (typeof module !== 'undefined' && module.exports) {
-    module.exports = Object.assign(tracePerf, {
+    module.exports = Object.assign(tracePerf, module.exports, {
         default: tracePerf,
         createTracePerf,
+        traced,
         OptimizedPerformanceMonitor: optimized_performance_monitor_1.OptimizedPerformanceMonitor,
         TrackingMode: optimized_performance_monitor_1.TrackingModes,
-        // Re-export types
-        ...typesExports
     });
 }
+// </cjs-compat>
 //# sourceMappingURL=index.js.map