nhb-toolbox 4.20.90 → 4.20.92

package/CHANGELOG.md

@@ -6,10 +6,18 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [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`.
-- **Update** `fromNow()` `Chronos` method: fixed issues related to 0 value for provided unit level.
+- **Updated** `fromNow()` `Chronos` method: **fixed** issues when provided unit level value is `0`.
 
 ## [4.20.89] - 2025-10-12
 

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

@@ -5,7 +5,7 @@ const convert_1 = require("../../string/convert");
 const constants_1 = require("../constants");
 const fromNowPlugin = (ChronosClass) => {
     const internal = ChronosClass[constants_1.INTERNALS];
-    ChronosClass.prototype.fromNow = function (level = 'minute', withSuffixPrefix = true, time) {
+    ChronosClass.prototype.fromNow = function (level = 'second', withSuffixPrefix = true, time) {
         const now = internal.toNewDate(this, time);
         const target = internal.internalDate(this);
         const isFuture = target > now;

package/dist/dts/date/plugins/fromNowPlugin.d.ts

@@ -5,14 +5,14 @@ declare module '../Chronos' {
         /**
          * @instance Returns full time difference from now (or a specified time) down to a given level.
          *
-         * @param level Determines the smallest unit to include in the output (e.g., 'minute' will show up to minutes, ignoring seconds). Defaults to `minute`.
+         * @param level Determines the smallest unit to include in the output (e.g., 'minute' will show up to minutes, ignoring seconds). Defaults to `second`.
          * @param withSuffixPrefix If `true`, adds `"in"` or `"ago"` depending on whether the time is in the future or past. Defaults to `true`.
          * @param time An optional time value to compare with (`string`, `number`, `Date`, or `Chronos` instance). Defaults to `now`.
          * @returns The difference as a human-readable string, e.g., `2 years 1 month 9 days 18 hours 56 minutes ago`.
          *
          *  @remarks
          * - This method calculates the **elapsed time difference** (exclusive of the end day), consistent with libraries like `Day.js` and `Luxon`.
-         * - If you need an *inclusive calendar-style* difference (counting both start and end days), add one day manually to the result.
+         * - If you need an *inclusive calendar-style* difference (counting both start and end days), adjust one day manually before calling `fromNow()`.
          */
         fromNow(level?: FromNowUnit, withSuffixPrefix?: boolean, time?: ChronosInput): string;
     }

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

@@ -200,8 +200,13 @@ export type $RomanBase = 'I' | 'V' | 'X' | 'L' | 'C' | 'D' | 'M';
  * - Designed purely for **editor IntelliSense**, not runtime validation.
  */
 export type $RomanNumeralCap = $RomanBase | Repeat<$RomanBase, 2> | Repeat<$RomanBase, 3> | Repeat<$RomanBase, 4> | Repeat<$RomanBase, 5>;
-/** * Represents repeated Roman numeral sequences (1–5 characters long) in uppercase letters and any string */
-export type RomanNumeralCap = Uppercase<LooseLiteral<$RomanNumeralCap>>;
+/**
+ *  * Represents repeated Roman numeral sequences (1–5 characters long, not always a valid roman numeral) in uppercase letters and any string
+ *
+ * @remarks
+ * - The {@link LooseLiteral} wrapper allows non-literal strings (e.g., variables) without losing IntelliSense for {@link $RomanNumeralCap} literals.
+ * - Does not enforce valid Roman numeral formation. */
+export type RomanNumeralCap = LooseLiteral<$RomanNumeralCap>;
 /**
  * * Comprehensive Roman numeral string type.
  *

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

@@ -2,7 +2,7 @@ import { formatUnitWithPlural } from '../../string/convert.js';
 import { INTERNALS } from '../constants.js';
 export const fromNowPlugin = (ChronosClass) => {
     const internal = ChronosClass[INTERNALS];
-    ChronosClass.prototype.fromNow = function (level = 'minute', withSuffixPrefix = true, time) {
+    ChronosClass.prototype.fromNow = function (level = 'second', withSuffixPrefix = true, time) {
         const now = internal.toNewDate(this, time);
         const target = internal.internalDate(this);
         const isFuture = target > now;

package/package.json

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