@salespark/toolkit 2.1.0 → 2.1.2

package/dist/index.d.cts

@@ -181,6 +181,24 @@ declare function flattenDepth<T = unknown>(array: readonly unknown[], depth?: nu
     isStrict?: boolean;
 }): T[];
 
+/****************************************************
+ * ##: Boolean Parser
+ * Converts a value to boolean, supporting common string/number representations
+ *
+ * Notes:
+ * - Accepts "true", "yes", "1", "false", "no", "0" (case/whitespace-insensitive)
+ * - Returns default value if not recognized or on error
+ * @param {unknown} value - Input value (string | number | boolean | null | undefined)
+ * @param {Boolean} def - Default value if input cannot be parsed (default: false)
+ * History:
+ * 21-08-2025: Created
+ ****************************************************/
+declare const toBool: (value: unknown, def?: boolean) => boolean;
+/**
+ * @deprecated Use `toBool` instead.
+ */
+declare const parseToBool: (value: unknown, def?: boolean) => boolean;
+
 /**
 ****************************************************
  * ##: Object Property Picker
@@ -340,6 +358,19 @@ declare function randomDigits(length?: number, options?: {
  * @deprecated Use `randomDigits` instead.
  */
 declare const otp: typeof randomDigits;
+/******************************************************
+ * ##: Decimal Number Formatter
+ * Formats a number with specified decimal places, handling comma/dot normalization.
+ *
+ * Intelligently handles European number formats (1.234,56) and US formats (1,234.56).
+ * Converts strings to numbers and applies decimal formatting.
+ * @param {number|string|null|undefined} value Number value to format
+ * @param {number} decimals Number of decimal places (default: 2)
+ * @returns {string} Formatted number string with specified decimals
+ * History:
+ * 16-10-2025: Created
+ ****************************************************/
+declare const formatDecimalNumber: (value: number | string | null | undefined, decimals?: number) => string;
 
 /******************************************************
  * ##: Debounce Function
@@ -663,4 +694,4 @@ declare const assessSecurityRisks: (risks: SecurityRisk[]) => {
 declare const isBrowser: boolean;
 declare const isNode: boolean;
 
-export { type SecurityCheckResult, type SecurityRisk, addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, currencyToSymbol, debounce, deburr, delay, difference, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, isNilEmptyOrZeroLen, isNilOrEmpty, isNilOrNaN, isNilOrZeroLen, isNilText, isNilTextOrEmpty, isNode, isNullOrUndefined, isNullOrUndefinedEmptyOrZero, isNullOrUndefinedInArray, isNullOrUndefinedOrNaN, isNullOrUndefinedTextInc, isNullUndefinedOrEmpty, isNullUndefinedOrEmptyEnforced, isNullUndefinedOrZero, isPTTaxId, isValidIBAN, isValidPTTaxId, objectToString, omit, otp, parseName, parseToNumber, pick, pluck, pushAll, randomDigits, removeDiacritics, round, safeParseInt, sanitize, sanitizeMarkdown, shuffle, slugify, sortBy, stringSimilarity, symbolToCurrency, throttle, toInteger, toNumber, uniq, uniqBy };
+export { type SecurityCheckResult, type SecurityRisk, addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, currencyToSymbol, debounce, deburr, delay, difference, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, formatDecimalNumber, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, isNilEmptyOrZeroLen, isNilOrEmpty, isNilOrNaN, isNilOrZeroLen, isNilText, isNilTextOrEmpty, isNode, isNullOrUndefined, isNullOrUndefinedEmptyOrZero, isNullOrUndefinedInArray, isNullOrUndefinedOrNaN, isNullOrUndefinedTextInc, isNullUndefinedOrEmpty, isNullUndefinedOrEmptyEnforced, isNullUndefinedOrZero, isPTTaxId, isValidIBAN, isValidPTTaxId, objectToString, omit, otp, parseName, parseToBool, parseToNumber, pick, pluck, pushAll, randomDigits, removeDiacritics, round, safeParseInt, sanitize, sanitizeMarkdown, shuffle, slugify, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };

package/dist/index.d.ts

@@ -181,6 +181,24 @@ declare function flattenDepth<T = unknown>(array: readonly unknown[], depth?: nu
     isStrict?: boolean;
 }): T[];
 
+/****************************************************
+ * ##: Boolean Parser
+ * Converts a value to boolean, supporting common string/number representations
+ *
+ * Notes:
+ * - Accepts "true", "yes", "1", "false", "no", "0" (case/whitespace-insensitive)
+ * - Returns default value if not recognized or on error
+ * @param {unknown} value - Input value (string | number | boolean | null | undefined)
+ * @param {Boolean} def - Default value if input cannot be parsed (default: false)
+ * History:
+ * 21-08-2025: Created
+ ****************************************************/
+declare const toBool: (value: unknown, def?: boolean) => boolean;
+/**
+ * @deprecated Use `toBool` instead.
+ */
+declare const parseToBool: (value: unknown, def?: boolean) => boolean;
+
 /**
 ****************************************************
  * ##: Object Property Picker
@@ -340,6 +358,19 @@ declare function randomDigits(length?: number, options?: {
  * @deprecated Use `randomDigits` instead.
  */
 declare const otp: typeof randomDigits;
