@salespark/toolkit 2.1.2 → 2.1.4

package/README.md

@@ -311,39 +311,35 @@ sanitize("<script>alert('hack')</script>Hello World!", 20);
 
 ### 🔢 Number Utilities
 
-**`clamp(n: number, min: number, max: number): number`** — Restricts a number within min and max bounds.
+**`clamp(n: number, min: number, max: number): number`** — Restricts a number to be within the min and max bounds.
 
 ```javascript
-clamp(15, 0, 10);
-// Result: 10
+clamp(10, 0, 5); // 5
+clamp(-5, 0, 10); // 0
 ```
 
-**`round(n: number, decimals?: number): number`** — Rounds a number to fixed decimal places.
+**`round(n: number, decimals?: number): number`** — Rounds a number to a fixed number of decimals without floating point surprises.
 
 ```javascript
-round(3.14159, 2);
-// Result: 3.14
+round(1.2345, 2); // 1.23
+round(1.235, 2); // 1.24
 ```
 
-**`toInteger(value: unknown, defaultValue?: number): number`** — Safely converts a value to an integer.
+**`safeParseInt(value: unknown, defaultValue?: number): number`** — Safely converts a value to an integer with fallback.
 
 ```javascript
-toInteger("42.7");
-// Result: 42
+safeParseInt("42"); // 42
+safeParseInt("abc", 10); // 10
+safeParseInt(3.9); // 3
 ```
 
-**`safeParseInt(value: unknown, defaultValue?: number): number`** — Alias for safe integer conversion.
+**`safeParseFloat(value: unknown, decimals?: number): number`** — Safely parses a value into a number with decimal precision and comma/dot normalization.
 
 ```javascript
-safeParseInt("abc", 0);
-// Result: 0
-```
-
-**`toNumber(value: unknown, decimals?: number): number`** — Safely parses a value into a number with optional decimal precision.
-
-```javascript
-toNumber("123,45", 2);
-// Result: 123.45
+safeParseFloat("123.45"); // 123.45
+safeParseFloat("123,45"); // 123.45
+safeParseFloat("1,234.56"); // 1234.56
+safeParseFloat("abc"); // 0
 ```
 
 **`randomDigits(length?: number, options?: { charset?: string; noLeadingZero?: boolean }): string`** — Generates a random string of digits with secure randomness when available.
@@ -356,12 +352,15 @@ randomDigits(6);
 **`randomDigits(length?: number, options?: { charset?: string; noLeadingZero?: boolean }): string`** — Generates a random string of digits with secure randomness when available.
 
 ```javascript
-randomDigits(6);
-// Result: "482751" (random)
+randomDigits(6); // "847293"
+randomDigits(4, { noLeadingZero: true }); // "3847" (no leading zero)
+randomDigits(6, { charset: "ABCDEF0123456789" }); // "3F2A9D" (hex)
 ```
 
 **`formatDecimalNumber(value: number | string | null | undefined, decimals?: number): string`** — Formats a number with specified decimal places, intelligently handling European (`1.234,56`) and US (`1,234.56`) number formats.
 
+**`formatDecimalNumber(value: number | string | null | undefined, decimals?: number): string`** — Formats a number with specified decimal places, intelligently handling European (`1.234,56`) and US (`1,234.56`) number formats.
+
 ```javascript
 formatDecimalNumber(1234.5678); // "1234.57"
 formatDecimalNumber("1.234,56", 2); // "1234.56" (European format)
@@ -371,6 +370,13 @@ formatDecimalNumber(null, 2); // "0.00"
 formatDecimalNumber("invalid", 2); // "0.00"
 ```
 
+#### 🗑️ Deprecated (Number Utilities)
+
+- **`toInteger`** → Use `safeParseInt` instead
+- **`toNumber`** → Use `safeParseFloat` instead
+- **`parseToNumber`** → Use `safeParseFloat` instead
+- **`otp`** → Use `randomDigits` instead
+
 ### ✅ Boolean Utilities
 
 **`toBool(value: unknown, def?: boolean): boolean`** — Converts a value to boolean, supporting common string/number representations.
@@ -443,14 +449,20 @@ isNilText("undefined");
 // Result: true
 ```
 
-**`isNilOrEmpty(value: unknown): boolean`** — Checks if value is null/undefined or an empty string.
+**`isNilOrEmpty(value: unknown): boolean`** — Checks if value is null/undefined or an empty string (trimmed).
 
 ```javascript
 isNilOrEmpty("");
 // Result: true
 
+isNilOrEmpty(" ");
+// Result: true
+
 isNilOrEmpty(null);
 // Result: true
+
+isNilOrEmpty(undefined);
+// Result: true
 ```
 
 **`hasNilOrEmpty(array: unknown): boolean`** — Checks if any element in array is nil or empty.
@@ -473,13 +485,13 @@ isNilEmptyOrZeroLen("");
 // Result: true
 ```
 
-**`isNilOrZeroLen(value: unknown): boolean`** — Checks if value is nil or has zero length.
+**`isNilEmptyOrZeroLength(value: unknown): boolean`**
 
 ```javascript
-isNilOrZeroLen([]);
+isNilEmptyOrZeroLength([]);
 // Result: true
 
-isNilOrZeroLen(null);
+isNilEmptyOrZeroLength("");
 // Result: true
 ```
 
