@jsenv/humanize 1.0.0 → 1.1.0

package/README.md

@@ -1,6 +1,14 @@
 # humanize [![npm package](https://img.shields.io/npm/v/@jsenv/humanize.svg?logo=npm&label=package)](https://www.npmjs.com/package/@jsenv/humanize)
 
-`@jsenv/humanize` turns a JavaScript value into a string meant to be read by a human. It is written in ES6 and compatible with browsers and Node.js.
+`@jsenv/humanize` helps to generate messages meant to be read by humans
+
+It is written in ES6 and compatible with browsers and Node.js.
+
+# API
+
+## humanize(jsValue)
+
+Turns a JavaScript value into a string meant to be read by a human.
 
 ```js
 import { humanize } from "@jsenv/humanize";
@@ -15,7 +23,6 @@ console.log(
 ```
 
 ```console
-❯ node ./docs/demo.mjs
 {
   "boolean": true,
   "number": 10,
@@ -23,13 +30,21 @@ console.log(
 }
 ```
 
-# Comparison with JSON.stringify
+### Comparison with JSON.stringify
+
+Table comparing `JSON.stringify` and `humanize()` to demonstrates how inspect focuses on readability and accuracy.
 
-Table comparing `JSON.stringify` and `@jsenv/humanize` to demonstrates how inspect focuses on readability and accuracy.
+| value     | JSON.stringify | humanize    |
+| --------- | -------------- | ----------- |
+| 123456789 | "123456789"    | 123_456_789 |
+| Infinity  | "null"         | Infinity    |
+| -0        | "0"            | -0          |
+| '"'       | '"\\""'        | '"'         |
 
-| value     | JSON.stringify | jsenv inspect |
-| --------- | -------------- | ------------- |
-| 123456789 | "123456789"    | 123_456_789   |
-| Infinity  | "null"         | Infinity      |
-| -0        | "0"            | -0            |
-| '"'       | '"\\""'        | '"'           |
+## humanizeDuration(ms, options)
+
+```js
+import { humanizeDuration } from "@jsenv/humanize";
+
+humanizeDuration(61_421); // "1 minute and 1 second"
+```

package/dist/browser/jsenv_humanize_browser.js

@@ -678,6 +678,80 @@ const compositeStringifiers = {
   String: inspectStringObject
 };
 
+// https://github.com/Marak/colors.js/blob/master/lib/styles.js
+// https://stackoverflow.com/a/75985833/2634179
+const RESET = "\x1b[0m";
+const ANSI = {
+  supported: true,
+  RED: "\x1b[31m",
+  GREEN: "\x1b[32m",
+  YELLOW: "\x1b[33m",
+  BLUE: "\x1b[34m",
+  MAGENTA: "\x1b[35m",
+  CYAN: "\x1b[36m",
+  GREY: "\x1b[90m",
+  color: (text, ANSI_COLOR) => {
+    return ANSI.supported && ANSI_COLOR ? "".concat(ANSI_COLOR).concat(text).concat(RESET) : text;
+  },
+  BOLD: "\x1b[1m",
+  UNDERLINE: "\x1b[4m",
+  STRIKE: "\x1b[9m",
+  effect: (text, ANSI_EFFECT) => {
+    return ANSI.supported && ANSI_EFFECT ? "".concat(ANSI_EFFECT).concat(text).concat(RESET) : text;
+  }
+};
+
+// see also https://github.com/sindresorhus/figures
+
+const UNICODE = {
+  supported: true,
+  get COMMAND_RAW() {
+    return UNICODE.supported ? "\u276F" : ">";
+  },
+  get OK_RAW() {
+    return UNICODE.supported ? "\u2714" : "\u221A";
+  },
+  get FAILURE_RAW() {
+    return UNICODE.supported ? "\u2716" : "\xD7";
+  },
+  get DEBUG_RAW() {
+    return UNICODE.supported ? "\u25C6" : "\u2666";
+  },
+  get INFO_RAW() {
+    return UNICODE.supported ? "\u2139" : "i";
+  },
+  get WARNING_RAW() {
+    return UNICODE.supported ? "\u26A0" : "\u203C";
+  },
+  get CIRCLE_CROSS_RAW() {
+    return UNICODE.supported ? "\u24E7" : "(\xD7)";
+  },
+  get COMMAND() {
+    return ANSI.color(UNICODE.COMMAND_RAW, ANSI.GREY); // ANSI_MAGENTA)
+  },
+  get OK() {
+    return ANSI.color(UNICODE.OK_RAW, ANSI.GREEN);
+  },
+  get FAILURE() {
+    return ANSI.color(UNICODE.FAILURE_RAW, ANSI.RED);
+  },
+  get DEBUG() {
+    return ANSI.color(UNICODE.DEBUG_RAW, ANSI.GREY);
+  },
+  get INFO() {
+    return ANSI.color(UNICODE.INFO_RAW, ANSI.BLUE);
+  },
+  get WARNING() {
+    return ANSI.color(UNICODE.WARNING_RAW, ANSI.YELLOW);
+  },
+  get CIRCLE_CROSS() {
+    return ANSI.color(UNICODE.CIRCLE_CROSS_RAW, ANSI.RED);
+  },
+  get ELLIPSIS() {
+    return UNICODE.supported ? "\u2026" : "...";
+  }
+};
+
 const getPrecision = number => {
   if (Math.floor(number) === number) return 0;
   const [, decimals] = number.toString().split(".");
@@ -914,7 +988,7 @@ const humanizeFileSize = (numberOfBytes, {
     short
   });
 };
