nhb-toolbox 4.25.1 → 4.25.10

package/CHANGELOG.md

@@ -6,6 +6,15 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.25.10] - 2025-11-06
+
+- **Fixed** *pluralization issues* in the methods of `Converter` classes.
+
+## [4.25.1-4] - 2025-11-05
+
+- **Added** *alias* for `Chronos` *static method* `use`: `register`.
+- **Updated** *tsdoc* for `Chronos` *static methods* `use` and `register`.
+
 ## [4.25.0] - 2025-11-03
 
 - **Added** new `Chronos` method `durationString(...)` and **Fixed** issues with internal *duration normalization logic*.

package/README.md

@@ -39,6 +39,7 @@
     <img src="https://img.shields.io/github/issues-pr/nazmul-nhb/nhb-toolbox?style=flat&label=PRs&logo=github" alt="Pull Requests" />
   </a>
 
+  <!-- License Info -->
   <a href="https://www.npmjs.com/package/nhb-toolbox" aria-label="License">
     <img src="https://img.shields.io/npm/l/nhb-toolbox.svg?label=LICENSE&style=flat&color=orange&logo=open-source-initiative" alt="License" />
   </a>
@@ -213,7 +214,7 @@ See [Changelog](CHANGELOG.md) for recent updates.
 
 **`Chronos`** - The ultimate date/time manipulation class with 100+ methods for parsing, formatting, calculating, and comparing dates. Handles all edge cases and timezones safely.
 