@@ -737,8 +749,10 @@ The following functions are deprecated but maintained for backward compatibility
 - `isNullOrUndefinedTextInc` — Use `isNilText` instead.
 - `isNullUndefinedOrEmpty` — Use `isNilOrEmpty` instead.
 - `isNullOrUndefinedInArray` — Use `hasNilOrEmpty` instead.
-- `isNullOrUndefinedEmptyOrZero` — Use `isNilEmptyOrZeroLen` instead.
-- `isNullUndefinedOrZero` — Use `isNilOrZeroLen` instead.
+- `isNullOrUndefinedEmptyOrZero` — Use `isNilEmptyOrZeroLength` instead.
+- `isNilEmptyOrZeroLen` — Use `isNilEmptyOrZeroLength` instead.
+- `isNullUndefinedOrZero` — Use `isNilEmptyOrZeroLength` instead.
+- `isNilOrZeroLen` — Use `isNilEmptyOrZeroLength` instead.
 - `isNullOrUndefinedOrNaN` — Use `isNilOrNaN` instead.
 - `humanFileSize` — Use `formatBytes` instead.
 - `getStringSimilarity` — Use `stringSimilarity` instead.
@@ -803,5 +817,5 @@ MIT © [SalesPark](https://salespark.io)
 
 ---
 
-_Document version: 5_  
-_Last update: 25-09-2025_
+_Document version: 7_  
+_Last update: 08-11-2025_

package/dist/index.cjs

@@ -253,7 +253,7 @@ function round(n, decimals = 0) {
   const f = Math.pow(10, decimals);
   return Math.round((n + Number.EPSILON) * f) / f;
 }
-function toInteger(value, defaultValue = 0) {
+function safeParseInt(value, defaultValue = 0) {
   try {
     const safeValue = parseInt(String(value), 10);
     return isNaN(safeValue) ? defaultValue : safeValue;
@@ -261,8 +261,8 @@ function toInteger(value, defaultValue = 0) {
     return defaultValue;
   }
 }
-var safeParseInt = toInteger;
-function toNumber(value, decimals = 6) {
+var toInteger = safeParseInt;
+function safeParseFloat(value, decimals = 6) {
   try {
     if (value === void 0 || value === null || value === "") return 0;
     let str = String(value);
@@ -278,7 +278,8 @@ function toNumber(value, decimals = 6) {
     return 0;
   }
 }
-var parseToNumber = toNumber;
+var toNumber = safeParseFloat;
+var parseToNumber = safeParseFloat;
 function secureRandomIndex(max) {
   if (max <= 0) return 0;
   const g = globalThis;
@@ -372,7 +373,7 @@ var isNilText = (value) => {
 };
 var isNilOrEmpty = (value) => {
   try {
-    return isNil(value) || value === "";
+    return isNil(value) || typeof value === "string" && value?.trim() === "";
   } catch {
     return true;
   }
@@ -388,24 +389,32 @@ var hasNilOrEmpty = (array) => {
     return true;
   }
 };
-var isNilEmptyOrZeroLen = (value) => {
+var isNilEmptyOrZeroLength = (value) => {
   try {
     if (isNil(value) || value === "") return true;
-    const maybeLen = value?.length;
-    return typeof maybeLen === "number" && maybeLen === 0;
+    if (typeof value === "object" && value !== null && "length" in value) {
+      const length = value.length;
+      return typeof length === "number" && length === 0;
+    }
+    return false;
   } catch {
     return true;
   }
 };
-var isNilOrZeroLen = (value) => {
+var isNilEmptyOrZeroLen = isNilEmptyOrZeroLength;
+var isNilOrZeroLength = (value) => {
   try {
     if (isNil(value)) return true;
-    const maybeLen = value?.length;
-    return typeof maybeLen === "number" && maybeLen === 0;
+    if (typeof value === "object" && value !== null && "length" in value) {
+      const length = value.length;
+      return typeof length === "number" && length === 0;
+    }
+    return false;
   } catch {
     return true;
   }
 };
+var isNilOrZeroLen = isNilOrZeroLength;
 var isNilOrNaN = (value) => {
   try {
     return isNil(value) || isNaN(value);
@@ -1649,9 +1658,11 @@ exports.isBrowser = isBrowser;
 exports.isFlattenable = isFlattenable;
 exports.isNil = isNil;
 exports.isNilEmptyOrZeroLen = isNilEmptyOrZeroLen;
+exports.isNilEmptyOrZeroLength = isNilEmptyOrZeroLength;
 exports.isNilOrEmpty = isNilOrEmpty;
 exports.isNilOrNaN = isNilOrNaN;
 exports.isNilOrZeroLen = isNilOrZeroLen;
+exports.isNilOrZeroLength = isNilOrZeroLength;
 exports.isNilText = isNilText;
 exports.isNilTextOrEmpty = isNilTextOrEmpty;
 exports.isNode = isNode;
@@ -1678,6 +1689,7 @@ exports.pushAll = pushAll;
 exports.randomDigits = randomDigits;
 exports.removeDiacritics = removeDiacritics;
 exports.round = round;
+exports.safeParseFloat = safeParseFloat;
 exports.safeParseInt = safeParseInt;
 exports.sanitize = sanitize;
 exports.sanitizeMarkdown = sanitizeMarkdown;