toolbox-x 2.2.5 → 2.4.0

package/dist/index.d.mts

@@ -292,6 +292,51 @@ declare function reverseNumber(num: Numeric): number;
  * @returns The average of the provided numbers. Returns `NaN` if no numbers are valid.
  */
 declare function getAverage(...numbers: Numeric[]): number;
+/**
+ * * Returns the number of decimal places represented by a number.
+ *
+ * @param value - The number or numeric string for which to calculate the number of decimal places.
+ * @returns The number of decimal places.
+ *
+ * @throws - {@link TypeError} - If the input value cannot be converted to a number, e.g. `undefined`, `null`, `NaN`, `'11x'` etc..
+ *
+ * @remarks
+ * - If a numeric string in scientific notation (e.g., '1e-6') is provided, it will calculate the decimal places accordingly.
+ * - If a numeric string has trailing zeros (e.g., ''1.00'' or `'9.900'`),
+ *   it will convert them as: `'1.00'` -> `1`, `'9.900'` -> `9.9` and return `0` and `1` respectively.
+ * - If a number is an integer, it will return `0`.
+ * - Internally uses {@link normalizeNumber} to normalize the input value.
+ *
+ * @example
+ * getDecimalPlaces(123.456); // 3
+ * getDecimalPlaces('123.45600'); // 3
+ * getDecimalPlaces(123); // 0
+ * getDecimalPlaces('1e-6'); // 6
+ * getDecimalPlaces('1.00'); // 0
+ * getDecimalPlaces('9.900'); // 1
+ */
+declare function getDecimalPlaces(value: Numeric): number;
+/**
+ * * Adds numbers safely, avoiding floating-point arithmetic issues.
+ *
+ * @param values - A list of numbers or numeric strings to add.
+ * @returns The sum of the provided numbers, with floating-point inaccuracies mitigated.
+ *
+ * @remarks
+ * - This function addresses common floating-point addition errors (e.g., `0.1 + 0.2 !== 0.3`)
+ *   by temporarily scaling numbers to integers, performing the addition, and then scaling back.
+ * - Non-numeric values are safely ignored in the runtime.
+ * - Rounding is used to mitigate floating-point inaccuracies.
+ * - Intended for use cases where floating-point inaccuracies are a concern.
+ * - Internally uses {@link normalizeNumber}, {@link getDecimalPlaces}, {@link roundNumber}.
+ * - It does not handle numbers beyond {@link Number.MAX_SAFE_INTEGER} or {@link Number.MIN_SAFE_INTEGER}.
+ *   May output incorrect results if the numbers are too large.
+ * @example
+ * safeAdd(0.1, 0.2); // → 0.3 (correctly handles floating-point error)
+ * safeAdd(1, '2', 3.456); // → 6.456
+ * safeAdd(0.1, 0.2, 0.3, 0.4); // → 1.0 (accurate sum)
+ */
+declare function safeAdd(...values: Numeric[]): number;
 /**
  * * Rounds a number to a specified number of decimal places.
  *
@@ -1235,4 +1280,4 @@ declare function remapFields<Source extends GenericObject, Target extends Record
  */
 declare function getCountryByPhone(phone: number | string): CountryDetails[];
 //#endregion
