nhb-toolbox 4.23.21 → 4.23.24

package/CHANGELOG.md

@@ -6,6 +6,15 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.23.24] - 2025-10-26
+
+- **Fixed** *pluralization issue* with ***suffixed*** `'-foot' --> '-feet'` for *format methods* in *converter classes*.
+
+## [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*.
@@ -13,7 +22,7 @@ All notable changes to the package will be documented here.
 ## [4.23.20] - 2025-10-25
 
 - **Fixed** *return type* for `supportedUnits()` *converter method*.
-- **Added** *new package subpath* for `Color` class: `nhb-toolbox/color`.
+- **Added** *new package subpath* for `Color` class: `'nhb-toolbox/color'`.
 
 ## [4.23.11] - 2025-10-24
 
@@ -28,13 +37,13 @@ All notable changes to the package will be documented here.
 
 ## [4.23.1] - 2025-10-24
 
-- **Exported** *all the converter classes* from the `nhb-toolbox/converter` sub-path too.
+- **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 *package sub-paths*.
+- **Exported** `pluralizer`, `verbalizer`, `httpStatus` and new `Converter` utility through different *package sub-paths*.
 
 ## [4.21.14] - 2025-10-14
 

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') ?
+                    u.replace(/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

@@ -48,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;
     /**
@@ -64,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).
@@ -90,15 +87,15 @@ export declare class $BaseConverter<Unit extends $Unit> {
     divide(n: Numeric): this;
     /**
      * @instance Rounds to given decimal places.
-     * @param decimals Number of decimal places to round.
+     * @param decimals Number of decimal places to round. Default is `0`.
      * @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).

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

@@ -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. */
@@ -51,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') ?
+                    u.replace(/foot$/, 'feet')
+                    : `${u}s`
                 : '';
         return `${abs} ${pluralized}`.trim();
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.23.21",
+  "version": "4.23.24",
   "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",