nhb-toolbox 4.23.20 → 4.23.23

package/CHANGELOG.md

@@ -0,0 +1,547 @@
+# Changelog
+
+<!-- markdownlint-disable-file MD024 -->
+
+All notable changes to the package will be documented here.
+
+---
+
+## [4.23.23] - 2025-10-26
+
+- **Fixed** *pluralization issue* with `'foot' --> 'feet'` for *format methods* in *converter classes*.
+- **Renamed** the export of `GENERAL_UNITS` (used in `Unit` class) and `CATEGORIZED_UNITS` (used in `Converter` classes) from `'nhb-toolbox/constants'`.
+
+## [4.23.21] - 2025-10-25
+
+- **Fixed** *return type* (now maintains *proper order* in the *tuple*) for `supportedUnits()` *converter method*.
+
+## [4.23.20] - 2025-10-25
+
+- **Fixed** *return type* for `supportedUnits()` *converter method*.
+- **Added** *new package subpath* for `Color` class: `'nhb-toolbox/color'`.
+
+## [4.23.11] - 2025-10-24
+
+- **Added** new base method `supportedUnits()` to get an *array/tuple of supported unit names*.
+- **Fixed** *precision issues* in several *conversion factors* across *converter classes*.
+- **Optimized** the `formatTo()` method for improved *performance*.
+
+## [4.23.10] - 2025-10-24
+
+- **Added** `metre` variants of units where needed in *converter classes*.
+- **Updated & Optimized** subpath exports for *converter classes* and *functions*.
+
+## [4.23.1] - 2025-10-24
+
+- **Exported** *all the converter classes* from the `'nhb-toolbox/converter'` sub-path too.
+
+## [4.23.0] - 2025-10-24
+
+- **Added** new *unit converter classes* and their *combined function* `Converter` (aliased `converter`).
+- **Introduced** new *utility types:* `Replace` `ReplaceFirst` and `$Record`.
+- **Exported** `pluralizer`, `verbalizer`, `httpStatus` and new `Converter` utility through different *package sub-paths*.
+
+## [4.21.14] - 2025-10-14
+
+- **Moved** `getTimeZoneName` method to `Chronos` *plugin system*, usable via `timeZonePlugin` and enhanced `timeZonePlugin`.
+
+## [4.21.10] - 2025-10-13
+
+- **Moved** `round` method to `Chronos` *plugin system*, usable via `roundPlugin`.
+- **Updated** *tsdoc* for some `Chronos` methods with *proper references.*
+
+## [4.21.4] - 2025-10-13
+
+- **Added** new type `$UTCOffset` and applied in corresponding `Chronos` methods.
+
+## [4.21.1] - 2025-10-13
+
+- **Updated** `TypeScript` compiler target from `ESNext` to `ES2023` for *more stable and predictable* `JavaScript` output.
+  - *Ensures consistent syntax across `TypeScript` versions.*
+
+## [4.21.0] - 2025-10-12
+
+- **Renamed** `RomanNumeralCap` type to `RomanCapital` and allow only strict `1-3999` and `RomanNumeral` type to `LooseRomanNumeral`.
+- **Removed** all *Roman numeral type helpers* and **recreated** a *strict* `RomanNumeral` with other *internal types*.
+
+## [4.20.92] - 2025-10-12
+
+- **Fixed** `RomanNumeralCap` type and **added** *@remarks* section.
+
+## [4.20.91] - 2025-10-12
+
+- **Updated** *tsdoc* for `fromNow()` `Chronos` method: modified *@remarks* section.
+
+## [4.20.90] - 2025-10-12
+
+- **Updated** `formatUnitWithPlural` utility: now returns *singular unit* for both `0` and `1`.
+- **Updated** `fromNow()` `Chronos` method: **fixed** issues when provided unit level value is `0`.
+
+## [4.20.89] - 2025-10-12
+
+- **Updated** behavior of `fromNow()` `Chronos` method: *excluded* `week` level and *included* `millisecond` for consistency. **Refactored** *internal logic*.
+
+## [4.20.88] - 2025-10-11
+
+- **Added** new utility `romanToInteger` and its *aliases* to convert *Roman numerals* to *Arabic numeric* representation and **updated** *input validation* for `convertToRomanNumerals`.
+- **Added** new *utility type* `Repeat` to repeat literal string, it works like `String.prototype.repeat()` but on *type-level*.
+
+## [4.20.87] - 2025-10-08
+
+- **Added** new *constants* and *types* related to *country information*, e.g. *full country name, code, ISO code* etc.
+
+## [4.20.86] - 2025-10-08
+
+- **Added** new *number utility* `getFactors` and its alias to calculate *factors* of a given number (*integer*).
+
+## [4.20.84] - 2025-10-07
+
+- **Added** new *number utility* `factorial` and its alias to calculate *factorial* of a given number (*integer*).
+
+## [4.20.80] - 2025-10-07
+
+### 🕧 Updates in Chronos
+
+- **Added** *overload signatures* for `isWeekend`, `isWorkDay` and `isBusinessHour` methods from `businessPlugin`.
+- **Fixed** issues with `isBusinessHour`: previously skipped *business start and end hours* in some cases.
+- **Added** new *utility type* `RangeTuple` to create *ranged tuple*.
+
+## [4.20.69-70] - 2025-10-07
+
+### 🕧 Updates in Chronos
+
+- **Added** *alias* for some methods available through *plugins*: `greet` for `getGreeting`, `getSeasonName` for `season`, `zodiac` for `getZodiacSign`
+- **Updated** behaviors of `isWeekend`, `isWorkDay` and `isBusinessHour` methods from `businessPlugin`, now accepts *indices of weekend day as tuple*.
+- **Updated** *internal states* for most of the plugins; **Renamed** some internal *types* and *exposed* some.
+
+## [4.20.66] - 2025-10-05
+
+- **Updated** `isObjectWithKeys`: now returns more *structured object shape* with provided keys.
+
+## [4.20.64] - 2025-10-05
+
+- **Updated** `extractObjectKeys`: now have *overload signatures*, returns a *tuple* or an *array of keys* (string literal).
+- **Updated** `extractObjectKeysDeep` no longer returns a *tuple*, instead now it returns an *array of keys* (string literal).
+
+## [4.20.60] - 2025-10-04
+
+- **Added** new *utility types* `ArrayToTuple<T[]>` and `Tuple<T>`.
+- **Updated** the *return type* of `extractObjectKeys`, now it returns *tuple of exact top-level keys*.
+- **Added** new utility `extractObjectKeysDeep` to extract *tuple* of *all nested keys*.
+- **Updated** *query string parser* utilities to receive *generic return type*.
+- **Added** new utility `literalQueryStringToObject` to parse *literal query string*.
+
+## [4.20.56] - 2025-10-02
+
+- **Updated** `isDeepEqual` utility: Now it accepts *arguments of unknown types*.
+
+## [4.20.54] - 2025-10-02
+
+- **Added** new utility `extractObjectKeys` to *extract keys of an object* with *proper typing*.
+- **Updated** `isObjectWithKeys`: *now properly typed*.
+
+## [4.20.52] - 2025-09-26
+
+- **Added** new `Chronos` *plugin* `greetingPlugin` for accessing `getGreeting` method in `Chronos` instances.
+- **Fixed** some *docs and internal type related issues* in `convertObjectValues` utility.
+
+## [4.20.50] - 2025-09-25
+
+- **Fixed** *return type* of `convertObjectValues` utility to correctly reflect the *transformed object structure* and `keys` option is now *more strict*: **only accepts keys which values are string and/or number** and **the array cannot be left empty**.
+- **Updated** *options type* for `with()` *static method* of `Chronos`.
+
+## [4.20.48] - 2025-09-22
+
+- **Wrapped** `ChronosMethods` type in `LooseLiteral` to allow passing *custom method names* without *type errors* when creating a custom [`Chronos Plugin`](https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/plugins#%EF%B8%8F-writing-your-own-custom-plugin).
+- **Updated** *error message* in `convert` method in `Currency` class.
+
+## [4.20.46] - 2025-09-22
+
+- `Chronos` class is now *exported via subpath* `'nhb-toolbox/chronos'`.
+
+## [4.20.44] - 2025-09-20
+
+- **Updated** type related issues in `Finder` class. Now it accepts *array of objects only*.
+
+## [4.20.40] - 2025-09-18
+
+- **Added** new **utility types**: `DeepPartialAll`, `Join`,`Split` along with `ValidArray`, `List` and *more*.
+
+## [4.20.32] - 2025-09-17
+
+- **Renamed** `isPastParticiple()` method to `isParticiple()` in `Verbalizer/verbalizer`.
+- **Optimized** *internal logic* for `toPast()` and `toParticiple()` methods in `Verbalizer/verbalizer`.
+- **Updated** all the *rules* for `Verbalizer/verbalizer`.
+
+## [4.20.30] - 2025-09-17
+
+- **Reduced** *unpacked size* by **removing** *tsdoc comments* from js (both `cjs` and `esm`) outputs.
+- **Updated** tsdoc for `Verbalizer/verbalizer`: **added** reference to documentation site.
+
+## [4.20.27] - 2025-09-16
+
+- **Fixed** *issues*: (**failed to convert already past/participle regular verbs**) with `toPast()` and `toParticiple()` methods in `Verbalizer/verbalizer`.
+
+## [4.20.26] - 2025-09-16
+
+- **Optimized** *internal logic* in both `Pluralizer` and `Verbalizer`.
+
+## [4.20.24] - 2025-09-15
+
+- **Added** new class `Verbalizer` and its shared instance `verbalizer` for verb form(s) manipulation.
+- **Updated** `Pluralizer/pluralizer`'s *internal mechanism* to *trim* input(s) and output(s).
+
+## [4.20.20] - 2025-09-04
+
+### 🎨 Updates for Stylog/LogStyler
+
+- **Reorganized** full `stylog` module.
+- **Renamed** `string()` method to `toANSI()` and `applyStyles()` to `toCSS()`.
+- **Added** new `ansi16()` method to apply `ANSI-16` color codes.
+- **Added** new `hsl()` and `bgHSL()` methods to colorize using custom `hsl` color values.
+- **Added** new `rgb()` and `bgRGB()` methods to colorize using custom `rgb` color values.
+- **Added** new `hex()` and `bgHex()` methods to colorize using custom `hex` color values.
+
+## [4.20.17] - 2025-09-02
+
+- **Added** *color support detector* for shell/console for `Stylog`/`LogStyler`.
+
+## [4.20.16] - 2025-09-01
+
+- **Added** new method `string()` in `LogStyler` (also in `Stylog`) and **made** `applyStyles()` method *public*.
+
+## [4.20.11] - 2025-09-01
+
+- **Added** new *Symbol* methods in `Chronos`: `Symbol.isConcatSpreadable` and `Symbol.match`.
+- **Fixed** string coercion issues with `toPrimitive` *Symbol* method in `Chronos`.
+- **Redesigned** `chronos` (`Chronos` wrapper) with *Proxy* and **updated** *TSDoc* for `chronos`.
+
+## [4.20.10] - 2025-09-01
+
+- **Added** new *utility types*: `RequireAtLeast`, `RequireExactly`, `RequireBetween`.
+- **Added** new *static* `Chronos` method `Chronos.with(options)` to create `Chronos` instance from specified *time component(s)*.
+
+## [4.20.1] - 2025-08-31
+
+- **Exported** *helper function and guards* used for `Stylog` and `LogStyler`: `hexToAnsi`, `isCSSColor`, `isBGColor`, `isTextStyle`.
+
+## [4.20.0] - 2025-08-31
+
+- **Added** new class `LogStyler` and its chainable `Stylog` utility to log styled input in the console.
+
+## [4.14.16] - 2025-08-30
+
+- **Updated** *types* related to *object flattening utilities*: `FlattenDotKey`, `DotValue`, `FlattenDotValue`, `FlattenLeafKey`, `LeafValue` and `FlattenLeafValue`.
+- **Made** all the (output) properties of `FlattenDotValue` and `FlattenLeafValue` *optional* to avoid issues.
+
+## [4.14.14] - 2025-08-27
+
+- **Updated** `DeepPartial` type to preserve optional properties of advanced types like `File`, `FileList`, `Chronos` etc.
+
+## [4.14.13] - 2025-08-24
+
+- **Updated** *return type* for `getColorForInitial` utility and **improved** *internal logic* and *error type* for color generator utilities.
+
+## [4.14.12] - 2025-08-23
+
+- **Updated** *error type* for `trimString` utility.
+
+## [4.14.10] - 2025-08-17
+
+- **Added** new utility `wordsToNumber` utility with alias: `convertWordsToNumber`, `convertWordToNumber` and `wordToNumber`
+
+## [4.14.9] - 2025-08-16
+
+- **Fixed** minor *internal issues* and **updated** JSDoc for `Pluralizer`.
+
+## [4.14.4-8] - 2025-08-13 - 2025-08-14
+
+- **Updated** internal logic of `convertStringCase` utility, added new `options` parameter.
+- **Fixed** multiple *internal issues* and JSDoc; Optimized internal logic.
+
+## [4.14.1-3] - 2025-08-11 - 2025-08-12
+
+- **Updated** JSDoc, dev dependencies and **fixed** minor issues.
+
+## [4.14.0] - 2025-08-11
+
+- **Added** new class `HttpStatus` for retrieving and managing HTTP status codes.
+
+## [4.13.11] - 2025-08-06
+
+- **Fixed** an issue with `getZodiacSign` method in `Chronos` that could not return correct *Vedic* sign.
+
+## [4.13.10] - 2025-08-02
+
+- **Updated** docs for `isPlural` and `isSingular` methods in `Pluralizer`.
+- **Updated** `getTimeZoneName()` and `getTimeZoneNameShort()` methods in `Chronos` to accept an optional UTC offset.
+- **Changed** return type of `getTimeZoneName()` to `string | UTCOffset` using `LooseLiteral<UTCOffset>`.
+
+## [4.13.9] - 2025-07-31
+
+- **Added** new `Chronos` method `getTimeZoneName()` to get full time-zone name.
+- **Added** new `Chronos` `timeZonePlugin` method `getTimeZoneNameShort()` to get abbreviated time-zone name.
+
+## [4.13.7] - 2025-07-23
+
+- **Updated** `isPlural` and `isSingular` methods in `Pluralizer` class to handle more cases.
+- **Ran full test** on `pluralizer` and fixed some known issues.
+
+## [4.13.3-6] - 2025-07-22
+
+- **Reordered** rules for `pluralizer` and fixed other issues.
+
+## [4.13.3] - 2025-07-22
+
+- **Updated** *pluralization/uncountable rules*, *case restoration method* and fixed other bugs in `pluralizer`.
+- **Updated** docs for `pluralizer`, `Pluralizer` and `formatUnitWithPlural`.
+
+## [4.13.1] - 2025-07-22
+
+- **Updated** docs in [README](README.md) for `pluralizer`.
+
+## [4.13.0] - 2025-07-22
+
+- **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/).
+
+## [4.12.70] - 2025-07-08
+
+- **Updated** numeric string related issues, specifically in `isNumber` & `isNumericString` and other helper functions.
+
+## [4.12.68-69] - 2025-07-05
+
+- **Updated Docs:** Added links to other npm packages.
+
+## [4.12.67] - 2025-07-03
+
+- **Fixed** some import alias typo.
+
+## [4.12.66] - 2025-07-02
+
+- **Updated** `convertArrayToString` function, now accepts array of objects and have 2 overload signatures with options.
+- **Updated** `RenameKeys` utility type by fixing some minor issues.
+
+## [4.12.64] - 2025-07-02
+
+- **Added** more utility types.
+- **Updated** JSDoc for some `Chronos` methods.
+
+## [4.12.61] - 2025-06-28
+
+- **Added** new utility type `Expand<T>` to resolve complex helper-wrapped types into readable structures, similar to `Prettify<T>` but only for special types to use with.
+- **Improved** type display for special cases where types were previously wrapped in multiple utility layers (e.g., `MergeAll`, `FlattenValue` etc.).
+
+## [4.12.60] - 2025-06-27
+
+- **Added** new array utilities:
+  - `sumByField`
+  - `averageByField`
+  - `sumFieldDifference`
+  - `groupAndSumByField`
+  - `groupAndAverageByField`
+
+- **Updated** `splitArrayByProperty` utility to allow nested field as dot-notation.
+
+## [4.12.50] - 2025-06-27
+
+- **Updated** return type definition and **enhanced** internal logic for `mergeObjects`, `mergeAndFlattenObjects`, `flattenObjectKeyValue`, `flattenObjectDotNotation`.
+- **Created** new utility types for the mentioned utilities.
+
+## [4.12.48] - 2025-06-24
+
+- **Fixed** typo for utility name `splitArrayByProperty`.
+- **Added** new utilities `getInstanceGetterNames` and `getStaticGetterNames`;
+- **Updated** `getClassDetails` and its return type.
+
+## [4.12.46] - 2025-06-24
+
+- **Added** new utilities ~~spitArrayByProperty~~ `splitArrayByProperty` and `deleteFields`.
+
+## [4.12.44] - 2025-06-23
+
+- **Updated** `getDatesInRange()` method in `Chronos`: fixed an option conflict.
+
+## [4.12.43] - 2025-06-22
+
+- **Updated** `getDatesInRange()` method in `Chronos`, now accepts both `day-names` and `day-index` array for `skipDays` and `onlyDays`.
+- **Updated** JSDoc for some functions and methods.
+
+## [4.12.42] - 2025-06-21
+
+- **Updated** JSDoc for some functions and methods.
+- **Updated and Optimized** `getDatesInRange()` method in `Chronos`. Added new option `onlyDays` to get dates for only the provided days.
+- **Allowed** `formatStrict()` method in `Chronos` to accept other string values [made less strict].
+
+## [4.12.41] - 2025-06-17
+
+- **Updated** `getDatesInRange()` and `getDatesForDay()` `Chronos` methods' options to change the date rounding behaviour.
+
+## [4.12.40] - 2025-06-17
+
+- **Added** new utility: `convertMinutesToTime` to convert minutes into clock-time (`H:mm`) format.
+- **Exposed** important `constants` to consumers via `'nhb-toolbox/constants'` import path.
+
+### 🕧 Updates for Chronos
+
+- **Added** new instance method `getDatesInRange()` to get dates in the range as ISO date string.
+- **Fixed** a bug by rounding the date to the start hour of the day and **updated** internal logic in static `getDatesForDay()` method.
+
+## [4.12.36] - 2025-06-13
+
+- **Added** new `convertSync()` method in `Currency` class to convert currency without network request.
+
+## [4.12.34-35] - 2025-06-12
+
+- **Updated** `format()` and `convert()` methods in `Currency` class:
+  - `format()` method now accepts `CurrencyCode` as optional second parameter
+  - `convert()` method now returns a new `Currency` instance.
+
+## [4.12.33] - 2025-06-11
+
+- **Trim** input string for `numberToWordsOrdinal` utility.
+- **Preserve** `File`, `FileList` and other file related object(s) when processing nested object(s) using `sanitizeData`.
+
+## [4.12.32] - 2025-06-11
+
+- **Fixed** a bug in `sanitizeData` and `createFormData` where key selections did not allow to choose keys with null/undefined value(s).
+- **Fixed** a bug in `createFormData` where values of nested object(s) incorrectly converted to lowercase. Process `date-like object(s)` more efficiently in both utilities.
+
+## [4.12.31] - 2025-06-10
+
+- **Added** new utility to convert number or numeric string to ordinal word.
+- **Updated** JSDoc for some types.
+- **Upgraded** TypeScript version to `5.8.3` and other dev-dependencies.
+
+## [4.12.28-30] - 2025-06-06
+
+- **Resolved** a compile-time `not-assignable` error that occurred when optional properties were present in parameters of `sanitizeData`, `createFormData`, and other utility functions.
+- **Added** additional utility types and integrated them into various parts of the package to improve type safety and maintainability.
+
+## [4.12.27] - 2025-06-02
+
+- **Updated** [README](README.md).
+- **Added** new utility types, can be imported from `'nhb-toolbox/utils/types'`.
+
+## [4.12.25-26] - 2025-06-02
+
+- **Updated** JSDoc for some `Chronos` methods and exposed `INTERNALS` Symbol
+
+## [4.12.24] - 2025-06-01
+
+### 🕧 Updates for Chronos
+
+- **Reduced** bloat by moving *rarely used* `Chronos` methods to plugin system.
+- **Changed** plugin import paths as `import { somePlugin } from nhb-toolbox/plugins/somePlugin` format so the users can assume the path easily.
+- **Updated** parameter type for `isBusinessHour` method: instead of multiple parameters can accept one options object now.
+
+## [4.12.23] - 2025-06-01
+
+### 🕧 Updates for Chronos
+
+- All *plugin* imports now use statement like `import { somePlugin } from 'nhb-toolbox/plugins/plugin-path';`
+- **Updated** `getZodiacSign` method: includes 2 presets `western` and `vedic` with aliases `tropical` and `sidereal`.
+- **Fixed** issues in `getZodiacSign` method which previously could not parse some date/month range.
+
+## [4.12.21-beta.2] - 2025-05-31
+
+- **Updated** `types.mjs` script for updating the exports fields for plugins in `package.json`.
+
+## [4.12.21-beta.1] - 2025-05-31
+
+- **Updated** `getZodiacSign` method: includes 2 presets `western` and `vedic`.
+- **Fixed** issues in `getZodiacSign` method.
+- Experimenting with exporting each Chronos plugin as separate module from the respective locations.
+
+## [4.12.20] - 2025-05-31
+
+### 🕧 Released Plugin System for Chronos
+
+- Plugin injection system for Chronos is now fully functional.
+
+## [4.12.13-beta.1] - 2025-05-31
+
+- **Created** more plugins for resource heavy methods of `Chronos`.
+
+## [4.12.13-alpha.2] - 2025-05-30
+
+- **Solved** experimental plugin export/import issues.
+
+## [4.12.13-alpha.1] - 2025-05-30
+
+### 🕧 Experimenting with Plugin System for Chronos
+
+- **Introduced** plugin injection in `Chronos` class. Started with `season` method. Will make convert more methods if this is successful after publishing.
+
+## [4.12.12] - 2025-05-30
+
+### 🕧 Updates in Chronos
+
+- **Added** new method `season` to get the name of the season for current Chronos instance. It has configurable options.
+- All `Chronos` methods that use `#format` method internally now accepts escape tokens and new token `ZZ` is introduced to include timezone offset (or Z for UTC time) in the formatted date string.
+- **Updated** some type names such as `Hours` ➡️ `ClockHour`, `Minutes` ➡️ `ClockMinute`, `Time` ➡️ `ClockTIme` etc. But the core definitions remain the same.
+
+## [4.12.10] - 2025-05-30
+
+### 🕧 New Chronos Methods
+
+- **Added** 2 new instance methods in `Chronos`, `day` and `monthName` to get day and month names respectively.
+
+### ℹ️ [README](README.md)
+
+- **Added** `Signature Utilities` section in `README.md`
+
+## [4.12.8] - 2025-05-29
+
+### Types
+
+- **Added** new types `Enumerate` and `NumberRange` to generate number literals like `0 | 1 | 2 | ... | 998`.
+- **Implemented** both types in few cases where a return type is number and limited to a range, especially in color and number related functions and `Color` & `Chronos` classes.
+
+### Method Changed in Chronos
+
+- `isoWeekday` is now `isoWeekDay`
+- Some method logic changed internally
+
+---
+
+## [4.12.7] - 2025-05-28
+
+### Docs
+
+- ➕ Introduced `CHANGELOG.md`
+
+## [4.12.6] - 2025-05-28
+
+### Added
+
+- ➕ `Chronos.getDatesFromDay()` — a new static method to retrieve all matching dates for a given day of the week.
+
+### Fixed
+
+- 🐛 Minor internal issues and stability improvements.
+
+---
+
+## [4.12.0] - 2025-05-28
+
+### ⚠️ Breaking Changes
+
+- ⚠️ **Deprecation Notice**: All versions below `4.12.0` are now marked as deprecated
+- ♻️ **Build System**: Switched from `tsup` back to `tsc` for building the library to resolve compatibility and output issues.
+
+### Fixed
+
+- 🛠️ Resolved ESM import issues by adding missing `.js` extensions in internal paths.
+- 🧩 Improved module resolution in strict ESM-only environments.
+
+### Improved
+
+- 🌲 Full **tree-shaking support** for ESM builds (CommonJS remains unaffected).
+  - 🌲 *From the beginning the library was tree-shakable* but now it's **properly tree-shakable** for ESM builds.
+  - 📦 CommonJS (`cjs`) build remains unaffected and stable.