-export { Currency, Finder, Unit, Unit as UnitConverter, convertToRomanNumerals as arabicToRoman, convertToRomanNumerals, convertToRomanNumerals as integerToRoman, convertToRomanNumerals as numberToRoman, convertToRomanNumerals as numericToRoman, convertToRomanNumerals as toRoman, convertToRomanNumerals as toRomanNumeral, averageByField, averageByField as avgByField, banglaToDigit, getAverage as calculateAverage, getAverage, getAverage as getAverageOfNumbers, factorial as calculateFactorial, factorial, factorial as getFactorial, calculateHCF as calculateGCD, calculateHCF, calculateLCM as calculateLCD, calculateLCM, calculatePercentage, capitalizeString, getOrdinal as cardinalToOrdinal, getOrdinal as convertNumberToOrdinal, getOrdinal as convertToOrdinal, getOrdinal, getOrdinal as getOrdinalNumber, getOrdinal as numberToOrdinal, numberToWordsOrdinal as cardinalWordsToOrdinal, numberToWordsOrdinal as convertNumberToWordsOrdinal, numberToWordsOrdinal, clampNumber, cloneObject, naturalSort as compareNaturally, naturalSort as compareSorter, naturalSort, naturalSort as naturalSortForString, computeTextDiff, convertArrayToString, convertArrayToString as joinArrayElements, formatCurrency as convertNumberToCurrency, formatCurrency, numberToWords as convertNumberToWords, numberToWords, convertObjectValues, romanToInteger as convertRomanToArabic, romanToInteger as convertRomanToInteger, romanToInteger as convertRomanToNumeric, romanToInteger as romanToArabic, romanToInteger, romanToInteger as romanToNumeric, convertStringCase, convertToDecimal, convertToDecimal as convertToFixed, wordsToNumber as convertWordToNumber, wordsToNumber as convertWordsToNumber, wordsToNumber as wordToNumber, wordsToNumber, countInstanceMethods, countInstanceMethods as getInstanceMethodsCount, countObjectFields, countStaticMethods, countStaticMethods as getStaticMethodsCount, countWords, countWords as countWordsInString, countWords as wordCount, createOptionsArray, generateQueryParams as createQueryParams, generateQueryParams as formatQueryParams, generateQueryParams, debounceAction, deepParsePrimitives, deepParsePrimitives as parsePrimitivesDeep, definePrototypeMethod, deleteFields, deleteFields as deleteObjectFields, deleteFields as omitFields, deleteFields as omitObjectFields, deleteFields as removeFields, deleteFields as removeObjectFields, digitToBangla, getDuplicates as extractDuplicates, getDuplicates as extractDuplicatesFromArray, getDuplicates, getDuplicates as getDuplicatesFromArray, extractEmails, extractObjectEntries as extractEntries, extractObjectEntries, extractObjectEntries as objectEntries, extractObjectKeys as extractKeys, extractObjectKeys, extractObjectKeysDeep as extractKeysDeep, extractObjectKeysDeep, findMissingElements as extractMissingElements, findMissingElements, findMissingElements as getMissingElements, extractNewFields, extractNumbersFromString as extractNumbers, extractNumbersFromString, extractNumbersFromString as parseNumbersFromText, extractURLs, extractUpdatedAndNewFields, extractUpdatedFields, getFactors as factorsOf, getFactors as getDivisors, getFactors, fibonacciGenerator, fibonacciGenerator as generateFibonacci, filterArrayOfObjects, findPrimeNumbers, findPrimeNumbers as getPrimeNumbers, flattenArray, flattenObjectDotNotation, flattenObjectKeyValue, formatUnitWithPlural as formatNumberWithPluralUnit, formatUnitWithPlural, formatUnitWithPlural as formatWithPlural, generateAnagrams, generateRandomID, getCharacterDifferences, getClassDetails, getCountryByPhone, getFibonacciSeries as getFibonacci, getFibonacciSeries as getFibonacciNumbers, getFibonacciSeries, getFibonacciSeriesMemo, getFibonacciSeriesMemo as getMemoizedFibonacci, getFibonacciSeriesMemo as getMemoizedFibonacciSeries, getInstanceGetterNames, getInstanceMethodNames, getLastArrayElement, getLevenshteinDistance, getLevenshteinDistance as levenshteinDistance, getNthFibonacci, getNumbersInRange, parseQueryString as getQueryStringAsObject, parseQueryString, parseQueryString as queryStringToObject, getRandomFloat as getRandomDecimal, getRandomFloat, getRandomNumber as getRandomInt, getRandomNumber, getStaticGetterNames, getStaticMethodNames, sumNumbers as getSumOfNumbers, sumNumbers, sumNumbers as sumOfNumbers, groupAndAverageByField, groupAndAverageByField as groupAndAvgByField, groupAndSumByField, splitArrayByProperty as groupArrayByProperty, splitArrayByProperty, isDeepEqual, isInvalidOrEmptyArray, isPrime, isPrime as isPrimeNumber, parseQueryStringLiteral as literalQueryStringToObject, parseQueryStringLiteral, maskString, mergeAndFlattenObjects, mergeObjects, moveArrayElement, normalizeNumber, normalizeString, parseJSON, parseJSON as parseJsonDeep, parseJsonToObject, parseObjectValues, parseObjectValues as parseStringifiedObjectValues, pickFields, pickFields as pickObjectFields, pickObjectFieldsByCondition as pickFieldsByCondition, pickObjectFieldsByCondition, remapFields, remapFields as remapObjectFields, removeDuplicatesFromArray as removeDuplicates, removeDuplicatesFromArray, replaceAllInString, reverseNumber, reverseString, rotateArray, roundNumber, roundNumber as roundToDecimal, roundToNearest as roundNumberToNearestInterval, roundToNearest, roundToNearest as roundToNearestInterval, sanitizeData, shuffleArray, slugifyString, sortAnArray, splitArray, stableStringify, stripJsonEdgeGarbage, sumByField, sumDigits, sumFieldDifference, sumFieldDifference as totalDeltaByField, throttleAction, trimString, truncateString };
+export { Currency, Finder, Unit, Unit as UnitConverter, safeAdd as add, safeAdd, convertToRomanNumerals as arabicToRoman, convertToRomanNumerals, convertToRomanNumerals as integerToRoman, convertToRomanNumerals as numberToRoman, convertToRomanNumerals as numericToRoman, convertToRomanNumerals as toRoman, convertToRomanNumerals as toRomanNumeral, getAverage as average, getAverage as calculateAverage, getAverage, averageByField, averageByField as avgByField, banglaToDigit, factorial as calculateFactorial, factorial, factorial as getFactorial, calculateHCF as calculateGCD, calculateHCF, calculateLCM as calculateLCD, calculateLCM, calculatePercentage, capitalizeString, getOrdinal as cardinalToOrdinal, getOrdinal as convertNumberToOrdinal, getOrdinal as convertToOrdinal, getOrdinal, getOrdinal as getOrdinalNumber, getOrdinal as numberToOrdinal, numberToWordsOrdinal as cardinalWordsToOrdinal, numberToWordsOrdinal as convertNumberToWordsOrdinal, numberToWordsOrdinal, clampNumber, cloneObject, naturalSort as compareNaturally, naturalSort as compareSorter, naturalSort, naturalSort as naturalSortForString, computeTextDiff, convertArrayToString, convertArrayToString as joinArrayElements, formatCurrency as convertNumberToCurrency, formatCurrency, numberToWords as convertNumberToWords, numberToWords, convertObjectValues, romanToInteger as convertRomanToArabic, romanToInteger as convertRomanToInteger, romanToInteger as convertRomanToNumeric, romanToInteger as romanToArabic, romanToInteger, romanToInteger as romanToNumeric, convertStringCase, convertToDecimal, convertToDecimal as convertToFixed, wordsToNumber as convertWordToNumber, wordsToNumber as convertWordsToNumber, wordsToNumber as wordToNumber, wordsToNumber, countInstanceMethods, countInstanceMethods as getInstanceMethodsCount, countObjectFields, countStaticMethods, countStaticMethods as getStaticMethodsCount, countWords, countWords as countWordsInString, countWords as wordCount, createOptionsArray, generateQueryParams as createQueryParams, generateQueryParams as formatQueryParams, generateQueryParams, debounceAction, getDecimalPlaces as decimalPlaces, getDecimalPlaces, deepParsePrimitives, deepParsePrimitives as parsePrimitivesDeep, definePrototypeMethod, deleteFields, deleteFields as deleteObjectFields, deleteFields as omitFields, deleteFields as omitObjectFields, deleteFields as removeFields, deleteFields as removeObjectFields, digitToBangla, getDuplicates as extractDuplicates, getDuplicates as extractDuplicatesFromArray, getDuplicates, getDuplicates as getDuplicatesFromArray, extractEmails, extractObjectEntries as extractEntries, extractObjectEntries, extractObjectEntries as objectEntries, extractObjectKeys as extractKeys, extractObjectKeys, extractObjectKeysDeep as extractKeysDeep, extractObjectKeysDeep, findMissingElements as extractMissingElements, findMissingElements, findMissingElements as getMissingElements, extractNewFields, extractNumbersFromString as extractNumbers, extractNumbersFromString, extractNumbersFromString as parseNumbersFromText, extractURLs, extractUpdatedAndNewFields, extractUpdatedFields, getFactors as factorsOf, getFactors as getDivisors, getFactors, fibonacciGenerator, fibonacciGenerator as generateFibonacci, filterArrayOfObjects, findPrimeNumbers, findPrimeNumbers as getPrimeNumbers, flattenArray, flattenObjectDotNotation, flattenObjectKeyValue, formatUnitWithPlural as formatNumberWithPluralUnit, formatUnitWithPlural, formatUnitWithPlural as formatWithPlural, generateAnagrams, generateRandomID, getCharacterDifferences, getClassDetails, getCountryByPhone, getFibonacciSeries as getFibonacci, getFibonacciSeries as getFibonacciNumbers, getFibonacciSeries, getFibonacciSeriesMemo, getFibonacciSeriesMemo as getMemoizedFibonacci, getFibonacciSeriesMemo as getMemoizedFibonacciSeries, getInstanceGetterNames, getInstanceMethodNames, getLastArrayElement, getLevenshteinDistance, getLevenshteinDistance as levenshteinDistance, getNthFibonacci, getNumbersInRange, parseQueryString as getQueryStringAsObject, parseQueryString, parseQueryString as queryStringToObject, getRandomFloat as getRandomDecimal, getRandomFloat, getRandomNumber as getRandomInt, getRandomNumber, getStaticGetterNames, getStaticMethodNames, sumNumbers as getSumOfNumbers, sumNumbers, sumNumbers as sumOfNumbers, groupAndAverageByField, groupAndAverageByField as groupAndAvgByField, groupAndSumByField, splitArrayByProperty as groupArrayByProperty, splitArrayByProperty, isDeepEqual, isInvalidOrEmptyArray, isPrime, isPrime as isPrimeNumber, parseQueryStringLiteral as literalQueryStringToObject, parseQueryStringLiteral, maskString, mergeAndFlattenObjects, mergeObjects, moveArrayElement, normalizeNumber, normalizeString, parseJSON, parseJSON as parseJsonDeep, parseJsonToObject, parseObjectValues, parseObjectValues as parseStringifiedObjectValues, pickFields, pickFields as pickObjectFields, pickObjectFieldsByCondition as pickFieldsByCondition, pickObjectFieldsByCondition, remapFields, remapFields as remapObjectFields, removeDuplicatesFromArray as removeDuplicates, removeDuplicatesFromArray, replaceAllInString, reverseNumber, reverseString, rotateArray, roundNumber, roundNumber as roundToDecimal, roundToNearest as roundNumberToNearestInterval, roundToNearest, roundToNearest as roundToNearestInterval, sanitizeData, shuffleArray, slugifyString, sortAnArray, splitArray, stableStringify, stripJsonEdgeGarbage, sumByField, sumDigits, sumFieldDifference, sumFieldDifference as totalDeltaByField, throttleAction, trimString, truncateString };

