@thi.ng/bench 3.6.7 → 3.6.8

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-12-12T10:11:58Z
+- **Last updated**: 2024-12-27T14:11:37Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,15 @@ 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.6.8](https://github.com/thi-ng/umbrella/tree/@thi.ng/bench@3.6.8) (2024-12-27)
+
+#### ♻️ Refactoring
+
+- migrate timestamp fns to [@thi.ng/timestamp](https://github.com/thi-ng/umbrella/tree/main/packages/timestamp) ([f178b1a](https://github.com/thi-ng/umbrella/commit/f178b1a))
+  - update deps
+  - update exports
+  - update readme
+
 ## [3.6.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/bench@3.6.0) (2024-08-10)
 
 #### 🚀 Features

package/README.md

@@ -7,7 +7,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 > [!NOTE]
-> This is one of 199 standalone projects, maintained as part
+> This is one of 200 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
@@ -33,19 +33,10 @@
 
 Benchmarking & profiling utilities w/ various statistics & formatters (CSV, JSON, Markdown etc.).
 
-Though no public API change (only additions), since v2.0.0 this library
-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))
-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.
+> [!IMPORTANT]
+> As of 2024-12-27, all timestamp-related functions have been extracted/migrated
+> to the new [@thi.ng/timestamp](https://thi.ng/timestamp) package, but are
+> still available here as re-exports too.
 
 ## Status
 
@@ -84,11 +75,12 @@ For Node.js REPL:
 const bench = await import("@thi.ng/bench");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 2.14 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 2.06 KB
 
 ## Dependencies
 
 - [@thi.ng/api](https://github.com/thi-ng/umbrella/tree/develop/packages/api)
+- [@thi.ng/timestamp](https://github.com/thi-ng/umbrella/tree/develop/packages/timestamp)
 
 Note: @thi.ng/api is in _most_ cases a type-only import (not used at runtime)
 

package/api.d.ts

@@ -1,5 +1,5 @@
 import type { Fn, Fn0, Fn2 } from "@thi.ng/api";
-export type Timestamp = number | bigint;
+export type { Timestamp } from "@thi.ng/timestamp";
 export type TimingResult<T> = [T, number];
 export interface BenchmarkOpts {
     /**

package/now.d.ts

@@ -1,24 +1,2 @@
-import type { Fn0 } from "@thi.ng/api";
-import type { Timestamp } from "./api.js";
-/**
- * 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>;
-/**
- * Returns the difference in milliseconds between 2 given {@link Timestamp}s.
- * `b` defaults to result of {@link now}.
- *
- * @param a
- * @param b
- */
-export declare const timeDiff: (a: Timestamp, b?: Timestamp) => number;
-/**
- * Takes a duration (either a number or bigint) in nanosec-scale (see
- * {@link now}) and converts it to a JS number in milliseconds.
- *
- * @param t
- */
-export declare const asMillis: (t: number | bigint) => number;
+export { asMillis, now, timeDiff } from "@thi.ng/timestamp";
 //# sourceMappingURL=now.d.ts.map

package/now.js

@@ -1,6 +1,4 @@
-const now = typeof BigInt !== "undefined" ? typeof process !== "undefined" && typeof process.hrtime !== "undefined" && typeof process.hrtime.bigint === "function" ? () => process.hrtime.bigint() : typeof performance !== "undefined" ? () => BigInt(Math.floor(performance.now() * 1e6)) : () => BigInt(Date.now() * 1e6) : typeof performance !== "undefined" ? () => performance.now() * 1e6 : () => Date.now() * 1e6;
-const timeDiff = (a, b = now()) => (typeof BigInt !== "undefined" ? Number(b - a) : b - a) * 1e-6;
-const asMillis = (t) => (typeof t === "bigint" ? Number(t) : t) * 1e-6;
+import { asMillis, now, timeDiff } from "@thi.ng/timestamp";
 export {
   asMillis,
   now,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/bench",
-  "version": "3.6.7",
+  "version": "3.6.8",
   "description": "Benchmarking & profiling utilities w/ various statistics & formatters (CSV, JSON, Markdown etc.)",
   "type": "module",
   "module": "./index.js",
@@ -19,6 +19,10 @@
     {
       "type": "patreon",
       "url": "https://patreon.com/thing_umbrella"
+    },
+    {
+      "type": "liberapay",
+      "url": "https://liberapay.com/thi.ng"
     }
   ],
   "author": "Karsten Schmidt <k+npm@thi.ng>",
@@ -36,14 +40,15 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.14"
+    "@thi.ng/api": "^8.11.15",
+    "@thi.ng/timestamp": "^1.1.0"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.48.0",
-    "@types/node": "^22.10.1",
-    "esbuild": "^0.24.0",
+    "@microsoft/api-extractor": "^7.48.1",
+    "@types/node": "^22.10.2",
+    "esbuild": "^0.24.2",
     "tools": "^0.0.1",
-    "typedoc": "^0.27.4",
+    "typedoc": "^0.27.6",
     "typescript": "^5.7.2"
   },
   "keywords": [
@@ -57,6 +62,7 @@
     "statistics",
     "table",
     "time",
+    "timestamp",
     "typescript"
   ],
   "publishConfig": {
@@ -116,5 +122,5 @@
     ],
     "year": 2018
   },
-  "gitHead": "34ac95538d96f046090fef5fd3a1dc36d54663d5\n"
+  "gitHead": "48bf4c22bf23f88ac99f435106af2214f79a0be1\n"
 }