package/dist/cjs/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STATUS_CODES = exports.HTTP_STATUS_CODES = exports.HTTP_STATUS = exports.HTTP_CODES = exports.COUNTRIES = exports.UNITS = exports.LOWERCASED_WORDS = exports.LOCALE_CODES = exports.FRANKFURTER_CURRENCIES = exports.CURRENCY_LOCALES = exports.CURRENCY_CODES = exports.CSS_COLORS = exports.NUMBER_COLOR_PALETTE = exports.ALPHABET_COLOR_PALETTE = exports.WESTERN_SEASONS = exports.US_ACADEMIC_SEASONS = exports.SEASON_PRESETS = exports.PHILIPPINES_SEASONS = exports.JAPAN_SEASONS = exports.INDIA_VEDIC_SEASONS = exports.INDIA_TAMIL_SEASONS = exports.INDIA_IMD_SEASONS = exports.ETHIOPIA_SEASONS = exports.BANGLADESH_SEASONS = exports.AUSTRALIA_SEASONS = exports.WESTERN_ZODIAC_SIGNS = exports.WEEK_DAYS = exports.VEDIC_ZODIAC_SIGNS = exports.TIME_ZONES = exports.TIME_ZONE_LABELS = exports.MONTHS = void 0;
+exports.STATUS_CODES = exports.HTTP_STATUS_CODES = exports.HTTP_STATUS = exports.HTTP_CODES = exports.COUNTRIES = exports.CATEGORIZED_UNITS = exports.LOWERCASED_WORDS = exports.LOCALE_CODES = exports.GENERAL_UNITS = exports.FRANKFURTER_CURRENCIES = exports.CURRENCY_LOCALES = exports.CURRENCY_CODES = exports.CSS_COLORS = exports.NUMBER_COLOR_PALETTE = exports.ALPHABET_COLOR_PALETTE = exports.WESTERN_SEASONS = exports.US_ACADEMIC_SEASONS = exports.SEASON_PRESETS = exports.PHILIPPINES_SEASONS = exports.JAPAN_SEASONS = exports.INDIA_VEDIC_SEASONS = exports.INDIA_TAMIL_SEASONS = exports.INDIA_IMD_SEASONS = exports.ETHIOPIA_SEASONS = exports.BANGLADESH_SEASONS = exports.AUSTRALIA_SEASONS = exports.WESTERN_ZODIAC_SIGNS = exports.WEEK_DAYS = exports.VEDIC_ZODIAC_SIGNS = exports.TIME_ZONES = exports.TIME_ZONE_LABELS = exports.MONTHS = void 0;
 var constants_1 = require("./date/constants");
 Object.defineProperty(exports, "MONTHS", { enumerable: true, get: function () { return constants_1.MONTHS; } });
 Object.defineProperty(exports, "TIME_ZONE_LABELS", { enumerable: true, get: function () { return constants_1.TIME_ZONE_LABELS; } });