package/dist/index.mjs

@@ -16,13 +16,13 @@
 
 import { a as isNonEmptyString, c as isNumber, d as isString, i as isInteger, m as isUndefined } from "./primitives-Djsevc69.mjs";
 import { n as convertStringCase, t as capitalizeString } from "./case-DBC4Rj0h.mjs";
-import { T as isObject, b as isFunction, d as isNumericString, j as isValidArray } from "./specials-krf7zsqI.mjs";
 import { c as ORDINAL_UNDER_TEEN, d as TENS, f as THOUSANDS, l as PREFIX_MULTIPLIERS, o as ONES, s as ORDINAL_TO_CARDINAL, t as BN_DIGITS, u as TEENS } from "./constants-ZyfpysiQ.mjs";
-import { a as normalizeNumber, i as getRandomFloat, n as formatCurrency, o as roundToNearest, r as getOrdinal, t as clampNumber } from "./utilities-BSv8VbnM.mjs";
 import { t as COUNTRIES } from "./countries-CMxHxKiK.mjs";
-import { B as getInstanceMethodNames, F as debounceAction, G as stableStringify, H as getStaticMethodNames, I as deepParsePrimitives, J as naturalSort, K as stripJsonEdgeGarbage, L as definePrototypeMethod, M as convertArrayToString, N as countInstanceMethods, P as countStaticMethods, R as getClassDetails, U as isDeepEqual, V as getStaticGetterNames, W as parseJSON, X as _getNumericProp, Y as sortAnArray, Z as _resolveNestedKey, n as trimString, q as throttleAction, r as truncateString, t as generateRandomID, z as getInstanceGetterNames } from "./basics-20lm69yy.mjs";
-import { A as extractObjectEntries, C as filterArrayOfObjects, D as shuffleArray, E as isInvalidOrEmptyArray, M as extractObjectKeysDeep, O as cloneObject, T as getLastArrayElement, _ as areInvalidNumbers, c as extractURLs, d as normalizeString, f as replaceAllInString, g as isPrime, h as findPrimeNumbers, j as extractObjectKeys, k as countObjectFields, l as formatUnitWithPlural, m as slugifyString, p as reverseString, s as extractEmails, u as maskString, v as isEven, w as flattenArray, x as isOdd } from "./guards-Dc9MB9on.mjs";
-import { c as extractUpdatedFields, d as mergeAndFlattenObjects, f as mergeObjects, h as sanitizeData, i as parseQueryStringLiteral, l as flattenObjectDotNotation, m as parseObjectValues, o as extractNewFields, p as parseJsonToObject, r as parseQueryString, s as extractUpdatedAndNewFields, t as generateQueryParams, u as flattenObjectKeyValue } from "./query-BomnyWh3.mjs";
+import { $ as trimString, Q as generateRandomID, _ as naturalSort, a as deepParsePrimitives, b as _resolveNestedKey, c as getInstanceGetterNames, d as getStaticMethodNames, et as truncateString, f as isDeepEqual, g as throttleAction, h as stripJsonEdgeGarbage, i as debounceAction, l as getInstanceMethodNames, m as stableStringify, n as countInstanceMethods, o as definePrototypeMethod, p as parseJSON, r as countStaticMethods, s as getClassDetails, t as convertArrayToString, u as getStaticGetterNames, v as sortAnArray, y as _getNumericProp } from "./utils-BO5CcsjK.mjs";
+import { T as isObject, b as isFunction, d as isNumericString, j as isValidArray } from "./specials-krf7zsqI.mjs";
+import { A as replaceAllInString, C as isOdd, D as formatUnitWithPlural, E as extractURLs, M as slugifyString, O as maskString, T as extractEmails, _ as findPrimeNumbers, a as shuffleArray, b as isEven, c as extractObjectEntries, i as isInvalidOrEmptyArray, j as reverseString, k as normalizeString, l as extractObjectKeys, n as flattenArray, o as cloneObject, r as getLastArrayElement, s as countObjectFields, t as filterArrayOfObjects, u as extractObjectKeysDeep, v as isPrime, y as areInvalidNumbers } from "./basics-B7Sqf33u.mjs";
+import { a as normalizeNumber, i as getRandomFloat, n as formatCurrency, o as roundToNearest, r as getOrdinal, t as clampNumber } from "./utilities-CmPwOkdy.mjs";
+import { c as extractUpdatedFields, d as mergeAndFlattenObjects, f as mergeObjects, h as sanitizeData, i as parseQueryStringLiteral, l as flattenObjectDotNotation, m as parseObjectValues, o as extractNewFields, p as parseJsonToObject, r as parseQueryString, s as extractUpdatedAndNewFields, t as generateQueryParams, u as flattenObjectKeyValue } from "./query-PGFEup3p.mjs";
 
 //#region src/string/anagram.ts
 /** `WeakMap` to cache user provided dictionary array */
