nhb-toolbox 4.3.2 → 4.10.3

package/dist/cjs/array/basics.js

@@ -17,8 +17,9 @@ const flattenArray = (input) => {
 };
 exports.flattenArray = flattenArray;
 /**
- * * Filters an array of objects based on multiple conditions for specified keys.
+ * @deprecated _Please, use `findAll` instance method from `Finder` class for **more advanced filtering and searching.**_
  *
+ * * Filters an array of objects based on multiple conditions for specified keys.
  * @param array - The array of objects to filter.
  * @param conditions - An object where keys represent the property names and values represent filter conditions.
  *                     The conditions can be a function `(value: T[K]) => boolean`.

package/dist/cjs/number/convert.js

@@ -5,13 +5,17 @@ exports.numberToWords = numberToWords;
 const constants_1 = require("./constants");
 const helpers_1 = require("./helpers");
 /**
- * * Converts a number to words.
- * @Warning ***Supports numeric values up to `10e19` or `10^20` (one hundred quintillion).***
+ * * Converts a numeric value into its corresponding English word representation.
+ * @warning ***Supports numeric values up to `10e19` or `10^20` (one hundred quintillion).***
+ * @warning ***Decimal values are ignored; only the integer part is converted.***
  * @param number - The number to convert into words.
  * @returns The number converted in words.
  */
 function numberToWords(num) {
-    let number = Number(num);
+    let number = Math.trunc(Number(num));
+    if (!Number.isFinite(number) || isNaN(number)) {
+        return 'Invalid Number!';
+    }
     const isNegative = number < 0;
     if (number === 0)
         return 'zero';
@@ -20,7 +24,7 @@ function numberToWords(num) {
     let result = '';
     while (number > 0) {
         if (i >= constants_1.thousands.length) {
-            return `Number exceeds supported range (max is 10e${constants_1.thousands.length * 3 - 2})`;
+            return `Number exceeds supported range (max is 10e19 aka 10^20)`;
         }
         if (number % 1000 !== 0) {
             const isLastGroup = i === 0 && number % 100 < 100;

package/dist/dts/array/basics.d.ts

@@ -8,8 +8,9 @@ import type { Flattened } from './types';
  */
 export declare const flattenArray: <T>(input: T | T[]) => Flattened<T>[];
 /**
- * * Filters an array of objects based on multiple conditions for specified keys.
+ * @deprecated _Please, use `findAll` instance method from `Finder` class for **more advanced filtering and searching.**_
  *
+ * * Filters an array of objects based on multiple conditions for specified keys.
  * @param array - The array of objects to filter.
  * @param conditions - An object where keys represent the property names and values represent filter conditions.
  *                     The conditions can be a function `(value: T[K]) => boolean`.

package/dist/dts/array/basics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"basics.d.ts","sourceRoot":"","sources":["../../../src/array/basics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,KAAG,SAAS,CAAC,CAAC,CAAC,EAO5D,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,aAAa,SACpD,CAAC,EAAE,cACE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,OAAO,GAAE,KACnE,CAAC,EAeH,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,CAAC,KAAG,OAWnD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,EAAE,KAAG,CAAC,EAW7C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,CAAC,EAAE,KAAG,CAAC,GAAG,SAEvD,CAAC"}
+{"version":3,"file":"basics.d.ts","sourceRoot":"","sources":["../../../src/array/basics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,KAAG,SAAS,CAAC,CAAC,CAAC,EAO5D,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,aAAa,SACpD,CAAC,EAAE,cACE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,OAAO,GAAE,KACnE,CAAC,EAeH,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,CAAC,KAAG,OAWnD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,CAAC,EAAE,KAAG,CAAC,EAW7C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,CAAC,EAAE,KAAG,CAAC,GAAG,SAEvD,CAAC"}

package/dist/dts/number/convert.d.ts

@@ -1,7 +1,8 @@
 import type { Numeric } from '../types';
 /**
- * * Converts a number to words.
- * @Warning ***Supports numeric values up to `10e19` or `10^20` (one hundred quintillion).***
+ * * Converts a numeric value into its corresponding English word representation.
+ * @warning ***Supports numeric values up to `10e19` or `10^20` (one hundred quintillion).***
+ * @warning ***Decimal values are ignored; only the integer part is converted.***
  * @param number - The number to convert into words.
  * @returns The number converted in words.
  */

package/dist/dts/number/convert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/number/convert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAIxC;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAgClD;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,QAAS,OAAO,KAAG,MA8BrD,CAAC"}
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/number/convert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAIxC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAoClD;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,QAAS,OAAO,KAAG,MA8BrD,CAAC"}

package/dist/esm/array/basics.js

@@ -13,8 +13,9 @@ export const flattenArray = (input) => {
     }, []);
 };
 /**
- * * Filters an array of objects based on multiple conditions for specified keys.
+ * @deprecated _Please, use `findAll` instance method from `Finder` class for **more advanced filtering and searching.**_
  *
+ * * Filters an array of objects based on multiple conditions for specified keys.
  * @param array - The array of objects to filter.
  * @param conditions - An object where keys represent the property names and values represent filter conditions.
  *                     The conditions can be a function `(value: T[K]) => boolean`.

package/dist/esm/number/convert.js

@@ -1,13 +1,17 @@
 import { thousands } from './constants';
 import { _convertLessThanThousand } from './helpers';
 /**
- * * Converts a number to words.
- * @Warning ***Supports numeric values up to `10e19` or `10^20` (one hundred quintillion).***
+ * * Converts a numeric value into its corresponding English word representation.
+ * @warning ***Supports numeric values up to `10e19` or `10^20` (one hundred quintillion).***
+ * @warning ***Decimal values are ignored; only the integer part is converted.***
  * @param number - The number to convert into words.
  * @returns The number converted in words.
  */
 export function numberToWords(num) {
-    let number = Number(num);
+    let number = Math.trunc(Number(num));
+    if (!Number.isFinite(number) || isNaN(number)) {
+        return 'Invalid Number!';
+    }
     const isNegative = number < 0;
     if (number === 0)
         return 'zero';
@@ -16,7 +20,7 @@ export function numberToWords(num) {
     let result = '';
     while (number > 0) {
         if (i >= thousands.length) {
-            return `Number exceeds supported range (max is 10e${thousands.length * 3 - 2})`;
+            return `Number exceeds supported range (max is 10e19 aka 10^20)`;
         }
         if (number % 1000 !== 0) {
             const isLastGroup = i === 0 && number % 100 < 100;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.3.2",
+  "version": "4.10.3",
   "description": "A versatile collection of smart, efficient, and reusable utility functions and classes for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",