@fuzdev/fuz_util 0.53.1 → 0.53.2

package/dist/bytes.d.ts

@@ -11,4 +11,11 @@
  * @returns `Uint8Array` view of the data.
  */
 export declare const to_bytes: (data: BufferSource | string) => Uint8Array;
+/**
+ * Formats a byte count as a human-readable string.
+ *
+ * @param n - byte count.
+ * @returns formatted string like `'1.2 KB'` or `'3.4 MB'`.
+ */
+export declare const format_bytes: (n: number) => string;
 //# sourceMappingURL=bytes.d.ts.map

package/dist/bytes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bytes.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/bytes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,YAAY,GAAG,MAAM,KAAG,UAKtD,CAAC"}
+{"version":3,"file":"bytes.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/bytes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,YAAY,GAAG,MAAM,KAAG,UAKtD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,GAAG,MAAM,KAAG,MAKxC,CAAC"}

package/dist/bytes.js

@@ -20,3 +20,18 @@ export const to_bytes = (data) => {
         return new Uint8Array(data);
     return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
 };
+/**
+ * Formats a byte count as a human-readable string.
+ *
+ * @param n - byte count.
+ * @returns formatted string like `'1.2 KB'` or `'3.4 MB'`.
+ */
+export const format_bytes = (n) => {
+    if (n < 1024)
+        return n + ' B';
+    if (n < 1024 * 1024)
+        return (n / 1024).toFixed(1) + ' KB';
+    if (n < 1024 * 1024 * 1024)
+        return (n / (1024 * 1024)).toFixed(1) + ' MB';
+    return (n / (1024 * 1024 * 1024)).toFixed(1) + ' GB';
+};

package/dist/hash_blake3.d.ts

@@ -2,9 +2,17 @@
  * BLAKE3 cryptographic hashing via `@fuzdev/blake3_wasm`.
  *
  * Synchronous and fast. Returns hex-encoded 256-bit (32-byte) digests.
+ * WASM initialization starts eagerly on import. Await `blake3_ready` before first use
+ * in browser contexts where the WASM must be fetched asynchronously.
  *
  * @module
  */
+/**
+ * Resolves when the BLAKE3 WASM module is initialized and ready.
+ * Initialization starts eagerly on import. Idempotent — safe to await multiple times.
+ * In Node.js/Deno (sync init), this resolves immediately.
+ */
+export declare const blake3_ready: Promise<void>;
 /**
  * Computes a BLAKE3 hash synchronously.
  *

package/dist/hash_blake3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hash_blake3.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/hash_blake3.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,YAAY,GAAG,MAAM,KAAG,MAAsC,CAAC"}
+{"version":3,"file":"hash_blake3.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/hash_blake3.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;;;GAIG;AACH,eAAO,MAAM,YAAY,eAAS,CAAC;AAEnC;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,YAAY,GAAG,MAAM,KAAG,MAAsC,CAAC"}

package/dist/hash_blake3.js

@@ -2,12 +2,20 @@
  * BLAKE3 cryptographic hashing via `@fuzdev/blake3_wasm`.
  *
  * Synchronous and fast. Returns hex-encoded 256-bit (32-byte) digests.
+ * WASM initialization starts eagerly on import. Await `blake3_ready` before first use
+ * in browser contexts where the WASM must be fetched asynchronously.
  *
  * @module
  */
-import { hash } from '@fuzdev/blake3_wasm';
+import { hash, init } from '@fuzdev/blake3_wasm';
 import { to_hex } from './hex.js';
 import { to_bytes } from './bytes.js';
+/**
+ * Resolves when the BLAKE3 WASM module is initialized and ready.
+ * Initialization starts eagerly on import. Idempotent — safe to await multiple times.
+ * In Node.js/Deno (sync init), this resolves immediately.
+ */
+export const blake3_ready = init();
 /**
  * Computes a BLAKE3 hash synchronously.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_util",
-  "version": "0.53.1",
+  "version": "0.53.2",
   "description": "utility belt for JS",
   "glyph": "🦕",
   "logo": "logo.svg",

package/src/lib/bytes.ts

@@ -19,3 +19,16 @@ export const to_bytes = (data: BufferSource | string): Uint8Array => {
 	if (data instanceof ArrayBuffer) return new Uint8Array(data);
 	return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
 };
+
+/**
+ * Formats a byte count as a human-readable string.
+ *
+ * @param n - byte count.
+ * @returns formatted string like `'1.2 KB'` or `'3.4 MB'`.
+ */
+export const format_bytes = (n: number): string => {
+	if (n < 1024) return n + ' B';
+	if (n < 1024 * 1024) return (n / 1024).toFixed(1) + ' KB';
+	if (n < 1024 * 1024 * 1024) return (n / (1024 * 1024)).toFixed(1) + ' MB';
+	return (n / (1024 * 1024 * 1024)).toFixed(1) + ' GB';
+};

package/src/lib/hash_blake3.ts

@@ -2,15 +2,24 @@
  * BLAKE3 cryptographic hashing via `@fuzdev/blake3_wasm`.
  *
  * Synchronous and fast. Returns hex-encoded 256-bit (32-byte) digests.
+ * WASM initialization starts eagerly on import. Await `blake3_ready` before first use
+ * in browser contexts where the WASM must be fetched asynchronously.
  *
  * @module
  */
 
-import {hash} from '@fuzdev/blake3_wasm';
+import {hash, init} from '@fuzdev/blake3_wasm';
 
 import {to_hex} from './hex.js';
 import {to_bytes} from './bytes.js';
 
+/**
+ * Resolves when the BLAKE3 WASM module is initialized and ready.
+ * Initialization starts eagerly on import. Idempotent — safe to await multiple times.
+ * In Node.js/Deno (sync init), this resolves immediately.
+ */
+export const blake3_ready = init();
+
 /**
  * Computes a BLAKE3 hash synchronously.
  *