@@ -29,11 +29,12 @@ var constants_3 = require("./number/constants");
 Object.defineProperty(exports, "CURRENCY_CODES", { enumerable: true, get: function () { return constants_3.CURRENCY_CODES; } });
 Object.defineProperty(exports, "CURRENCY_LOCALES", { enumerable: true, get: function () { return constants_3.CURRENCY_LOCALES; } });
 Object.defineProperty(exports, "FRANKFURTER_CURRENCIES", { enumerable: true, get: function () { return constants_3.SUPPORTED_CURRENCIES; } });
+Object.defineProperty(exports, "GENERAL_UNITS", { enumerable: true, get: function () { return constants_3.UNITS; } });
 Object.defineProperty(exports, "LOCALE_CODES", { enumerable: true, get: function () { return constants_3.LOCALE_CODES; } });
 var constants_4 = require("./string/constants");
 Object.defineProperty(exports, "LOWERCASED_WORDS", { enumerable: true, get: function () { return constants_4.LOWERCASE; } });
 var constants_5 = require("./converter/constants");
-Object.defineProperty(exports, "UNITS", { enumerable: true, get: function () { return constants_5.UNITS; } });
+Object.defineProperty(exports, "CATEGORIZED_UNITS", { enumerable: true, get: function () { return constants_5.UNITS; } });
 var countries_1 = require("./object/countries");
 Object.defineProperty(exports, "COUNTRIES", { enumerable: true, get: function () { return countries_1.COUNTRIES; } });
 var constants_6 = require("./http-status/constants");