+/******************************************************
+ * ##: Decimal Number Formatter
+ * Formats a number with specified decimal places, handling comma/dot normalization.
+ *
+ * Intelligently handles European number formats (1.234,56) and US formats (1,234.56).
+ * Converts strings to numbers and applies decimal formatting.
+ * @param {number|string|null|undefined} value Number value to format
+ * @param {number} decimals Number of decimal places (default: 2)
+ * @returns {string} Formatted number string with specified decimals
+ * History:
+ * 16-10-2025: Created
+ ****************************************************/
+declare const formatDecimalNumber: (value: number | string | null | undefined, decimals?: number) => string;
 
 /******************************************************
  * ##: Debounce Function
@@ -663,4 +694,4 @@ declare const assessSecurityRisks: (risks: SecurityRisk[]) => {
 declare const isBrowser: boolean;
 declare const isNode: boolean;
 
-export { type SecurityCheckResult, type SecurityRisk, addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, currencyToSymbol, debounce, deburr, delay, difference, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, isNilEmptyOrZeroLen, isNilOrEmpty, isNilOrNaN, isNilOrZeroLen, isNilText, isNilTextOrEmpty, isNode, isNullOrUndefined, isNullOrUndefinedEmptyOrZero, isNullOrUndefinedInArray, isNullOrUndefinedOrNaN, isNullOrUndefinedTextInc, isNullUndefinedOrEmpty, isNullUndefinedOrEmptyEnforced, isNullUndefinedOrZero, isPTTaxId, isValidIBAN, isValidPTTaxId, objectToString, omit, otp, parseName, parseToNumber, pick, pluck, pushAll, randomDigits, removeDiacritics, round, safeParseInt, sanitize, sanitizeMarkdown, shuffle, slugify, sortBy, stringSimilarity, symbolToCurrency, throttle, toInteger, toNumber, uniq, uniqBy };
+export { type SecurityCheckResult, type SecurityRisk, addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, currencyToSymbol, debounce, deburr, delay, difference, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, formatDecimalNumber, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, isNilEmptyOrZeroLen, isNilOrEmpty, isNilOrNaN, isNilOrZeroLen, isNilText, isNilTextOrEmpty, isNode, isNullOrUndefined, isNullOrUndefinedEmptyOrZero, isNullOrUndefinedInArray, isNullOrUndefinedOrNaN, isNullOrUndefinedTextInc, isNullUndefinedOrEmpty, isNullUndefinedOrEmptyEnforced, isNullUndefinedOrZero, isPTTaxId, isValidIBAN, isValidPTTaxId, objectToString, omit, otp, parseName, parseToBool, parseToNumber, pick, pluck, pushAll, randomDigits, removeDiacritics, round, safeParseInt, sanitize, sanitizeMarkdown, shuffle, slugify, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };

package/dist/index.js

@@ -133,6 +133,33 @@ function flattenDepth(array, depth = 1, options) {
   return flattenDepthBase(array, depth, predicate, isStrict);
 }
 
+// src/utils/bool.ts
+var toBool = (value, def = false) => {
+  try {
+    if (value === null || value === void 0) return def;
+    if (typeof value === "boolean") return value;
+    if (typeof value === "number") return value === 1;
+    if (typeof value === "string") {
+      switch (value.toLowerCase().trim()) {
+        case "true":
+        case "yes":
+        case "1":
+          return true;
+        case "false":
+        case "no":
+        case "0":
+          return false;
+        default:
+          return def;
+      }
+    }
+    return def;
+  } catch {
+    return false;
+  }
+};
+var parseToBool = toBool;
+
 // src/utils/object.ts
 function pick(obj, keys) {
   const out = {};
@@ -281,6 +308,30 @@ function randomDigits(length = 6, options) {
   return out;
 }
 var otp = randomDigits;
+var formatDecimalNumber = (value, decimals = 2) => {
+  try {
+    let processedValue = value ?? 0;
+    if (typeof processedValue === "string") {
+      const trimmed = processedValue.trim();
+      if (trimmed.includes(",") && trimmed.includes(".")) {
+        const lastComma = trimmed.lastIndexOf(",");
+        const lastDot = trimmed.lastIndexOf(".");
+        processedValue = lastComma > lastDot ? trimmed.replace(/\./g, "").replace(",", ".") : trimmed.replace(/,/g, "");
+      } else if (trimmed.includes(",")) {
+        processedValue = trimmed.replace(/,/g, ".");
+      } else {
+        processedValue = trimmed;
+      }
+    }
+    const numValue = parseFloat(String(processedValue));
+    if (isNaN(numValue)) {
+      return 0 .toFixed(Math.max(0, Math.floor(decimals)));
+    }
+    return numValue.toFixed(Math.max(0, Math.floor(decimals)));
+  } catch (error) {
+    return 0 .toFixed(Math.max(0, Math.floor(decimals)));
+  }
+};
 
 // src/utils/func.ts
 function debounce(fn, wait = 250) {
@@ -1563,6 +1614,6 @@ var assessSecurityRisks = (risks) => {
 var isBrowser = typeof globalThis !== "undefined" && typeof globalThis.document !== "undefined";
 var isNode = typeof process !== "undefined" && !!process.versions?.node;
 
-export { addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, currencyToSymbol, debounce, deburr, delay, difference, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, isNilEmptyOrZeroLen, isNilOrEmpty, isNilOrNaN, isNilOrZeroLen, isNilText, isNilTextOrEmpty, isNode, isNullOrUndefined, isNullOrUndefinedEmptyOrZero, isNullOrUndefinedInArray, isNullOrUndefinedOrNaN, isNullOrUndefinedTextInc, isNullUndefinedOrEmpty, isNullUndefinedOrEmptyEnforced, isNullUndefinedOrZero, isPTTaxId, isValidIBAN, isValidPTTaxId, objectToString, omit, otp, parseName, parseToNumber, pick, pluck, pushAll, randomDigits, removeDiacritics, round, safeParseInt, sanitize, sanitizeMarkdown, shuffle, slugify, sortBy, stringSimilarity, symbolToCurrency, throttle, toInteger, toNumber, uniq, uniqBy };
+export { addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, currencyToSymbol, debounce, deburr, delay, difference, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, formatDecimalNumber, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, isNilEmptyOrZeroLen, isNilOrEmpty, isNilOrNaN, isNilOrZeroLen, isNilText, isNilTextOrEmpty, isNode, isNullOrUndefined, isNullOrUndefinedEmptyOrZero, isNullOrUndefinedInArray, isNullOrUndefinedOrNaN, isNullOrUndefinedTextInc, isNullUndefinedOrEmpty, isNullUndefinedOrEmptyEnforced, isNullUndefinedOrZero, isPTTaxId, isValidIBAN, isValidPTTaxId, objectToString, omit, otp, parseName, parseToBool, parseToNumber, pick, pluck, pushAll, randomDigits, removeDiacritics, round, safeParseInt, sanitize, sanitizeMarkdown, shuffle, slugify, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map