@salespark/toolkit 2.1.5 → 2.1.6

package/README.md

@@ -27,7 +27,7 @@ npm i @salespark/toolkit
 - **Array utilities**: chunk, uniqBy, deep equality, flatten, groupBy, etc.
 - **Object utilities**: pick, omit, clean objects, deep merge, etc.
 - **String utilities**: slugify, template fill, deburr, sanitize, etc.
-- **Number utilities**: clamp, round, safe parse, random digits, etc.
+- **Number utilities**: clamp, round, safe parse (locale-aware), random digits, etc.
 - **Function utilities**: debounce, throttle, formatCurrency, parseName, currency conversions, etc.
 - **Boolean utilities**: safe boolean conversion with common representations
 - **Validation utilities**: IBAN validator (ISO 13616), Portuguese tax ID validator
@@ -333,13 +333,16 @@ safeParseInt("abc", 10); // 10
 safeParseInt(3.9); // 3
 ```
 
-**`safeParseFloat(value: unknown, decimals?: number): number`** — Safely parses a value into a number with decimal precision and comma/dot normalization.
+**`safeParseFloat(value: unknown, decimals?: number): number`** — Safely parses a value into a number with decimal precision, handling locale separators (commas, dots, spaces) and invalid inputs.
 
 ```javascript
 safeParseFloat("123.45"); // 123.45
 safeParseFloat("123,45"); // 123.45
 safeParseFloat("1,234.56"); // 1234.56
+safeParseFloat("1 234,56"); // 1234.56 (spaces as thousands)
+safeParseFloat("1.234,56"); // 1234.56 (dot thousands, comma decimals)
 safeParseFloat("abc"); // 0
+safeParseFloat(NaN); // 0
 ```
 
 **`randomDigits(length?: number, options?: { charset?: string; noLeadingZero?: boolean }): string`** — Generates a random string of digits with secure randomness when available.
@@ -817,5 +820,5 @@ MIT © [SalesPark](https://salespark.io)
 
 ---
 
-_Document version: 7_  
-_Last update: 08-11-2025_
+_Document version: 8_  
+_Last update: 10-12-2025_

package/dist/index.cjs

@@ -264,16 +264,35 @@ function safeParseInt(value, defaultValue = 0) {
 var toInteger = safeParseInt;
 function safeParseFloat(value, decimals = 6) {
   try {
+    if (typeof value === "number") {
+      return isNaN(value) ? 0 : Number(value.toFixed(decimals));
+    }
     if (value === void 0 || value === null || value === "") return 0;
-    let str = String(value);
+    let str = String(value).trim();
+    if (!str) return 0;
+    str = str.replace(/\s+/g, "");
+    let normalized;
     if (str.includes(",") && str.includes(".")) {
-      str = str.replace(/,/g, "");
+      const lastComma = str.lastIndexOf(",");
+      const lastDot = str.lastIndexOf(".");
+      if (lastDot > lastComma) {
+        normalized = str.replace(/,/g, "");
+      } else {
+        normalized = str.replace(/\./g, "").replace(",", ".");
+      }
     } else if (str.includes(",")) {
-      str = str.replace(",", ".");
+      const parts = str.split(",");
+      if (parts.length === 2 && parts[1].length <= 2) {
+        normalized = str.replace(",", ".");
+      } else {
+        normalized = str.replace(/,/g, "");
+      }
+    } else {
+      normalized = str;
     }
-    const num = parseFloat(str);
-    if (isNaN(num)) return 0;
-    return parseFloat(num.toFixed(decimals));
+    const num = parseFloat(normalized);
+    if (!isFinite(num)) return 0;
+    return Number(num.toFixed(decimals));
   } catch {
     return 0;
   }