modestbench 0.7.0 → 0.9.0

package/dist/utils/package.cjs

@@ -6,13 +6,74 @@
  *
  * @packageDocumentation
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    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;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.findPackageRoot = void 0;
+exports.findPackageRoot = exports.getPackageVersion = void 0;
+const node_fs_1 = require("node:fs");
 const promises_1 = require("node:fs/promises");
-const node_path_1 = __importDefault(require("node:path"));
+const node_path_1 = __importStar(require("node:path"));
+const node_url_1 = require("node:url");
+/**
+ * Cached package version, loaded at module initialization
+ *
+ * NOTE: This relies on package.json being at the same relative path from both
+ * src/ and dist/ directories (../../package.json). If the build output
+ * structure changes, this will break.
+ */
+const cachedPackageVersion = (() => {
+    try {
+        const __dirname = (0, node_path_1.dirname)((0, node_url_1.fileURLToPath)(require("url").pathToFileURL(__filename)));
+        const pkgPath = (0, node_path_1.join)(__dirname, '..', '..', 'package.json');
+        const pkgContent = (0, node_fs_1.readFileSync)(pkgPath, 'utf8');
+        const pkg = JSON.parse(pkgContent);
+        return pkg.version;
+    }
+    catch {
+        // Fallback if package.json cannot be read (shouldn't happen in normal use)
+        return 'unknown';
+    }
+})();
+/**
+ * Get the ModestBench package version
+ *
+ * @returns The version string from package.json
+ */
+const getPackageVersion = () => {
+    return cachedPackageVersion;
+};
+exports.getPackageVersion = getPackageVersion;
 /**
  * Find the nearest package.json and return its directory
  *

package/dist/utils/package.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"package.js","sourceRoot":"","sources":["../../src/utils/package.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;AAEH,+CAA4C;AAC5C,0DAA6B;AAE7B;;;;;GAKG;AACI,MAAM,eAAe,GAAG,KAAK,EAAE,QAAgB,EAAmB,EAAE;IACzE,IAAI,UAAU,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,mBAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;IAEzC,OAAO,UAAU,KAAK,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;YAC1D,MAAM,IAAA,mBAAQ,EAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACrC,OAAO,UAAU,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;YAC9C,UAAU,GAAG,mBAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAjBW,QAAA,eAAe,mBAiB1B"}
+{"version":3,"file":"package.js","sourceRoot":"","sources":["../../src/utils/package.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,qCAAuC;AACvC,+CAA4C;AAC5C,uDAAgD;AAChD,uCAAyC;AAEzC;;;;;;GAMG;AACH,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE;IACjC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAA,mBAAO,EAAC,IAAA,wBAAa,2CAAiB,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,IAAA,sBAAY,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAwB,CAAC;QAC1D,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;QAC3E,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC,EAAE,CAAC;AAEL;;;;GAIG;AACI,MAAM,iBAAiB,GAAG,GAAW,EAAE;IAC5C,OAAO,oBAAoB,CAAC;AAC9B,CAAC,CAAC;AAFW,QAAA,iBAAiB,qBAE5B;AAEF;;;;;GAKG;AACI,MAAM,eAAe,GAAG,KAAK,EAAE,QAAgB,EAAmB,EAAE;IACzE,IAAI,UAAU,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,mBAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;IAEzC,OAAO,UAAU,KAAK,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;YAC1D,MAAM,IAAA,mBAAQ,EAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACrC,OAAO,UAAU,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;YAC9C,UAAU,GAAG,mBAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAjBW,QAAA,eAAe,mBAiB1B"}

package/dist/utils/package.d.cts

@@ -5,6 +5,12 @@
  *
  * @packageDocumentation
  */
+/**
+ * Get the ModestBench package version
+ *
+ * @returns The version string from package.json
+ */
+export declare const getPackageVersion: () => string;
 /**
  * Find the nearest package.json and return its directory
  *

package/dist/utils/package.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../src/utils/package.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,MAAM,CAiBtE,CAAC"}
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../src/utils/package.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2BH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAO,MAEpC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,MAAM,CAiBtE,CAAC"}

package/dist/utils/package.d.ts

@@ -5,6 +5,12 @@
  *
  * @packageDocumentation
  */
