modestbench 0.0.3 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## [0.2.0](https://github.com/boneskull/modestbench/compare/modestbench-v0.1.0...modestbench-v0.2.0) (2025-10-26)
+
+
+### Features
+
+* add --output-file CLI option ([#66](https://github.com/boneskull/modestbench/issues/66)) ([09bb5ae](https://github.com/boneskull/modestbench/commit/09bb5ae7468c9d5eb9d1e9641c58350a5b3856dd))
+* **history:** implement trend analysis and comparison ([#64](https://github.com/boneskull/modestbench/issues/64)) ([acf7dda](https://github.com/boneskull/modestbench/commit/acf7ddaa91f7ae242c2a2df86fd610ce88f8ac91))
+* **history:** implement trends and comparison ([acf7dda](https://github.com/boneskull/modestbench/commit/acf7ddaa91f7ae242c2a2df86fd610ce88f8ac91))
+* implement date parsing, compare, and trend analysis core ([acf7dda](https://github.com/boneskull/modestbench/commit/acf7ddaa91f7ae242c2a2df86fd610ce88f8ac91))
+* implement full trends command with visualizations ([acf7dda](https://github.com/boneskull/modestbench/commit/acf7ddaa91f7ae242c2a2df86fd610ce88f8ac91))
+
+## [0.1.0](https://github.com/boneskull/modestbench/compare/modestbench-v0.0.3...modestbench-v0.1.0) (2025-10-24)
+
+
+### Features
+
+* new-fangled errors ([dd9128d](https://github.com/boneskull/modestbench/commit/dd9128df0dea260af9d9216a310784cfe3b3126e))
+
+
+### Bug Fixes
+
+* **deps:** @pasqal-io/starlight-client-mermaid is now a dev dep ([82ecb85](https://github.com/boneskull/modestbench/commit/82ecb8555d9e58c630ad7c358b21be37c8bd68b9))
+* **deps:** pin dependency @pasqal-io/starlight-client-mermaid to 0.1.0 ([#58](https://github.com/boneskull/modestbench/issues/58)) ([d167cf9](https://github.com/boneskull/modestbench/commit/d167cf95c0db583c72b605ea8b66a8d28118ed4d))
+* **reporters:** it is a task, not a test ([07f9b5a](https://github.com/boneskull/modestbench/commit/07f9b5a91f847ebd57c4dfca285998b0a817c6b2))
+* **reporters:** it is also a task even in the simple reporter ([592f7b4](https://github.com/boneskull/modestbench/commit/592f7b43a13a66ccbea6955808ea83614303f76e))
+
 ## [0.0.3](https://github.com/boneskull/modestbench/compare/modestbench-v0.0.2...modestbench-v0.0.3) (2025-10-23)
 
 

package/README.md

@@ -130,37 +130,7 @@ modestbench --iterations 5000 --reporters human,json
 
 ### View Results
 
-```text
-🚀 ModestBench
-
-Environment:
-  Node.js: v24.10.0
-  Platform: darwin arm64
-  CPU: Apple M4 Max (16 cores)
-  Memory: 48.0 GB
-
-Found 1 benchmark file(s)
-
-▶ benchmarks/example.bench.js
-
-  ▶ Array Operations
-    ✓ Array.push()
-      810.05μs ±2.45% (1.23M ops/sec)
-    ✓ Array spread
-      81.01ms ±4.12% (12.34K ops/sec)
-  ✓ 2 passed
-
-  ✓ All 2 tasks passed
-
-📊 Results
-
-✓ All tests passed: 2
-📁 Files: 1
-📊 Suites: 1
-⏱️ Duration: 1.82s
-
-🎉 All benchmarks completed successfully!
-```
+![Example output showing colorful terminal display with benchmark results](./public/human-reporter.png)
 
 ## Getting Started
 
@@ -273,6 +243,44 @@ modestbench --tags fast --exclude-tags experimental
 
 See [Tagging and Filtering](#tagging-and-filtering) for detailed examples.
 
+#### Output Options
+
+Control where and how benchmark results are saved:
+
+```bash
+# Write to a directory (creates results.json, results.csv, etc.)
+modestbench --reporters json,csv --output ./results
+
+# Custom filename for single reporter
+modestbench --reporters json --output-file my-benchmarks.json
+
+# Custom filename in specific directory
+modestbench --reporters json --output ./results --output-file benchmarks-2024.json
+
+# Custom filename with absolute path
+modestbench --reporters json --output-file /tmp/my-benchmarks.json
+
+# With subdirectories
+modestbench --reporters csv --output ./results --output-file reports/performance.csv
+
+# Short flag alias
+modestbench --reporters json --of custom.json
+```
+
+**Key Options:**
+
+- `--output <dir>`, `-o <dir>` - Directory to write output files (default: stdout)
+- `--output-file <filename>`, `--of <filename>` - Custom filename for output
+  - Works with absolute or relative paths
+  - Requires exactly one reporter (e.g., `--reporters json`)
+  - When used with `--output`, the filename is relative to that directory
+  - When used alone, the path is relative to current working directory
+
+**Limitations:**
+
+- `--output-file` only works with a single reporter
+- For multiple reporters, use `--output <dir>` (defaults to `results.json`, `results.csv`, etc.)
+
 ### History Management
 
 **modestbench** automatically tracks benchmark results over time in a local `.modestbench/` directory. This history enables you to:

package/dist/bootstrap.cjs

@@ -7,13 +7,12 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.bootstrap = void 0;
-const manager_js_1 = require("./config/manager.cjs");
 const index_js_1 = require("./core/engines/index.cjs");
-const error_manager_js_1 = require("./core/error-manager.cjs");
-const loader_js_1 = require("./core/loader.cjs");
-const manager_js_2 = require("./progress/manager.cjs");
-const registry_js_1 = require("./reporters/registry.cjs");
-const history_js_1 = require("./storage/history.cjs");
+const config_manager_js_1 = require("./services/config-manager.cjs");
+const file_loader_js_1 = require("./services/file-loader.cjs");
+const history_storage_js_1 = require("./services/history-storage.cjs");
+const progress_manager_js_1 = require("./services/progress-manager.cjs");
+const reporter_registry_js_1 = require("./services/reporter-registry.cjs");
 /**
  * Initializes the ModestBench engine with default dependencies.
  *
@@ -24,12 +23,11 @@ const history_js_1 = require("./storage/history.cjs");
  */
 const bootstrap = () => {
     const engine = new index_js_1.TinybenchEngine({
-        configManager: new manager_js_1.ModestBenchConfigurationManager(),
-        errorManager: new error_manager_js_1.ModestBenchErrorManager(),
-        fileLoader: new loader_js_1.BenchmarkFileLoader(),
-        historyStorage: new history_js_1.FileHistoryStorage(),
-        progressManager: new manager_js_2.ModestBenchProgressManager(),
-        reporterRegistry: new registry_js_1.ModestBenchReporterRegistry(),
+        configManager: new config_manager_js_1.ModestBenchConfigurationManager(),
+        fileLoader: new file_loader_js_1.BenchmarkFileLoader(),
+        historyStorage: new history_storage_js_1.FileHistoryStorage(),
+        progressManager: new progress_manager_js_1.ModestBenchProgressManager(),
+        reporterRegistry: new reporter_registry_js_1.ModestBenchReporterRegistry(),
     });
     return engine;
 };

package/dist/bootstrap.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,qDAAsE;AAEtE,uDAA0D;AAC1D,+DAAkE;AAClE,iDAAuD;AACvD,uDAAmE;AACnE,0DAAsE;AACtE,sDAA0D;AAE1D;;;;;;;GAOG;AACI,MAAM,SAAS,GAAG,GAAsB,EAAE;IAC/C,MAAM,MAAM,GAAG,IAAI,0BAAe,CAAC;QACjC,aAAa,EAAE,IAAI,4CAA+B,EAAE;QACpD,YAAY,EAAE,IAAI,0CAAuB,EAAE;QAC3C,UAAU,EAAE,IAAI,+BAAmB,EAAE;QACrC,cAAc,EAAE,IAAI,+BAAkB,EAAE;QACxC,eAAe,EAAE,IAAI,uCAA0B,EAAE;QACjD,gBAAgB,EAAE,IAAI,yCAA2B,EAAE;KACpD,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAVW,QAAA,SAAS,aAUpB"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,uDAA0D;AAC1D,qEAA+E;AAC/E,+DAAgE;AAChE,uEAAmE;AACnE,yEAA4E;AAC5E,2EAA8E;AAE9E;;;;;;;GAOG;AACI,MAAM,SAAS,GAAG,GAAsB,EAAE;IAC/C,MAAM,MAAM,GAAG,IAAI,0BAAe,CAAC;QACjC,aAAa,EAAE,IAAI,mDAA+B,EAAE;QACpD,UAAU,EAAE,IAAI,oCAAmB,EAAE;QACrC,cAAc,EAAE,IAAI,uCAAkB,EAAE;QACxC,eAAe,EAAE,IAAI,gDAA0B,EAAE;QACjD,gBAAgB,EAAE,IAAI,kDAA2B,EAAE;KACpD,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AATW,QAAA,SAAS,aASpB"}

package/dist/bootstrap.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,KAAK,iBAAiB,EAAE,0BAAyB;AAQ1D;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,QAAO,iBAU5B,CAAC"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,iBAAiB,EAAE,0BAAyB;AAQ1D;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,QAAO,iBAS5B,CAAC"}

package/dist/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,KAAK,iBAAiB,EAAE,yBAAyB;AAQ1D;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,QAAO,iBAU5B,CAAC"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,iBAAiB,EAAE,yBAAyB;AAQ1D;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,QAAO,iBAS5B,CAAC"}

package/dist/bootstrap.js

@@ -4,13 +4,12 @@
  *
  * @packageDocumentation
  */
-import { ModestBenchConfigurationManager } from "./config/manager.js";
 import { TinybenchEngine } from "./core/engines/index.js";
-import { ModestBenchErrorManager } from "./core/error-manager.js";
-import { BenchmarkFileLoader } from "./core/loader.js";
-import { ModestBenchProgressManager } from "./progress/manager.js";
-import { ModestBenchReporterRegistry } from "./reporters/registry.js";
-import { FileHistoryStorage } from "./storage/history.js";
+import { ModestBenchConfigurationManager } from "./services/config-manager.js";
+import { BenchmarkFileLoader } from "./services/file-loader.js";
+import { FileHistoryStorage } from "./services/history-storage.js";
+import { ModestBenchProgressManager } from "./services/progress-manager.js";
+import { ModestBenchReporterRegistry } from "./services/reporter-registry.js";
 /**
  * Initializes the ModestBench engine with default dependencies.
  *
@@ -22,7 +21,6 @@ import { FileHistoryStorage } from "./storage/history.js";
 export const bootstrap = () => {
     const engine = new TinybenchEngine({
         configManager: new ModestBenchConfigurationManager(),
-        errorManager: new ModestBenchErrorManager(),
         fileLoader: new BenchmarkFileLoader(),
         historyStorage: new FileHistoryStorage(),
         progressManager: new ModestBenchProgressManager(),

package/dist/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,+BAA+B,EAAE,4BAA4B;AAEtE,OAAO,EAAE,eAAe,EAAE,gCAAgC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,gCAAgC;AAClE,OAAO,EAAE,mBAAmB,EAAE,yBAAyB;AACvD,OAAO,EAAE,0BAA0B,EAAE,8BAA8B;AACnE,OAAO,EAAE,2BAA2B,EAAE,gCAAgC;AACtE,OAAO,EAAE,kBAAkB,EAAE,6BAA6B;AAE1D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAsB,EAAE;IAC/C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,aAAa,EAAE,IAAI,+BAA+B,EAAE;QACpD,YAAY,EAAE,IAAI,uBAAuB,EAAE;QAC3C,UAAU,EAAE,IAAI,mBAAmB,EAAE;QACrC,cAAc,EAAE,IAAI,kBAAkB,EAAE;QACxC,eAAe,EAAE,IAAI,0BAA0B,EAAE;QACjD,gBAAgB,EAAE,IAAI,2BAA2B,EAAE;KACpD,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,gCAAgC;AAC1D,OAAO,EAAE,+BAA+B,EAAE,qCAAqC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,kCAAkC;AAChE,OAAO,EAAE,kBAAkB,EAAE,sCAAsC;AACnE,OAAO,EAAE,0BAA0B,EAAE,uCAAuC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,wCAAwC;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAsB,EAAE;IAC/C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,aAAa,EAAE,IAAI,+BAA+B,EAAE;QACpD,UAAU,EAAE,IAAI,mBAAmB,EAAE;QACrC,cAAc,EAAE,IAAI,kBAAkB,EAAE;QACxC,eAAe,EAAE,IAAI,0BAA0B,EAAE;QACjD,gBAAgB,EAAE,IAAI,2BAA2B,EAAE;KACpD,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}