-const humanizeMemoryUsage = (metricValue, {
+const humanizeMemory = (metricValue, {
   decimals,
   short
 } = {}) => {
@@ -1154,4 +1228,4 @@ const fillLeft = (value, biggestValue, char = " ") => {
   return padded;
 };
 
-export { createDetailedMessage, determineQuote, distributePercentages, generateContentFrame, humanize, humanizeDuration, humanizeEllapsedTime, humanizeFileSize, humanizeMemoryUsage, humanizeMethodSymbol, inspectChar };
+export { ANSI, UNICODE, createDetailedMessage, determineQuote, distributePercentages, generateContentFrame, humanize, humanizeDuration, humanizeEllapsedTime, humanizeFileSize, humanizeMemory, humanizeMethodSymbol, inspectChar };

package/dist/node/jsenv_humanize_node.js

@@ -91,170 +91,86 @@ const error = (...args) => console.error(...args);
 
 const errorDisabled = () => {};
 
-const ESC = '\u001B[';
-const OSC = '\u001B]';
-const BEL = '\u0007';
-const SEP = ';';
+/* globals WorkerGlobalScope, DedicatedWorkerGlobalScope, SharedWorkerGlobalScope, ServiceWorkerGlobalScope */
 
-/* global window */
-const isBrowser = typeof window !== 'undefined' && typeof window.document !== 'undefined';
+const isBrowser = globalThis.window?.document !== undefined;
 
-const isTerminalApp = !isBrowser && process$1.env.TERM_PROGRAM === 'Apple_Terminal';
-const isWindows = !isBrowser && process$1.platform === 'win32';
-const cwdFunction = isBrowser ? () => {
-	throw new Error('`process.cwd()` only works in Node.js, not the browser.');
-} : process$1.cwd;
+globalThis.process?.versions?.node !== undefined;
 
-const ansiEscapes = {};
+globalThis.process?.versions?.bun !== undefined;
 
-ansiEscapes.cursorTo = (x, y) => {
-	if (typeof x !== 'number') {
-		throw new TypeError('The `x` argument is required');
-	}
+globalThis.Deno?.version?.deno !== undefined;
 
-	if (typeof y !== 'number') {
-		return ESC + (x + 1) + 'G';
-	}
+globalThis.process?.versions?.electron !== undefined;
 
-	return ESC + (y + 1) + SEP + (x + 1) + 'H';
-};
+globalThis.navigator?.userAgent?.includes('jsdom') === true;
 
-ansiEscapes.cursorMove = (x, y) => {
-	if (typeof x !== 'number') {
-		throw new TypeError('The `x` argument is required');
-	}
+typeof WorkerGlobalScope !== 'undefined' && globalThis instanceof WorkerGlobalScope;
 
-	let returnValue = '';
+typeof DedicatedWorkerGlobalScope !== 'undefined' && globalThis instanceof DedicatedWorkerGlobalScope;
 
-	if (x < 0) {
-		returnValue += ESC + (-x) + 'D';
-	} else if (x > 0) {
-		returnValue += ESC + x + 'C';
-	}
+typeof SharedWorkerGlobalScope !== 'undefined' && globalThis instanceof SharedWorkerGlobalScope;
 
-	if (y < 0) {
-		returnValue += ESC + (-y) + 'A';
-	} else if (y > 0) {
-		returnValue += ESC + y + 'B';
-	}
+typeof ServiceWorkerGlobalScope !== 'undefined' && globalThis instanceof ServiceWorkerGlobalScope;
 
-	return returnValue;
-};
+// Note: I'm intentionally not DRYing up the other variables to keep them "lazy".
+const platform = globalThis.navigator?.userAgentData?.platform;
+
+platform === 'macOS'
+	|| globalThis.navigator?.platform === 'MacIntel' // Even on Apple silicon Macs.
+	|| globalThis.navigator?.userAgent?.includes(' Mac ') === true
+	|| globalThis.process?.platform === 'darwin';
+
+platform === 'Windows'
+	|| globalThis.navigator?.platform === 'Win32'
+	|| globalThis.process?.platform === 'win32';
+
+platform === 'Linux'
+	|| globalThis.navigator?.platform?.startsWith('Linux') === true
+	|| globalThis.navigator?.userAgent?.includes(' Linux ') === true
+	|| globalThis.process?.platform === 'linux';
+
+platform === 'Android'
+	|| globalThis.navigator?.platform === 'Android'
+	|| globalThis.navigator?.userAgent?.includes(' Android ') === true
+	|| globalThis.process?.platform === 'android';
+
+const ESC = '\u001B[';
+
+!isBrowser && process$1.env.TERM_PROGRAM === 'Apple_Terminal';
+const isWindows = !isBrowser && process$1.platform === 'win32';
+
+isBrowser ? () => {
+	throw new Error('`process.cwd()` only works in Node.js, not the browser.');
+} : process$1.cwd;
 
-ansiEscapes.cursorUp = (count = 1) => ESC + count + 'A';
-ansiEscapes.cursorDown = (count = 1) => ESC + count + 'B';
-ansiEscapes.cursorForward = (count = 1) => ESC + count + 'C';
-ansiEscapes.cursorBackward = (count = 1) => ESC + count + 'D';
-
-ansiEscapes.cursorLeft = ESC + 'G';
-ansiEscapes.cursorSavePosition = isTerminalApp ? '\u001B7' : ESC + 's';
-ansiEscapes.cursorRestorePosition = isTerminalApp ? '\u001B8' : ESC + 'u';
-ansiEscapes.cursorGetPosition = ESC + '6n';
-ansiEscapes.cursorNextLine = ESC + 'E';
-ansiEscapes.cursorPrevLine = ESC + 'F';
-ansiEscapes.cursorHide = ESC + '?25l';
-ansiEscapes.cursorShow = ESC + '?25h';
-
-ansiEscapes.eraseLines = count => {
+const cursorUp = (count = 1) => ESC + count + 'A';
+
+const cursorLeft = ESC + 'G';
+
+const eraseLines = count => {
 	let clear = '';
 
 	for (let i = 0; i < count; i++) {
-		clear += ansiEscapes.eraseLine + (i < count - 1 ? ansiEscapes.cursorUp() : '');
+		clear += eraseLine + (i < count - 1 ? cursorUp() : '');
 	}
 
 	if (count) {
-		clear += ansiEscapes.cursorLeft;
+		clear += cursorLeft;
 	}
 
 	return clear;
 };
+const eraseLine = ESC + '2K';
+const eraseScreen = ESC + '2J';
 
-ansiEscapes.eraseEndLine = ESC + 'K';
-ansiEscapes.eraseStartLine = ESC + '1K';
-ansiEscapes.eraseLine = ESC + '2K';
-ansiEscapes.eraseDown = ESC + 'J';
-ansiEscapes.eraseUp = ESC + '1J';
-ansiEscapes.eraseScreen = ESC + '2J';
-ansiEscapes.scrollUp = ESC + 'S';
-ansiEscapes.scrollDown = ESC + 'T';
-
-ansiEscapes.clearScreen = '\u001Bc';
-
-ansiEscapes.clearTerminal = isWindows
-	? `${ansiEscapes.eraseScreen}${ESC}0f`
+const clearTerminal = isWindows
+	? `${eraseScreen}${ESC}0f`
 	// 1. Erases the screen (Only done in case `2` is not supported)
 	// 2. Erases the whole screen including scrollback buffer
 	// 3. Moves cursor to the top-left position
 	// More info: https://www.real-world-systems.com/docs/ANSIcode.html
-	: `${ansiEscapes.eraseScreen}${ESC}3J${ESC}H`;
-
-ansiEscapes.enterAlternativeScreen = ESC + '?1049h';
-ansiEscapes.exitAlternativeScreen = ESC + '?1049l';
-
-ansiEscapes.beep = BEL;
-
-ansiEscapes.link = (text, url) => [
-	OSC,
-	'8',
-	SEP,
-	SEP,
-	url,
-	BEL,
-	text,
-	OSC,
-	'8',
-	SEP,
-	SEP,
-	BEL,
-].join('');
-
-ansiEscapes.image = (buffer, options = {}) => {
-	let returnValue = `${OSC}1337;File=inline=1`;
-
-	if (options.width) {
-		returnValue += `;width=${options.width}`;
-	}
-
-	if (options.height) {
-		returnValue += `;height=${options.height}`;
-	}
-
-	if (options.preserveAspectRatio === false) {
-		returnValue += ';preserveAspectRatio=0';
-	}
-
-	return returnValue + ':' + buffer.toString('base64') + BEL;
-};
-
-ansiEscapes.iTerm = {
-	setCwd: (cwd = cwdFunction()) => `${OSC}50;CurrentDir=${cwd}${BEL}`,
-
-	annotation(message, options = {}) {
-		let returnValue = `${OSC}1337;`;
-
-		const hasX = typeof options.x !== 'undefined';
-		const hasY = typeof options.y !== 'undefined';
-		if ((hasX || hasY) && !(hasX && hasY && typeof options.length !== 'undefined')) {
-			throw new Error('`x`, `y` and `length` must be defined when `x` or `y` is defined');
-		}
-
-		message = message.replace(/\|/g, '');
-
-		returnValue += options.isHidden ? 'AddHiddenAnnotation=' : 'AddAnnotation=';
-
-		if (options.length > 0) {
-			returnValue += (
-				hasX
-					? [message, options.length, options.x, options.y]
-					: [options.length, message]
-			).join('|');
-		} else {
-			returnValue += message;
-		}
-
-		return returnValue + BEL;
-	},
-};
+	:	`${eraseScreen}${ESC}3J${ESC}H`;
 
 /*
  * see also https://github.com/vadimdemedes/ink
@@ -302,7 +218,7 @@ const createDynamicLog = ({
     if (visualLineCount > rows) {
       if (clearTerminalAllowed) {
         clearAttemptResult = true;
-        return ansiEscapes.clearTerminal;
+        return clearTerminal;
       }
       // the whole log cannot be cleared because it's vertically to long
       // (longer than terminal height)
@@ -315,7 +231,7 @@ const createDynamicLog = ({
     }
 
     clearAttemptResult = true;
-    return ansiEscapes.eraseLines(visualLineCount);
+    return eraseLines(visualLineCount);
   };
 
   const update = (string) => {
@@ -344,20 +260,22 @@ const createDynamicLog = ({
     clearAttemptResult = undefined;
   };
 
-  const clearDuringFunctionCall = (callback) => {
+  const clearDuringFunctionCall = (
+    callback,
+    ouputAfterCallback = lastOutput,
+  ) => {
     // 1. Erase the current log
-    // 2. Call callback (expected to write something on stdout)
+    // 2. Call callback (expect to write something on stdout)
     // 3. Restore the current log
     // During step 2. we expect a "write from outside" so we uninstall
     // the stream spy during function call
-    const currentOutput = lastOutput;
     update("");
 
     writing = true;
     callback();
     writing = false;
 
-    update(currentOutput);
+    update(ouputAfterCallback);
   };
 
   const writeFromOutsideEffect = (value) => {
@@ -630,14 +548,19 @@ const ANSI = {
   YELLOW: "\x1b[33m",
   BLUE: "\x1b[34m",
   MAGENTA: "\x1b[35m",
+  CYAN: "\x1b[36m",
   GREY: "\x1b[90m",
   color: (text, ANSI_COLOR) => {
-    return ANSI.supported ? `${ANSI_COLOR}${text}${RESET}` : text;
+    return ANSI.supported && ANSI_COLOR ? `${ANSI_COLOR}${text}${RESET}` : text;
   },
 
   BOLD: "\x1b[1m",
+  UNDERLINE: "\x1b[4m",
+  STRIKE: "\x1b[9m",
   effect: (text, ANSI_EFFECT) => {
-    return ANSI.supported ? `${ANSI_EFFECT}${text}${RESET}` : text;
+    return ANSI.supported && ANSI_EFFECT
+      ? `${ANSI_EFFECT}${text}${RESET}`
+      : text;
   },
 };
 
@@ -1011,6 +934,9 @@ const UNICODE = {
   get CIRCLE_CROSS() {
     return ANSI.color(UNICODE.CIRCLE_CROSS_RAW, ANSI.RED);
   },
+  get ELLIPSIS() {
+    return UNICODE.supported ? `…` : `...`;
+  },
 };
 
 const createTaskLog = (
@@ -1751,7 +1677,7 @@ const humanizeFileSize = (numberOfBytes, { decimals, short } = {}) => {
   return inspectBytes(numberOfBytes, { decimals, short });
 };
 
-const humanizeMemoryUsage = (metricValue, { decimals, short } = {}) => {
+const humanizeMemory = (metricValue, { decimals, short } = {}) => {
   return inspectBytes(metricValue, { decimals, fixedDecimals: true, short });
 };
 
@@ -2000,4 +1926,4 @@ const fillLeft = (value, biggestValue, char = " ") => {
   return padded;
 };
 
-export { ANSI, UNICODE, createDetailedMessage, createDynamicLog, createLogger, createTaskLog, determineQuote, distributePercentages, generateContentFrame, humanize, humanizeDuration, humanizeEllapsedTime, humanizeFileSize, humanizeMemoryUsage, humanizeMethodSymbol, inspectChar, startSpinner };
+export { ANSI, UNICODE, createDetailedMessage, createDynamicLog, createLogger, createTaskLog, determineQuote, distributePercentages, generateContentFrame, humanize, humanizeDuration, humanizeEllapsedTime, humanizeFileSize, humanizeMemory, humanizeMethodSymbol, inspectChar, startSpinner };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/humanize",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Generate messages meant to read by humans",
   "license": "MIT",
   "repository": {
@@ -39,10 +39,10 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "string-width": "7.0.0"
+    "string-width": "7.2.0"
   },
   "devDependencies": {
-    "ansi-escapes": "6.2.0",
+    "ansi-escapes": "7.0.0",
     "is-unicode-supported": "2.0.0",
     "supports-color": "9.4.0"
   }

package/src/.jsenv/jsenv_tests_output.txt

@@ -1,35 +1,32 @@
------------ 23 executions to run ------------
-20 with node (node_worker_thread@20.11.0)
-1 with chromium (chromium@120.0.6099.28)
-1 with firefox (firefox@119.0)
-1 with webkit (webkit@17.4)
+-------------- execution start --------------
+21 files matching "testPlan" in /Users/damien.maillard/dev/perso/jsenv-core/packages/independent/humanize/src
 ---------------------------------------------
 
-✔ 01/23 _tests/byte/file_size.test.js [node/0.03s/1.2MB] (1 completed)
-✔ 02/23 _tests/byte/memory_usage.test.js [node/0.03s/1.2MB] (2 completed)
-✔ 03/23 _tests/content_frame/content_frame.test.js [node/0.1s/2.6MB] (3 completed)
-✔ 04/23 _tests/js_value/_inspect.test.html [chromium/0.2s/10.1MB] (4 completed)
-✔ 05/23 _tests/js_value/_inspect.test.html [firefox/0.2s] (5 completed)
+✔ 01/23 _tests/byte/file_size.test.js [node/0.03s] (1 completed)
+✔ 02/23 _tests/byte/memory.test.js [node/0.03s] (2 completed)
+✔ 03/23 _tests/content_frame/content_frame.test.js [node/0.07s] (3 completed)
+✔ 04/23 _tests/js_value/_inspect.test.html [chromium/0.2s] (4 completed)
+✔ 05/23 _tests/js_value/_inspect.test.html [firefox/0.1s] (5 completed)
 ✔ 06/23 _tests/js_value/_inspect.test.html [webkit/0.3s] (6 completed)
-✔ 07/23 _tests/js_value/array.test.js [node/0.09s/1.2MB] (7 completed)
-✔ 08/23 _tests/js_value/biginit.test.js [node/0.06s/1.2MB] (8 completed)
-✔ 09/23 _tests/js_value/boolean.test.js [node/0.1s/1.2MB] (9 completed)
-✔ 10/23 _tests/js_value/date.test.js [node/0.04s/1.2MB] (10 completed)
-✔ 11/23 _tests/js_value/error.test.js [node/0.05s/1.2MB] (11 completed)
-✔ 12/23 _tests/js_value/function.test.js [node/0.05s/1.2MB] (12 completed)
-✔ 13/23 _tests/js_value/instance.test.js [node/0.05s/1.2MB] (13 completed)
-✔ 14/23 _tests/js_value/null.test.js [node/0.04s/1.2MB] (14 completed)
-✔ 15/23 _tests/js_value/number.test.js [node/0.06s/1.3MB] (15 completed)
-✔ 16/23 _tests/js_value/object.test.js [node/0.05s/1.3MB] (16 completed)
-✔ 17/23 _tests/js_value/regexp.test.js [node/0.05s/1.2MB] (17 completed)
-✔ 18/23 _tests/js_value/string.test.js [node/0.05s/1.2MB] (18 completed)
-✔ 19/23 _tests/js_value/symbol.test.js [node/0.05s/1.2MB] (19 completed)
-✔ 20/23 _tests/js_value/undefined.test.js [node/0.06s/1.2MB] (20 completed)
-✔ 21/23 _tests/time/decimals.test.js [node/0.03s/1.2MB] (21 completed)
-✔ 22/23 _tests/time/duration.test.js [node/0.03s/1.2MB] (22 completed)
-✔ 23/23 _tests/time/ellapsed.test.js [node/0.02s/1.2MB] (all completed)
+✔ 07/23 _tests/js_value/array.test.js [node/0.03s] (7 completed)
+✔ 08/23 _tests/js_value/biginit.test.js [node/0.03s] (8 completed)
+✔ 09/23 _tests/js_value/boolean.test.js [node/0.1s] (9 completed)
+✔ 10/23 _tests/js_value/date.test.js [node/0.1s] (10 completed)
+✔ 11/23 _tests/js_value/error.test.js [node/0.1s] (11 completed)
+✔ 12/23 _tests/js_value/function.test.js [node/0.05s] (12 completed)
+✔ 13/23 _tests/js_value/instance.test.js [node/0.1s] (13 completed)
+✔ 14/23 _tests/js_value/null.test.js [node/0.04s] (14 completed)
+✔ 15/23 _tests/js_value/number.test.js [node/0.06s] (15 completed)
+✔ 16/23 _tests/js_value/object.test.js [node/0.06s] (16 completed)
+✔ 17/23 _tests/js_value/regexp.test.js [node/0.04s] (17 completed)
+✔ 18/23 _tests/js_value/string.test.js [node/0.05s] (18 completed)
+✔ 19/23 _tests/js_value/symbol.test.js [node/0.02s] (19 completed)
+✔ 20/23 _tests/js_value/undefined.test.js [node/0.03s] (20 completed)
+✔ 21/23 _tests/time/decimals.test.js [node/0.03s] (21 completed)
+✔ 22/23 _tests/time/duration.test.js [node/0.03s] (22 completed)
+✔ 23/23 _tests/time/ellapsed.test.js [node/0.03s] (all completed)
 
------------------- summary ------------------
+--------------- execution end ---------------
 23 executions: all completed
-duration: 4.4s (setup: 0.4s, execution: 4.2s, teardown: 0.2s)
+duration: 2.6s (setup: 0.4s, execution: 2.4s, teardown: 0.2s)
 ---------------------------------------------

package/src/_tests/byte/file_size.test.js

@@ -2,9 +2,9 @@ import { assert } from "@jsenv/assert";
 
 import { humanizeFileSize } from "@jsenv/humanize";
 
-const test = (fileSize, expected) => {
+const test = (fileSize, expect) => {
   const actual = humanizeFileSize(fileSize);
-  assert({ actual, expected });
+  assert({ actual, expect });
 };
 
 test(0, "0 B");

package/src/_tests/byte/memory.test.js

@@ -0,0 +1,11 @@
+import { assert } from "@jsenv/assert";
+
+import { humanizeMemory } from "@jsenv/humanize";
+
+const test = (memoryUsageInBytes, expect) => {
+  const actual = humanizeMemory(memoryUsageInBytes);
+  assert({ actual, expect });
+};
+
+test(1000, "1.0 kB");
+test(1100, "1.1 kB");

package/src/_tests/js_value/array.test.js

@@ -3,35 +3,35 @@ import { humanize } from "@jsenv/humanize";
 
 {
   const actual = humanize([]);
-  const expected = `[]`;
-  assert({ actual, expected });
+  const expect = `[]`;
+  assert({ actual, expect });
 }
 
 {
   const actual = humanize([[]]);
-  const expected = `[
+  const expect = `[
   []
 ]`;
-  assert({ actual, expected });
+  assert({ actual, expect });
 }
 
 {
   const actual = humanize(Array(3));
   // prettier-ignore
-  const expected = `[
+  const expect = `[
   ,
   ,
 ${"  "}
 ]`
-  assert({ actual, expected });
+  assert({ actual, expect });
 }
 
 {
   const actual = humanize([Symbol()]);
-  const expected = `[
+  const expect = `[
   Symbol()
 ]`;
-  assert({ actual, expected });
+  assert({ actual, expect });
 }
 
 {
@@ -40,23 +40,23 @@ ${"  "}
 
   {
     const actual = humanize(newArray);
-    const expected = `[
+    const expect = `[
   "foo",
   1
 ]`;
     assert({
       actual,
-      expected,
+      expect,
     });
   }
 
   {
     const actual = humanize(newArray);
-    const expected = `[
+    const expect = `[
   "foo",
   1
 ]`;
-    assert({ actual, expected });
+    assert({ actual, expect });
   }
 }
 
@@ -64,9 +64,9 @@ ${"  "}
   const circularArray = [0];
   circularArray.push(circularArray);
   const actual = humanize(circularArray);
-  const expected = `[
+  const expect = `[
   0,
   Symbol.for('circular')
 ]`;
-  assert({ actual, expected });
+  assert({ actual, expect });
 }