nhb-toolbox 4.12.80 → 4.13.0

package/CHANGELOG.md

@@ -6,7 +6,12 @@ All notable changes to the package will be documented here.
 
 ---
 
-## [4.12.80] - 2025-07-19
+## [4.13.0] - 2025-07-21
+
+- **Added** new `Pluralizer` class and utility `pluralizer` (shared instance of `Pluralizer` class) with multiple methods.
+- **Refactored** codes in number utilities, introduced new `normalizeNumber` utility.
+
+## [4.12.80-81] - 2025-07-19
 
 - **Updated** `convertArrayToString` to accept array of any primitive values.
 - **Fully integrated** with [nhb-scripts](https://www.npmjs.com/package/nhb-scripts/).

package/README.md

@@ -300,6 +300,12 @@ debounceAction(fetchResults, 300);
   </a>
 </div>
 
+<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+  <a target="_blank" href="https://www.npmjs.com/package/nhb-express">
+    <img src="https://img.shields.io/badge/Express_Server_Scaffolder-nhb--express-orange" alt="nhb-express" />
+  </a>
+</div>
+
 <div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
   <a target="_blank" href="https://www.npmjs.com/package/nhb-anagram-generator">
     <img src="https://img.shields.io/badge/Anagram_Generator-nhb--anagram--generator-teal" alt="nhb-anagram-generator" />

package/dist/cjs/array/helpers.js

@@ -3,8 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports._resolveNestedKey = _resolveNestedKey;
 exports._getNumericProp = _getNumericProp;
 const non_primitives_1 = require("../guards/non-primitives");
-const primitives_1 = require("../guards/primitives");
-const specials_1 = require("../guards/specials");
+const utilities_1 = require("../number/utilities");
 /**
  * Safely resolves nested keys from a dot-separated string like "user.city".
  *
@@ -36,9 +35,7 @@ function _getNumericProp(obj, path) {
                 return acc[key];
             }
         }, obj);
-        return ((0, primitives_1.isNumber)(value) ? value
-            : (0, specials_1.isNumericString)(value) ? Number(value)
-                : 0);
+        return (0, utilities_1.normalizeNumber)(value) ?? 0;
     }
     else {
         return 0;

package/dist/cjs/index.js

@@ -15,13 +15,13 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Unit = exports.Currency = exports.sumOfNumbers = exports.sumNumbers = exports.sumDigits = exports.roundToDecimal = exports.roundNumber = exports.reverseNumber = exports.getSumOfNumbers = exports.getRandomNumber = exports.getRandomInt = exports.getAverageOfNumbers = exports.getAverage = exports.convertToFixed = exports.convertToDecimal = exports.calculateLCM = exports.calculateLCD = exports.calculateHCF = exports.calculateGCD = exports.calculateAverage = exports.wordCount = exports.parseNumbersFromText = exports.levenshteinDistance = exports.getLevenshteinDistance = exports.extractNumbersFromString = exports.extractNumbers = exports.countWordsInString = exports.countWords = exports.slugifyString = exports.reverseString = exports.replaceAllInString = exports.normalizeString = exports.maskString = exports.formatWithPlural = exports.formatUnitWithPlural = exports.formatNumberWithPluralUnit = exports.extractURLs = exports.extractEmails = exports.convertStringCase = exports.isSnakeCase = exports.isPascalCase = exports.isPalindrome = exports.isKebabCase = exports.isEmojiOnly = exports.isCamelCase = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
-exports.numberToOrdinal = exports.getRandomFloat = exports.getRandomDecimal = exports.getOrdinalNumber = exports.getOrdinal = exports.formatCurrency = exports.convertToOrdinal = exports.convertNumberToOrdinal = exports.convertNumberToCurrency = exports.clampNumber = exports.cardinalToOrdinal = exports.isPrimeNumber = exports.isPrime = exports.getPrimeNumbers = exports.findPrimeNumbers = exports.toRomanNumeral = exports.toRoman = exports.numericToRoman = exports.numberToWordsOrdinal = exports.numberToWords = exports.numberToRoman = exports.integerToRoman = exports.convertToRomanNumerals = exports.convertNumberToWordsOrdinal = exports.convertNumberToWords = exports.cardinalWordsToOrdinal = exports.isPerfectSquare = exports.isPartOfFibonacciSeries = exports.isPartOfFibonacci = exports.isOddNumber = exports.isOdd = exports.isNumberInvalid = exports.isMultiple = exports.isInvalidNumber = exports.isFibonacci = exports.isEvenNumber = exports.isEven = exports.areNumbersInvalid = exports.areInvalidNumbers = exports.getNthFibonacci = exports.getMemoizedFibonacciSeries = exports.getMemoizedFibonacci = exports.getFibonacciSeriesMemo = exports.getFibonacciSeries = exports.getFibonacciNumbers = exports.getFibonacci = exports.generateFibonacci = exports.fibonacciGenerator = exports.calculatePercentage = exports.UnitConverter = void 0;
-exports.extractTimeStringFromUTC = exports.extractTimeFromUTC = exports.extractMinutesFromUTC = exports.extractHourMinute = exports.convertMinutesToUTCOffset = exports.convertMinutesToTime = exports.convertMinutesToHourMinutes = exports.chronusts = exports.chronusjs = exports.chronus = exports.chronosts = exports.chronosjs = exports.chronos = exports.INTERNALS = exports.Chronus = exports.Chronos = exports.isValidUTCOffSet = exports.isValidUTC = exports.isValidTimeString = exports.isValidTime = exports.isLeapYear = exports.isDateLike = exports.greet = exports.getGreeting = exports.generateGreeting = exports.extractSolidColorValues = exports.extractAlphaColorValues = exports.Colour = exports.Color = exports.convertRgbToRgba = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertRgbaToHsla = exports.convertRgbaToHex8 = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHslaToRgba = exports.convertHslaToHex8 = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertHex8ToRgba = exports.convertHex8ToHsla = exports.convertColorCode = exports.generateRandomHSLColor = exports.generateRandomColorInHexRGB = exports.getColorForInitial = exports.getNumbersInRange = exports.roundToNearestInterval = exports.roundToNearest = exports.roundNumberToNearestInterval = void 0;
-exports.createFormData = exports.createControlledFormData = exports.convertIntoFormData = exports.naturalSortForString = exports.naturalSort = exports.compareSorter = exports.compareNaturally = exports.splitArrayByProperty = exports.splitArray = exports.rotateArray = exports.removeDuplicatesFromArray = exports.removeDuplicates = exports.moveArrayElement = exports.groupArrayByProperty = exports.getMissingElements = exports.getDuplicatesFromArray = exports.getDuplicates = exports.findMissingElements = exports.extractMissingElements = exports.extractDuplicatesFromArray = exports.extractDuplicates = exports.createOptionsArray = exports.sortAnArray = exports.Finder = exports.totalDeltaByField = exports.sumFieldDifference = exports.sumByField = exports.groupAndSumByField = exports.groupAndAvgByField = exports.groupAndAverageByField = exports.avgByField = exports.averageByField = exports.shuffleArray = exports.isValidEmptyArray = exports.isInvalidOrEmptyArray = exports.getLastArrayElement = exports.flattenArray = exports.filterArrayOfObjects = exports.minutesToUTCOffset = exports.getTotalMinutesFromUTC = exports.getTotalMinutesFromTime = exports.getTotalMinutes = exports.getTimeStringFromUTC = exports.getTimeFromMinutes = exports.getMinutesFromUTC = exports.getHourMinutesFromMinutes = exports.getCurrentTime = exports.getCurrentDateTime = exports.formatUTCOffset = exports.extractTotalMinutesFromTime = void 0;
-exports.removeFromLocalStorage = exports.getFromSessionStorage = exports.getFromLocalStorage = exports.toggleFullScreen = exports.smoothScrollTo = exports.copyToClipboard = exports.updateQueryParam = exports.queryStringToObject = exports.parseQueryString = exports.getQueryStringAsObject = exports.getQueryParams = exports.generateQueryParams = exports.formatQueryParams = exports.createQueryParams = exports.removeObjectFields = exports.removeFields = exports.remapObjectFields = exports.remapFields = exports.pickObjectFieldsByCondition = exports.pickObjectFields = exports.pickFieldsByCondition = exports.pickFields = exports.omitObjectFields = exports.omitFields = exports.deleteObjectFields = exports.deleteFields = exports.convertObjectValues = exports.sanitizeData = exports.parseStringifiedObjectValues = exports.parseObjectValues = exports.parseJsonToObject = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObjectKeyValue = exports.flattenObjectDotNotation = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.countObjectFields = exports.cloneObject = exports.isValidFormData = exports.isOriginFileObj = exports.isFileUpload = exports.isFileOrBlob = exports.isFileList = exports.isFileArray = exports.isCustomFileArray = exports.isCustomFile = exports.serializeForm = exports.parseFormData = void 0;
-exports.isObject = exports.isNotEmptyObject = exports.isMethodDescriptor = exports.isMethod = exports.isMap = exports.isJSONObject = exports.isJSON = exports.isFunction = exports.isError = exports.isEmptyObjectGuard = exports.isEmptyObject = exports.isDate = exports.isArrayWithLength = exports.isArrayOfType = exports.isArray = exports.doesReturnPromise = exports.isUndefined = exports.isTruthy = exports.isSymbol = exports.isString = exports.isPrimitive = exports.isPositiveInteger = exports.isNumber = exports.isNull = exports.isNormalPrimitive = exports.isNonEmptyString = exports.isInteger = exports.isFalsy = exports.isBoolean = exports.isBigInt = exports.Paginator = exports.throttleAction = exports.parsePrimitivesDeep = exports.parseJsonDeep = exports.parseJSON = exports.joinArrayElements = exports.isDeepEqual = exports.getStaticMethodsCount = exports.getStaticMethodNames = exports.getInstanceMethodsCount = exports.getInstanceMethodNames = exports.getClassDetails = exports.deepParsePrimitives = exports.debounceAction = exports.countStaticMethods = exports.countInstanceMethods = exports.convertArrayToString = exports.saveToSessionStorage = exports.saveToLocalStorage = exports.removeFromSessionStorage = void 0;
-exports.isValidURL = exports.isValidEmail = exports.isUUID = exports.isURL = exports.isPhoneNumber = exports.isNumericString = exports.isNodeEnvironment = exports.isNodeENV = exports.isNode = exports.isIPAddress = exports.isExpectedNodeENV = exports.isEnvironment = exports.isEmailArray = exports.isEmail = exports.isDateString = exports.isBrowser = exports.isBase64 = exports.isValidSet = exports.isValidObject = exports.isValidMap = exports.isValidJSON = exports.isValidArray = exports.isSet = exports.isReturningPromise = exports.isRegularExpression = exports.isRegExp = exports.isPromise = exports.isObjectWithKeys = exports.isObjectEmpty = void 0;
+exports.sumOfNumbers = exports.sumNumbers = exports.sumDigits = exports.roundToDecimal = exports.roundNumber = exports.reverseNumber = exports.getSumOfNumbers = exports.getRandomNumber = exports.getRandomInt = exports.getAverageOfNumbers = exports.getAverage = exports.convertToFixed = exports.convertToDecimal = exports.calculateLCM = exports.calculateLCD = exports.calculateHCF = exports.calculateGCD = exports.calculateAverage = exports.pluralizer = exports.Pluralizer = exports.wordCount = exports.parseNumbersFromText = exports.levenshteinDistance = exports.getLevenshteinDistance = exports.extractNumbersFromString = exports.extractNumbers = exports.countWordsInString = exports.countWords = exports.slugifyString = exports.reverseString = exports.replaceAllInString = exports.normalizeString = exports.maskString = exports.formatWithPlural = exports.formatUnitWithPlural = exports.formatNumberWithPluralUnit = exports.extractURLs = exports.extractEmails = exports.convertStringCase = exports.isSnakeCase = exports.isPascalCase = exports.isPalindrome = exports.isKebabCase = exports.isEmojiOnly = exports.isCamelCase = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
+exports.getRandomDecimal = exports.getOrdinalNumber = exports.getOrdinal = exports.formatCurrency = exports.convertToOrdinal = exports.convertNumberToOrdinal = exports.convertNumberToCurrency = exports.clampNumber = exports.cardinalToOrdinal = exports.isPrimeNumber = exports.isPrime = exports.getPrimeNumbers = exports.findPrimeNumbers = exports.toRomanNumeral = exports.toRoman = exports.numericToRoman = exports.numberToWordsOrdinal = exports.numberToWords = exports.numberToRoman = exports.integerToRoman = exports.convertToRomanNumerals = exports.convertNumberToWordsOrdinal = exports.convertNumberToWords = exports.cardinalWordsToOrdinal = exports.isPerfectSquare = exports.isPartOfFibonacciSeries = exports.isPartOfFibonacci = exports.isOddNumber = exports.isOdd = exports.isNumberInvalid = exports.isMultiple = exports.isInvalidNumber = exports.isFibonacci = exports.isEvenNumber = exports.isEven = exports.areNumbersInvalid = exports.areInvalidNumbers = exports.getNthFibonacci = exports.getMemoizedFibonacciSeries = exports.getMemoizedFibonacci = exports.getFibonacciSeriesMemo = exports.getFibonacciSeries = exports.getFibonacciNumbers = exports.getFibonacci = exports.generateFibonacci = exports.fibonacciGenerator = exports.calculatePercentage = exports.UnitConverter = exports.Unit = exports.Currency = void 0;
+exports.extractHourMinute = exports.convertMinutesToUTCOffset = exports.convertMinutesToTime = exports.convertMinutesToHourMinutes = exports.chronusts = exports.chronusjs = exports.chronus = exports.chronosts = exports.chronosjs = exports.chronos = exports.INTERNALS = exports.Chronus = exports.Chronos = exports.isValidUTCOffSet = exports.isValidUTC = exports.isValidTimeString = exports.isValidTime = exports.isLeapYear = exports.isDateLike = exports.greet = exports.getGreeting = exports.generateGreeting = exports.extractSolidColorValues = exports.extractAlphaColorValues = exports.Colour = exports.Color = exports.convertRgbToRgba = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertRgbaToHsla = exports.convertRgbaToHex8 = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHslaToRgba = exports.convertHslaToHex8 = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertHex8ToRgba = exports.convertHex8ToHsla = exports.convertColorCode = exports.generateRandomHSLColor = exports.generateRandomColorInHexRGB = exports.getColorForInitial = exports.getNumbersInRange = exports.roundToNearestInterval = exports.roundToNearest = exports.roundNumberToNearestInterval = exports.numberToOrdinal = exports.normalizeNumber = exports.getRandomFloat = void 0;
+exports.naturalSortForString = exports.naturalSort = exports.compareSorter = exports.compareNaturally = exports.splitArrayByProperty = exports.splitArray = exports.rotateArray = exports.removeDuplicatesFromArray = exports.removeDuplicates = exports.moveArrayElement = exports.groupArrayByProperty = exports.getMissingElements = exports.getDuplicatesFromArray = exports.getDuplicates = exports.findMissingElements = exports.extractMissingElements = exports.extractDuplicatesFromArray = exports.extractDuplicates = exports.createOptionsArray = exports.sortAnArray = exports.Finder = exports.totalDeltaByField = exports.sumFieldDifference = exports.sumByField = exports.groupAndSumByField = exports.groupAndAvgByField = exports.groupAndAverageByField = exports.avgByField = exports.averageByField = exports.shuffleArray = exports.isValidEmptyArray = exports.isInvalidOrEmptyArray = exports.getLastArrayElement = exports.flattenArray = exports.filterArrayOfObjects = exports.minutesToUTCOffset = exports.getTotalMinutesFromUTC = exports.getTotalMinutesFromTime = exports.getTotalMinutes = exports.getTimeStringFromUTC = exports.getTimeFromMinutes = exports.getMinutesFromUTC = exports.getHourMinutesFromMinutes = exports.getCurrentTime = exports.getCurrentDateTime = exports.formatUTCOffset = exports.extractTotalMinutesFromTime = exports.extractTimeStringFromUTC = exports.extractTimeFromUTC = exports.extractMinutesFromUTC = void 0;
+exports.toggleFullScreen = exports.smoothScrollTo = exports.copyToClipboard = exports.updateQueryParam = exports.queryStringToObject = exports.parseQueryString = exports.getQueryStringAsObject = exports.getQueryParams = exports.generateQueryParams = exports.formatQueryParams = exports.createQueryParams = exports.removeObjectFields = exports.removeFields = exports.remapObjectFields = exports.remapFields = exports.pickObjectFieldsByCondition = exports.pickObjectFields = exports.pickFieldsByCondition = exports.pickFields = exports.omitObjectFields = exports.omitFields = exports.deleteObjectFields = exports.deleteFields = exports.convertObjectValues = exports.sanitizeData = exports.parseStringifiedObjectValues = exports.parseObjectValues = exports.parseJsonToObject = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObjectKeyValue = exports.flattenObjectDotNotation = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.countObjectFields = exports.cloneObject = exports.isValidFormData = exports.isOriginFileObj = exports.isFileUpload = exports.isFileOrBlob = exports.isFileList = exports.isFileArray = exports.isCustomFileArray = exports.isCustomFile = exports.serializeForm = exports.parseFormData = exports.createFormData = exports.createControlledFormData = exports.convertIntoFormData = void 0;
+exports.isMethod = exports.isMap = exports.isJSONObject = exports.isJSON = exports.isFunction = exports.isError = exports.isEmptyObjectGuard = exports.isEmptyObject = exports.isDate = exports.isArrayWithLength = exports.isArrayOfType = exports.isArray = exports.doesReturnPromise = exports.isUndefined = exports.isTruthy = exports.isSymbol = exports.isString = exports.isPrimitive = exports.isPositiveInteger = exports.isNumber = exports.isNull = exports.isNormalPrimitive = exports.isNonEmptyString = exports.isInteger = exports.isFalsy = exports.isBoolean = exports.isBigInt = exports.Paginator = exports.throttleAction = exports.parsePrimitivesDeep = exports.parseJsonDeep = exports.parseJSON = exports.joinArrayElements = exports.isDeepEqual = exports.getStaticMethodsCount = exports.getStaticMethodNames = exports.getInstanceMethodsCount = exports.getInstanceMethodNames = exports.getClassDetails = exports.deepParsePrimitives = exports.debounceAction = exports.countStaticMethods = exports.countInstanceMethods = exports.convertArrayToString = exports.saveToSessionStorage = exports.saveToLocalStorage = exports.removeFromSessionStorage = exports.removeFromLocalStorage = exports.getFromSessionStorage = exports.getFromLocalStorage = void 0;
+exports.isValidURL = exports.isValidEmail = exports.isUUID = exports.isURL = exports.isPhoneNumber = exports.isNumericString = exports.isNodeEnvironment = exports.isNodeENV = exports.isNode = exports.isIPAddress = exports.isExpectedNodeENV = exports.isEnvironment = exports.isEmailArray = exports.isEmail = exports.isDateString = exports.isBrowser = exports.isBase64 = exports.isValidSet = exports.isValidObject = exports.isValidMap = exports.isValidJSON = exports.isValidArray = exports.isSet = exports.isReturningPromise = exports.isRegularExpression = exports.isRegExp = exports.isPromise = exports.isObjectWithKeys = exports.isObjectEmpty = exports.isObject = exports.isNotEmptyObject = exports.isMethodDescriptor = void 0;
 // ! String Utilities
 var basics_1 = require("./string/basics");
 Object.defineProperty(exports, "capitalizeString", { enumerable: true, get: function () { return basics_1.capitalizeString; } });
@@ -58,6 +58,10 @@ Object.defineProperty(exports, "getLevenshteinDistance", { enumerable: true, get
 Object.defineProperty(exports, "levenshteinDistance", { enumerable: true, get: function () { return utilities_1.getLevenshteinDistance; } });
 Object.defineProperty(exports, "parseNumbersFromText", { enumerable: true, get: function () { return utilities_1.extractNumbersFromString; } });
 Object.defineProperty(exports, "wordCount", { enumerable: true, get: function () { return utilities_1.countWords; } });
+// ! Pluralizer Class and Its Default Instance
+var Pluralizer_1 = require("./pluralize/Pluralizer");
+Object.defineProperty(exports, "Pluralizer", { enumerable: true, get: function () { return Pluralizer_1.Pluralizer; } });
+Object.defineProperty(exports, "pluralizer", { enumerable: true, get: function () { return Pluralizer_1.pluralizer; } });
 // ! Number Utilities
 var basics_2 = require("./number/basics");
 Object.defineProperty(exports, "calculateAverage", { enumerable: true, get: function () { return basics_2.getAverage; } });
@@ -137,6 +141,7 @@ Object.defineProperty(exports, "getOrdinal", { enumerable: true, get: function (
 Object.defineProperty(exports, "getOrdinalNumber", { enumerable: true, get: function () { return utilities_2.getOrdinal; } });
 Object.defineProperty(exports, "getRandomDecimal", { enumerable: true, get: function () { return utilities_2.getRandomFloat; } });
 Object.defineProperty(exports, "getRandomFloat", { enumerable: true, get: function () { return utilities_2.getRandomFloat; } });
+Object.defineProperty(exports, "normalizeNumber", { enumerable: true, get: function () { return utilities_2.normalizeNumber; } });
 Object.defineProperty(exports, "numberToOrdinal", { enumerable: true, get: function () { return utilities_2.getOrdinal; } });
 Object.defineProperty(exports, "roundNumberToNearestInterval", { enumerable: true, get: function () { return utilities_2.roundToNearest; } });
 Object.defineProperty(exports, "roundToNearest", { enumerable: true, get: function () { return utilities_2.roundToNearest; } });

package/dist/cjs/number/utilities.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getOrdinal = exports.getRandomFloat = exports.clampNumber = exports.formatCurrency = exports.roundToNearest = void 0;
+exports.normalizeNumber = exports.getOrdinal = exports.getRandomFloat = exports.clampNumber = exports.formatCurrency = exports.roundToNearest = void 0;
+const primitives_1 = require("../guards/primitives");
+const specials_1 = require("../guards/specials");
 const constants_1 = require("./constants");
 /**
  * * Rounds a number to the nearest specified interval.
@@ -85,3 +87,17 @@ const getOrdinal = (num, withNumber = true) => {
     return withNumber ? String(num).concat(suffix) : suffix;
 };
 exports.getOrdinal = getOrdinal;
+/**
+ * * Normalize a number or numeric string to a number.
+ * @description
+ * This function checks if the input is a number or a numeric string and converts it to a number.
+ * If the input is not a valid number or numeric string, it returns undefined.
+ * @param num - The number to normalize.
+ * @returns The normalized number or undefined if the input is not a valid number or numeric string.
+ */
+const normalizeNumber = (num) => {
+    return ((0, primitives_1.isNumber)(num) ? num
+        : (0, specials_1.isNumericString)(num) ? Number(num)
+            : undefined);
+};
+exports.normalizeNumber = normalizeNumber;

package/dist/cjs/pluralize/Pluralizer.js

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pluralizer = exports.Pluralizer = void 0;
+const utilities_1 = require("../number/utilities");
+const rules_1 = require("./rules");
+/**
+ * * Handles English word pluralization and singularization with support for irregular forms and uncountable nouns.
+ *
+ * - Provides methods to convert words between singular and plural forms, check if a word is plural or singular, and manage custom pluralization rules.
+ * - Supports adding custom pluralization and singularization rules, as well as uncountable nouns.
+ * - Automatically handles common irregular forms like "child" to "children"
+ * - Automatically loads common irregular forms and uncountable nouns.
+ * - Supports options for count-based pluralization, allowing for inclusive formatting.
+ * - This class is useful for applications that need to handle natural language processing, such as chatbots, content management systems, or any text processing tasks that require accurate pluralization.
+ * @example
+ * const pluralizer = new Pluralizer();
+ * pluralizer.pluralize('child'); // "children"
+ * pluralizer.toSingular('geese'); // "goose"
+ * pluralizer.isPlural('fish'); // false (uncountable)
+ */
+class Pluralizer {
+    #pluralRules = [];
+    #singularRules = [];
+    #uncountables = new Set();
+    #irregularSingles = {};
+    #irregularPlurals = {};
+    /**
+     * Initializes the Pluralizer with default rules and exceptions.
+     * Automatically loads irregular rules, pluralization rules, and uncountable nouns.
+     */
+    constructor() {
+        this.#loadRules();
+    }
+    #loadRules() {
+        // ! Load irregular rules
+        rules_1.irregularRules.forEach(([single, plural]) => {
+            this.addIrregular(single, plural);
+        });
+        // ! Load plural rules
+        rules_1.pluralRules.forEach(([rule, replacement]) => {
+            this.addPluralRule(rule, replacement);
+        });
+        // ! Load uncountables
+        rules_1.uncountables.forEach((word) => {
+            this.addUncountable(word);
+        });
+    }
+    #restoreCase(word, token) {
+        if (word === word.toUpperCase())
+            return token.toUpperCase();
+        if (word[0] === word[0].toUpperCase()) {
+            return token.charAt(0).toUpperCase() + token.slice(1).toLowerCase();
+        }
+        return token.toLowerCase();
+    }
+    #sanitizeWord(word, rules) {
+        if (!word.length || this.#isUncountable(word)) {
+            return word;
+        }
+        for (let i = rules.length - 1; i >= 0; i--) {
+            const [rule, replacement] = rules[i];
+            if (rule.test(word)) {
+                return word.replace(rule, replacement);
+            }
+        }
+        return word;
+    }
+    /**
+     * Check if a word is uncountable.
+     * Supports both string and RegExp entries.
+     */
+    #isUncountable(word) {
+        const lower = word.toLowerCase();
+        for (const entry of this.#uncountables) {
+            if (typeof entry === 'string') {
+                if (entry === lower)
+                    return true;
+            }
+            else {
+                if (entry.test(word))
+                    return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * * Add a new pluralization rule.
+     * @param rule Pattern to match singular words.
+     * @param replacement Replacement pattern for plural form.
+     * @example
+     * pluralizer.addPluralRule(/(quiz)$/i, '$1zes');
+     */
+    addPluralRule(rule, replacement) {
+        this.#pluralRules.push([rule, replacement]);
+    }
+    /**
+     * Add a new singularization rule.
+     * @param rule Pattern to match plural words.
+     * @param replacement Replacement pattern for singular form.
+     * @example
+     * pluralizer.addSingularRule(/(matr)ices$/i, '$1ix');
+     */
+    addSingularRule(rule, replacement) {
+        this.#singularRules.push([rule, replacement]);
+    }
+    addUncountable(word) {
+        this.#uncountables.add(typeof word === 'string' ? word.toLowerCase() : word);
+    }
+    /**
+     * Add a word or pattern that should never change between singular and plural.
+     * @param word A word or regex pattern.
+     * @example
+     * pluralizer.addUncountable('fish');
+     * pluralizer.addUncountable(/pok[eé]mon$/i);
+     */
+    addIrregular(single, plural) {
+        const singleLower = single.toLowerCase();
+        const pluralLower = plural.toLowerCase();
+        this.#irregularSingles[singleLower] = pluralLower;
+        this.#irregularPlurals[pluralLower] = singleLower;
+    }
+    /**
+     * Get the proper singular or plural form based on count.
+     * @param word Target word to pluralize or singularize.
+     * @param options Optional count and inclusive formatting.
+     * @returns The transformed word.
+     * @example
+     * pluralizer.pluralize('category', { count: 3 }); // "categories"
+     * pluralizer.pluralize('child', { count: 1, inclusive: true }); // "1 child"
+     */
+    pluralize(word, options = {}) {
+        const count = (0, utilities_1.normalizeNumber)(options?.count);
+        if (typeof count === 'number') {
+            const pluralized = count > 1 ? this.toPlural(word) : this.toSingular(word);
+            return options.inclusive ? `${count} ${pluralized}` : pluralized;
+        }
+        return this.toPlural(word);
+    }
+    /**
+     * Convert a word to its plural form.
+     * @param word Singular form of the word.
+     * @returns Plural form of the word.
+     * @example
+     * pluralizer.toPlural('analysis'); // "analyses"
+     */
+    toPlural(word) {
+        if (!word)
+            return '';
+        const lower = word.toLowerCase();
+        if (this.#isUncountable(word))
+            return word;
+        if (this.#irregularSingles[lower]) {
+            return this.#restoreCase(word, this.#irregularSingles[lower]);
+        }
+        return this.#restoreCase(word, this.#sanitizeWord(lower, this.#pluralRules));
+    }
+    /**
+     * Convert a word to its singular form.
+     * @param word Plural form of the word.
+     * @returns Singular form of the word.
+     * @example
+     * pluralizer.toSingular('geese'); // "goose"
+     */
+    toSingular(word) {
+        if (!word)
+            return '';
+        const lower = word.toLowerCase();
+        if (this.#isUncountable(word))
+            return word;
+        if (this.#irregularPlurals[lower]) {
+            return this.#restoreCase(word, this.#irregularPlurals[lower]);
+        }
+        return this.#restoreCase(word, this.#sanitizeWord(lower, this.#singularRules));
+    }
+    /**
+     * Check if a given word is plural.
+     * @param word Word to check.
+     * @returns True if the word is plural, otherwise false.
+     * @example
+     * pluralizer.isPlural('children'); // true
+     */
+    isPlural(word) {
+        const lower = word?.toLowerCase();
+        if (this.#isUncountable(word))
+            return false;
+        if (this.#irregularPlurals?.[lower])
+            return true;
+        return this.toSingular(lower) !== lower;
+    }
+    /**
+     * Check if a given word is singular.
+     * @param word Word to check.
+     * @returns True if the word is singular, otherwise false.
+     * @example
+     * pluralizer.isSingular('child'); // true
+     */
+    isSingular(word) {
+        const lower = word?.toLowerCase();
+        if (this.#isUncountable(word))
+            return false;
+        if (this.#irregularSingles?.[lower])
+            return true;
+        return this.toPlural(lower) !== lower;
+    }
+}
+exports.Pluralizer = Pluralizer;
+/**
+ * Default shared instance of {@link Pluralizer}.
+ *
+ * - _Use this when you don’t need multiple configurations._
+ * - _It comes preloaded with standard pluralization rules, irregular forms, and uncountable nouns._
+ *
+ * * Handles English word pluralization and singularization with support for irregular forms and uncountable nouns.
+ *
+ * - Provides methods to convert words between singular and plural forms, check if a word is plural or singular, and manage custom pluralization rules.
+ * - Supports adding custom pluralization and singularization rules, as well as uncountable nouns.
+ * - Automatically handles common irregular forms like "child" to "children"
+ * - Automatically loads common irregular forms and uncountable nouns.
+ * - Supports options for count-based pluralization, allowing for inclusive formatting.
+ * - This is useful for applications that need to handle natural language processing, such as chatbots, content management systems, or any text processing tasks that require accurate pluralization.
+ * @example
+ * import { pluralizer } from 'nhb-toolbox';
+ *
+ * pluralizer.pluralize('child'); // "children"
+ * pluralizer.toSingular('geese'); // "goose"
+ * pluralizer.isPlural('fish'); // false (uncountable)
+ */
+exports.pluralizer = new Pluralizer();