@riim/bench 0.1.1 → 0.2.0

package/README.md

@@ -0,0 +1 @@
+# @riim/bench

package/dist/Bench.d.ts

@@ -1,25 +1,26 @@
 export interface ITaskFnParams {
+    iteration: number;
     timeStart: () => void;
     timeEnd: () => void;
 }
-export type TTaskFn = (params: ITaskFnParams) => any;
-export interface ITask {
+export type TTaskFn<T> = (params: ITaskFnParams) => T | Promise<T>;
+export interface ITask<T> {
     name: string;
-    fn: TTaskFn;
+    fn: TTaskFn<T>;
     completionTimeMeasurements: Array<number>;
     memoryUsageMeasurements: Array<number>;
 }
-export type TReturnedValue = [taskName: string, returnedValue: any];
-export type TCheckReturnedValues = (returnedValues: Array<TReturnedValue>) => void;
-export declare class Bench {
+export type TReturnedValue<T> = [taskName: string, returnedValue: T];
+export type TCheckReturnedValues<T> = (values: Array<TReturnedValue<T>>, iteration: number) => void;
+export declare class Bench<T = any> {
     readonly name: string | undefined;
     readonly warmupTime: number;
     readonly warmupIterations: number;
     readonly time: number;
     readonly iterations: number;
     readonly memoryUsage: boolean;
-    readonly checkReturnedValues: TCheckReturnedValues | null;
-    protected _tasks: Map<string, ITask>;
+    readonly checkReturnedValues: TCheckReturnedValues<T> | null;
+    protected _tasks: Map<string, ITask<T>>;
     onIterationStart: import("@riim/event").IUnparametrizedEvent<any>;
     onIterationEnd: import("@riim/event").IUnparametrizedEvent<any>;
     constructor({ name, warmupTime, warmupIterations, time, iterations, memoryUsage, checkReturnedValues }?: {
@@ -29,9 +30,9 @@ export declare class Bench {
         time?: number;
         iterations?: number;
         memoryUsage?: boolean;
-        checkReturnedValues?: TCheckReturnedValues;
+        checkReturnedValues?: TCheckReturnedValues<T>;
     });
-    add(name: string, fn: TTaskFn): this;
+    add(name: string, fn: TTaskFn<T>): this;
     remove(name: string): this;
     run(options?: {
         warmupTime?: number;
@@ -39,7 +40,7 @@ export declare class Bench {
         time?: number;
         iterations?: number;
         memoryUsage?: boolean;
-        checkReturnedValues?: TCheckReturnedValues;
+        checkReturnedValues?: TCheckReturnedValues<T>;
     }): Promise<void>;
     protected _formatMeasurements({ verbose, memoryUsage }?: {
         verbose?: boolean;

package/dist/bench.js

@@ -1,5 +1,36 @@
-import { event, fireEvent } from "@riim/event";
-import jstat from "jstat";
+Object.defineProperty(exports, Symbol.toStringTag, {
+  value: 'Module'
+});
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+      key = keys[i];
+      if (!__hasOwnProp.call(to, key) && key !== except) {
+        __defProp(to, key, {
+          get: (k => from[k]).bind(null, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+      }
+    }
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+  value: mod,
+  enumerable: true
+}) : target, mod));
+
+//#endregion
+var _riim_event = require("@riim/event");
+var jstat = require("jstat");
+jstat = __toESM(jstat);
 
 //#region src/utils.ts
 var noop = () => {};
@@ -22,7 +53,7 @@ function percentile(sortedMeasurements, pct) {
 }
 function rme(measurements, meanValue) {
   var n = measurements.length;
-  var tValue = jstat.studentt.inv(.975, n - 1);
+  var tValue = jstat.default.studentt.inv(.975, n - 1);
   var variance = measurements.map(val => Math.pow(val - meanValue, 2)).reduce((sum, val) => sum + val, 0) / (n - 1);
   return tValue * (Math.sqrt(variance) / Math.sqrt(n)) / meanValue * 100;
 }
@@ -30,6 +61,16 @@ function rme(measurements, meanValue) {
 //#endregion
 //#region src/Bench.ts
 var Bench = class {
+  name;
+  warmupTime;
+  warmupIterations;
+  time;
+  iterations;
+  memoryUsage;
+  checkReturnedValues;
+  _tasks = /* @__PURE__ */new Map();
+  onIterationStart = (0, _riim_event.event)();
+  onIterationEnd = (0, _riim_event.event)();
   constructor({
     name,
     warmupTime = Infinity,
@@ -39,9 +80,6 @@ var Bench = class {
     memoryUsage = false,
     checkReturnedValues
   } = {}) {
-    this._tasks = /* @__PURE__ */new Map();
-    this.onIterationStart = event();
-    this.onIterationEnd = event();
     this.name = name;
     this.warmupTime = warmupTime;
     this.warmupIterations = warmupIterations;
@@ -84,22 +122,25 @@ var Bench = class {
     }
     if (warmupTime != Infinity || warmupIterations != Infinity) {
       var _taskFnParams = {
+        iteration: -1,
         timeStart: noop,
         timeEnd: noop
       };
       for (var i = 0, startTime = Date.now();; i++) {
-        fireEvent(this.onIterationStart);
+        _taskFnParams.iteration = i;
+        (0, _riim_event.fireEvent)(this.onIterationStart);
         for (var j = 0, k = tasks.length; j < k; j++) {
           var returnedValue = tasks[j].fn(_taskFnParams);
           if (returnedValue instanceof Promise) await returnedValue;
         }
-        fireEvent(this.onIterationEnd);
+        (0, _riim_event.fireEvent)(this.onIterationEnd);
         if (Date.now() - startTime >= warmupTime || i >= warmupIterations) break;
       }
     }
     var taskStartTime;
     var taskEndTime;
     var taskFnParams = {
+      iteration: -1,
       timeStart: () => {
         taskStartTime = performance.now();
       },
@@ -109,8 +150,9 @@ var Bench = class {
     };
     for (var _i = 0, _startTime = Date.now();; _i++) {
       tasks.sort(() => Math.random() - .5);
+      taskFnParams.iteration = _i;
       var returnedValues = checkReturnedValues ? [] : null;
-      fireEvent(this.onIterationStart);
+      (0, _riim_event.fireEvent)(this.onIterationStart);
       for (var _j = 0, m = tasks.length; _j < m; _j++) {
         var {
           name,
@@ -137,8 +179,8 @@ var Bench = class {
         completionTimeMeasurements.push(taskEndTime - taskStartTime);
         returnedValues?.push([name, _returnedValue]);
       }
-      checkReturnedValues?.(returnedValues);
-      fireEvent(this.onIterationEnd);
+      checkReturnedValues?.(returnedValues, _i);
+      (0, _riim_event.fireEvent)(this.onIterationEnd);
       if (Date.now() - _startTime >= time || _i >= iterations) break;
     }
   }
@@ -179,7 +221,7 @@ var Bench = class {
     }]) => a - b);
   }
   table({
-    verbose = false
+    verbose = true
   } = {}) {
     var formattedMeasurements = this._formatMeasurements({
       verbose
@@ -239,4 +281,4 @@ var Bench = class {
 };
 
 //#endregion
-export { Bench };
+exports.Bench = Bench;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riim/bench",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "",
   "homepage": "https://github.com/Riim/bench#readme",
   "bugs": {
@@ -17,25 +17,25 @@
   "typings": "dist/index.d.ts",
   "scripts": {
     "build": "rm -rf dist && npx tsc && rolldown -c && babel dist --out-dir dist",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "rm -rf coverage && jest --coverage"
   },
   "devDependencies": {
     "@babel/cli": "7.28.6",
     "@babel/core": "7.29.0",
     "@babel/plugin-transform-block-scoping": "7.28.6",
-    "@eslint/js": "9.39.2",
+    "@eslint/js": "9.39.3",
     "@trivago/prettier-plugin-sort-imports": "6.0.2",
-    "@types/node": "25.2.3",
-    "@typescript-eslint/parser": "8.55.0",
-    "eslint": "9.39.2",
+    "@types/node": "25.3.2",
+    "@typescript-eslint/parser": "8.56.1",
+    "eslint": "9.39.3",
     "eslint-plugin-github": "6.0.0",
     "globals": "17.3.0",
-    "rolldown": "1.0.0-rc.4",
+    "rolldown": "1.0.0-rc.6",
     "typescript": "5.9.3",
-    "typescript-eslint": "8.55.0"
+    "typescript-eslint": "8.56.1"
   },
   "dependencies": {
-    "@riim/event": "0.1.0",
+    "@riim/event": "0.2.0",
     "jstat": "1.9.6"
   }
 }

package/benchmarks/loops.bench.ts

@@ -1,75 +0,0 @@
-import { Bench } from '../src';
-
-const arr = Array.from({ length: 1000 }, (_, idx) => idx + 1);
-let item: number;
-
-const bench = new Bench({ time: 1000 });
-
-bench
-	.add('by index with l-var', () => {
-		for (let i = 0, l = arr.length; i < l; i++) {
-			item = arr[i];
-		}
-	})
-	.add('by index without l-var', () => {
-		for (let i = 0; i < arr.length; i++) {
-			item = arr[i];
-		}
-	})
-	.add('by index without l-var 2', () => {
-		for (let i = 0; i != arr.length; i++) {
-			item = arr[i];
-		}
-	})
-	.add('by index from end', () => {
-		for (let i = arr.length; i != 0; ) {
-			item = arr[--i];
-		}
-	})
-	.add('by index from end 2', () => {
-		for (let i = arr.length - 1; i >= 0; i--) {
-			item = arr[i];
-		}
-	})
-	.add('of operator', () => {
-		for (let item_ of arr) {
-			item = item_;
-		}
-	})
-	.add('Array#forEach()', () => {
-		arr.forEach((item_) => {
-			item = item_;
-		});
-	});
-
-(async () => {
-	await bench.run();
-
-	// ┌──────────────────────────┬─────┬──────────┬──────────┐
-	// │ (index)                  │ pos │ mean     │ rme      │
-	// ├──────────────────────────┼─────┼──────────┼──────────┤
-	// │ by index with l-var      │ 100 │ 0.001055 │ '±0.52%' │
-	// │ by index without l-var   │ 100 │ 0.001057 │ '±1.22%' │
-	// │ Array#forEach()          │ 87  │ 0.001217 │ '±1.74%' │
-	// │ by index without l-var 2 │ 72  │ 0.001458 │ '±0.4%'  │
-	// │ by index from end 2      │ 72  │ 0.001461 │ '±0.3%'  │
-	// │ of operator              │ 68  │ 0.001544 │ '±0.37%' │
-	// │ by index from end        │ 58  │ 0.001833 │ '±0.42%' │
-	// └──────────────────────────┴─────┴──────────┴──────────┘
-	console.table(bench.table());
-
-	await bench.run({ memoryUsage: true });
-
-	// ┌──────────────────────────┬─────┬─────┬──────┬──────┐
-	// │ (index)                  │ pos │ min │ max  │ mean │
-	// ├──────────────────────────┼─────┼─────┼──────┼──────┤
-	// │ by index with l-var      │ 100 │ 448 │ 600  │ 448  │
-	// │ by index without l-var   │ 100 │ 448 │ 3880 │ 448  │
-	// │ by index without l-var 2 │ 100 │ 448 │ 3848 │ 448  │
-	// │ by index from end        │ 100 │ 448 │ 3848 │ 448  │
-	// │ by index from end 2      │ 100 │ 448 │ 3848 │ 448  │
-	// │ of operator              │ 100 │ 448 │ 4080 │ 448  │
-	// │ Array#forEach()          │ 89  │ 504 │ 4032 │ 504  │
-	// └──────────────────────────┴─────┴─────┴──────┴──────┘
-	console.table(bench.memoryUsageTable());
-})();