nhb-toolbox 4.25.10 → 4.25.11

package/CHANGELOG.md

@@ -6,6 +6,10 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.25.11] - 2025-11-06
+
+- **Fixed** *pluralization logic* in `fromNow()` method of `Chronos`: *Only `1` is considered singular, every other number is plural*.
+
 ## [4.25.10] - 2025-11-06
 
 - **Fixed** *pluralization issues* in the methods of `Converter` classes.

package/dist/cjs/date/plugins/fromNowPlugin.js

@@ -91,7 +91,7 @@ const fromNowPlugin = (ChronosClass) => {
                 suffix = ' ago';
             }
         }
-        return `${prefix}${parts.length ? parts?.join(' ') : `0 ${level}`}${suffix}`;
+        return `${prefix}${parts.length ? parts?.join(' ') : `0 ${level}s`}${suffix}`;
     };
 };
 exports.fromNowPlugin = fromNowPlugin;

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

@@ -188,7 +188,7 @@ export declare class Chronos {
      *
      * - Supported format tokens include: `YYYY`, `YY`, `mmmm`, `mmm`, `MM`, `M`, `DD`, `D`, `dd`, `ddd`, `Do`, `HH`, `H`, `hh`, `h`, `mm`, `m`, `ss`, `s`, `ms`, `mss`, `a`, `A`, and `ZZ`.
      * - *Any token not wrapped in brackets will be parsed and replaced with its corresponding date component.*
-     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/format#format-tokens format tokens} for detailed usage.
+     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/format#format-tokens format tokens} for details.
      *
      * @param useUTC - Optional boolean to format the date using UTC time.
      * When `true`, it behaves like `formatUTC()` and outputs time based on UTC offset. Defaults to `false`.
@@ -200,11 +200,11 @@ export declare class Chronos {
     /**
      * @instance Formats the date into a predefined strict string format using local time or UTC.
      *
-     * @remarks Offers `over 21,000` predefined formats with full IntelliSense support.
+     * @remarks Offers `over 26,500` predefined formats with full IntelliSense support.
      *
      * @param format - The desired format string. Defaults to `'dd, mmm DD, YYYY HH:mm:ss'`
      *                 (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.
+     *	- Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/format#format-tokens format tokens} for details.
      *
      * @param useUTC - If `true`, formats the date in UTC (equivalent to `formatUTC()`).
      *                 Defaults to `false` (local time).
@@ -221,7 +221,7 @@ export declare class Chronos {
      *
      * - Supported format tokens include: `YYYY`, `YY`, `mmmm`, `mmm`, `MM`, `M`, `DD`, `D`, `dd`, `ddd`, `Do`, `HH`, `H`, `hh`, `h`, `mm`, `m`, `ss`, `s`, `ms`, `mss`, `a`, `A`, and `ZZ`.
      * - *Any token not wrapped in brackets will be parsed and replaced with its corresponding date component.*
-     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/format#format-tokens format tokens} for detailed usage.
+     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/format#format-tokens format tokens} for details.
      *
      * @returns Formatted date string in desired format (UTC time).
      */
@@ -527,7 +527,7 @@ export declare class Chronos {
      * @param options - Configuration for the date range. Accepts a fixed (`RangeWithDates`) format.
      * @returns Array of ISO date strings in either local or UTC format, excluding any skipped weekdays if specified.
      *
-     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/calculation#getdatesinrange the documentation site} for detailed usage.
+     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/calculation#getdatesinrange the documentation site} for details.
      *
      * @example
      * // Using a fixed date range:
@@ -555,7 +555,7 @@ export declare class Chronos {
      * @param options - Configuration for the date range. Accepts a relative (`RelativeDateRange`) format.
      * @returns Array of ISO date strings in either local or UTC format, excluding any skipped weekdays if specified.
      *
-     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/calculation#getdatesinrange the documentation site} for detailed usage.
+     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/calculation#getdatesinrange the documentation site} for details.
      *
      * @example
      * // Using a relative date range with skipDays:
@@ -684,7 +684,7 @@ export declare class Chronos {
      * @param options - Relative range (e.g., 7 days, 4 weeks) and output format (local with timezone or utc).
      * @returns Array of ISO date strings in the specified format. Returns empty array if no matches in the time span.
      *
-     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/statics#getdatesforday the documentation site} for detailed usage.
+     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/statics#getdatesforday the documentation site} for details.
      *
      * @example
      * Chronos.getDatesForDay('Wednesday', { span: 7, unit: 'day' });
@@ -706,7 +706,7 @@ export declare class Chronos {
      * @param options - Date range (from/to, e.g. `'2025-06-30'`, ` new Date()`, `new Chronos()` etc.) and output format (local with timezone or utc).
      * @returns Array of ISO date strings in the specified format. Returns empty array if no matches in the range.
      *
-     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/statics#getdatesforday the documentation site} for detailed usage.
+     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/statics#getdatesforday the documentation site} for details.
      *
      * @example
      * Chronos.getDatesForDay('Monday', {

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

@@ -75,9 +75,10 @@ export type ChronosFormat = Year | Month | Day | MonthDate | Hour | Minute | Sec
 export type DateParts = `${MonthDate} ${Exclude<Month, 'M' | 'MM'>}` | `${Exclude<Month, 'M' | 'MM'>} ${MonthDate}` | `${Day}, ${MonthDate} ${Exclude<Month, 'M' | 'MM'>}` | `${Day}, ${Exclude<Month, 'M' | 'MM'>} ${MonthDate}` | `${Exclude<Month, 'M' | 'MM'>} ${MonthDate}, ${Year}` | `${MonthDate} ${Exclude<Month, 'M' | 'MM'>}, ${Year}` | `${Exclude<Month, 'M' | 'MM'>} ${MonthDate} ${Year}` | `${MonthDate} ${Exclude<Month, 'M' | 'MM'>} ${Year}` | `${Day}, ${Exclude<Month, 'M' | 'MM'>} ${MonthDate}, ${Year}` | `${Day}, ${MonthDate} ${Exclude<Month, 'M' | 'MM'>}, ${Year}` | `${Day}, ${Exclude<Month, 'M' | 'MM'>} ${MonthDate} ${Year}` | `${Day}, ${MonthDate} ${Exclude<Month, 'M' | 'MM'>} ${Year}` | `${Exclude<MonthDate, 'Do'>}.${Exclude<Month, 'mmm' | 'mmmm'>}.${Year}` | `${Year}.${Exclude<Month, 'mmm' | 'mmmm'>}.${Exclude<MonthDate, 'Do'>}` | `${Exclude<MonthDate, 'Do'>}/${Exclude<Month, 'mmm' | 'mmmm'>}/${Year}` | `${Exclude<MonthDate, 'Do'>}-${Exclude<Month, 'mmm' | 'mmmm'>}-${Year}` | `${Exclude<Month, 'mmm' | 'mmmm'>}/${Exclude<MonthDate, 'Do'>}/${Year}` | `${Exclude<Month, 'mmm' | 'mmmm'>}-${Exclude<MonthDate, 'Do'>}-${Year}` | `${Year}-${Exclude<Month, 'mmm' | 'mmmm'>}-${Exclude<MonthDate, 'Do'>}` | `${Year}/${Exclude<Month, 'mmm' | 'mmmm'>}/${Exclude<MonthDate, 'Do'>}` | `${Year}-${Exclude<MonthDate, 'Do'>}-${Exclude<Month, 'mmm' | 'mmmm'>}` | `${Year}/${Exclude<MonthDate, 'Do'>}/${Exclude<Month, 'mmm' | 'mmmm'>}`;
 /** Standard Time Formats */
 export type TimeParts = `${Exclude<Hour, 'h' | 'hh' | 'H'>}:${Exclude<Minute, 'm'>}` | `${Exclude<Hour, 'H' | 'HH' | 'h'>}:${Exclude<Minute, 'm'>} ${TimeFormats}` | `${Exclude<Hour, 'h' | 'hh' | 'H'>}:${Exclude<Minute, 'm'>}:${Exclude<Second, 's'>}` | `${Exclude<Hour, 'H' | 'HH' | 'h'>}:${Exclude<Minute, 'm'>}:${Exclude<Second, 's'>} ${TimeFormats}` | `${Exclude<Hour, 'h' | 'hh' | 'H'>}:${Exclude<Minute, 'm'>}:${Exclude<Second, 's'>}:${Exclude<Millisecond, 'ms'>}` | `${Exclude<Hour, 'H' | 'HH' | 'h'>}:${Exclude<Minute, 'm'>}:${Exclude<Second, 's'>}:${Exclude<Millisecond, 'ms'>} ${TimeFormats}`;
-type DateTimeConnector = ' ' | ', ' | '; ' | ' - ';
-/** Strict pre-defined types for formatting date and time. */
-export type StrictFormat = LooseLiteral<DateParts | TimeParts | `${DateParts}${DateTimeConnector}${TimeParts}`>;
+type DateTimeConnector = ' ' | ', ' | '; ' | ' - ' | 'T';
+type DateTimeISO = 'YYYY-MM-DDTHH:mm:ss.mssZZ';
+/** Pre-defined literal types for formatting date and time. Optionally can pass any string. */
+export type StrictFormat = LooseLiteral<DateTimeISO | DateParts | TimeParts | `${DateParts}${DateTimeConnector}${TimeParts}`>;
 /** Iterable `Chronos` object properties */
 export interface ChronosObject {
     /** Full year (e.g., 2025). */
@@ -216,7 +217,16 @@ export type $UTCOffset = `${PositiveUTCHour | NegativeUTCHour}:${UTCMinute}`;
 export type UTCOffSet = `UTC${$UTCOffset}`;
 /** `Chronos` Date Format options */
 export interface FormatOptions {
-    /** - The desired format (Default format is dd, `MMM DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55). */
+    /**
+     * * The desired format (Default format is `'dd, MMM DD, YYYY HH:mm:ss'` = `'Sun, Apr 06, 2025 16:11:55'`).
+     *
+     * - To output raw text (i.e., not interpreted as a date token), wrap it in square brackets.
+     * - For example, `[Today is] ddd` results in `Today is Sunday`, and `YYYY[ year]` results in `2025 year`.
+     *
+     * - Supported format tokens include: `YYYY`, `YY`, `mmmm`, `mmm`, `MM`, `M`, `DD`, `D`, `dd`, `ddd`, `Do`, `HH`, `H`, `hh`, `h`, `mm`, `m`, `ss`, `s`, `ms`, `mss`, `a`, `A`, and `ZZ`.
+     * - *Any token not wrapped in brackets will be parsed and replaced with its corresponding date component.*
+     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/format#format-tokens format tokens} for details.
+     */
     format?: string;
     /** - Whether to use UTC time. Defaults to `false`. */
     useUTC?: boolean;

package/dist/esm/date/plugins/fromNowPlugin.js

@@ -88,6 +88,6 @@ export const fromNowPlugin = (ChronosClass) => {
                 suffix = ' ago';
             }
         }
-        return `${prefix}${parts.length ? parts?.join(' ') : `0 ${level}`}${suffix}`;
+        return `${prefix}${parts.length ? parts?.join(' ') : `0 ${level}s`}${suffix}`;
     };
 };

package/package.json

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