@thi.ng/bench 3.1.23 → 3.2.2

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-01-10T15:20:18Z
+- **Last updated**: 2023-02-10T14:03:10Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,13 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [3.2.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/bench@3.2.0) (2023-02-05)
+
+#### 🚀 Features
+
+- add support for performance.now() ([f48cb35](https://github.com/thi-ng/umbrella/commit/f48cb35))
+  - update now() to add perf.now as primary fallback option
+
 ## [3.1.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/bench@3.1.0) (2021-11-17)
 
 #### 🚀 Features

package/README.md

@@ -27,12 +27,18 @@ This project is part of the
 Benchmarking utilities w/ various statistics & formatters (CSV, Markdown etc.).
 
 Though no public API change (only additions), since v2.0.0 this library
-internally attempts to use high-res ES
+internally (via
+[`now()`](https://docs.thi.ng/umbrella/bench/functions/now.html)) attempts to
+use high-res ES
 [`BigInt`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt)
 timestamps (in Node via
-[`process.hrtime.bigint()`](https://nodejs.org/dist/latest-v12.x/docs/api/process.html#process_process_hrtime_bigint)).
-If `BigInt` is not available in the target environment, timestamps are still
-only sourced via `Date.now()`.
+[`process.hrtime.bigint()`](https://nodejs.org/dist/latest-v12.x/docs/api/process.html#process_process_hrtime_bigint))
+or falls back to `performance.now()` or lacking that to `Date.now()`. In all
+cases, returns a (possibly rounded) nanosec-scale timestamp, either as `bigint`
+or `number`. The
+[`timeDiff()`](https://docs.thi.ng/umbrella/bench/functions/timeDiff.html)
+function can be used to compute the difference between two such timestamp and
+return it as milliseconds.
 
 ## Status
 
@@ -65,7 +71,7 @@ For Node.js REPL:
 const bench = await import("@thi.ng/bench");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 1.25 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 1.27 KB
 
 ## Dependencies
 
@@ -82,6 +88,7 @@ A selection:
 | Screenshot                                                                                                                | Description                                                                      | Live demo                                                | Source                                                                                |
 |:--------------------------------------------------------------------------------------------------------------------------|:---------------------------------------------------------------------------------|:---------------------------------------------------------|:--------------------------------------------------------------------------------------|
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/geom-knn.jpg" width="240"/>           | Doodle w/ K-nearest neighbor search result visualization                         | [Demo](https://demo.thi.ng/umbrella/geom-knn/)           | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/geom-knn)           |
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/geom-knn-hash.jpg" width="240"/>      | K-nearest neighbor search in an hash grid                                        | [Demo](https://demo.thi.ng/umbrella/geom-knn-hash/)      | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/geom-knn-hash)      |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/geom-voronoi-mst.jpg" width="240"/>   | Poisson-disk shape-aware sampling, Voronoi & Minimum Spanning Tree visualization | [Demo](https://demo.thi.ng/umbrella/geom-voronoi-mst/)   | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/geom-voronoi-mst)   |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/markdown-parser.jpg" width="240"/>    | Minimal Markdown to Hiccup to HTML parser / transformer                          | [Demo](https://demo.thi.ng/umbrella/markdown/)           | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/markdown)           |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/parse-playground.png" width="240"/>   | Parser grammar livecoding editor/playground & codegen                            | [Demo](https://demo.thi.ng/umbrella/parse-playground/)   | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/parse-playground)   |

package/now.d.ts

@@ -1,9 +1,9 @@
 import type { Fn0, FnU2 } from "@thi.ng/api";
 import type { Timestamp } from "./api.js";
 /**
- * If available, returns wrapper for `process.hrtime.bigint()` else
- * falls back to `Date.now()`. In all cases, returns a nanosec-scale
- * timestamp, either as `bigint` or `number`.
+ * If available, returns wrapper for `process.hrtime.bigint()` else falls back
+ * to `performance.now()` or lacking that to `Date.now()`. In all cases, returns
+ * a nanosec-scale timestamp, either as `bigint` or `number`.
  */
 export declare const now: Fn0<Timestamp>;
 /**

package/now.js

@@ -1,15 +1,19 @@
 /**
- * If available, returns wrapper for `process.hrtime.bigint()` else
- * falls back to `Date.now()`. In all cases, returns a nanosec-scale
- * timestamp, either as `bigint` or `number`.
+ * If available, returns wrapper for `process.hrtime.bigint()` else falls back
+ * to `performance.now()` or lacking that to `Date.now()`. In all cases, returns
+ * a nanosec-scale timestamp, either as `bigint` or `number`.
  */
 export const now = typeof BigInt !== "undefined"
     ? typeof process !== "undefined" &&
         typeof process.hrtime !== "undefined" &&
         typeof process.hrtime.bigint === "function"
         ? () => process.hrtime.bigint()
-        : () => BigInt(Date.now() * 1e6)
-    : () => Date.now() * 1e6;
+        : typeof performance !== "undefined"
+            ? () => BigInt(Math.floor(performance.now() * 1e6))
+            : () => BigInt(Date.now() * 1e6)
+    : typeof performance !== "undefined"
+        ? () => performance.now() * 1e6
+        : () => Date.now() * 1e6;
 /**
  * Returns the difference in milliseconds between 2 given
  * {@link Timestamp}s.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/bench",
-  "version": "3.1.23",
+  "version": "3.2.2",
   "description": "Benchmarking utilities w/ various statistics & formatters (CSV, Markdown etc.)",
   "type": "module",
   "module": "./index.js",
@@ -34,16 +34,16 @@
     "test": "testament test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.6.3"
+    "@thi.ng/api": "^8.7.2"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.33.7",
-    "@thi.ng/testament": "^0.3.9",
-    "@types/node": "^18.11.13",
-    "rimraf": "^3.0.2",
+    "@microsoft/api-extractor": "^7.34.2",
+    "@thi.ng/testament": "^0.3.11",
+    "@types/node": "^18.11.18",
+    "rimraf": "^4.1.2",
     "tools": "^0.0.1",
-    "typedoc": "^0.23.22",
-    "typescript": "^4.9.4"
+    "typedoc": "^0.23.24",
+    "typescript": "^4.9.5"
   },
   "keywords": [
     "benchmark",
@@ -114,5 +114,5 @@
     ],
     "year": 2018
   },
-  "gitHead": "3f0b3e2a7c82aefc7e46fb4338369836b5e1b8cf\n"
+  "gitHead": "cafa4ecea90fb681949dc3885a5bd6ddefa38b51\n"
 }