package/dist/cjs/converter/base.js

@@ -13,7 +13,10 @@ class $BaseConverter {
         const abs = Math.abs(value ?? this.value);
         const u = unit ?? this.unit;
         const pluralized = abs <= 1 ? u
-            : u ? `${u}s`
+            : u ?
+                u?.endsWith('foot') ?
+                    'feet'
+                    : `${u}s`
                 : '';
         return `${abs} ${pluralized}`.trim();
     }

package/dist/dts/constants.d.ts

@@ -2,8 +2,8 @@ export { MONTHS, TIME_ZONE_LABELS, TIME_ZONES, VEDIC_ZODIAC_SIGNS, DAYS as WEEK_
 export { AUSTRALIA_SEASONS, BANGLADESH_SEASONS, ETHIOPIA_SEASONS, INDIA_IMD_SEASONS, INDIA_TAMIL_SEASONS, INDIA_VEDIC_SEASONS, JAPAN_SEASONS, PHILIPPINES_SEASONS, SEASON_PRESETS, US_ACADEMIC_SEASONS, DEFAULT_SEASONS as WESTERN_SEASONS, } from './date/seasons';
 export { ALPHABET_COLOR_PALETTE, NUMBER_COLOR_PALETTE } from './colors/constants';
 export { CSS_COLORS } from './colors/css-colors';
-export { CURRENCY_CODES, CURRENCY_LOCALES, SUPPORTED_CURRENCIES as FRANKFURTER_CURRENCIES, LOCALE_CODES, } from './number/constants';
+export { CURRENCY_CODES, CURRENCY_LOCALES, SUPPORTED_CURRENCIES as FRANKFURTER_CURRENCIES, UNITS as GENERAL_UNITS, LOCALE_CODES, } from './number/constants';
 export { LOWERCASE as LOWERCASED_WORDS } from './string/constants';
-export { UNITS } from './converter/constants';
+export { UNITS as CATEGORIZED_UNITS } from './converter/constants';
 export { COUNTRIES } from './object/countries';
 export { HTTP_STATUS_CODES as HTTP_CODES, HTTP_STATUS_CODES as HTTP_STATUS, HTTP_STATUS_CODES, HTTP_STATUS_CODES as STATUS_CODES, } from './http-status/constants';

package/dist/dts/converter/base.d.ts

@@ -1,6 +1,5 @@
 import type { Numeric } from '../types/index';
-import type { Tuple } from '../utils/types';
-import type { $Unit, Category, CategoryUnits, FormatToOptions, Units } from './types';
+import type { $Unit, Category, FormatToOptions, Units, UnitsTuple } from './types';
 /**
  * @description Base class providing common mathematical and formatting utilities
  * for all unit converters (time, length, data, temperature, etc.).
@@ -49,7 +48,6 @@ export declare class $BaseConverter<Unit extends $Unit> {
      * @remarks
      * - This method is automatically called when the instance is used in a string context.
      * - For complex and versatile pluralization, please refer to {@link https://toolbox.nazmul-nhb.dev/docs/utilities/string/pluralizer pluralizer} or {@link https://toolbox.nazmul-nhb.dev/docs/classes/Pluralizer Pluralizer Class} instead.
-
      */
     toString(): string;
     /**
@@ -65,9 +63,7 @@ export declare class $BaseConverter<Unit extends $Unit> {
      * @returns JSON string of `{ value, unit }`.
      */
     toJSON(): string;
-    /**
-     * @instance Returns a new instance with the absolute value.
-     */
+    /** @instance Returns a new instance with the absolute value. */
     abs(): this;
     /**
      * @instance Adds a numeric value (same unit assumed).
@@ -95,11 +91,11 @@ export declare class $BaseConverter<Unit extends $Unit> {
      * @returns A new instance with rounded value.
      */
     round(decimals?: number): this;
-    /** * @instance Returns whether this value is greater than another numeric value. */
+    /** @instance Returns whether this value is greater than another numeric value. */
     gt(n: Numeric): boolean;
-    /** * @instance Returns whether this value is less than another numeric value. */
+    /** @instance Returns whether this value is less than another numeric value. */
     lt(n: Numeric): boolean;
-    /** * @instance Returns whether this value equals another numeric value. */
+    /** @instance Returns whether this value equals another numeric value. */
     eq(n: Numeric): boolean;
     /**
      * @instance Returns a human-friendly formatted string with fixed decimals (if the value is fraction).
@@ -119,5 +115,5 @@ export declare class $BaseConverter<Unit extends $Unit> {
      * @param category Category to filter units by.
      * @returns Tuple of supported units for the specified category.
      */
-    supportedUnits<Cat extends Category>(category: Cat): Tuple<CategoryUnits<Cat>>;
+    supportedUnits<Cat extends Category>(category: Cat): UnitsTuple<Cat>;
 }

