nhb-toolbox 4.23.23 → 4.23.25

package/CHANGELOG.md

@@ -6,10 +6,18 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.23.25] - 2025-10-27
+
+- **Updated** tsdoc for `Chronos` *constructor* and **optimized** *internal logic* for some *checker methods*.
+
+## [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'`.
+- **Exported** `GENERAL_UNITS` (used in `Unit` class) and `CATEGORIZED_UNITS` (used in `Converter` classes) from `'nhb-toolbox/constants'`.
 
 ## [4.23.21] - 2025-10-25
 

package/dist/cjs/converter/base.js

@@ -15,7 +15,7 @@ class $BaseConverter {
         const pluralized = abs <= 1 ? u
             : u ?
                 u?.endsWith('foot') ?
-                    'feet'
+                    u.replace(/foot$/, 'feet')
                     : `${u}s`
                 : '';
         return `${abs} ${pluralized}`.trim();

package/dist/cjs/date/Chronos.js

@@ -393,18 +393,18 @@ class Chronos {
     }
     isSame(other, unit, weekStartsOn = 0) {
         const time = other instanceof _a ? other : new _a(other);
-        return (this.startOf(unit, weekStartsOn).toDate().getTime() ===
-            time.startOf(unit, weekStartsOn).toDate().getTime());
+        return (this.startOf(unit, weekStartsOn).timestamp ===
+            time.startOf(unit, weekStartsOn).timestamp);
     }
     isBefore(other, unit, weekStartsOn = 0) {
         const time = other instanceof _a ? other : new _a(other);
-        return (this.startOf(unit, weekStartsOn).toDate().getTime() <
-            time.startOf(unit, weekStartsOn).toDate().getTime());
+        return (this.startOf(unit, weekStartsOn).timestamp <
+            time.startOf(unit, weekStartsOn).timestamp);
     }
     isAfter(other, unit, weekStartsOn = 0) {
         const time = other instanceof _a ? other : new _a(other);
-        return (this.startOf(unit, weekStartsOn).toDate().getTime() >
-            time.startOf(unit, weekStartsOn).toDate().getTime());
+        return (this.startOf(unit, weekStartsOn).timestamp >
+            time.startOf(unit, weekStartsOn).timestamp);
     }
     isSameOrBefore(other, unit, weekStartsOn = 0) {
         return (this.isSame(other, unit, weekStartsOn) || this.isBefore(other, unit, weekStartsOn));

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

@@ -8,7 +8,7 @@ import { $Time } from './time';
 import type { $Unit, Converted } from './types';
 import { $Volume } from './volume';
 /**
- * @function Converter : This is a unit converter function that creates instances of specific converter classes based on the provided unit.
+ * @function Converter - This is a unit converter function that creates instances of specific converter class based on the provided unit.
  *
  * @description Converts values between compatible units (time, length, data, temperature, mass, area, volume).
  * The returned instance exposes only methods relevant to the provided unit type.

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

@@ -87,7 +87,7 @@ 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;

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

@@ -31,9 +31,9 @@ export declare class Chronos {
     /** Use `readonly and/or private` methods outside `Chronos`. Purpose: Plugin creation. */
     protected static [INTERNALS]: ChronosInternals;
     /**
-     * * `Chronos` date/time in Native JS `Date` format.
+     * * `Chronos` date/time as Native JS `Date` object.
      *
-     * - **NOTE**: It is **HIGHLY** advised *not to rely* on this public property to access native JS `Date`. It's not reliable when timezone and/or UTC related operations are performed. If you really need to use native `Date`, use `toDate` method.  THis property is purely for developer convenience and sugar.
+     * - **NOTE**: It is **HIGHLY** advised *not to rely* on this public property to access native JS `Date`. It's not reliable when timezone and/or UTC related operations are performed. If you really need to use native `Date`, use `toDate` method. This property is purely for developer convenience and sugar.
      */
     native: Date;
     /** Origin of the `Chronos` instance (Method that created `new Chronos`), useful fo tracking instance. */
@@ -68,9 +68,6 @@ export declare class Chronos {
     /**
      * * Creates a new immutable `Chronos` instance.
      *
-     * **Note**: *If a date is provided **without a time component**, the instance will default to `00:00:00.000` UTC
-     * and convert it to the **equivalent local time** using the current environment's UTC offset.*
-     *
      * @param value - A date value as `Date` object, it will be used as is.
      *
      * @returns Instance of `Chronos` with all methods and properties.
@@ -79,9 +76,6 @@ export declare class Chronos {
     /**
      * * Creates a new immutable `Chronos` instance.
      *
-     * **Note**: *If a date is provided **without a time component**, the instance will default to `00:00:00.000` UTC
-     * and convert it to the **equivalent local time** using the current environment's UTC offset.*
-     *
      * @param value - A date value as `Chronos` object.
      *
      * @returns Instance of `Chronos` with all methods and properties.
@@ -175,7 +169,7 @@ export declare class Chronos {
     /** @instance Returns a date as a string value in ISO format. */
     toISOString(): string;
     /**
-     * @instance Wrapper over native `toLocaleString`
+     * @instance Wrapper over native `toLocaleString`.
      * @description Converts a date and time to a string by using the current or specified locale.
      *
      * @param locales A locale string, array of locale strings, Intl.Locale object, or array of Intl.Locale objects that contain one or more language or locale tags. If you include more than one locale string, list them in descending order of priority so that the first entry is the preferred locale. If you omit this parameter, the default locale of the JavaScript runtime is used.
@@ -212,9 +206,9 @@ export declare class Chronos {
      *                 (e.g., `'Sun, Apr 06, 2025 16:11:55'`).
      *	 - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/format#format-tokens format tokens} for detailed usage.
      *
-     * @param useUTC - If `true`, formats the date in UTC (equivalent to `formatUTC()`);
+     * @param useUTC - If `true`, formats the date in UTC (equivalent to `formatUTC()`).
      *                 Defaults to `false` (local time).
-     * @returns A formatted date string in the specified format
+     * @returns A formatted date string in the specified format.
      */
     formatStrict(format?: StrictFormat, useUTC?: boolean): string;
     /**

package/dist/esm/converter/base.js

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

package/dist/esm/date/Chronos.js

@@ -390,18 +390,18 @@ export class Chronos {
     }
     isSame(other, unit, weekStartsOn = 0) {
         const time = other instanceof _a ? other : new _a(other);
-        return (this.startOf(unit, weekStartsOn).toDate().getTime() ===
-            time.startOf(unit, weekStartsOn).toDate().getTime());
+        return (this.startOf(unit, weekStartsOn).timestamp ===
+            time.startOf(unit, weekStartsOn).timestamp);
     }
     isBefore(other, unit, weekStartsOn = 0) {
         const time = other instanceof _a ? other : new _a(other);
-        return (this.startOf(unit, weekStartsOn).toDate().getTime() <
-            time.startOf(unit, weekStartsOn).toDate().getTime());
+        return (this.startOf(unit, weekStartsOn).timestamp <
+            time.startOf(unit, weekStartsOn).timestamp);
     }
     isAfter(other, unit, weekStartsOn = 0) {
         const time = other instanceof _a ? other : new _a(other);
-        return (this.startOf(unit, weekStartsOn).toDate().getTime() >
-            time.startOf(unit, weekStartsOn).toDate().getTime());
+        return (this.startOf(unit, weekStartsOn).timestamp >
+            time.startOf(unit, weekStartsOn).timestamp);
     }
     isSameOrBefore(other, unit, weekStartsOn = 0) {
         return (this.isSame(other, unit, weekStartsOn) || this.isBefore(other, unit, weekStartsOn));

package/package.json

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