@visulima/humanizer 3.0.0-alpha.1 → 3.0.0-alpha.11

package/LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 visulima
+Copyright (c) 2026 visulima
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,15 +1,24 @@
-<div align="center">
-  <h3>Visulima humanizer</h3>
-  <p>
-  Humanizer is a library for humanizing data in a human-readable form.
-  </p>
-</div>
+<!-- START_PACKAGE_OG_IMAGE_PLACEHOLDER -->
+
+<a href="https://www.anolilab.com/open-source" align="center">
+
+  <img src="__assets__/package-og.svg" alt="humanizer" />
+
+</a>
+
+<h3 align="center">Humanizer is a library for humanizing data in a human-readable form.</h3>
+
+<!-- END_PACKAGE_OG_IMAGE_PLACEHOLDER -->
 
 <br />
 
 <div align="center">
 
-[![typescript-image]][typescript-url] [![npm-image]][npm-url] [![license-image]][license-url]
+[![typescript-image][typescript-badge]][typescript-url]
+[![mit licence][license-badge]][license]
+[![npm downloads][npm-downloads-badge]][npm-downloads]
+[![Chat][chat-badge]][chat]
+[![PRs Welcome][prs-welcome-badge]][prs-welcome]
 
 </div>
 
@@ -1056,14 +1065,23 @@ If you would like to help take a look at the [list of issues](https://github.com
 - [Daniel Bannert](https://github.com/prisis)
 - [All Contributors](https://github.com/visulima/visulima/graphs/contributors)
 
+## Made with ❤️ at Anolilab
+
+This is an open source project and will always remain free to use. If you think it's cool, please star it 🌟. [Anolilab](https://www.anolilab.com/open-source) is a Development and AI Studio. Contact us at [hello@anolilab.com](mailto:hello@anolilab.com) if you need any help with these technologies or just want to say hi!
+
 ## License
 
-The visulima humanizer is open-sourced software licensed under the [MIT][license-url]
+The visulima humanizer is open-sourced software licensed under the [MIT][license]
 
-[typescript-image]: https://img.shields.io/badge/Typescript-294E80.svg?style=for-the-badge&logo=typescript
+<!-- badges -->
 
-[typescript-url]: https://www.typescriptlang.org/ "TypeScript" "typescript"
-[license-image]: https://img.shields.io/npm/l/@visulima/humanizer?color=blueviolet&style=for-the-badge
-[license-url]: LICENSE.md "license"
-[npm-image]: https://img.shields.io/npm/v/@visulima/humanizer/latest.svg?style=for-the-badge&logo=npm
-[npm-url]: https://www.npmjs.com/package/@visulima/humanizer/v/latest "npm"
+[license-badge]: https://img.shields.io/npm/l/@visulima/humanizer?style=for-the-badge
+[license]: https://github.com/visulima/visulima/blob/main/LICENSE
+[npm-downloads-badge]: https://img.shields.io/npm/dm/@visulima/humanizer?style=for-the-badge
+[npm-downloads]: https://www.npmjs.com/package/@visulima/humanizer
+[prs-welcome-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge
+[prs-welcome]: https://github.com/visulima/visulima/blob/main/.github/CONTRIBUTING.md
+[chat-badge]: https://img.shields.io/discord/932323359193186354.svg?style=for-the-badge
+[chat]: https://discord.gg/TtFJY8xkFK
+[typescript-badge]: https://img.shields.io/badge/Typescript-294E80.svg?style=for-the-badge&logo=typescript
+[typescript-url]: https://www.typescriptlang.org/

package/dist/index.js

@@ -1,3 +1,3 @@
-export { formatBytes, parseBytes } from './packem_shared/parseBytes-JWspeMzP.js';
-export { default as duration } from './packem_shared/duration-C62ipnQn.js';
-export { default as parseDuration } from './packem_shared/parseDuration-CeFaBgx9.js';
+export { formatBytes, parseBytes } from './packem_shared/parseBytes-BkjYV2ut.js';
+export { default as duration } from './packem_shared/duration-Br8Mr-Lj.js';
+export { default as parseDuration } from './packem_shared/parseDuration-qO1Y4eiu.js';

package/dist/language/ro.js

@@ -28,15 +28,28 @@ const roUnitMap = {
   zi: "d",
   zile: "d"
 };
+const romanianUnit = (unit) => (counter) => {
+  if (counter === 1) {
+    return unit[0];
+  }
+  if (Math.floor(counter) !== counter || counter === 0) {
+    return unit[1];
+  }
+  const remainder = counter % 100;
+  if (remainder >= 1 && remainder <= 19) {
+    return unit[1];
+  }
+  return unit[2];
+};
 const durationLanguage = createDurationLanguage(
-  (counter) => counter === 1 ? "an" : "ani",
-  (counter) => counter === 1 ? "lună" : "luni",
-  (counter) => counter === 1 ? "săptămână" : "săptămâni",
-  (counter) => counter === 1 ? "zi" : "zile",
-  (counter) => counter === 1 ? "oră" : "ore",
-  (counter) => counter === 1 ? "minut" : "minute",
-  (counter) => counter === 1 ? "secundă" : "secunde",
-  (counter) => counter === 1 ? "milisecundă" : "milisecunde",
+  romanianUnit(["an", "ani", "de ani"]),
+  romanianUnit(["lună", "luni", "de luni"]),
+  romanianUnit(["săptămână", "săptămâni", "de săptămâni"]),
+  romanianUnit(["zi", "zile", "de zile"]),
+  romanianUnit(["oră", "ore", "de ore"]),
+  romanianUnit(["minut", "minute", "de minute"]),
+  romanianUnit(["secundă", "secunde", "de secunde"]),
+  romanianUnit(["milisecundă", "milisecunde", "de milisecunde"]),
   "peste %s",
   // "in %s"
   "%s în urmă",

package/dist/language/sr_Latn.d.ts

@@ -1 +1,2 @@
+import type { DurationLanguage } from "../types.d.ts";
 export declare const durationLanguage: DurationLanguage;

package/dist/language/util/validate-duration-language.js

@@ -1,14 +1,15 @@
 const validateDurationLanguage = (language) => {
   const requiredProperties = ["y", "mo", "w", "d", "h", "m", "s", "ms", "future", "past"];
   for (const property of requiredProperties) {
-    if (!Object.prototype.hasOwnProperty.call(language, property)) {
+    if (!Object.hasOwn(language, property)) {
       throw new TypeError(`Missing required property: ${property}`);
     }
   }
   if (typeof language.future !== "string" || typeof language.past !== "string") {
     throw new TypeError("Properties future and past must be of type string");
   }
-  for (const property of ["y", "mo", "w", "d", "h", "m", "s", "ms"]) {
+  const unitProperties = ["y", "mo", "w", "d", "h", "m", "s", "ms"];
+  for (const property of unitProperties) {
     if (typeof language[property] !== "string" && typeof language[property] !== "function") {
       throw new TypeError(`Property ${property} must be of type string or function`);
     }

package/dist/packem_shared/{duration-C62ipnQn.js → duration-Br8Mr-Lj.js}

@@ -88,7 +88,7 @@ const getPieces = (ms, options) => {
         for (let index_ = index + 1; index_ < units.length; index_++) {
           const smallerUnitName = units[index_];
           const smallerUnitCount = unitCounts[smallerUnitName];
-          unitCounts[unitName] += smallerUnitCount * unitMeasures[smallerUnitName] / unitMeasures[unitName];
+          unitCounts[unitName] = (unitCounts[unitName] ?? 0) + smallerUnitCount * unitMeasures[smallerUnitName] / unitMeasures[unitName];
           unitCounts[smallerUnitName] = 0;
         }
         break;
@@ -109,7 +109,7 @@ const getPieces = (ms, options) => {
       const previousUnitMs = unitMeasures[previousUnitName];
       const amountOfPreviousUnit = Math.floor(rounded * unitMeasures[unitName] / previousUnitMs);
       if (amountOfPreviousUnit) {
-        unitCounts[previousUnitName] += amountOfPreviousUnit;
+        unitCounts[previousUnitName] = (unitCounts[previousUnitName] ?? 0) + amountOfPreviousUnit;
         unitCounts[unitName] = 0;
       } else {
         break;
@@ -158,18 +158,14 @@ const formatPieces = (pieces, options, ms) => {
       adverb = language.past ?? "";
     }
   }
-  const renderedPieces = [];
-  for (const piece_ of pieces) {
-    const piece = piece_;
-    renderedPieces.push(renderPiece(piece, language, options));
-  }
+  const renderedPieces = pieces.map((piece) => renderPiece(piece, language, options));
   let result;
   if (!conjunction || pieces.length === 1) {
     result = renderedPieces.join(delimiter);
   } else if (pieces.length === 2) {
     result = renderedPieces.join(conjunction);
   } else {
-    result = renderedPieces.slice(0, -1).join(delimiter) + (serialComma ? "," : "") + conjunction + renderedPieces.at(-1);
+    result = renderedPieces.slice(0, -1).join(delimiter) + (serialComma ? "," : "") + conjunction + (renderedPieces.at(-1) ?? "");
   }
   if (adverb) {
     result = adverb.replace("%s", result);

package/dist/packem_shared/{parseBytes-JWspeMzP.js → parseBytes-BkjYV2ut.js}

@@ -1,3 +1,13 @@
+const PARSE_BYTES_REGEX = /^(?<value>-?\d+(?:[.,]\d+)*) *(?<type>[a-z]+)?$/i;
+const KIBI_REGEX = /^KIBI/;
+const MIBI_REGEX = /^MIBI/;
+const GIBI_REGEX = /^GIBI/;
+const TEBI_REGEX = /^TEBI/;
+const PEBI_REGEX = /^PEBI/;
+const EXBI_REGEX = /^EXBI/;
+const ZEBI_REGEX = /^ZEBI/;
+const YIBI_REGEX = /^YIBI/;
+const IB_SUFFIX_REGEX = /^(.)IB$/;
 const BYTE_SIZES = {
   iec: [
     {
@@ -158,13 +168,17 @@ const parseLocalizedNumber = (stringNumber, locale) => {
   return Number.parseFloat(stringNumber.replaceAll(new RegExp(`\\${thousandSeparator}`, "g"), "").replace(new RegExp(`\\${decimalSeparator}`), "."));
 };
 const fromBase = (base) => {
-  if (base === 2) {
-    return 1024;
-  }
-  if (base === 10) {
-    return 1e3;
+  switch (base) {
+    case 2: {
+      return 1024;
+    }
+    case 10: {
+      return 1e3;
+    }
+    default: {
+      throw new Error("Unsupported base.");
+    }
   }
-  throw new TypeError(`Unsupported base.`);
 };
 const parseBytes = (value, options) => {
   const config = {
@@ -179,15 +193,13 @@ const parseBytes = (value, options) => {
   if (value.length > 100) {
     throw new TypeError("Value exceeds the maximum length of 100 characters.");
   }
-  const match = /^(?<value>-?(?:\d+(([.,])\d+)*)?[.,]?\d+) *(?<type>bytes?|b|kb|kib|mb|mib|gb|gib|tb|tib|pb|pib|eb|eib|zb|zib|yb|yib|(kilo|kibi|mega|mebi|giga|gibi|tera|tebi|peta|pebi|exa|exbi|zetta|zebi|yotta|yobi)?bytes)?$/i.exec(
-    value
-  );
+  const match = PARSE_BYTES_REGEX.exec(value);
   const groups = match?.groups;
   if (!groups) {
     return Number.NaN;
   }
   const localizedNumber = parseLocalizedNumber(groups.value, config.locale);
-  const type = (groups.type ?? "Bytes").toUpperCase().replace(/^KIBI/, "KILO").replace(/^MIBI/, "MEGA").replace(/^GIBI/, "GIGA").replace(/^TEBI/, "TERA").replace(/^PEBI/, "PETA").replace(/^EXBI/, "EXA").replace(/^ZEBI/, "ZETTA").replace(/^YIBI/, "YOTTA").replace(/^(.)IB$/, "$1B");
+  const type = (groups.type ?? "Bytes").toUpperCase().replace(KIBI_REGEX, "KILO").replace(MIBI_REGEX, "MEGA").replace(GIBI_REGEX, "GIGA").replace(TEBI_REGEX, "TERA").replace(PEBI_REGEX, "PETA").replace(EXBI_REGEX, "EXA").replace(ZEBI_REGEX, "ZETTA").replace(YIBI_REGEX, "YOTTA").replace(IB_SUFFIX_REGEX, "$1B");
   const level = BYTE_SIZES[config.units].findIndex((unit) => unit.short[0].toUpperCase() === type[0]);
   const base = fromBase(config.base);
   return localizedNumber * base ** level;

package/dist/packem_shared/{parseDuration-CeFaBgx9.js → parseDuration-qO1Y4eiu.js}

@@ -15,6 +15,7 @@ const ESCAPE_REGEX = /[-/\\^$*+?.()|[\]{}]/g;
 const ISO_FORMAT = /^PT(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?$/i;
 const COLON_FORMAT = /^(?:(\d+):)?(?:(\d+):)?(\d+)$/;
 const NUMERIC_STRING_REGEX = /^[+-]?\d+(?:\.\d+)?$/;
+const SIGN_PREFIX_REGEX = /^[-+]/;
 const parseDuration = (value, options) => {
   if (typeof value !== "string" || value.length === 0) {
     return void 0;
@@ -53,14 +54,13 @@ const parseDuration = (value, options) => {
   if (colonMatch) {
     let hours = 0;
     let minutes = 0;
-    let seconds = 0;
     if (colonMatch[2] !== void 0) {
       hours = Number.parseInt(colonMatch[1] ?? "0", 10);
       minutes = Number.parseInt(colonMatch[2], 10);
     } else if (colonMatch[1] !== void 0) {
       minutes = Number.parseInt(colonMatch[1], 10);
     }
-    seconds = Number.parseInt(colonMatch[3] ?? "0", 10);
+    const seconds = Number.parseInt(colonMatch[3] ?? "0", 10);
     return hours * 36e5 + minutes * 6e4 + seconds * 1e3;
   }
   const currentUnitMapKeys = Object.keys(currentUnitMap);
@@ -84,7 +84,7 @@ const parseDuration = (value, options) => {
     }
     const trimmedNumberString = numberString.trim();
     const sign = trimmedNumberString.startsWith("-") ? -1 : 1;
-    const absNumberString = trimmedNumberString.replace(/^[-+]/, "");
+    const absNumberString = trimmedNumberString.replace(SIGN_PREFIX_REGEX, "");
     const parsedNumber = Number.parseFloat(absNumberString);
     const unitKey = currentUnitMap[unitString.toLowerCase()];
     if (unitKey === void 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/humanizer",
-  "version": "3.0.0-alpha.1",
+  "version": "3.0.0-alpha.11",
   "description": "Humanizer is a library for humanizing data in a human-readable form.",
   "keywords": [
     "visulima",
@@ -70,7 +70,7 @@
     "dist"
   ],
   "engines": {
-    "node": ">=22.13 <=25.x"
+    "node": "^22.14.0 || >=24.10.0"
   },
   "publishConfig": {
     "access": "public",