package/dist/dts/converter/types.d.ts

@@ -1,4 +1,4 @@
-import type { LooseLiteral } from '../utils/types';
+import type { LooseLiteral, Mutable } from '../utils/types';
 import type { $Area } from './area';
 import type { $BaseConverter } from './base';
 import type { UNITS } from './constants';
@@ -9,7 +9,7 @@ import type { $Temperature } from './temp';
 import type { $Time } from './time';
 import type { $Volume } from './volume';
 /** - Type for Record of Units */
-type UnitsRecord = typeof UNITS;
+export type UnitsRecord = typeof UNITS;
 /** * Category of units supported by the converter. */
 export type Category = keyof UnitsRecord;
 /** * Map of unit categories to their respective units. */
@@ -20,6 +20,8 @@ export type UnitMap = {
 export type $Unit = LooseLiteral<UnitMap[Category]>;
 /** * Type for array of all Units */
 export type Units = Array<UnitMap[Category]>;
+/** * Tuple type for Units in a specific Category */
+export type UnitsTuple<Cat extends Category> = Mutable<UnitsRecord[Cat]>;
 /** * Infer the category of a given unit type `U`. */
 export type InferCategory<U extends $Unit> = {
     [K in Category]: U extends UnitMap[K] ? K : never;
@@ -49,4 +51,3 @@ export type $TempUnit = UnitMap['temp'];
 export type $TimeUnit = UnitMap['time'];
 /** Union type for all the volume units */
 export type $VolumeUnit = UnitMap['volume'];
-export {};

package/dist/esm/constants.js

@@ -2,8 +2,8 @@ export { MONTHS, TIME_ZONE_LABELS, TIME_ZONES, VEDIC_ZODIAC_SIGNS, DAYS as WEEK_
 export { AUSTRALIA_SEASONS, BANGLADESH_SEASONS, ETHIOPIA_SEASONS, INDIA_IMD_SEASONS, INDIA_TAMIL_SEASONS, INDIA_VEDIC_SEASONS, JAPAN_SEASONS, PHILIPPINES_SEASONS, SEASON_PRESETS, US_ACADEMIC_SEASONS, DEFAULT_SEASONS as WESTERN_SEASONS, } from './date/seasons.js';
 export { ALPHABET_COLOR_PALETTE, NUMBER_COLOR_PALETTE } from './colors/constants.js';
 export { CSS_COLORS } from './colors/css-colors.js';
-export { CURRENCY_CODES, CURRENCY_LOCALES, SUPPORTED_CURRENCIES as FRANKFURTER_CURRENCIES, LOCALE_CODES, } from './number/constants.js';
+export { CURRENCY_CODES, CURRENCY_LOCALES, SUPPORTED_CURRENCIES as FRANKFURTER_CURRENCIES, UNITS as GENERAL_UNITS, LOCALE_CODES, } from './number/constants.js';
 export { LOWERCASE as LOWERCASED_WORDS } from './string/constants.js';
-export { UNITS } from './converter/constants.js';
+export { UNITS as CATEGORIZED_UNITS } from './converter/constants.js';
 export { COUNTRIES } from './object/countries.js';
 export { HTTP_STATUS_CODES as HTTP_CODES, HTTP_STATUS_CODES as HTTP_STATUS, HTTP_STATUS_CODES, HTTP_STATUS_CODES as STATUS_CODES, } from './http-status/constants.js';

package/dist/esm/converter/base.js

@@ -10,7 +10,10 @@ export class $BaseConverter {
         const abs = Math.abs(value ?? this.value);
         const u = unit ?? this.unit;
         const pluralized = abs <= 1 ? u
-            : u ? `${u}s`
+            : u ?
+                u?.endsWith('foot') ?
+                    'feet'
+                    : `${u}s`
                 : '';
         return `${abs} ${pluralized}`.trim();
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.23.20",
+  "version": "4.23.23",
   "description": "A versatile collection of smart, efficient, and reusable utility functions, classes and types for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -13,6 +13,7 @@
     "dist",
     "LICENSE",
     "README.md",
+    "CHANGELOG.md",
     "package.json"
   ],
   "repository": {