utilium 3.7.1 → 3.9.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/dist/numbers.d.ts

@@ -9,3 +9,7 @@ export declare const formatCompact: {
 };
 export type ToNumber<T extends CoercibleToString> = `${T}` extends `${infer U extends number}` ? U : never;
 export type ToBigInt<T extends CoercibleToString> = `${T}` extends `${infer U extends bigint}` ? U : never;
+/**
+ * Parse a string containing some number of bytes, e.g. `1 GiB` or `99.4kb`
+ */
+export declare function parseBytes(input: string): bigint | null;

package/dist/numbers.js

@@ -15,3 +15,23 @@ export function toRadians(degrees) {
 }
 const __formatter = Intl.NumberFormat('en', { notation: 'compact' });
 export const formatCompact = __formatter.format.bind(__formatter);
+const byteSizePattern = /^(?<size>\d+(?:\.\d+)?)\s*(?<unit>\w*)$/i;
+const units = ['', 'K', 'M', 'G', 'T', 'P', 'E'];
+/**
+ * Parse a string containing some number of bytes, e.g. `1 GiB` or `99.4kb`
+ */
+export function parseBytes(input) {
+    const match = byteSizePattern.exec(input.trim());
+    if (!match)
+        return null;
+    const size = BigInt(match.groups.size);
+    let unit = match.groups.unit.toUpperCase();
+    if (unit.at(-1) == 'B')
+        unit = unit.slice(0, -1);
+    if (unit.at(-1) == 'I')
+        unit = unit.slice(0, -1);
+    const unitIndex = BigInt(units.indexOf(unit));
+    if (unitIndex === -1n)
+        return null;
+    return size * 1024n ** unitIndex;
+}

package/package.json

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