-> 🧩 **Note**: Some methods in `Chronos` are available only through the [plugin system](https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/plugins#-official-plugins). This modular design ensures the core bundle stays lightweight — plugins are loaded only when needed, reducing unnecessary code in your final build.
+> 🧩 **Note**: Some methods in `Chronos` are available only through the [**plugin system**](https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/plugins#-official-plugins). This modular design ensures the core bundle stays lightweight — plugins are loaded only when needed, reducing unnecessary code in your final build.
 
 ```typescript
 new Chronos('2025-01-01').addDays(3).format('YYYY-MM-DD'); // "2025-01-04"

package/dist/cjs/converter/base.js

@@ -12,13 +12,28 @@ class $BaseConverter {
     $withPluralUnit(value, unit) {
         const abs = Math.abs(value ?? this.value);
         const u = unit ?? this.unit;
-        const pluralized = abs <= 1 ? u
-            : u ?
-                u?.endsWith('foot') ?
-                    u.replace(/foot$/, 'feet')
-                    : `${u}s`
-                : '';
-        return `${abs} ${pluralized}`.trim();
+        if (!u)
+            return String(abs);
+        let pluralized;
+        if (abs === 1) {
+            pluralized = u;
+        }
+        else if (constants_1.IRREGULAR_PLURALS?.[u]) {
+            pluralized = constants_1.IRREGULAR_PLURALS[u];
+        }
+        else if (constants_1.INVARIANT_UNITS.has(u)) {
+            pluralized = u;
+        }
+        else if (u.endsWith('foot')) {
+            pluralized = u.replace(/foot$/, 'feet');
+        }
+        else if (u.endsWith('inch')) {
+            pluralized = u.replace(/inch$/, 'inches');
+        }
+        else {
+            pluralized = constants_1.Y_TO_IES.has(u) ? u.replace(/y$/, 'ies') : `${u}s`;
+        }
+        return `${abs} ${pluralized}`;
     }
     $round(value, decimals = 2) {
         const factor = 10 ** decimals;

package/dist/cjs/converter/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UNITS = void 0;
+exports.Y_TO_IES = exports.INVARIANT_UNITS = exports.IRREGULAR_PLURALS = exports.UNITS = void 0;
 exports.UNITS = Object.freeze({
     time: [
         'nanosecond',
@@ -100,3 +100,13 @@ exports.UNITS = Object.freeze({
         'long-ton',
     ],
 });
+exports.IRREGULAR_PLURALS = {
+    millennium: 'millennia',
+    century: 'centuries',
+};
+exports.INVARIANT_UNITS = new Set([
+    'celsius',
+    'fahrenheit',
+    'kelvin',
+]);
+exports.Y_TO_IES = new Set(['century']);

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

@@ -8,3 +8,6 @@ export declare const UNITS: Readonly<{
     readonly volume: readonly ["cubic-millimeter", "cubic-centimeter", "cubic-meter", "cubic-kilometer", "cubic-millimetre", "cubic-centimetre", "cubic-metre", "cubic-kilometre", "cubic-inch", "cubic-foot", "cubic-yard", "liter", "litre", "milliliter", "millilitre", "gallon", "quart", "pint", "cup", "tablespoon", "teaspoon"];
     readonly mass: readonly ["microgram", "milligram", "gram", "kilogram", "tonne", "ounce", "pound", "stone", "short-ton", "long-ton"];
 }>;
+export declare const IRREGULAR_PLURALS: Record<string, string>;
+export declare const INVARIANT_UNITS: Set<string>;
+export declare const Y_TO_IES: Set<string>;

package/dist/dts/date/Chronos.d.ts

@@ -771,7 +771,7 @@ export declare class Chronos {
      * @param plugin The plugin to inject.
      *
      * @remarks
-     * - Using {@link use} method on in `React` projects may trigger *linter error* like `"React Hooks must be called in a React function component or a custom React Hook function."`
+     * - Using this (`use`) method in `React` projects may trigger *linter error* like `"React Hooks must be called in a React function component or a custom React Hook function."`
      * 	- To prevent this incorrect *linter error* in `React` projects, prefer using {@link register} method (alias `use` method).
      *
      * - **NOTE:** *Once a plugin is injected, all the registered methods for that plugin will be available for the whole project.*
@@ -784,7 +784,7 @@ export declare class Chronos {
      *
      * @remarks
      * - This is just an alias for {@link use} method.
-     * - Using {@link use} method on in `React` projects may trigger *linter error* like `"React Hooks must be called in a React function component or a custom React Hook function."`
+     * - Using {@link use} method in `React` projects may trigger *linter error* like `"React Hooks must be called in a React function component or a custom React Hook function."`
      * 	- To prevent this incorrect *linter error* in `React` projects, prefer using this (`register`) method over {@link use} method.
      *
      * - **NOTE:** *Once a plugin is injected, all the registered methods for that plugin will be available for the whole project.*

package/dist/dts/date/chronos-statics.d.ts

@@ -88,7 +88,7 @@ export interface ChronosStatics {
      * @param plugin The plugin to inject.
      *
      * @remarks
-     * - Using {@link use} method on in `React` projects may trigger *linter error* like `"React Hooks must be called in a React function component or a custom React Hook function."`
+     * - Using this (`use`) method in `React` projects may trigger *linter error* like `"React Hooks must be called in a React function component or a custom React Hook function."`
      * 	- To prevent this incorrect *linter error* in `React` projects, prefer using {@link register} method (alias `use` method).
      *
      * - **NOTE:** *Once a plugin is injected, all the registered methods for that plugin will be available for the whole project.*
@@ -101,7 +101,7 @@ export interface ChronosStatics {
      *
      * @remarks
      * - This is just an alias for {@link use} method.
-     * - Using {@link use} method on in `React` projects may trigger *linter error* like `"React Hooks must be called in a React function component or a custom React Hook function."`
+     * - Using {@link use} method in `React` projects may trigger *linter error* like `"React Hooks must be called in a React function component or a custom React Hook function."`
      * 	- To prevent this incorrect *linter error* in `React` projects, prefer using this (`register`) method over {@link use} method.
      *
      * - **NOTE:** *Once a plugin is injected, all the registered methods for that plugin will be available for the whole project.*

package/dist/esm/converter/base.js

@@ -1,4 +1,4 @@
-import { UNITS } from './constants.js';
+import { INVARIANT_UNITS, IRREGULAR_PLURALS, UNITS, Y_TO_IES } from './constants.js';
 export class $BaseConverter {
     value;
     unit;
@@ -9,13 +9,28 @@ export class $BaseConverter {
     $withPluralUnit(value, unit) {
         const abs = Math.abs(value ?? this.value);
         const u = unit ?? this.unit;
-        const pluralized = abs <= 1 ? u
-            : u ?
-                u?.endsWith('foot') ?
-                    u.replace(/foot$/, 'feet')
-                    : `${u}s`
-                : '';
-        return `${abs} ${pluralized}`.trim();
+        if (!u)
+            return String(abs);
+        let pluralized;
+        if (abs === 1) {
+            pluralized = u;
+        }
+        else if (IRREGULAR_PLURALS?.[u]) {
+            pluralized = IRREGULAR_PLURALS[u];
+        }
+        else if (INVARIANT_UNITS.has(u)) {
+            pluralized = u;
+        }
+        else if (u.endsWith('foot')) {
+            pluralized = u.replace(/foot$/, 'feet');
+        }
+        else if (u.endsWith('inch')) {
+            pluralized = u.replace(/inch$/, 'inches');
+        }
+        else {
+            pluralized = Y_TO_IES.has(u) ? u.replace(/y$/, 'ies') : `${u}s`;
+        }
+        return `${abs} ${pluralized}`;
     }
     $round(value, decimals = 2) {
         const factor = 10 ** decimals;

package/dist/esm/converter/constants.js

@@ -97,3 +97,13 @@ export const UNITS = Object.freeze({
         'long-ton',
     ],
 });
+export const IRREGULAR_PLURALS = {
+    millennium: 'millennia',
+    century: 'centuries',
+};
+export const INVARIANT_UNITS = new Set([
+    'celsius',
+    'fahrenheit',
+    'kelvin',
+]);
+export const Y_TO_IES = new Set(['century']);

package/package.json

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