utilium 3.7.1 → 3.8.0

package/dist/format.d.ts

@@ -0,0 +1,5 @@
+export declare function dateRange(date: Date): string;
+export declare function bytes(bytes: bigint | number): string;
+export declare function ms(time: number): string;
+/** Formats a short duration into colon-separated values */
+export declare function duration(seconds: number): string;

package/dist/format.js

@@ -0,0 +1,33 @@
+// SPDX-License-Identifier: LGPL-3.0-or-later
+// Copyright (c) 2026 James Prevett
+export function dateRange(date) {
+    const rawDays = (date.getTime() - Date.now()) / (24 * 3600_000);
+    const daysCount = Math.abs(rawDays);
+    const daysText = Math.round(daysCount);
+    const plural = daysCount == 1 ? '' : 's';
+    return `${date.toLocaleString()} (${rawDays >= 0 ? `in ${daysText} day${plural}` : `${daysText} day${plural} ago`})`;
+}
+export function bytes(bytes) {
+    if (typeof bytes == 'number') {
+        bytes = BigInt(bytes);
+    }
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    const i = bytes == 0n ? 0 : Math.floor((bytes.toString(10).length - 1) / 3);
+    const value = bytes == 0n ? 0 : Number(bytes) / Math.pow(1000, i);
+    return `${Number.isInteger(value) ? value : value.toFixed(2)} ${units[i]}`;
+}
+export function ms(time) {
+    return time > 5000 ? (time / 1000).toFixed(2) + 's' : time + 'ms';
+}
+/** Formats a short duration into colon-separated values */
+export function duration(seconds) {
+    if (!Number.isFinite(seconds))
+        return '--:--';
+    seconds = Math.floor(seconds);
+    let minutes = Math.floor(seconds / 60);
+    seconds %= 60;
+    const hours = Math.floor(minutes / 60);
+    minutes %= 60;
+    const secondsStr = ':' + seconds.toString().padStart(2, '0');
+    return hours ? `${hours}:${minutes.toString().padStart(2, '0')}${secondsStr}` : minutes + secondsStr;
+}

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export * as cache from './cache.js';
 export * from './checksum.js';
 export * from './color.js';
 export * as diff from './diff.js';
+export * as format from './format.js';
 export * from './list.js';
 export * from './misc.js';
 export * from './numbers.js';

package/dist/index.js

@@ -7,6 +7,7 @@ export * as cache from './cache.js';
 export * from './checksum.js';
 export * from './color.js';
 export * as diff from './diff.js';
+export * as format from './format.js';
 export * from './list.js';
 export * from './misc.js';
 export * from './numbers.js';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "utilium",
-	"version": "3.7.1",
+	"version": "3.8.0",
 	"description": "Typescript utilities",
 	"funding": {
 		"type": "individual",
@@ -68,5 +68,6 @@
 	},
 	"allowScripts": {
 		"esbuild": true
-	}
+	},
+	"sideEffects": false
 }