+/**
+ * Get the ModestBench package version
+ *
+ * @returns The version string from package.json
+ */
+export declare const getPackageVersion: () => string;
 /**
  * Find the nearest package.json and return its directory
  *

package/dist/utils/package.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../src/utils/package.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,MAAM,CAiBtE,CAAC"}
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../src/utils/package.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2BH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAO,MAEpC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,MAAM,CAiBtE,CAAC"}

package/dist/utils/package.js

@@ -5,8 +5,38 @@
  *
  * @packageDocumentation
  */
+import { readFileSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
-import path from 'node:path';
+import path, { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Cached package version, loaded at module initialization
+ *
+ * NOTE: This relies on package.json being at the same relative path from both
+ * src/ and dist/ directories (../../package.json). If the build output
+ * structure changes, this will break.
+ */
+const cachedPackageVersion = (() => {
+    try {
+        const __dirname = dirname(fileURLToPath(import.meta.url));
+        const pkgPath = join(__dirname, '..', '..', 'package.json');
+        const pkgContent = readFileSync(pkgPath, 'utf8');
+        const pkg = JSON.parse(pkgContent);
+        return pkg.version;
+    }
+    catch {
+        // Fallback if package.json cannot be read (shouldn't happen in normal use)
+        return 'unknown';
+    }
+})();
+/**
+ * Get the ModestBench package version
+ *
+ * @returns The version string from package.json
+ */
+export const getPackageVersion = () => {
+    return cachedPackageVersion;
+};
 /**
  * Find the nearest package.json and return its directory
  *

package/dist/utils/package.js.map

@@ -1 +1 @@
-{"version":3,"file":"package.js","sourceRoot":"","sources":["../../src/utils/package.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,QAAgB,EAAmB,EAAE;IACzE,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;IAEzC,OAAO,UAAU,KAAK,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;YAC1D,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACrC,OAAO,UAAU,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;YAC9C,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}
+{"version":3,"file":"package.js","sourceRoot":"","sources":["../../src/utils/package.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE;IACjC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAwB,CAAC;QAC1D,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;QAC3E,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC,EAAE,CAAC;AAEL;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAW,EAAE;IAC5C,OAAO,oBAAoB,CAAC;AAC9B,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,QAAgB,EAAmB,EAAE;IACzE,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;IAEzC,OAAO,UAAU,KAAK,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;YAC1D,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACrC,OAAO,UAAU,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;YAC9C,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}

package/dist/utils/reporter-utils.cjs

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * ModestBench Reporter Utilities
+ *
+ * Formatting functions for benchmark data, exported for use by third-party
+ * reporter plugins.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporterUtils = exports.formatPercentage = exports.formatOpsPerSecond = exports.formatDuration = exports.formatBytes = void 0;
+/**
+ * Format bytes in human-readable format
+ *
+ * @param bytes - Number of bytes
+ * @returns Formatted string (e.g., "1.5 GB", "256 MB", "1.2 KB")
+ */
+const formatBytes = (bytes) => {
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    let size = bytes;
+    let unitIndex = 0;
+    while (size >= 1024 && unitIndex < units.length - 1) {
+        size /= 1024;
+        unitIndex++;
+    }
+    return `${size.toFixed(1)} ${units[unitIndex]}`;
+};
+exports.formatBytes = formatBytes;
+/**
+ * Format duration in human-readable format
+ *
+ * @param nanoseconds - Duration in nanoseconds
+ * @returns Formatted string (e.g., "1.23ms", "456.78μs", "789.00ns")
+ */
+const formatDuration = (nanoseconds) => {
+    if (nanoseconds < 1000) {
+        return `${nanoseconds.toFixed(2)}ns`;
+    }
+    else if (nanoseconds < 1_000_000) {
+        return `${(nanoseconds / 1000).toFixed(2)}μs`;
+    }
+    else if (nanoseconds < 1_000_000_000) {
+        return `${(nanoseconds / 1_000_000).toFixed(2)}ms`;
+    }
+    else {
+        return `${(nanoseconds / 1_000_000_000).toFixed(2)}s`;
+    }
+};
+exports.formatDuration = formatDuration;
+/**
+ * Format operations per second in human-readable format
+ *
+ * @param opsPerSecond - Operations per second
+ * @returns Formatted string (e.g., "1.2M ops/sec", "456K ops/sec")
+ */
+const formatOpsPerSecond = (opsPerSecond) => {
+    if (opsPerSecond < 1000) {
+        return `${opsPerSecond.toFixed(2)} ops/sec`;
+    }
+    else if (opsPerSecond < 1_000_000) {
+        return `${(opsPerSecond / 1000).toFixed(2)}K ops/sec`;
+    }
+    else if (opsPerSecond < 1_000_000_000) {
+        return `${(opsPerSecond / 1_000_000).toFixed(2)}M ops/sec`;
+    }
+    else {
+        return `${(opsPerSecond / 1_000_000_000).toFixed(2)}B ops/sec`;
+    }
+};
+exports.formatOpsPerSecond = formatOpsPerSecond;
+/**
+ * Format percentage value
+ *
+ * @param value - Percentage value (e.g., 12.345 for 12.345%)
+ * @returns Formatted string (e.g., "12.35%")
+ */
+const formatPercentage = (value) => {
+    return `${value.toFixed(2)}%`;
+};
+exports.formatPercentage = formatPercentage;
+/**
+ * Reporter utilities object implementing the ReporterUtils interface
+ *
+ * This object is provided to reporter plugins via the ReporterContext.
+ */
+exports.reporterUtils = {
+    formatBytes: exports.formatBytes,
+    formatDuration: exports.formatDuration,
+    formatOpsPerSecond: exports.formatOpsPerSecond,
+    formatPercentage: exports.formatPercentage,
+};
+//# sourceMappingURL=reporter-utils.js.map

package/dist/utils/reporter-utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter-utils.js","sourceRoot":"","sources":["../../src/utils/reporter-utils.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAIH;;;;;GAKG;AACI,MAAM,WAAW,GAAG,CAAC,KAAa,EAAU,EAAE;IACnD,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,OAAO,IAAI,IAAI,IAAI,IAAI,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,IAAI,IAAI,IAAI,CAAC;QACb,SAAS,EAAE,CAAC;IACd,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;AAClD,CAAC,CAAC;AAXW,QAAA,WAAW,eAWtB;AAEF;;;;;GAKG;AACI,MAAM,cAAc,GAAG,CAAC,WAAmB,EAAU,EAAE;IAC5D,IAAI,WAAW,GAAG,IAAI,EAAE,CAAC;QACvB,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;SAAM,IAAI,WAAW,GAAG,SAAS,EAAE,CAAC;QACnC,OAAO,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,CAAC;SAAM,IAAI,WAAW,GAAG,aAAa,EAAE,CAAC;QACvC,OAAO,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,CAAC,WAAW,GAAG,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACxD,CAAC;AACH,CAAC,CAAC;AAVW,QAAA,cAAc,kBAUzB;AAEF;;;;;GAKG;AACI,MAAM,kBAAkB,GAAG,CAAC,YAAoB,EAAU,EAAE;IACjE,IAAI,YAAY,GAAG,IAAI,EAAE,CAAC;QACxB,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;IAC9C,CAAC;SAAM,IAAI,YAAY,GAAG,SAAS,EAAE,CAAC;QACpC,OAAO,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;IACxD,CAAC;SAAM,IAAI,YAAY,GAAG,aAAa,EAAE,CAAC;QACxC,OAAO,GAAG,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,CAAC,YAAY,GAAG,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;IACjE,CAAC;AACH,CAAC,CAAC;AAVW,QAAA,kBAAkB,sBAU7B;AAEF;;;;;GAKG;AACI,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAU,EAAE;IACxD,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AAChC,CAAC,CAAC;AAFW,QAAA,gBAAgB,oBAE3B;AAEF;;;;GAIG;AACU,QAAA,aAAa,GAAkB;IAC1C,WAAW,EAAX,mBAAW;IACX,cAAc,EAAd,sBAAc;IACd,kBAAkB,EAAlB,0BAAkB;IAClB,gBAAgB,EAAhB,wBAAgB;CACjB,CAAC"}

package/dist/utils/reporter-utils.d.cts

@@ -0,0 +1,42 @@
+/**
+ * ModestBench Reporter Utilities
+ *
+ * Formatting functions for benchmark data, exported for use by third-party
+ * reporter plugins.
+ */
+import type { ReporterUtils } from "../types/plugin.cjs";
+/**
+ * Format bytes in human-readable format
+ *
+ * @param bytes - Number of bytes
+ * @returns Formatted string (e.g., "1.5 GB", "256 MB", "1.2 KB")
+ */
+export declare const formatBytes: (bytes: number) => string;
+/**
+ * Format duration in human-readable format
+ *
+ * @param nanoseconds - Duration in nanoseconds
+ * @returns Formatted string (e.g., "1.23ms", "456.78μs", "789.00ns")
+ */
+export declare const formatDuration: (nanoseconds: number) => string;
+/**
+ * Format operations per second in human-readable format
+ *
+ * @param opsPerSecond - Operations per second
+ * @returns Formatted string (e.g., "1.2M ops/sec", "456K ops/sec")
+ */
+export declare const formatOpsPerSecond: (opsPerSecond: number) => string;
+/**
+ * Format percentage value
+ *
+ * @param value - Percentage value (e.g., 12.345 for 12.345%)
+ * @returns Formatted string (e.g., "12.35%")
+ */
+export declare const formatPercentage: (value: number) => string;
+/**
+ * Reporter utilities object implementing the ReporterUtils interface
+ *
+ * This object is provided to reporter plugins via the ReporterContext.
+ */
+export declare const reporterUtils: ReporterUtils;
+//# sourceMappingURL=reporter-utils.d.ts.map

package/dist/utils/reporter-utils.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter-utils.d.ts","sourceRoot":"","sources":["../../src/utils/reporter-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,4BAA2B;AAExD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,MAW3C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,KAAG,MAUpD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,cAAc,MAAM,KAAG,MAUzD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,KAAG,MAEhD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,aAK3B,CAAC"}

package/dist/utils/reporter-utils.d.ts

@@ -0,0 +1,42 @@
+/**
+ * ModestBench Reporter Utilities
+ *
+ * Formatting functions for benchmark data, exported for use by third-party
+ * reporter plugins.
+ */
+import type { ReporterUtils } from "../types/plugin.js";
+/**
+ * Format bytes in human-readable format
+ *
+ * @param bytes - Number of bytes
+ * @returns Formatted string (e.g., "1.5 GB", "256 MB", "1.2 KB")
+ */
+export declare const formatBytes: (bytes: number) => string;
+/**
+ * Format duration in human-readable format
+ *
+ * @param nanoseconds - Duration in nanoseconds
+ * @returns Formatted string (e.g., "1.23ms", "456.78μs", "789.00ns")
+ */
+export declare const formatDuration: (nanoseconds: number) => string;
+/**
+ * Format operations per second in human-readable format
+ *
+ * @param opsPerSecond - Operations per second
+ * @returns Formatted string (e.g., "1.2M ops/sec", "456K ops/sec")
+ */
+export declare const formatOpsPerSecond: (opsPerSecond: number) => string;
+/**
+ * Format percentage value
+ *
+ * @param value - Percentage value (e.g., 12.345 for 12.345%)
+ * @returns Formatted string (e.g., "12.35%")
+ */
+export declare const formatPercentage: (value: number) => string;
+/**
+ * Reporter utilities object implementing the ReporterUtils interface
+ *
+ * This object is provided to reporter plugins via the ReporterContext.
+ */
+export declare const reporterUtils: ReporterUtils;
+//# sourceMappingURL=reporter-utils.d.ts.map

package/dist/utils/reporter-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter-utils.d.ts","sourceRoot":"","sources":["../../src/utils/reporter-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,2BAA2B;AAExD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,MAW3C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,KAAG,MAUpD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,cAAc,MAAM,KAAG,MAUzD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,KAAG,MAEhD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,aAK3B,CAAC"}

package/dist/utils/reporter-utils.js

@@ -0,0 +1,83 @@
+/**
+ * ModestBench Reporter Utilities
+ *
+ * Formatting functions for benchmark data, exported for use by third-party
+ * reporter plugins.
+ */
+/**
+ * Format bytes in human-readable format
+ *
+ * @param bytes - Number of bytes
+ * @returns Formatted string (e.g., "1.5 GB", "256 MB", "1.2 KB")
+ */
+export const formatBytes = (bytes) => {
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    let size = bytes;
+    let unitIndex = 0;
+    while (size >= 1024 && unitIndex < units.length - 1) {
+        size /= 1024;
+        unitIndex++;
+    }
+    return `${size.toFixed(1)} ${units[unitIndex]}`;
+};
+/**
+ * Format duration in human-readable format
+ *
+ * @param nanoseconds - Duration in nanoseconds
+ * @returns Formatted string (e.g., "1.23ms", "456.78μs", "789.00ns")
+ */
+export const formatDuration = (nanoseconds) => {
+    if (nanoseconds < 1000) {
+        return `${nanoseconds.toFixed(2)}ns`;
+    }
+    else if (nanoseconds < 1_000_000) {
+        return `${(nanoseconds / 1000).toFixed(2)}μs`;
+    }
+    else if (nanoseconds < 1_000_000_000) {
+        return `${(nanoseconds / 1_000_000).toFixed(2)}ms`;
+    }
+    else {
+        return `${(nanoseconds / 1_000_000_000).toFixed(2)}s`;
+    }
+};
+/**
+ * Format operations per second in human-readable format
+ *
+ * @param opsPerSecond - Operations per second
+ * @returns Formatted string (e.g., "1.2M ops/sec", "456K ops/sec")
+ */
+export const formatOpsPerSecond = (opsPerSecond) => {
+    if (opsPerSecond < 1000) {
+        return `${opsPerSecond.toFixed(2)} ops/sec`;
+    }
+    else if (opsPerSecond < 1_000_000) {
+        return `${(opsPerSecond / 1000).toFixed(2)}K ops/sec`;
+    }
+    else if (opsPerSecond < 1_000_000_000) {
+        return `${(opsPerSecond / 1_000_000).toFixed(2)}M ops/sec`;
+    }
+    else {
+        return `${(opsPerSecond / 1_000_000_000).toFixed(2)}B ops/sec`;
+    }
+};
+/**
+ * Format percentage value
+ *
+ * @param value - Percentage value (e.g., 12.345 for 12.345%)
+ * @returns Formatted string (e.g., "12.35%")
+ */
+export const formatPercentage = (value) => {
+    return `${value.toFixed(2)}%`;
+};
+/**
+ * Reporter utilities object implementing the ReporterUtils interface
+ *
+ * This object is provided to reporter plugins via the ReporterContext.
+ */
+export const reporterUtils = {
+    formatBytes,
+    formatDuration,
+    formatOpsPerSecond,
+    formatPercentage,
+};
+//# sourceMappingURL=reporter-utils.js.map

package/dist/utils/reporter-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter-utils.js","sourceRoot":"","sources":["../../src/utils/reporter-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAU,EAAE;IACnD,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,OAAO,IAAI,IAAI,IAAI,IAAI,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,IAAI,IAAI,IAAI,CAAC;QACb,SAAS,EAAE,CAAC;IACd,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;AAClD,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,WAAmB,EAAU,EAAE;IAC5D,IAAI,WAAW,GAAG,IAAI,EAAE,CAAC;QACvB,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;SAAM,IAAI,WAAW,GAAG,SAAS,EAAE,CAAC;QACnC,OAAO,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,CAAC;SAAM,IAAI,WAAW,GAAG,aAAa,EAAE,CAAC;QACvC,OAAO,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,CAAC,WAAW,GAAG,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACxD,CAAC;AACH,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,YAAoB,EAAU,EAAE;IACjE,IAAI,YAAY,GAAG,IAAI,EAAE,CAAC;QACxB,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;IAC9C,CAAC;SAAM,IAAI,YAAY,GAAG,SAAS,EAAE,CAAC;QACpC,OAAO,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;IACxD,CAAC;SAAM,IAAI,YAAY,GAAG,aAAa,EAAE,CAAC;QACxC,OAAO,GAAG,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,CAAC,YAAY,GAAG,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;IACjE,CAAC;AACH,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAU,EAAE;IACxD,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AAChC,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,WAAW;IACX,cAAc;IACd,kBAAkB;IAClB,gBAAgB;CACjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "modestbench",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "type": "module",
   "description": "A full-ass benchmarking framework for Node.js",
   "repository": {
@@ -94,13 +94,12 @@
     "clean": "rm -rf dist",
     "commitlint": "commitlint",
     "dev": "zshy --watch",
-    "docs:build": "run-s docs:copy astro:build",
+    "docs:build": "run-s build:schema docs:copy astro:build",
     "docs:copy": "tsx scripts/copy-docs.ts",
     "docs:dev": "run-s docs:copy astro:dev",
     "docs:preview": "astro preview --config astro.config.js",
     "fix": "run-s -sl fix:*",
     "fix:eslint": "eslint --fix .",
-    "fix:pkg": "npm pkg fix",
     "fix:prettier": "prettier --write . && markdownlint-cli2 --fix \"**/*.md\"",
     "lint": "run-p -sl --aggregate-output lint:*",
     "lint-staged": "lint-staged",
@@ -136,33 +135,34 @@
     "@astrojs/starlight": "0.37.1",
     "@commitlint/cli": "20.2.0",
     "@commitlint/config-conventional": "20.2.0",
-    "@eslint/js": "9.39.1",
+    "@eslint/js": "9.39.2",
     "@jest/globals": "30.2.0",
     "@pasqal-io/starlight-client-mermaid": "0.1.0",
     "@stylistic/eslint-plugin": "5.6.1",
     "@types/mocha": "10.0.10",
-    "@types/node": "24.10.3",
+    "@types/node": "24.10.4",
     "@types/wallabyjs": "0.0.15",
     "@types/yargs": "17.0.35",
-    "asciinema-player": "3.12.1",
+    "asciinema-player": "3.13.5",
     "astro": "5.16.5",
     "astro-broken-link-checker": "file:./vendor/astro-broken-link-checker",
     "ava": "6.4.1",
     "bupkis": "0.14.0",
     "cspell": "9.4.0",
-    "eslint": "9.39.1",
+    "eslint": "9.39.2",
     "eslint-plugin-jsonc": "2.21.0",
     "eslint-plugin-perfectionist": "4.15.1",
     "globals": "16.5.0",
     "husky": "9.1.7",
     "jest": "30.2.0",
-    "knip": "5.73.1",
+    "knip": "5.73.4",
     "lint-staged": "16.2.7",
     "markdownlint-cli2": "0.20.0",
     "markdownlint-cli2-formatter-pretty": "0.0.9",
     "mocha": "11.7.5",
     "npm-run-all2": "8.0.4",
     "prettier": "3.7.4",
+    "prettier-plugin-astro": "0.14.1",
     "prettier-plugin-jsdoc": "1.8.0",
     "prettier-plugin-pkg": "0.21.2",
     "prettier-plugin-sort-json": "4.1.1",
@@ -181,7 +181,6 @@
       "@types/wallabyjs",
       "@types/mocha",
       "markdownlint-cli2-formatter-pretty",
-      "asciinema-player",
       "@astrojs/mdx",
       "astro-broken-link-checker",
       "jest",
@@ -215,6 +214,9 @@
     }
   },
   "lint-staged": {
+    "*.{astro,css}": [
+      "prettier --write"
+    ],
     "*.{ts,cts,js,cjs,yml,json5}": [
       "eslint --fix",
       "prettier --write",
@@ -238,7 +240,16 @@
   "prettier": {
     "jsdocCommentLineStrategy": "keep",
     "jsdocPreferCodeFences": true,
+    "overrides": [
+      {
+        "files": "*.astro",
+        "options": {
+          "parser": "astro"
+        }
+      }
+    ],
     "plugins": [
+      "prettier-plugin-astro",
       "prettier-plugin-jsdoc",
       "prettier-plugin-pkg",
       "prettier-plugin-sort-json"

package/src/adapters/types.ts

@@ -8,7 +8,7 @@
 import type {
   BenchmarkDefinition,
   BenchmarkSuite,
-} from '../core/benchmark-schema.js';
+} from '../config/benchmark-schema.js';
 
 /**
  * A captured test suite (describe block) from a test framework