@@ -576,8 +576,8 @@ function getAverage(...numbers) {
 	let sum = 0;
 	let count = 0;
 	for (const n of numbers) {
-		const num = Number(n);
-		if (isNumber(num)) {
+		const num = normalizeNumber(n);
+		if (!isUndefined(num)) {
 			sum += num;
 			count++;
 		}
@@ -585,6 +585,72 @@ function getAverage(...numbers) {
 	return count === 0 ? NaN : Math.round(sum / count * 1e3) / 1e3;
 }
 /**
+* * Returns the number of decimal places represented by a number.
+*
+* @param value - The number or numeric string for which to calculate the number of decimal places.
+* @returns The number of decimal places.
+*
+* @throws - {@link TypeError} - If the input value cannot be converted to a number, e.g. `undefined`, `null`, `NaN`, `'11x'` etc..
+*
+* @remarks
+* - If a numeric string in scientific notation (e.g., '1e-6') is provided, it will calculate the decimal places accordingly.
+* - If a numeric string has trailing zeros (e.g., ''1.00'' or `'9.900'`),
+*   it will convert them as: `'1.00'` -> `1`, `'9.900'` -> `9.9` and return `0` and `1` respectively.
+* - If a number is an integer, it will return `0`.
+* - Internally uses {@link normalizeNumber} to normalize the input value.
+*
+* @example
+* getDecimalPlaces(123.456); // 3
+* getDecimalPlaces('123.45600'); // 3
+* getDecimalPlaces(123); // 0
+* getDecimalPlaces('1e-6'); // 6
+* getDecimalPlaces('1.00'); // 0
+* getDecimalPlaces('9.900'); // 1
+*/
+function getDecimalPlaces(value) {
+	const number = normalizeNumber(value);
+	if (isUndefined(number)) throw new TypeError(`Invalid numeric representation: ${value}`);
+	const str = String(number);
+	if (str.includes("e-")) {
+		const [, exponent] = str.split("e-");
+		return Number(exponent);
+	}
+	const [, decimal = ""] = str.split(".");
+	return decimal.length;
+}
+/**
+* * Adds numbers safely, avoiding floating-point arithmetic issues.
+*
+* @param values - A list of numbers or numeric strings to add.
+* @returns The sum of the provided numbers, with floating-point inaccuracies mitigated.
+*
+* @remarks
+* - This function addresses common floating-point addition errors (e.g., `0.1 + 0.2 !== 0.3`)
+*   by temporarily scaling numbers to integers, performing the addition, and then scaling back.
+* - Non-numeric values are safely ignored in the runtime.
+* - Rounding is used to mitigate floating-point inaccuracies.
+* - Intended for use cases where floating-point inaccuracies are a concern.
+* - Internally uses {@link normalizeNumber}, {@link getDecimalPlaces}, {@link roundNumber}.
+* - It does not handle numbers beyond {@link Number.MAX_SAFE_INTEGER} or {@link Number.MIN_SAFE_INTEGER}.
+*   May output incorrect results if the numbers are too large.
+* @example
+* safeAdd(0.1, 0.2); // → 0.3 (correctly handles floating-point error)
+* safeAdd(1, '2', 3.456); // → 6.456
+* safeAdd(0.1, 0.2, 0.3, 0.4); // → 1.0 (accurate sum)
+*/
+function safeAdd(...values) {
+	let scale = 1;
+	const nums = [];
+	for (const value of values) {
+		const num = normalizeNumber(value);
+		if (!isUndefined(num)) {
+			nums.push(num);
+			scale = Math.max(scale, 10 ** getDecimalPlaces(num));
+		}
+	}
+	return nums.reduce((total, value) => total + roundNumber(value * scale, 0), 0) / scale;
+}
+/**
 * * Rounds a number to a specified number of decimal places.
 *
 * @param number - The number to round.
@@ -2171,4 +2237,4 @@ function getCountryByPhone(phone) {
 }
 
 //#endregion
-export { Currency, Finder, Unit, Unit as UnitConverter, convertToRomanNumerals as arabicToRoman, convertToRomanNumerals, convertToRomanNumerals as integerToRoman, convertToRomanNumerals as numberToRoman, convertToRomanNumerals as numericToRoman, convertToRomanNumerals as toRoman, convertToRomanNumerals as toRomanNumeral, averageByField, averageByField as avgByField, banglaToDigit, getAverage as calculateAverage, getAverage, getAverage as getAverageOfNumbers, factorial as calculateFactorial, factorial, factorial as getFactorial, calculateHCF as calculateGCD, calculateHCF, calculateLCM as calculateLCD, calculateLCM, calculatePercentage, capitalizeString, getOrdinal as cardinalToOrdinal, getOrdinal as convertNumberToOrdinal, getOrdinal as convertToOrdinal, getOrdinal, getOrdinal as getOrdinalNumber, getOrdinal as numberToOrdinal, numberToWordsOrdinal as cardinalWordsToOrdinal, numberToWordsOrdinal as convertNumberToWordsOrdinal, numberToWordsOrdinal, clampNumber, cloneObject, naturalSort as compareNaturally, naturalSort as compareSorter, naturalSort, naturalSort as naturalSortForString, computeTextDiff, convertArrayToString, convertArrayToString as joinArrayElements, formatCurrency as convertNumberToCurrency, formatCurrency, numberToWords as convertNumberToWords, numberToWords, convertObjectValues, romanToInteger as convertRomanToArabic, romanToInteger as convertRomanToInteger, romanToInteger as convertRomanToNumeric, romanToInteger as romanToArabic, romanToInteger, romanToInteger as romanToNumeric, convertStringCase, convertToDecimal, convertToDecimal as convertToFixed, wordsToNumber as convertWordToNumber, wordsToNumber as convertWordsToNumber, wordsToNumber as wordToNumber, wordsToNumber, countInstanceMethods, countInstanceMethods as getInstanceMethodsCount, countObjectFields, countStaticMethods, countStaticMethods as getStaticMethodsCount, countWords, countWords as countWordsInString, countWords as wordCount, createOptionsArray, generateQueryParams as createQueryParams, generateQueryParams as formatQueryParams, generateQueryParams, debounceAction, deepParsePrimitives, deepParsePrimitives as parsePrimitivesDeep, definePrototypeMethod, deleteFields, deleteFields as deleteObjectFields, deleteFields as omitFields, deleteFields as omitObjectFields, deleteFields as removeFields, deleteFields as removeObjectFields, digitToBangla, getDuplicates as extractDuplicates, getDuplicates as extractDuplicatesFromArray, getDuplicates, getDuplicates as getDuplicatesFromArray, extractEmails, extractObjectEntries as extractEntries, extractObjectEntries, extractObjectEntries as objectEntries, extractObjectKeys as extractKeys, extractObjectKeys, extractObjectKeysDeep as extractKeysDeep, extractObjectKeysDeep, findMissingElements as extractMissingElements, findMissingElements, findMissingElements as getMissingElements, extractNewFields, extractNumbersFromString as extractNumbers, extractNumbersFromString, extractNumbersFromString as parseNumbersFromText, extractURLs, extractUpdatedAndNewFields, extractUpdatedFields, getFactors as factorsOf, getFactors as getDivisors, getFactors, fibonacciGenerator, fibonacciGenerator as generateFibonacci, filterArrayOfObjects, findPrimeNumbers, findPrimeNumbers as getPrimeNumbers, flattenArray, flattenObjectDotNotation, flattenObjectKeyValue, formatUnitWithPlural as formatNumberWithPluralUnit, formatUnitWithPlural, formatUnitWithPlural as formatWithPlural, generateAnagrams, generateRandomID, getCharacterDifferences, getClassDetails, getCountryByPhone, getFibonacciSeries as getFibonacci, getFibonacciSeries as getFibonacciNumbers, getFibonacciSeries, getFibonacciSeriesMemo, getFibonacciSeriesMemo as getMemoizedFibonacci, getFibonacciSeriesMemo as getMemoizedFibonacciSeries, getInstanceGetterNames, getInstanceMethodNames, getLastArrayElement, getLevenshteinDistance, getLevenshteinDistance as levenshteinDistance, getNthFibonacci, getNumbersInRange, parseQueryString as getQueryStringAsObject, parseQueryString, parseQueryString as queryStringToObject, getRandomFloat as getRandomDecimal, getRandomFloat, getRandomNumber as getRandomInt, getRandomNumber, getStaticGetterNames, getStaticMethodNames, sumNumbers as getSumOfNumbers, sumNumbers, sumNumbers as sumOfNumbers, groupAndAverageByField, groupAndAverageByField as groupAndAvgByField, groupAndSumByField, splitArrayByProperty as groupArrayByProperty, splitArrayByProperty, isDeepEqual, isInvalidOrEmptyArray, isPrime, isPrime as isPrimeNumber, parseQueryStringLiteral as literalQueryStringToObject, parseQueryStringLiteral, maskString, mergeAndFlattenObjects, mergeObjects, moveArrayElement, normalizeNumber, normalizeString, parseJSON, parseJSON as parseJsonDeep, parseJsonToObject, parseObjectValues, parseObjectValues as parseStringifiedObjectValues, pickFields, pickFields as pickObjectFields, pickObjectFieldsByCondition as pickFieldsByCondition, pickObjectFieldsByCondition, remapFields, remapFields as remapObjectFields, removeDuplicatesFromArray as removeDuplicates, removeDuplicatesFromArray, replaceAllInString, reverseNumber, reverseString, rotateArray, roundNumber, roundNumber as roundToDecimal, roundToNearest as roundNumberToNearestInterval, roundToNearest, roundToNearest as roundToNearestInterval, sanitizeData, shuffleArray, slugifyString, sortAnArray, splitArray, stableStringify, stripJsonEdgeGarbage, sumByField, sumDigits, sumFieldDifference, sumFieldDifference as totalDeltaByField, throttleAction, trimString, truncateString };
+export { Currency, Finder, Unit, Unit as UnitConverter, safeAdd as add, safeAdd, convertToRomanNumerals as arabicToRoman, convertToRomanNumerals, convertToRomanNumerals as integerToRoman, convertToRomanNumerals as numberToRoman, convertToRomanNumerals as numericToRoman, convertToRomanNumerals as toRoman, convertToRomanNumerals as toRomanNumeral, getAverage as average, getAverage as calculateAverage, getAverage, averageByField, averageByField as avgByField, banglaToDigit, factorial as calculateFactorial, factorial, factorial as getFactorial, calculateHCF as calculateGCD, calculateHCF, calculateLCM as calculateLCD, calculateLCM, calculatePercentage, capitalizeString, getOrdinal as cardinalToOrdinal, getOrdinal as convertNumberToOrdinal, getOrdinal as convertToOrdinal, getOrdinal, getOrdinal as getOrdinalNumber, getOrdinal as numberToOrdinal, numberToWordsOrdinal as cardinalWordsToOrdinal, numberToWordsOrdinal as convertNumberToWordsOrdinal, numberToWordsOrdinal, clampNumber, cloneObject, naturalSort as compareNaturally, naturalSort as compareSorter, naturalSort, naturalSort as naturalSortForString, computeTextDiff, convertArrayToString, convertArrayToString as joinArrayElements, formatCurrency as convertNumberToCurrency, formatCurrency, numberToWords as convertNumberToWords, numberToWords, convertObjectValues, romanToInteger as convertRomanToArabic, romanToInteger as convertRomanToInteger, romanToInteger as convertRomanToNumeric, romanToInteger as romanToArabic, romanToInteger, romanToInteger as romanToNumeric, convertStringCase, convertToDecimal, convertToDecimal as convertToFixed, wordsToNumber as convertWordToNumber, wordsToNumber as convertWordsToNumber, wordsToNumber as wordToNumber, wordsToNumber, countInstanceMethods, countInstanceMethods as getInstanceMethodsCount, countObjectFields, countStaticMethods, countStaticMethods as getStaticMethodsCount, countWords, countWords as countWordsInString, countWords as wordCount, createOptionsArray, generateQueryParams as createQueryParams, generateQueryParams as formatQueryParams, generateQueryParams, debounceAction, getDecimalPlaces as decimalPlaces, getDecimalPlaces, deepParsePrimitives, deepParsePrimitives as parsePrimitivesDeep, definePrototypeMethod, deleteFields, deleteFields as deleteObjectFields, deleteFields as omitFields, deleteFields as omitObjectFields, deleteFields as removeFields, deleteFields as removeObjectFields, digitToBangla, getDuplicates as extractDuplicates, getDuplicates as extractDuplicatesFromArray, getDuplicates, getDuplicates as getDuplicatesFromArray, extractEmails, extractObjectEntries as extractEntries, extractObjectEntries, extractObjectEntries as objectEntries, extractObjectKeys as extractKeys, extractObjectKeys, extractObjectKeysDeep as extractKeysDeep, extractObjectKeysDeep, findMissingElements as extractMissingElements, findMissingElements, findMissingElements as getMissingElements, extractNewFields, extractNumbersFromString as extractNumbers, extractNumbersFromString, extractNumbersFromString as parseNumbersFromText, extractURLs, extractUpdatedAndNewFields, extractUpdatedFields, getFactors as factorsOf, getFactors as getDivisors, getFactors, fibonacciGenerator, fibonacciGenerator as generateFibonacci, filterArrayOfObjects, findPrimeNumbers, findPrimeNumbers as getPrimeNumbers, flattenArray, flattenObjectDotNotation, flattenObjectKeyValue, formatUnitWithPlural as formatNumberWithPluralUnit, formatUnitWithPlural, formatUnitWithPlural as formatWithPlural, generateAnagrams, generateRandomID, getCharacterDifferences, getClassDetails, getCountryByPhone, getFibonacciSeries as getFibonacci, getFibonacciSeries as getFibonacciNumbers, getFibonacciSeries, getFibonacciSeriesMemo, getFibonacciSeriesMemo as getMemoizedFibonacci, getFibonacciSeriesMemo as getMemoizedFibonacciSeries, getInstanceGetterNames, getInstanceMethodNames, getLastArrayElement, getLevenshteinDistance, getLevenshteinDistance as levenshteinDistance, getNthFibonacci, getNumbersInRange, parseQueryString as getQueryStringAsObject, parseQueryString, parseQueryString as queryStringToObject, getRandomFloat as getRandomDecimal, getRandomFloat, getRandomNumber as getRandomInt, getRandomNumber, getStaticGetterNames, getStaticMethodNames, sumNumbers as getSumOfNumbers, sumNumbers, sumNumbers as sumOfNumbers, groupAndAverageByField, groupAndAverageByField as groupAndAvgByField, groupAndSumByField, splitArrayByProperty as groupArrayByProperty, splitArrayByProperty, isDeepEqual, isInvalidOrEmptyArray, isPrime, isPrime as isPrimeNumber, parseQueryStringLiteral as literalQueryStringToObject, parseQueryStringLiteral, maskString, mergeAndFlattenObjects, mergeObjects, moveArrayElement, normalizeNumber, normalizeString, parseJSON, parseJSON as parseJsonDeep, parseJsonToObject, parseObjectValues, parseObjectValues as parseStringifiedObjectValues, pickFields, pickFields as pickObjectFields, pickObjectFieldsByCondition as pickFieldsByCondition, pickObjectFieldsByCondition, remapFields, remapFields as remapObjectFields, removeDuplicatesFromArray as removeDuplicates, removeDuplicatesFromArray, replaceAllInString, reverseNumber, reverseString, rotateArray, roundNumber, roundNumber as roundToDecimal, roundToNearest as roundNumberToNearestInterval, roundToNearest, roundToNearest as roundToNearestInterval, sanitizeData, shuffleArray, slugifyString, sortAnArray, splitArray, stableStringify, stripJsonEdgeGarbage, sumByField, sumDigits, sumFieldDifference, sumFieldDifference as totalDeltaByField, throttleAction, trimString, truncateString };

package/dist/{parse-TuFyLeVH.mjs → parse-CILDG7TG.mjs}

@@ -15,10 +15,10 @@
  */
 
 import { a as isNonEmptyString, c as isNumber, d as isString } from "./primitives-Djsevc69.mjs";
-import { d as isNumericString } from "./specials-krf7zsqI.mjs";
-import { r as getOrdinal } from "./utilities-BSv8VbnM.mjs";
 import { i as MS_MAP, n as DAYS, o as SORTED_TIME_FORMATS, r as MONTHS } from "./constants-GZL_CT1W.mjs";
-import { i as isTimeWithUnit } from "./guards-DKGBsd6x.mjs";
+import { d as isNumericString } from "./specials-krf7zsqI.mjs";
+import { r as getOrdinal } from "./utilities-CmPwOkdy.mjs";
+import { i as isTimeWithUnit } from "./guards-DBunDnng.mjs";
 
 //#region src/date/helpers.ts
 /** Core formatting logic shared by `formatDate` and `Chronos`, `BanglaCalendar` classes */

package/dist/{parse-jh637S25.cjs → parse-CffWYCuy.cjs}

@@ -15,10 +15,10 @@
  */
 
 const require_primitives = require('./primitives-CBGICrDR.cjs');
-const require_specials = require('./specials-DU8u108m.cjs');
-const require_utilities = require('./utilities-BVpk3LKy.cjs');
 const require_constants = require('./constants-CgFaV72Z.cjs');
-const require_guards = require('./guards-CqbVT4L5.cjs');
+const require_specials = require('./specials-DU8u108m.cjs');
+const require_utilities = require('./utilities-_COSGq1U.cjs');
+const require_guards = require('./guards-BD2Fkugj.cjs');
 
 //#region src/date/helpers.ts
 /** Core formatting logic shared by `formatDate` and `Chronos`, `BanglaCalendar` classes */

package/dist/{query-sWSi-d7u.cjs → query-Blm7AiEZ.cjs}

@@ -15,9 +15,9 @@
  */
 
 const require_primitives = require('./primitives-CBGICrDR.cjs');
+const require_utils = require('./utils-DR9g0Sef.cjs');
 const require_specials = require('./specials-DU8u108m.cjs');
-const require_guards = require('./guards-CqbVT4L5.cjs');
-const require_basics = require('./basics-byj0VH1c.cjs');
+const require_guards = require('./guards-BD2Fkugj.cjs');
 
 //#region src/form/guards.ts
 /**
@@ -140,7 +140,7 @@ function sanitizeData(input, options, _return) {
 	*/
 	const _processArray = (arr, path) => {
 		return arr?.map((item) => {
-			if (require_primitives.isString(item) && trimStrings) return require_basics.trimString(item);
+			if (require_primitives.isString(item) && trimStrings) return require_utils.trimString(item);
 			if (Array.isArray(item)) return _processArray(item, path);
 			if (require_specials.isObject(item)) return _processObject(item, path);
 			return item;
@@ -162,7 +162,7 @@ function sanitizeData(input, options, _return) {
 		if (ignoreKeySet.has(fullKeyPath)) return acc;
 		if (ignoreNullish && !_isRequiredKey(fullKeyPath) && value == null) return acc;
 		if (ignoreFalsy && !value && !_isRequiredKey(fullKeyPath)) return acc;
-		if (require_primitives.isString(value) && trimStrings) acc[key] = require_basics.trimString(value);
+		if (require_primitives.isString(value) && trimStrings) acc[key] = require_utils.trimString(value);
 		else if (_shouldNotProcess(value)) acc[key] = value;
 		else if (value && require_specials.isObject(value)) if (_shouldNotProcess(value)) acc[key] = value;
 		else {
@@ -175,9 +175,9 @@ function sanitizeData(input, options, _return) {
 		} else acc[key] = value;
 		return acc;
 	}, {});
-	if (require_primitives.isString(input)) return require_basics.trimString(input);
+	if (require_primitives.isString(input)) return require_utils.trimString(input);
 	if (Array.isArray(input)) {
-		if (require_specials.isArrayOfType(input, require_primitives.isString)) return require_basics.trimString(input);
+		if (require_specials.isArrayOfType(input, require_primitives.isString)) return require_utils.trimString(input);
 		return input?.map((item) => sanitizeData(item, options, _return))?.filter((val) => {
 			if (ignoreNullish && val == null) return false;
 			if (ignoreFalsy && !val) return false;
@@ -338,7 +338,7 @@ const flattenObjectDotNotation = (object) => {
 */
 const extractUpdatedFields = (baseObject, updatedObject) => {
 	const updatedFields = {};
-	for (const key in updatedObject) if (key in baseObject && !require_basics.isDeepEqual(updatedObject[key], baseObject[key])) if (updatedObject[key] && require_specials.isNotEmptyObject(updatedObject[key])) {
+	for (const key in updatedObject) if (key in baseObject && !require_utils.isDeepEqual(updatedObject[key], baseObject[key])) if (updatedObject[key] && require_specials.isNotEmptyObject(updatedObject[key])) {
 		updatedFields[key] = extractUpdatedFields(baseObject[key], updatedObject[key]);
 		if (updatedFields[key] && require_specials.isEmptyObject(updatedFields[key])) delete updatedFields[key];
 	} else updatedFields[key] = updatedObject[key];
@@ -371,7 +371,7 @@ const extractUpdatedAndNewFields = (baseObject, updatedObject) => {
 	const updatedFields = {};
 	const newFields = {};
 	for (const key in updatedObject) if (!(key in baseObject)) newFields[key] = updatedObject[key];
-	else if (!require_basics.isDeepEqual(updatedObject[key], baseObject[key])) if (updatedObject[key] && require_specials.isNotEmptyObject(updatedObject[key])) {
+	else if (!require_utils.isDeepEqual(updatedObject[key], baseObject[key])) if (updatedObject[key] && require_specials.isNotEmptyObject(updatedObject[key])) {
 		updatedFields[key] = extractUpdatedAndNewFields(baseObject[key], updatedObject[key]);
 		if (updatedFields[key] && require_specials.isEmptyObject(updatedFields[key])) delete updatedFields[key];
 	} else updatedFields[key] = updatedObject[key];
@@ -465,7 +465,7 @@ function parseQueryString(query, parsePrimitives = true) {
 	for (const [key, value] of params.entries()) if (key in entries) {
 		const current = entries[key];
 		const array = Array.isArray(current) ? [...current, value] : [current, value];
-		entries[key] = parsePrimitives ? require_basics.deepParsePrimitives(array) : array;
+		entries[key] = parsePrimitives ? require_utils.deepParsePrimitives(array) : array;
 	} else entries[key] = value;
 	return parsePrimitives ? parseObjectValues(entries) : entries;
 }

package/dist/{query-BomnyWh3.mjs → query-PGFEup3p.mjs}

@@ -15,9 +15,9 @@
  */
 
 import { d as isString } from "./primitives-Djsevc69.mjs";
+import { $ as trimString, a as deepParsePrimitives, f as isDeepEqual } from "./utils-BO5CcsjK.mjs";
 import { E as isObjectWithKeys, T as isObject, g as isArrayOfType, j as isValidArray, v as isEmptyObject, w as isNotEmptyObject } from "./specials-krf7zsqI.mjs";
-import { t as isDateLike } from "./guards-DKGBsd6x.mjs";
-import { I as deepParsePrimitives, U as isDeepEqual, n as trimString } from "./basics-20lm69yy.mjs";
+import { t as isDateLike } from "./guards-DBunDnng.mjs";
 
 //#region src/form/guards.ts
 /**

package/dist/{stylog.cjs → stylog/index.cjs}

@@ -15,11 +15,11 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_primitives = require('./primitives-CBGICrDR.cjs');
-const require_css_colors = require('./css-colors-DC7oZ46Y.cjs');
-const require_guards = require('./guards-CrfVwk0-.cjs');
-const require_convert = require('./convert-BjKz_hhr.cjs');
-const require_specials = require('./specials-DU8u108m.cjs');
+const require_primitives = require('../primitives-CBGICrDR.cjs');
+const require_css_colors = require('../css-colors-DC7oZ46Y.cjs');
+const require_specials = require('../specials-DU8u108m.cjs');
+const require_guards = require('../guards-CrfVwk0-.cjs');
+const require_convert = require('../convert-BjKz_hhr.cjs');
 
 //#region src/stylog/console.log.ts
 /**

package/dist/{stylog.d.cts → stylog/index.d.cts}

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-import { _ as Hex } from "./Color-SUPeP6fO.cjs";
-import { a as AnsiSequence, n as Stylog, o as BGColor, t as LogStyler, u as TextStyle } from "./Stylog-DdPP_CJf.cjs";
+import { _ as Hex } from "../Color-SUPeP6fO.cjs";
+import { a as AnsiSequence, n as Stylog, o as BGColor, t as LogStyler, u as TextStyle } from "../Stylog-DdPP_CJf.cjs";
 
 //#region src/stylog/utils.d.ts
 /**

package/dist/{stylog.d.mts → stylog/index.d.mts}

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-import { _ as Hex } from "./Color-D6qMZgDm.mjs";
-import { a as AnsiSequence, n as Stylog, o as BGColor, t as LogStyler, u as TextStyle } from "./Stylog-B8sKWvn_.mjs";
+import { _ as Hex } from "../Color-D6qMZgDm.mjs";
+import { a as AnsiSequence, n as Stylog, o as BGColor, t as LogStyler, u as TextStyle } from "../Stylog-B8sKWvn_.mjs";
 
 //#region src/stylog/utils.d.ts
 /**

package/dist/{stylog.mjs → stylog/index.mjs}

@@ -14,11 +14,11 @@
  * limitations under the License.
  */
 
-import { c as isNumber, d as isString } from "./primitives-Djsevc69.mjs";
-import { t as CSS_COLORS } from "./css-colors-B-y4TmeC.mjs";
-import { f as _isValidHue, i as isHex6, m as _isValidRGBComponent, o as isRGB, p as _isValidPercentage, t as isCSSColor } from "./guards-CNG9gnvL.mjs";
-import { a as convertHexToRgb, s as convertHslToRgb } from "./convert-DRZXcjcS.mjs";
-import { g as isArrayOfType, r as isBrowser } from "./specials-krf7zsqI.mjs";
+import { c as isNumber, d as isString } from "../primitives-Djsevc69.mjs";
+import { t as CSS_COLORS } from "../css-colors-B-y4TmeC.mjs";
+import { g as isArrayOfType, r as isBrowser } from "../specials-krf7zsqI.mjs";
+import { f as _isValidHue, i as isHex6, m as _isValidRGBComponent, o as isRGB, p as _isValidPercentage, t as isCSSColor } from "../guards-CNG9gnvL.mjs";
+import { a as convertHexToRgb, s as convertHslToRgb } from "../convert-DRZXcjcS.mjs";
 
 //#region src/stylog/console.log.ts
 /**

package/dist/types/pluralizer.d.cts

@@ -14,5 +14,29 @@
  * limitations under the License.
  */
 
-import { n as PluralizeOptions, r as PluralizeRule, t as IrregularMap } from "../pluralizer-DYsDqq9c.cjs";
+import { ct as Numeric } from "../object-DyVg8BFt.cjs";
+
+//#region src/types/pluralizer.d.ts
+/** A pair of RegExp and replacement for pluralization rules */
+type PluralizeRule = [RegExp, string];
+/**
+ * A map of irregular singular to plural forms.
+ * Used for handling exceptions in pluralization.
+ */
+type IrregularMap = Record<string, string>;
+/** * Options for pluralize method. */
+interface PluralizeOptions {
+  /**
+   * The count to determine singular or plural form. Either number or numeric string.
+   * If not provided, bypass the check and pluralize the word anyways.
+   */
+  count?: Numeric;
+  /**
+   * Whether to include the count in the output. Depends on the `count` value.
+   * If true, the output will be in the format "2 Categories".
+   * If false, it will just return the pluralized word.
+   */
+  inclusive?: boolean;
+}
+//#endregion
 export { IrregularMap, PluralizeOptions, PluralizeRule };

package/dist/types/pluralizer.d.mts

@@ -14,5 +14,29 @@
  * limitations under the License.
  */
 
-import { n as PluralizeOptions, r as PluralizeRule, t as IrregularMap } from "../pluralizer-DXMuPUAK.mjs";
+import { ct as Numeric } from "../object-DyVg8BFt.mjs";
+
+//#region src/types/pluralizer.d.ts
+/** A pair of RegExp and replacement for pluralization rules */
+type PluralizeRule = [RegExp, string];
+/**
+ * A map of irregular singular to plural forms.
+ * Used for handling exceptions in pluralization.
+ */
+type IrregularMap = Record<string, string>;
+/** * Options for pluralize method. */
+interface PluralizeOptions {
+  /**
+   * The count to determine singular or plural form. Either number or numeric string.
+   * If not provided, bypass the check and pluralize the word anyways.
+   */
+  count?: Numeric;
+  /**
+   * Whether to include the count in the output. Depends on the `count` value.
+   * If true, the output will be in the format "2 Categories".
+   * If false, it will just return the pluralized word.
+   */
+  inclusive?: boolean;
+}
+//#endregion
 export { IrregularMap, PluralizeOptions, PluralizeRule };

package/dist/{utilities-BSv8VbnM.mjs → utilities-CmPwOkdy.mjs}

@@ -15,8 +15,8 @@
  */
 
 import { c as isNumber } from "./primitives-Djsevc69.mjs";
-import { d as isNumericString } from "./specials-krf7zsqI.mjs";
 import { r as CURRENCY_LOCALES } from "./constants-ZyfpysiQ.mjs";
+import { d as isNumericString } from "./specials-krf7zsqI.mjs";
 
 //#region src/number/utilities.ts
 /**

package/dist/{utilities-BVpk3LKy.cjs → utilities-_COSGq1U.cjs}

@@ -15,8 +15,8 @@
  */
 
 const require_primitives = require('./primitives-CBGICrDR.cjs');
-const require_specials = require('./specials-DU8u108m.cjs');
 const require_constants = require('./constants-B3nc8psr.cjs');
+const require_specials = require('./specials-DU8u108m.cjs');
 
 //#region src/number/utilities.ts
 /**