@fuzdev/fuz_util 0.44.0 → 0.45.0

package/LICENSE

@@ -1,4 +1,4 @@
-The MIT License (MIT)
+MIT License
 
 Copyright (c) fuz.dev
 

package/dist/benchmark.d.ts

@@ -135,9 +135,24 @@ export declare class Benchmark {
     table(options?: BenchmarkFormatTableOptions): string;
     /**
      * Format results as a Markdown table.
+     * @param options - Formatting options (groups for organized output with optional baselines)
      * @returns Formatted markdown string
+     *
+     * @example
+     * ```ts
+     * // Standard table
+     * console.log(bench.markdown());
+     *
+     * // Grouped by category with custom baseline
+     * console.log(bench.markdown({
+     *   groups: [
+     *     { name: 'Format', filter: (r) => r.name.startsWith('format/'), baseline: 'format/prettier' },
+     *     { name: 'Parse', filter: (r) => r.name.startsWith('parse/') },
+     *   ]
+     * }));
+     * ```
      */
-    markdown(): string;
+    markdown(options?: BenchmarkFormatTableOptions): string;
     /**
      * Format results as JSON.
      * @param options - Formatting options (pretty, include_timings)
@@ -150,6 +165,33 @@ export declare class Benchmark {
      * @returns Array of benchmark results
      */
     results(): Array<BenchmarkResult>;
+    /**
+     * Check if the benchmark has been run and has results.
+     * @returns True if results are available
+     *
+     * @example
+     * ```ts
+     * if (bench.has_results) {
+     *   console.log(bench.table());
+     * }
+     * ```
+     */
+    get has_results(): boolean;
+    /**
+     * Get results as a map for convenient lookup by task name.
+     * Returns a new Map each call to prevent external mutation.
+     * @returns Map of task name to benchmark result
+     *
+     * @example
+     * ```ts
+     * const results_map = bench.results_by_name();
+     * const slugify_result = results_map.get('slugify');
+     * if (slugify_result) {
+     *   console.log(`slugify: ${slugify_result.stats.ops_per_second} ops/sec`);
+     * }
+     * ```
+     */
+    results_by_name(): Map<string, BenchmarkResult>;
     /**
      * Reset the benchmark results.
      * Keeps tasks intact so benchmarks can be rerun.

package/dist/benchmark.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"benchmark.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/benchmark.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,EAMN,KAAK,0BAA0B,EAC/B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACX,eAAe,EACf,aAAa,EACb,eAAe,EACf,2BAA2B,EAC3B,MAAM,sBAAsB,CAAC;AAgD9B;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,GAC5B,IAAI,MAAM,OAAO,EACjB,YAAY,MAAM,EAClB,aAAa,OAAO,KAClB,OAAO,CAAC,OAAO,CAyBjB,CAAC;AAEF;;GAEG;AACH,qBAAa,SAAS;;gBAMT,MAAM,GAAE,eAAoB;IAcxC;;;;;;;;;;;;;;;;;;OAkBG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,GAAG,IAAI;IAC1C,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAkB9B;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS1B;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASxB;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASxB;;;OAGG;IACG,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAqH5C;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,MAAM;IAMpD;;;OAGG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,MAAM;IAIlD;;;;OAIG;IACH,OAAO,IAAI,KAAK,CAAC,eAAe,CAAC;IAIjC;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAMb;;;;;;;;;;;OAWG;IACH,OAAO,IAAI,MAAM;CA+BjB"}
+{"version":3,"file":"benchmark.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/benchmark.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,EAON,KAAK,0BAA0B,EAC/B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACX,eAAe,EACf,aAAa,EACb,eAAe,EACf,2BAA2B,EAC3B,MAAM,sBAAsB,CAAC;AAgD9B;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,GAC5B,IAAI,MAAM,OAAO,EACjB,YAAY,MAAM,EAClB,aAAa,OAAO,KAClB,OAAO,CAAC,OAAO,CAyBjB,CAAC;AAEF;;GAEG;AACH,qBAAa,SAAS;;gBAMT,MAAM,GAAE,eAAoB;IAcxC;;;;;;;;;;;;;;;;;;OAkBG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,GAAG,IAAI;IAC1C,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAkB9B;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS1B;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASxB;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASxB;;;OAGG;IACG,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAqH5C;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,MAAM;IAMpD;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,MAAM;IAMvD;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,MAAM;IAIlD;;;;OAIG;IACH,OAAO,IAAI,KAAK,CAAC,eAAe,CAAC;IAIjC;;;;;;;;;;OAUG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;;;;;;;;;;;OAaG;IACH,eAAe,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAI/C;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAMb;;;;;;;;;;;OAWG;IACH,OAAO,IAAI,MAAM;CA+BjB"}

package/dist/benchmark.js

@@ -21,7 +21,7 @@
 import { is_promise, wait } from './async.js';
 import { BenchmarkStats } from './benchmark_stats.js';
 import { timer_default, time_unit_detect_best, time_format } from './time.js';
-import { benchmark_format_table, benchmark_format_table_grouped, benchmark_format_markdown, benchmark_format_json, benchmark_format_number, } from './benchmark_format.js';
+import { benchmark_format_table, benchmark_format_table_grouped, benchmark_format_markdown, benchmark_format_markdown_grouped, benchmark_format_json, benchmark_format_number, } from './benchmark_format.js';
 // Default configuration values
 const DEFAULT_DURATION_MS = 1000;
 const DEFAULT_WARMUP_ITERATIONS = 10;
@@ -328,10 +328,27 @@ export class Benchmark {
     }
     /**
      * Format results as a Markdown table.
+     * @param options - Formatting options (groups for organized output with optional baselines)
      * @returns Formatted markdown string
+     *
+     * @example
+     * ```ts
+     * // Standard table
+     * console.log(bench.markdown());
+     *
+     * // Grouped by category with custom baseline
+     * console.log(bench.markdown({
+     *   groups: [
+     *     { name: 'Format', filter: (r) => r.name.startsWith('format/'), baseline: 'format/prettier' },
+     *     { name: 'Parse', filter: (r) => r.name.startsWith('parse/') },
+     *   ]
+     * }));
+     * ```
      */
-    markdown() {
-        return benchmark_format_markdown(this.#results);
+    markdown(options) {
+        return options?.groups
+            ? benchmark_format_markdown_grouped(this.#results, options.groups)
+            : benchmark_format_markdown(this.#results);
     }
     /**
      * Format results as JSON.
@@ -349,6 +366,37 @@ export class Benchmark {
     results() {
         return [...this.#results];
     }
+    /**
+     * Check if the benchmark has been run and has results.
+     * @returns True if results are available
+     *
+     * @example
+     * ```ts
+     * if (bench.has_results) {
+     *   console.log(bench.table());
+     * }
+     * ```
+     */
+    get has_results() {
+        return this.#results.length > 0;
+    }
+    /**
+     * Get results as a map for convenient lookup by task name.
+     * Returns a new Map each call to prevent external mutation.
+     * @returns Map of task name to benchmark result
+     *
+     * @example
+     * ```ts
+     * const results_map = bench.results_by_name();
+     * const slugify_result = results_map.get('slugify');
+     * if (slugify_result) {
+     *   console.log(`slugify: ${slugify_result.stats.ops_per_second} ops/sec`);
+     * }
+     * ```
+     */
+    results_by_name() {
+        return new Map(this.#results.map((r) => [r.name, r]));
+    }
     /**
      * Reset the benchmark results.
      * Keeps tasks intact so benchmarks can be rerun.

package/dist/benchmark_baseline.d.ts

@@ -11,7 +11,7 @@ import { type BenchmarkComparison } from './benchmark_stats.js';
 export declare const BenchmarkBaselineEntry: z.ZodObject<{
     name: z.ZodString;
     mean_ns: z.ZodNumber;
-    median_ns: z.ZodNumber;
+    p50_ns: z.ZodNumber;
     std_dev_ns: z.ZodNumber;
     min_ns: z.ZodNumber;
     max_ns: z.ZodNumber;
@@ -35,7 +35,7 @@ export declare const BenchmarkBaseline: z.ZodObject<{
     entries: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         mean_ns: z.ZodNumber;
-        median_ns: z.ZodNumber;
+        p50_ns: z.ZodNumber;
         std_dev_ns: z.ZodNumber;
         min_ns: z.ZodNumber;
         max_ns: z.ZodNumber;

package/dist/benchmark_baseline.js

@@ -10,14 +10,14 @@ import { git_info_get } from './git.js';
 import { benchmark_stats_compare, } from './benchmark_stats.js';
 import { stats_confidence_interval_from_summary } from './stats.js';
 // Version for forward compatibility - increment when schema changes
-const BASELINE_VERSION = 1;
+const BASELINE_VERSION = 2;
 /**
  * Schema for a single benchmark entry in the baseline.
  */
 export const BenchmarkBaselineEntry = z.object({
     name: z.string(),
     mean_ns: z.number(),
-    median_ns: z.number(),
+    p50_ns: z.number(),
     std_dev_ns: z.number(),
     min_ns: z.number(),
     max_ns: z.number(),
@@ -48,7 +48,7 @@ const results_to_entries = (results) => {
     return results.map((r) => ({
         name: r.name,
         mean_ns: r.stats.mean_ns,
-        median_ns: r.stats.median_ns,
+        p50_ns: r.stats.p50_ns,
         std_dev_ns: r.stats.std_dev_ns,
         min_ns: r.stats.min_ns,
         max_ns: r.stats.max_ns,

package/dist/benchmark_format.d.ts

@@ -3,36 +3,63 @@ import type { BenchmarkResult, BenchmarkGroup } from './benchmark_types.js';
  * Format results as an ASCII table with percentiles, min/max, and relative performance.
  * All times use the same unit for easy comparison.
  * @param results - Array of benchmark results
+ * @param baseline - Optional task name to use as baseline for comparison (defaults to fastest)
  * @returns Formatted table string with enhanced metrics
  *
  * @example
  * ```ts
  * console.log(benchmark_format_table(results));
- * // ┌─────────────┬────────────┬────────────┬──────────┬──────────┬──────────┬──────────┬──────────┬──────────┬──────────┐
- * // │ Task Name   │  ops/sec   │ median(μs) │ p75 (μs) │ p90 (μs) │ p95 (μs) │ p99 (μs) │ min (μs) │ max (μs) │ vs Best  │
- * // ├─────────────┼────────────┼────────────┼──────────┼──────────┼──────────┼──────────┼──────────┼──────────┼──────────┤
- * // │ slugify v2  │ 1,237,144  │    0.81    │   0.85   │   0.89   │   0.95   │   1.20   │   0.72   │    2.45  │ baseline │
- * // │ slugify     │   261,619  │    3.82    │   3.95   │   4.12   │   4.35   │   5.10   │   3.21   │   12.45  │   4.73x  │
- * // └─────────────┴────────────┴────────────┴──────────┴──────────┴──────────┴──────────┴──────────┴──────────┴──────────┘
+ * // ┌─────────────┬────────────┬──────────┬──────────┬──────────┬──────────┬──────────┬──────────┬──────────┬──────────┐
+ * // │ Task Name   │  ops/sec   │ p50 (μs) │ p75 (μs) │ p90 (μs) │ p95 (μs) │ p99 (μs) │ min (μs) │ max (μs) │ vs Best  │
+ * // ├─────────────┼────────────┼──────────┼──────────┼──────────┼──────────┼──────────┼──────────┼──────────┼──────────┤
+ * // │ slugify v2  │ 1,237,144  │   0.81   │   0.85   │   0.89   │   0.95   │   1.20   │   0.72   │   2.45   │ baseline │
+ * // │ slugify     │   261,619  │   3.82   │   3.95   │   4.12   │   4.35   │   5.10   │   3.21   │  12.45   │   4.73x  │
+ * // └─────────────┴────────────┴──────────┴──────────┴──────────┴──────────┴──────────┴──────────┴──────────┴──────────┘
  * ```
  */
-export declare const benchmark_format_table: (results: Array<BenchmarkResult>) => string;
+export declare const benchmark_format_table: (results: Array<BenchmarkResult>, baseline?: string) => string;
 /**
  * Format results as a Markdown table with key metrics.
  * All times use the same unit for easy comparison.
  * @param results - Array of benchmark results
+ * @param baseline - Optional task name to use as baseline for comparison (defaults to fastest)
  * @returns Formatted markdown table string
  *
  * @example
  * ```ts
  * console.log(benchmark_format_markdown(results));
- * // | Task Name  | ops/sec    | median (μs) | p75 (μs) | p90 (μs) | p95 (μs) | p99 (μs) | min (μs) | max (μs) | vs Best  |
- * // |------------|------------|-------------|----------|----------|----------|----------|----------|----------|----------|
- * // | slugify v2 | 1,237,144  | 0.81        | 0.85     | 0.89     | 0.95     | 1.20     | 0.72     | 2.45     | baseline |
- * // | slugify    |   261,619  | 3.82        | 3.95     | 4.12     | 4.35     | 5.10     | 3.21     | 12.45    | 4.73x    |
+ * // | Task Name  | ops/sec    | p50 (μs) | p75 (μs) | p90 (μs) | p95 (μs) | p99 (μs) | min (μs) | max (μs) | vs Best  |
+ * // |------------|------------|----------|----------|----------|----------|----------|----------|----------|----------|
+ * // | slugify v2 | 1,237,144  | 0.81     | 0.85     | 0.89     | 0.95     | 1.20     | 0.72     | 2.45     | baseline |
+ * // | slugify    |   261,619  | 3.82     | 3.95     | 4.12     | 4.35     | 5.10     | 3.21     | 12.45    | 4.73x    |
  * ```
  */
-export declare const benchmark_format_markdown: (results: Array<BenchmarkResult>) => string;
+export declare const benchmark_format_markdown: (results: Array<BenchmarkResult>, baseline?: string) => string;
+/**
+ * Format results as grouped Markdown tables with headers between groups.
+ * @param results - Array of benchmark results
+ * @param groups - Array of group definitions
+ * @returns Formatted markdown string with group headers and tables
+ *
+ * @example
+ * ```ts
+ * const groups = [
+ *   { name: 'Fast Paths', filter: (r) => r.name.includes('fast'), baseline: 'fast/reference' },
+ *   { name: 'Slow Paths', filter: (r) => r.name.includes('slow') },
+ * ];
+ * console.log(benchmark_format_markdown_grouped(results, groups));
+ * // ### Fast Paths
+ * // | Task Name | ops/sec | ... | vs fast/reference |
+ * // |-----------|---------|-----|-------------------|
+ * // | ...       | ...     | ... | ...               |
+ * //
+ * // ### Slow Paths
+ * // | Task Name | ops/sec | ... | vs Best |
+ * // |-----------|---------|-----|---------|
+ * // | ...       | ...     | ... | ...     |
+ * ```
+ */
+export declare const benchmark_format_markdown_grouped: (results: Array<BenchmarkResult>, groups: Array<BenchmarkGroup>) => string;
 export interface BenchmarkFormatJsonOptions {
     /** Whether to pretty-print (default: true) */
     pretty?: boolean;

package/dist/benchmark_format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"benchmark_format.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/benchmark_format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAE,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAK1E;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,KAAK,CAAC,eAAe,CAAC,KAAG,MAiFxE,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,yBAAyB,GAAI,SAAS,KAAK,CAAC,eAAe,CAAC,KAAG,MA4E3E,CAAC;AAEF,MAAM,WAAW,0BAA0B;IAC1C,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GACjC,SAAS,KAAK,CAAC,eAAe,CAAC,EAC/B,UAAU,0BAA0B,KAClC,MA6BF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,8BAA8B,GAC1C,SAAS,KAAK,CAAC,eAAe,CAAC,EAC/B,QAAQ,KAAK,CAAC,cAAc,CAAC,KAC3B,MA2BF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,0CAAgB,CAAC"}
+{"version":3,"file":"benchmark_format.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/benchmark_format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAE,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAK1E;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,sBAAsB,GAClC,SAAS,KAAK,CAAC,eAAe,CAAC,EAC/B,WAAW,MAAM,KACf,MAiGF,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,yBAAyB,GACrC,SAAS,KAAK,CAAC,eAAe,CAAC,EAC/B,WAAW,MAAM,KACf,MA4FF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,iCAAiC,GAC7C,SAAS,KAAK,CAAC,eAAe,CAAC,EAC/B,QAAQ,KAAK,CAAC,cAAc,CAAC,KAC3B,MA2BF,CAAC;AAEF,MAAM,WAAW,0BAA0B;IAC1C,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GACjC,SAAS,KAAK,CAAC,eAAe,CAAC,EAC/B,UAAU,0BAA0B,KAClC,MA6BF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,8BAA8B,GAC1C,SAAS,KAAK,CAAC,eAAe,CAAC,EAC/B,QAAQ,KAAK,CAAC,cAAc,CAAC,KAC3B,MA2BF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,0CAAgB,CAAC"}

package/dist/benchmark_format.js

@@ -5,46 +5,61 @@ import { format_number } from './maths.js';
  * Format results as an ASCII table with percentiles, min/max, and relative performance.
  * All times use the same unit for easy comparison.
  * @param results - Array of benchmark results
+ * @param baseline - Optional task name to use as baseline for comparison (defaults to fastest)
  * @returns Formatted table string with enhanced metrics
  *
  * @example
  * ```ts
  * console.log(benchmark_format_table(results));
- * // ┌─────────────┬────────────┬────────────┬──────────┬──────────┬──────────┬──────────┬──────────┬──────────┬──────────┐
- * // │ Task Name   │  ops/sec   │ median(μs) │ p75 (μs) │ p90 (μs) │ p95 (μs) │ p99 (μs) │ min (μs) │ max (μs) │ vs Best  │
- * // ├─────────────┼────────────┼────────────┼──────────┼──────────┼──────────┼──────────┼──────────┼──────────┼──────────┤
- * // │ slugify v2  │ 1,237,144  │    0.81    │   0.85   │   0.89   │   0.95   │   1.20   │   0.72   │    2.45  │ baseline │
- * // │ slugify     │   261,619  │    3.82    │   3.95   │   4.12   │   4.35   │   5.10   │   3.21   │   12.45  │   4.73x  │
- * // └─────────────┴────────────┴────────────┴──────────┴──────────┴──────────┴──────────┴──────────┴──────────┴──────────┘
+ * // ┌─────────────┬────────────┬──────────┬──────────┬──────────┬──────────┬──────────┬──────────┬──────────┬──────────┐
+ * // │ Task Name   │  ops/sec   │ p50 (μs) │ p75 (μs) │ p90 (μs) │ p95 (μs) │ p99 (μs) │ min (μs) │ max (μs) │ vs Best  │
+ * // ├─────────────┼────────────┼──────────┼──────────┼──────────┼──────────┼──────────┼──────────┼──────────┼──────────┤
+ * // │ slugify v2  │ 1,237,144  │   0.81   │   0.85   │   0.89   │   0.95   │   1.20   │   0.72   │   2.45   │ baseline │
+ * // │ slugify     │   261,619  │   3.82   │   3.95   │   4.12   │   4.35   │   5.10   │   3.21   │  12.45   │   4.73x  │
+ * // └─────────────┴────────────┴──────────┴──────────┴──────────┴──────────┴──────────┴──────────┴──────────┴──────────┘
  * ```
  */
-export const benchmark_format_table = (results) => {
+export const benchmark_format_table = (results, baseline) => {
     if (results.length === 0)
         return '(no results)';
     // Detect best unit for all results
     const mean_times = results.map((r) => r.stats.mean_ns);
     const unit = time_unit_detect_best(mean_times);
     const unit_str = TIME_UNIT_DISPLAY[unit];
-    // Find fastest for relative comparison
-    const fastest_ops = Math.max(...results.map((r) => r.stats.ops_per_second));
+    // Find baseline for relative comparison
+    let baseline_ops;
+    let vs_column_header;
+    if (baseline !== undefined) {
+        const baseline_result = results.find((r) => r.name === baseline);
+        if (!baseline_result) {
+            const available = results.map((r) => r.name).join(', ');
+            throw new Error(`Baseline task "${baseline}" not found in results. Available tasks: ${available}`);
+        }
+        baseline_ops = baseline_result.stats.ops_per_second;
+        vs_column_header = `vs ${baseline}`;
+    }
+    else {
+        baseline_ops = Math.max(...results.map((r) => r.stats.ops_per_second));
+        vs_column_header = 'vs Best';
+    }
     const rows = [];
     // Header with unit
     rows.push([
         'Task Name',
         'ops/sec',
-        `median (${unit_str})`,
+        `p50 (${unit_str})`,
         `p75 (${unit_str})`,
         `p90 (${unit_str})`,
         `p95 (${unit_str})`,
         `p99 (${unit_str})`,
         `min (${unit_str})`,
         `max (${unit_str})`,
-        'vs Best',
+        vs_column_header,
     ]);
     // Data rows - all use same unit
     results.forEach((r) => {
         const ops_sec = benchmark_format_number(r.stats.ops_per_second, 2);
-        const median = time_format(r.stats.median_ns, unit, 2).replace(unit_str, '').trim();
+        const p50 = time_format(r.stats.p50_ns, unit, 2).replace(unit_str, '').trim();
         const p75 = time_format(r.stats.p75_ns, unit, 2).replace(unit_str, '').trim();
         const p90 = time_format(r.stats.p90_ns, unit, 2).replace(unit_str, '').trim();
         const p95 = time_format(r.stats.p95_ns, unit, 2).replace(unit_str, '').trim();
@@ -52,9 +67,9 @@ export const benchmark_format_table = (results) => {
         const min = time_format(r.stats.min_ns, unit, 2).replace(unit_str, '').trim();
         const max = time_format(r.stats.max_ns, unit, 2).replace(unit_str, '').trim();
         // Calculate relative performance
-        const ratio = fastest_ops / r.stats.ops_per_second;
-        const vs_best = ratio === 1.0 ? 'baseline' : `${ratio.toFixed(2)}x`;
-        rows.push([r.name, ops_sec, median, p75, p90, p95, p99, min, max, vs_best]);
+        const ratio = baseline_ops / r.stats.ops_per_second;
+        const vs_baseline = ratio === 1.0 ? 'baseline' : `${ratio.toFixed(2)}x`;
+        rows.push([r.name, ops_sec, p50, p75, p90, p95, p99, min, max, vs_baseline]);
     });
     // Calculate column widths (using display width for proper emoji handling)
     const widths = rows[0].map((_, col_i) => {
@@ -91,44 +106,59 @@ export const benchmark_format_table = (results) => {
  * Format results as a Markdown table with key metrics.
  * All times use the same unit for easy comparison.
  * @param results - Array of benchmark results
+ * @param baseline - Optional task name to use as baseline for comparison (defaults to fastest)
  * @returns Formatted markdown table string
  *
  * @example
  * ```ts
  * console.log(benchmark_format_markdown(results));
- * // | Task Name  | ops/sec    | median (μs) | p75 (μs) | p90 (μs) | p95 (μs) | p99 (μs) | min (μs) | max (μs) | vs Best  |
- * // |------------|------------|-------------|----------|----------|----------|----------|----------|----------|----------|
- * // | slugify v2 | 1,237,144  | 0.81        | 0.85     | 0.89     | 0.95     | 1.20     | 0.72     | 2.45     | baseline |
- * // | slugify    |   261,619  | 3.82        | 3.95     | 4.12     | 4.35     | 5.10     | 3.21     | 12.45    | 4.73x    |
+ * // | Task Name  | ops/sec    | p50 (μs) | p75 (μs) | p90 (μs) | p95 (μs) | p99 (μs) | min (μs) | max (μs) | vs Best  |
+ * // |------------|------------|----------|----------|----------|----------|----------|----------|----------|----------|
+ * // | slugify v2 | 1,237,144  | 0.81     | 0.85     | 0.89     | 0.95     | 1.20     | 0.72     | 2.45     | baseline |
+ * // | slugify    |   261,619  | 3.82     | 3.95     | 4.12     | 4.35     | 5.10     | 3.21     | 12.45    | 4.73x    |
  * ```
  */
-export const benchmark_format_markdown = (results) => {
+export const benchmark_format_markdown = (results, baseline) => {
     if (results.length === 0)
         return '(no results)';
     // Detect best unit for all results
     const mean_times = results.map((r) => r.stats.mean_ns);
     const unit = time_unit_detect_best(mean_times);
     const unit_str = TIME_UNIT_DISPLAY[unit];
-    // Find fastest for relative comparison
-    const fastest_ops = Math.max(...results.map((r) => r.stats.ops_per_second));
+    // Find baseline for relative comparison
+    let baseline_ops;
+    let vs_column_header;
+    if (baseline !== undefined) {
+        const baseline_result = results.find((r) => r.name === baseline);
+        if (!baseline_result) {
+            const available = results.map((r) => r.name).join(', ');
+            throw new Error(`Baseline task "${baseline}" not found in results. Available tasks: ${available}`);
+        }
+        baseline_ops = baseline_result.stats.ops_per_second;
+        vs_column_header = `vs ${baseline}`;
+    }
+    else {
+        baseline_ops = Math.max(...results.map((r) => r.stats.ops_per_second));
+        vs_column_header = 'vs Best';
+    }
     const rows = [];
     // Header with unit
     rows.push([
         'Task Name',
         'ops/sec',
-        `median (${unit_str})`,
+        `p50 (${unit_str})`,
         `p75 (${unit_str})`,
         `p90 (${unit_str})`,
         `p95 (${unit_str})`,
         `p99 (${unit_str})`,
         `min (${unit_str})`,
         `max (${unit_str})`,
-        'vs Best',
+        vs_column_header,
     ]);
     // Data rows - all use same unit
     results.forEach((r) => {
         const ops_sec = benchmark_format_number(r.stats.ops_per_second, 2);
-        const median = time_format(r.stats.median_ns, unit, 2).replace(unit_str, '').trim();
+        const p50 = time_format(r.stats.p50_ns, unit, 2).replace(unit_str, '').trim();
         const p75 = time_format(r.stats.p75_ns, unit, 2).replace(unit_str, '').trim();
         const p90 = time_format(r.stats.p90_ns, unit, 2).replace(unit_str, '').trim();
         const p95 = time_format(r.stats.p95_ns, unit, 2).replace(unit_str, '').trim();
@@ -136,9 +166,9 @@ export const benchmark_format_markdown = (results) => {
         const min = time_format(r.stats.min_ns, unit, 2).replace(unit_str, '').trim();
         const max = time_format(r.stats.max_ns, unit, 2).replace(unit_str, '').trim();
         // Calculate relative performance
-        const ratio = fastest_ops / r.stats.ops_per_second;
-        const vs_best = ratio === 1.0 ? 'baseline' : `${ratio.toFixed(2)}x`;
-        rows.push([r.name, ops_sec, median, p75, p90, p95, p99, min, max, vs_best]);
+        const ratio = baseline_ops / r.stats.ops_per_second;
+        const vs_baseline = ratio === 1.0 ? 'baseline' : `${ratio.toFixed(2)}x`;
+        rows.push([r.name, ops_sec, p50, p75, p90, p95, p99, min, max, vs_baseline]);
     });
     // Calculate column widths
     const widths = rows[0].map((_, col_i) => {
@@ -168,6 +198,54 @@ export const benchmark_format_markdown = (results) => {
     }
     return lines.join('\n');
 };
+/**
+ * Format results as grouped Markdown tables with headers between groups.
+ * @param results - Array of benchmark results
+ * @param groups - Array of group definitions
+ * @returns Formatted markdown string with group headers and tables
+ *
+ * @example
+ * ```ts
+ * const groups = [
+ *   { name: 'Fast Paths', filter: (r) => r.name.includes('fast'), baseline: 'fast/reference' },
+ *   { name: 'Slow Paths', filter: (r) => r.name.includes('slow') },
+ * ];
+ * console.log(benchmark_format_markdown_grouped(results, groups));
+ * // ### Fast Paths
+ * // | Task Name | ops/sec | ... | vs fast/reference |
+ * // |-----------|---------|-----|-------------------|
+ * // | ...       | ...     | ... | ...               |
+ * //
+ * // ### Slow Paths
+ * // | Task Name | ops/sec | ... | vs Best |
+ * // |-----------|---------|-----|---------|
+ * // | ...       | ...     | ... | ...     |
+ * ```
+ */
+export const benchmark_format_markdown_grouped = (results, groups) => {
+    if (results.length === 0)
+        return '(no results)';
+    const sections = [];
+    for (const group of groups) {
+        const group_results = results.filter(group.filter);
+        if (group_results.length === 0)
+            continue;
+        // Add group header and table
+        const header = group.description
+            ? `### ${group.name}\n\n${group.description}\n`
+            : `### ${group.name}\n`;
+        sections.push(header);
+        sections.push(benchmark_format_markdown(group_results, group.baseline));
+    }
+    // Handle ungrouped results (those that don't match any group)
+    const grouped_names = new Set(groups.flatMap((g) => results.filter(g.filter).map((r) => r.name)));
+    const ungrouped = results.filter((r) => !grouped_names.has(r.name));
+    if (ungrouped.length > 0) {
+        sections.push('### Other\n');
+        sections.push(benchmark_format_markdown(ungrouped));
+    }
+    return sections.join('\n');
+};
 /**
  * Format results as JSON.
  * @param results - Array of benchmark results
@@ -191,7 +269,7 @@ export const benchmark_format_json = (results, options) => {
         total_time_ms: r.total_time_ms,
         ops_per_second: r.stats.ops_per_second,
         mean_ns: r.stats.mean_ns,
-        median_ns: r.stats.median_ns,
+        p50_ns: r.stats.p50_ns,
         std_dev_ns: r.stats.std_dev_ns,
         min_ns: r.stats.min_ns,
         max_ns: r.stats.max_ns,
@@ -248,7 +326,7 @@ export const benchmark_format_table_grouped = (results, groups) => {
             ? `\n📦 ${group.name}\n   ${group.description}`
             : `\n📦 ${group.name}`;
         sections.push(header);
-        sections.push(benchmark_format_table(group_results));
+        sections.push(benchmark_format_table(group_results, group.baseline));
     }
     // Handle ungrouped results (those that don't match any group)
     const grouped_names = new Set(groups.flatMap((g) => results.filter(g.filter).map((r) => r.name)));

package/dist/benchmark_stats.d.ts

@@ -53,8 +53,8 @@ export interface BenchmarkCompareOptions {
 export declare class BenchmarkStats {
     /** Mean (average) time in nanoseconds */
     readonly mean_ns: number;
-    /** Median time in nanoseconds */
-    readonly median_ns: number;
+    /** 50th percentile (median) time in nanoseconds */
+    readonly p50_ns: number;
     /** Standard deviation in nanoseconds */
     readonly std_dev_ns: number;
     /** Minimum time in nanoseconds */

package/dist/benchmark_stats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"benchmark_stats.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/benchmark_stats.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,mFAAmF;IACnF,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,OAAO,CAAC;IAC5B,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,WAAW,EAAE,OAAO,CAAC;IACrB,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,gBAAgB,EAAE,eAAe,CAAC;IAClC,mDAAmD;IACnD,UAAU,EAAE,OAAO,CAAC;IACpB,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,qBAAa,cAAc;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,CAAC,sBAAsB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,sDAAsD;IACtD,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,yCAAyC;IACzC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,mDAAmD;IACnD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,sEAAsE;IACtE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;gBAEvB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC;IAiErC;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGlB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,uBAAuB,GACnC,GAAG,wBAAwB,EAC3B,GAAG,wBAAwB,EAC3B,UAAU,uBAAuB,KAC/B,mBA6GF,CAAC"}
+{"version":3,"file":"benchmark_stats.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/benchmark_stats.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,mFAAmF;IACnF,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,OAAO,CAAC;IAC5B,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,WAAW,EAAE,OAAO,CAAC;IACrB,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,gBAAgB,EAAE,eAAe,CAAC;IAClC,mDAAmD;IACnD,UAAU,EAAE,OAAO,CAAC;IACpB,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,qBAAa,cAAc;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,CAAC,sBAAsB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,sDAAsD;IACtD,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,yCAAyC;IACzC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,mDAAmD;IACnD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,sEAAsE;IACtE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;gBAEvB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC;IAiErC;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGlB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,uBAAuB,GACnC,GAAG,wBAAwB,EAC3B,GAAG,wBAAwB,EAC3B,UAAU,uBAAuB,KAC/B,mBA6GF,CAAC"}

package/dist/benchmark_stats.js

@@ -13,8 +13,8 @@ import { stats_mean, stats_median, stats_std_dev, stats_percentile, stats_cv, st
 export class BenchmarkStats {
     /** Mean (average) time in nanoseconds */
     mean_ns;
-    /** Median time in nanoseconds */
-    median_ns;
+    /** 50th percentile (median) time in nanoseconds */
+    p50_ns;
     /** Standard deviation in nanoseconds */
     std_dev_ns;
     /** Minimum time in nanoseconds */
@@ -62,7 +62,7 @@ export class BenchmarkStats {
         // If no valid timings, return empty stats
         if (valid_timings.length === 0) {
             this.mean_ns = NaN;
-            this.median_ns = NaN;
+            this.p50_ns = NaN;
             this.std_dev_ns = NaN;
             this.min_ns = NaN;
             this.max_ns = NaN;
@@ -86,7 +86,7 @@ export class BenchmarkStats {
         this.sample_size = cleaned.length;
         // Calculate statistics on cleaned data
         this.mean_ns = stats_mean(cleaned);
-        this.median_ns = stats_median(sorted_cleaned);
+        this.p50_ns = stats_median(sorted_cleaned);
         this.std_dev_ns = stats_std_dev(cleaned, this.mean_ns);
         const { min, max } = stats_min_max(sorted_cleaned);
         this.min_ns = min;

package/dist/benchmark_types.d.ts

@@ -170,5 +170,11 @@ export interface BenchmarkGroup {
     description?: string;
     /** Filter function to determine which results belong to this group */
     filter: (result: BenchmarkResult) => boolean;
+    /**
+     * Task name to use as baseline for the "vs" column.
+     * When specified, ratios are computed against this task instead of the fastest.
+     * If the baseline task is not found in the group, falls back to "vs Best" with a warning.
+     */
+    baseline?: string;
 }
 //# sourceMappingURL=benchmark_types.d.ts.map

package/dist/benchmark_types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"benchmark_types.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/benchmark_types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,WAAW,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACH,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAEjF;;;;;;;;;;;;;;;;OAgBG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnF;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IAEb,wEAAwE;IACxE,EAAE,EAAE,MAAM,OAAO,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IAEb,4CAA4C;IAC5C,KAAK,EAAE,cAAc,CAAC;IAEtB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IAEnB,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC3C;;OAEG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,sEAAsE;IACtE,MAAM,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC;CAC7C"}
+{"version":3,"file":"benchmark_types.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/benchmark_types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,WAAW,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACH,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAEjF;;;;;;;;;;;;;;;;OAgBG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnF;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IAEb,wEAAwE;IACxE,EAAE,EAAE,MAAM,OAAO,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IAEb,4CAA4C;IAC5C,KAAK,EAAE,cAAc,CAAC;IAEtB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IAEnB,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC3C;;OAEG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,sEAAsE;IACtE,MAAM,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC;IAE7C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/package_json.d.ts

@@ -33,7 +33,6 @@ export declare const PackageJson: z.ZodObject<{
     name: z.ZodString;
     version: z.ZodString;
     private: z.ZodOptional<z.ZodBoolean>;
-    public: z.ZodOptional<z.ZodBoolean>;
     description: z.ZodOptional<z.ZodString>;
     motto: z.ZodOptional<z.ZodString>;
     glyph: z.ZodOptional<z.ZodString>;

package/dist/package_json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package_json.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/package_json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAMtB,eAAO,MAAM,qBAAqB;;;;mBAOhC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E,eAAO,MAAM,iBAAiB;;;;mBAO5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,kBAAkB;;;mBAM7B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAapE,eAAO,MAAM,WAAW,yEAAsB,CAAC;AAC/C,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,kJAI7B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoEtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}
+{"version":3,"file":"package_json.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/package_json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAMtB,eAAO,MAAM,qBAAqB;;;;mBAOhC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E,eAAO,MAAM,iBAAiB;;;;mBAO5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,kBAAkB;;;mBAM7B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAapE,eAAO,MAAM,WAAW,yEAAsB,CAAC;AAC/C,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,kJAI7B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6DtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/package_json.js

@@ -54,12 +54,6 @@ export const PackageJson = z.looseObject({
         .boolean()
         .meta({ description: 'disallow publishing to the configured registry' })
         .optional(),
-    public: z
-        .boolean()
-        .meta({
-        description: 'a Gro extension that enables publishing `.well-known/package.json` and `.well-known/src`',
-    })
-        .optional(),
     description: z.string().optional(),
     motto: z
         .string()

package/dist/process.d.ts

@@ -74,4 +74,8 @@ export interface RestartableProcess {
  * handling many concurrent `restart` calls gracefully.
  */
 export declare const spawn_restartable_process: (command: string, args?: ReadonlyArray<string>, options?: SpawnOptions) => RestartableProcess;
+/**
+ * Check if a PID is still running.
+ */
+export declare const process_is_pid_running: (pid: number) => boolean;
 //# sourceMappingURL=process.d.ts.map

package/dist/process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,aAAa,CAAC;AAIxC,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,OAAO;IACvB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAID,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,UAAU,CAAC,OAAO,aAAa,CAAC,KAAG,OAAO,CAAC,WAAW,CACvD,CAAC;AAE/B,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,GACrB,SAAS,MAAM,EACf,OAAM,aAAa,CAAC,MAAM,CAAM,EAChC,UAAU,YAAY,KACpB,OAAO,CAAC,UAAU,CAYpB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACzB,SAAS,MAAM,EACf,OAAM,aAAa,CAAC,MAAM,CAAM,EAChC,UAAU,YAAY,KACpB,cAUF,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,OAAO,YAAY,KAAG,MACwC,CAAC;AAEnG;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,GAAG,CAAC,YAAY,CAAa,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,YAAY,KAAG,CAAC,MAAM,IAAI,CAWtE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,YAAY,KAAG,OAAO,CAAC,WAAW,CAShE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,QAAO,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CACQ,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,GACzC,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,uBAAuB,KAAK,MAAM,GAAG,IAAI,EACtF,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,uBAAuB,KAAK,MAAM,GAAG,IAAI,EACtF,eAAc,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,uBAAuB,KAAK,IACtD,KACd,IAYF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,WAAW,KAAG,MAKxD,CAAC;AAGF,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GACrC,SAAS,MAAM,EACf,OAAM,aAAa,CAAC,MAAM,CAAM,EAChC,UAAU,YAAY,KACpB,kBAuBF,CAAC"}
+{"version":3,"file":"process.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,aAAa,CAAC;AAIxC,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,OAAO;IACvB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAID,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,UAAU,CAAC,OAAO,aAAa,CAAC,KAAG,OAAO,CAAC,WAAW,CACvD,CAAC;AAE/B,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,GACrB,SAAS,MAAM,EACf,OAAM,aAAa,CAAC,MAAM,CAAM,EAChC,UAAU,YAAY,KACpB,OAAO,CAAC,UAAU,CAYpB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACzB,SAAS,MAAM,EACf,OAAM,aAAa,CAAC,MAAM,CAAM,EAChC,UAAU,YAAY,KACpB,cAUF,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,OAAO,YAAY,KAAG,MACwC,CAAC;AAEnG;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,GAAG,CAAC,YAAY,CAAa,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,YAAY,KAAG,CAAC,MAAM,IAAI,CAWtE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,YAAY,KAAG,OAAO,CAAC,WAAW,CAShE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,QAAO,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CACQ,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,GACzC,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,uBAAuB,KAAK,MAAM,GAAG,IAAI,EACtF,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,uBAAuB,KAAK,MAAM,GAAG,IAAI,EACtF,eAAc,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,uBAAuB,KAAK,IACtD,KACd,IAYF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,WAAW,KAAG,MAKxD,CAAC;AAGF,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GACrC,SAAS,MAAM,EACf,OAAM,aAAa,CAAC,MAAM,CAAM,EAChC,UAAU,YAAY,KACpB,kBAuBF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,OASpD,CAAC"}

package/dist/process.js

@@ -146,3 +146,17 @@ export const spawn_restartable_process = (command, args = [], options) => {
     void restart();
     return { restart, kill };
 };
+/**
+ * Check if a PID is still running.
+ */
+export const process_is_pid_running = (pid) => {
+    try {
+        // Sending signal 0 doesn't actually send a signal, just checks if process exists
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        // ESRCH = no such process, EPERM = exists but no permission
+        return err.code === 'EPERM';
+    }
+};

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "@fuzdev/fuz_util",
-  "version": "0.44.0",
+  "version": "0.45.0",
   "description": "utility belt for JS",
   "glyph": "🦕",
   "logo": "logo.svg",
   "logo_alt": "a green sauropod wearing a brown utility belt",
   "motto": "ancient not extinct",
-  "public": true,
   "license": "MIT",
   "homepage": "https://util.fuz.dev/",
   "author": {

package/src/lib/benchmark.ts

@@ -26,6 +26,7 @@ import {
 	benchmark_format_table,
 	benchmark_format_table_grouped,
 	benchmark_format_markdown,
+	benchmark_format_markdown_grouped,
 	benchmark_format_json,
 	benchmark_format_number,
 	type BenchmarkFormatJsonOptions,
@@ -407,10 +408,27 @@ export class Benchmark {
 
 	/**
 	 * Format results as a Markdown table.
+	 * @param options - Formatting options (groups for organized output with optional baselines)
 	 * @returns Formatted markdown string
+	 *
+	 * @example
+	 * ```ts
+	 * // Standard table
+	 * console.log(bench.markdown());
+	 *
+	 * // Grouped by category with custom baseline
+	 * console.log(bench.markdown({
+	 *   groups: [
+	 *     { name: 'Format', filter: (r) => r.name.startsWith('format/'), baseline: 'format/prettier' },
+	 *     { name: 'Parse', filter: (r) => r.name.startsWith('parse/') },
+	 *   ]
+	 * }));
+	 * ```
 	 */
-	markdown(): string {
-		return benchmark_format_markdown(this.#results);
+	markdown(options?: BenchmarkFormatTableOptions): string {
+		return options?.groups
+			? benchmark_format_markdown_grouped(this.#results, options.groups)
+			: benchmark_format_markdown(this.#results);
 	}
 
 	/**
@@ -431,6 +449,39 @@ export class Benchmark {
 		return [...this.#results];
 	}
 
+	/**
+	 * Check if the benchmark has been run and has results.
+	 * @returns True if results are available
+	 *
+	 * @example
+	 * ```ts
+	 * if (bench.has_results) {
+	 *   console.log(bench.table());
+	 * }
+	 * ```
+	 */
+	get has_results(): boolean {
+		return this.#results.length > 0;
+	}
+
+	/**
+	 * Get results as a map for convenient lookup by task name.
+	 * Returns a new Map each call to prevent external mutation.
+	 * @returns Map of task name to benchmark result
+	 *
+	 * @example
+	 * ```ts
+	 * const results_map = bench.results_by_name();
+	 * const slugify_result = results_map.get('slugify');
+	 * if (slugify_result) {
+	 *   console.log(`slugify: ${slugify_result.stats.ops_per_second} ops/sec`);
+	 * }
+	 * ```
+	 */
+	results_by_name(): Map<string, BenchmarkResult> {
+		return new Map(this.#results.map((r) => [r.name, r]));
+	}
+
 	/**
 	 * Reset the benchmark results.
 	 * Keeps tasks intact so benchmarks can be rerun.

package/src/lib/benchmark_baseline.ts

@@ -18,7 +18,7 @@ import {
 import {stats_confidence_interval_from_summary} from './stats.js';
 
 // Version for forward compatibility - increment when schema changes
-const BASELINE_VERSION = 1;
+const BASELINE_VERSION = 2;
 
 /**
  * Schema for a single benchmark entry in the baseline.
@@ -26,7 +26,7 @@ const BASELINE_VERSION = 1;
 export const BenchmarkBaselineEntry = z.object({
 	name: z.string(),
 	mean_ns: z.number(),
-	median_ns: z.number(),
+	p50_ns: z.number(),
 	std_dev_ns: z.number(),
 	min_ns: z.number(),
 	max_ns: z.number(),
@@ -137,7 +137,7 @@ const results_to_entries = (results: Array<BenchmarkResult>): Array<BenchmarkBas
 	return results.map((r) => ({
 		name: r.name,
 		mean_ns: r.stats.mean_ns,
-		median_ns: r.stats.median_ns,
+		p50_ns: r.stats.p50_ns,
 		std_dev_ns: r.stats.std_dev_ns,
 		min_ns: r.stats.min_ns,
 		max_ns: r.stats.max_ns,

package/src/lib/benchmark_format.ts

@@ -7,20 +7,24 @@ import {format_number} from './maths.js';
  * Format results as an ASCII table with percentiles, min/max, and relative performance.
  * All times use the same unit for easy comparison.
  * @param results - Array of benchmark results
+ * @param baseline - Optional task name to use as baseline for comparison (defaults to fastest)
  * @returns Formatted table string with enhanced metrics
  *
  * @example
  * ```ts
  * console.log(benchmark_format_table(results));
- * // ┌─────────────┬────────────┬────────────┬──────────┬──────────┬──────────┬──────────┬──────────┬──────────┬──────────┐
- * // │ Task Name   │  ops/sec   │ median(μs) │ p75 (μs) │ p90 (μs) │ p95 (μs) │ p99 (μs) │ min (μs) │ max (μs) │ vs Best  │
- * // ├─────────────┼────────────┼────────────┼──────────┼──────────┼──────────┼──────────┼──────────┼──────────┼──────────┤
- * // │ slugify v2  │ 1,237,144  │    0.81    │   0.85   │   0.89   │   0.95   │   1.20   │   0.72   │    2.45  │ baseline │
- * // │ slugify     │   261,619  │    3.82    │   3.95   │   4.12   │   4.35   │   5.10   │   3.21   │   12.45  │   4.73x  │
- * // └─────────────┴────────────┴────────────┴──────────┴──────────┴──────────┴──────────┴──────────┴──────────┴──────────┘
+ * // ┌─────────────┬────────────┬──────────┬──────────┬──────────┬──────────┬──────────┬──────────┬──────────┬──────────┐
+ * // │ Task Name   │  ops/sec   │ p50 (μs) │ p75 (μs) │ p90 (μs) │ p95 (μs) │ p99 (μs) │ min (μs) │ max (μs) │ vs Best  │
+ * // ├─────────────┼────────────┼──────────┼──────────┼──────────┼──────────┼──────────┼──────────┼──────────┼──────────┤
+ * // │ slugify v2  │ 1,237,144  │   0.81   │   0.85   │   0.89   │   0.95   │   1.20   │   0.72   │   2.45   │ baseline │
+ * // │ slugify     │   261,619  │   3.82   │   3.95   │   4.12   │   4.35   │   5.10   │   3.21   │  12.45   │   4.73x  │
+ * // └─────────────┴────────────┴──────────┴──────────┴──────────┴──────────┴──────────┴──────────┴──────────┴──────────┘
  * ```
  */
-export const benchmark_format_table = (results: Array<BenchmarkResult>): string => {
+export const benchmark_format_table = (
+	results: Array<BenchmarkResult>,
+	baseline?: string,
+): string => {
 	if (results.length === 0) return '(no results)';
 
 	// Detect best unit for all results
@@ -28,8 +32,24 @@ export const benchmark_format_table = (results: Array<BenchmarkResult>): string
 	const unit = time_unit_detect_best(mean_times);
 	const unit_str = TIME_UNIT_DISPLAY[unit];
 
-	// Find fastest for relative comparison
-	const fastest_ops = Math.max(...results.map((r) => r.stats.ops_per_second));
+	// Find baseline for relative comparison
+	let baseline_ops: number;
+	let vs_column_header: string;
+
+	if (baseline !== undefined) {
+		const baseline_result = results.find((r) => r.name === baseline);
+		if (!baseline_result) {
+			const available = results.map((r) => r.name).join(', ');
+			throw new Error(
+				`Baseline task "${baseline}" not found in results. Available tasks: ${available}`,
+			);
+		}
+		baseline_ops = baseline_result.stats.ops_per_second;
+		vs_column_header = `vs ${baseline}`;
+	} else {
+		baseline_ops = Math.max(...results.map((r) => r.stats.ops_per_second));
+		vs_column_header = 'vs Best';
+	}
 
 	const rows: Array<Array<string>> = [];
 
@@ -37,20 +57,20 @@ export const benchmark_format_table = (results: Array<BenchmarkResult>): string
 	rows.push([
 		'Task Name',
 		'ops/sec',
-		`median (${unit_str})`,
+		`p50 (${unit_str})`,
 		`p75 (${unit_str})`,
 		`p90 (${unit_str})`,
 		`p95 (${unit_str})`,
 		`p99 (${unit_str})`,
 		`min (${unit_str})`,
 		`max (${unit_str})`,
-		'vs Best',
+		vs_column_header,
 	]);
 
 	// Data rows - all use same unit
 	results.forEach((r) => {
 		const ops_sec = benchmark_format_number(r.stats.ops_per_second, 2);
-		const median = time_format(r.stats.median_ns, unit, 2).replace(unit_str, '').trim();
+		const p50 = time_format(r.stats.p50_ns, unit, 2).replace(unit_str, '').trim();
 		const p75 = time_format(r.stats.p75_ns, unit, 2).replace(unit_str, '').trim();
 		const p90 = time_format(r.stats.p90_ns, unit, 2).replace(unit_str, '').trim();
 		const p95 = time_format(r.stats.p95_ns, unit, 2).replace(unit_str, '').trim();
@@ -59,10 +79,10 @@ export const benchmark_format_table = (results: Array<BenchmarkResult>): string
 		const max = time_format(r.stats.max_ns, unit, 2).replace(unit_str, '').trim();
 
 		// Calculate relative performance
-		const ratio = fastest_ops / r.stats.ops_per_second;
-		const vs_best = ratio === 1.0 ? 'baseline' : `${ratio.toFixed(2)}x`;
+		const ratio = baseline_ops / r.stats.ops_per_second;
+		const vs_baseline = ratio === 1.0 ? 'baseline' : `${ratio.toFixed(2)}x`;
 
-		rows.push([r.name, ops_sec, median, p75, p90, p95, p99, min, max, vs_best]);
+		rows.push([r.name, ops_sec, p50, p75, p90, p95, p99, min, max, vs_baseline]);
 	});
 
 	// Calculate column widths (using display width for proper emoji handling)
@@ -107,18 +127,22 @@ export const benchmark_format_table = (results: Array<BenchmarkResult>): string
  * Format results as a Markdown table with key metrics.
  * All times use the same unit for easy comparison.
  * @param results - Array of benchmark results
+ * @param baseline - Optional task name to use as baseline for comparison (defaults to fastest)
  * @returns Formatted markdown table string
  *
  * @example
  * ```ts
  * console.log(benchmark_format_markdown(results));
- * // | Task Name  | ops/sec    | median (μs) | p75 (μs) | p90 (μs) | p95 (μs) | p99 (μs) | min (μs) | max (μs) | vs Best  |
- * // |------------|------------|-------------|----------|----------|----------|----------|----------|----------|----------|
- * // | slugify v2 | 1,237,144  | 0.81        | 0.85     | 0.89     | 0.95     | 1.20     | 0.72     | 2.45     | baseline |
- * // | slugify    |   261,619  | 3.82        | 3.95     | 4.12     | 4.35     | 5.10     | 3.21     | 12.45    | 4.73x    |
+ * // | Task Name  | ops/sec    | p50 (μs) | p75 (μs) | p90 (μs) | p95 (μs) | p99 (μs) | min (μs) | max (μs) | vs Best  |
+ * // |------------|------------|----------|----------|----------|----------|----------|----------|----------|----------|
+ * // | slugify v2 | 1,237,144  | 0.81     | 0.85     | 0.89     | 0.95     | 1.20     | 0.72     | 2.45     | baseline |
+ * // | slugify    |   261,619  | 3.82     | 3.95     | 4.12     | 4.35     | 5.10     | 3.21     | 12.45    | 4.73x    |
  * ```
  */
-export const benchmark_format_markdown = (results: Array<BenchmarkResult>): string => {
+export const benchmark_format_markdown = (
+	results: Array<BenchmarkResult>,
+	baseline?: string,
+): string => {
 	if (results.length === 0) return '(no results)';
 
 	// Detect best unit for all results
@@ -126,8 +150,24 @@ export const benchmark_format_markdown = (results: Array<BenchmarkResult>): stri
 	const unit = time_unit_detect_best(mean_times);
 	const unit_str = TIME_UNIT_DISPLAY[unit];
 
-	// Find fastest for relative comparison
-	const fastest_ops = Math.max(...results.map((r) => r.stats.ops_per_second));
+	// Find baseline for relative comparison
+	let baseline_ops: number;
+	let vs_column_header: string;
+
+	if (baseline !== undefined) {
+		const baseline_result = results.find((r) => r.name === baseline);
+		if (!baseline_result) {
+			const available = results.map((r) => r.name).join(', ');
+			throw new Error(
+				`Baseline task "${baseline}" not found in results. Available tasks: ${available}`,
+			);
+		}
+		baseline_ops = baseline_result.stats.ops_per_second;
+		vs_column_header = `vs ${baseline}`;
+	} else {
+		baseline_ops = Math.max(...results.map((r) => r.stats.ops_per_second));
+		vs_column_header = 'vs Best';
+	}
 
 	const rows: Array<Array<string>> = [];
 
@@ -135,20 +175,20 @@ export const benchmark_format_markdown = (results: Array<BenchmarkResult>): stri
 	rows.push([
 		'Task Name',
 		'ops/sec',
-		`median (${unit_str})`,
+		`p50 (${unit_str})`,
 		`p75 (${unit_str})`,
 		`p90 (${unit_str})`,
 		`p95 (${unit_str})`,
 		`p99 (${unit_str})`,
 		`min (${unit_str})`,
 		`max (${unit_str})`,
-		'vs Best',
+		vs_column_header,
 	]);
 
 	// Data rows - all use same unit
 	results.forEach((r) => {
 		const ops_sec = benchmark_format_number(r.stats.ops_per_second, 2);
-		const median = time_format(r.stats.median_ns, unit, 2).replace(unit_str, '').trim();
+		const p50 = time_format(r.stats.p50_ns, unit, 2).replace(unit_str, '').trim();
 		const p75 = time_format(r.stats.p75_ns, unit, 2).replace(unit_str, '').trim();
 		const p90 = time_format(r.stats.p90_ns, unit, 2).replace(unit_str, '').trim();
 		const p95 = time_format(r.stats.p95_ns, unit, 2).replace(unit_str, '').trim();
@@ -157,10 +197,10 @@ export const benchmark_format_markdown = (results: Array<BenchmarkResult>): stri
 		const max = time_format(r.stats.max_ns, unit, 2).replace(unit_str, '').trim();
 
 		// Calculate relative performance
-		const ratio = fastest_ops / r.stats.ops_per_second;
-		const vs_best = ratio === 1.0 ? 'baseline' : `${ratio.toFixed(2)}x`;
+		const ratio = baseline_ops / r.stats.ops_per_second;
+		const vs_baseline = ratio === 1.0 ? 'baseline' : `${ratio.toFixed(2)}x`;
 
-		rows.push([r.name, ops_sec, median, p75, p90, p95, p99, min, max, vs_best]);
+		rows.push([r.name, ops_sec, p50, p75, p90, p95, p99, min, max, vs_baseline]);
 	});
 
 	// Calculate column widths
@@ -196,6 +236,62 @@ export const benchmark_format_markdown = (results: Array<BenchmarkResult>): stri
 	return lines.join('\n');
 };
 
+/**
+ * Format results as grouped Markdown tables with headers between groups.
+ * @param results - Array of benchmark results
+ * @param groups - Array of group definitions
+ * @returns Formatted markdown string with group headers and tables
+ *
+ * @example
+ * ```ts
+ * const groups = [
+ *   { name: 'Fast Paths', filter: (r) => r.name.includes('fast'), baseline: 'fast/reference' },
+ *   { name: 'Slow Paths', filter: (r) => r.name.includes('slow') },
+ * ];
+ * console.log(benchmark_format_markdown_grouped(results, groups));
+ * // ### Fast Paths
+ * // | Task Name | ops/sec | ... | vs fast/reference |
+ * // |-----------|---------|-----|-------------------|
+ * // | ...       | ...     | ... | ...               |
+ * //
+ * // ### Slow Paths
+ * // | Task Name | ops/sec | ... | vs Best |
+ * // |-----------|---------|-----|---------|
+ * // | ...       | ...     | ... | ...     |
+ * ```
+ */
+export const benchmark_format_markdown_grouped = (
+	results: Array<BenchmarkResult>,
+	groups: Array<BenchmarkGroup>,
+): string => {
+	if (results.length === 0) return '(no results)';
+
+	const sections: Array<string> = [];
+
+	for (const group of groups) {
+		const group_results = results.filter(group.filter);
+		if (group_results.length === 0) continue;
+
+		// Add group header and table
+		const header = group.description
+			? `### ${group.name}\n\n${group.description}\n`
+			: `### ${group.name}\n`;
+		sections.push(header);
+		sections.push(benchmark_format_markdown(group_results, group.baseline));
+	}
+
+	// Handle ungrouped results (those that don't match any group)
+	const grouped_names = new Set(groups.flatMap((g) => results.filter(g.filter).map((r) => r.name)));
+	const ungrouped = results.filter((r) => !grouped_names.has(r.name));
+
+	if (ungrouped.length > 0) {
+		sections.push('### Other\n');
+		sections.push(benchmark_format_markdown(ungrouped));
+	}
+
+	return sections.join('\n');
+};
+
 export interface BenchmarkFormatJsonOptions {
 	/** Whether to pretty-print (default: true) */
 	pretty?: boolean;
@@ -229,7 +325,7 @@ export const benchmark_format_json = (
 		total_time_ms: r.total_time_ms,
 		ops_per_second: r.stats.ops_per_second,
 		mean_ns: r.stats.mean_ns,
-		median_ns: r.stats.median_ns,
+		p50_ns: r.stats.p50_ns,
 		std_dev_ns: r.stats.std_dev_ns,
 		min_ns: r.stats.min_ns,
 		max_ns: r.stats.max_ns,
@@ -292,7 +388,7 @@ export const benchmark_format_table_grouped = (
 			? `\n📦 ${group.name}\n   ${group.description}`
 			: `\n📦 ${group.name}`;
 		sections.push(header);
-		sections.push(benchmark_format_table(group_results));
+		sections.push(benchmark_format_table(group_results, group.baseline));
 	}
 
 	// Handle ungrouped results (those that don't match any group)

package/src/lib/benchmark_stats.ts

@@ -72,8 +72,8 @@ export interface BenchmarkCompareOptions {
 export class BenchmarkStats {
 	/** Mean (average) time in nanoseconds */
 	readonly mean_ns: number;
-	/** Median time in nanoseconds */
-	readonly median_ns: number;
+	/** 50th percentile (median) time in nanoseconds */
+	readonly p50_ns: number;
 	/** Standard deviation in nanoseconds */
 	readonly std_dev_ns: number;
 	/** Minimum time in nanoseconds */
@@ -124,7 +124,7 @@ export class BenchmarkStats {
 		// If no valid timings, return empty stats
 		if (valid_timings.length === 0) {
 			this.mean_ns = NaN;
-			this.median_ns = NaN;
+			this.p50_ns = NaN;
 			this.std_dev_ns = NaN;
 			this.min_ns = NaN;
 			this.max_ns = NaN;
@@ -151,7 +151,7 @@ export class BenchmarkStats {
 
 		// Calculate statistics on cleaned data
 		this.mean_ns = stats_mean(cleaned);
-		this.median_ns = stats_median(sorted_cleaned);
+		this.p50_ns = stats_median(sorted_cleaned);
 		this.std_dev_ns = stats_std_dev(cleaned, this.mean_ns);
 
 		const {min, max} = stats_min_max(sorted_cleaned);

package/src/lib/benchmark_types.ts

@@ -194,4 +194,11 @@ export interface BenchmarkGroup {
 
 	/** Filter function to determine which results belong to this group */
 	filter: (result: BenchmarkResult) => boolean;
+
+	/**
+	 * Task name to use as baseline for the "vs" column.
+	 * When specified, ratios are computed against this task instead of the fastest.
+	 * If the baseline task is not found in the group, falls back to "vs Best" with a warning.
+	 */
+	baseline?: string;
 }

package/src/lib/package_json.ts

@@ -71,13 +71,6 @@ export const PackageJson = z.looseObject({
 		.boolean()
 		.meta({description: 'disallow publishing to the configured registry'})
 		.optional(),
-	public: z
-		.boolean()
-		.meta({
-			description:
-				'a Gro extension that enables publishing `.well-known/package.json` and `.well-known/src`',
-		})
-		.optional(),
 	description: z.string().optional(),
 	motto: z
 		.string()

package/src/lib/process.ts

@@ -205,3 +205,17 @@ export const spawn_restartable_process = (
 	void restart();
 	return {restart, kill};
 };
+
+/**
+ * Check if a PID is still running.
+ */
+export const process_is_pid_running = (pid: number): boolean => {
+	try {
+		// Sending signal 0 doesn't actually send a signal, just checks if process exists
+		process.kill(pid, 0);
+		return true;
+	} catch (err: any) {
+		// ESRCH = no such process, EPERM = exists but no permission
+		return err.code === 'EPERM';
+	}
+};