nhb-toolbox 3.8.1 → 3.8.4

package/dist/array/sort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../src/array/sort.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAe,MAAM,SAAS,CAAC;AAEtE;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,aAAa,EAClD,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,CAAC,EAAE,CAAC;AAEP;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,EAC9D,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,CAAC,EAAE,WAAW,GACnB,CAAC,EAAE,CAAC"}
+{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../src/array/sort.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAe,MAAM,SAAS,CAAC;AAGtE;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,aAAa,EAClD,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,CAAC,EAAE,CAAC;AAEP;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,EAC9D,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,CAAC,EAAE,WAAW,GACnB,CAAC,EAAE,CAAC"}

package/dist/array/sort.js

@@ -1,5 +1,6 @@
 import { isArrayOfType, isObject, isValidArray, } from '../guards/non-primitives';
 import { isBoolean, isNumber, isString } from '../guards/primitives';
+import { naturalSort } from './utils';
 /**
  * * Sorts an array of strings, numbers, booleans, or objects based on the provided options.
  *
@@ -18,8 +19,8 @@ export function sortAnArray(array, options) {
     // Check if the array contains strings
     if (isArrayOfType(array, isString)) {
         return [...array].sort((a, b) => options?.sortOrder === 'desc' ?
-            b.localeCompare(a)
-            : a.localeCompare(b));
+            naturalSort(b, a)
+            : naturalSort(a, b));
     }
     // Check if the array contains numbers
     if (isArrayOfType(array, isNumber)) {
@@ -46,8 +47,8 @@ export function sortAnArray(array, options) {
             }
             if (typeof keyA === 'string' && typeof keyB === 'string') {
                 return options?.sortOrder === 'desc' ?
-                    keyB.localeCompare(keyA)
-                    : keyA.localeCompare(keyB);
+                    naturalSort(keyB, keyA)
+                    : naturalSort(keyA, keyB);
             }
             if (typeof keyA === 'number' && typeof keyB === 'number') {
                 return options?.sortOrder === 'desc' ?

package/dist/array/types.d.ts

@@ -50,4 +50,11 @@ export interface SortByOption<T extends GenericObject> extends OrderOption {
 }
 /** * Options for sorting array. */
 export type SortOptions<T> = T extends GenericObject ? SortByOption<T> : OrderOption;
+/** Optional settings to configure comparison behavior. */
+export interface SortNature {
+    /** If true, compares string chunks without case sensitivity. Defaults to `true`. */
+    caseInsensitive?: boolean;
+    /** If true, uses localeCompare for string chunk comparisons. Defaults to `false`. */
+    localeAware?: boolean;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/array/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/array/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,uCAAuC;AACvC,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;IACvC;;;OAGG;IACH,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAE/B;;;OAGG;IACH,cAAc,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAEhC;;;;OAIG;IACH,cAAc,CAAC,EAAE,EAAE,CAAC;IAEpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,EAAE,CAAC;CACrB;AAED,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,aAAa,CAAE,SAAQ,WAAW;IACzE,2DAA2D;IAC3D,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;CACnC;AAED,mCAAmC;AACnC,MAAM,MAAM,WAAW,CAAC,CAAC,IACxB,CAAC,SAAS,aAAa,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/array/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,uCAAuC;AACvC,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;IACvC;;;OAGG;IACH,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAE/B;;;OAGG;IACH,cAAc,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAEhC;;;;OAIG;IACH,cAAc,CAAC,EAAE,EAAE,CAAC;IAEpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,EAAE,CAAC;CACrB;AAED,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,aAAa,CAAE,SAAQ,WAAW;IACzE,2DAA2D;IAC3D,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;CACnC;AAED,mCAAmC;AACnC,MAAM,MAAM,WAAW,CAAC,CAAC,IACxB,CAAC,SAAS,aAAa,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;AAEzD,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IAC1B,oFAAoF;IACpF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qFAAqF;IACrF,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/dist/array/utils.d.ts

@@ -0,0 +1,14 @@
+import type { SortNature } from './types';
+/**
+ * * Compare two strings using natural sorting (e.g., "file2" < "file10").
+ * Optionally supports case-insensitive and locale-aware string chunk comparisons.
+ *
+ * @param a - The first string to compare.
+ * @param b - The second string to compare.
+ * @param options - Optional settings to configure comparison behavior.
+ * @param options.caseInsensitive - If true, compares string chunks without case sensitivity. Defaults to `true`.
+ * @param options.localeAware - If true, uses localeCompare for string chunk comparisons. Defaults to `false`.
+ * @returns A negative number if `a` comes before `b`, a positive number if `a` comes after `b`, or 0 if equal.
+ */
+export declare function naturalSort(a: string, b: string, options?: SortNature): number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/array/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/array/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAC1B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,CAAC,EAAE,UAAU,GAClB,MAAM,CAgFR"}

package/dist/array/utils.js

@@ -0,0 +1,78 @@
+/**
+ * * Compare two strings using natural sorting (e.g., "file2" < "file10").
+ * Optionally supports case-insensitive and locale-aware string chunk comparisons.
+ *
+ * @param a - The first string to compare.
+ * @param b - The second string to compare.
+ * @param options - Optional settings to configure comparison behavior.
+ * @param options.caseInsensitive - If true, compares string chunks without case sensitivity. Defaults to `true`.
+ * @param options.localeAware - If true, uses localeCompare for string chunk comparisons. Defaults to `false`.
+ * @returns A negative number if `a` comes before `b`, a positive number if `a` comes after `b`, or 0 if equal.
+ */
+export function naturalSort(a, b, options) {
+    const { caseInsensitive = true, localeAware = false } = options || {};
+    /**
+     * * Splits a string into an array of number and non-number chunks.
+     * @param str - The string to split.
+     * @returns An array of string and number parts.
+     */
+    const _createChunks = (str) => {
+        const chunks = [];
+        let current = '';
+        let isNumeric = false;
+        for (const char of str) {
+            const charIsNum = !Number.isNaN(Number(char));
+            if (current.length === 0) {
+                current = char;
+                isNumeric = charIsNum;
+                continue;
+            }
+            if (charIsNum === isNumeric) {
+                current += char;
+            }
+            else {
+                chunks.push(isNumeric ? Number(current) : current);
+                current = char;
+                isNumeric = charIsNum;
+            }
+        }
+        if (current.length > 0) {
+            chunks.push(isNumeric ? Number(current) : current);
+        }
+        return chunks;
+    };
+    const aChunks = _createChunks(a);
+    const bChunks = _createChunks(b);
+    for (let i = 0; i < Math.min(aChunks.length, bChunks.length); i++) {
+        let aChunk = aChunks[i];
+        let bChunk = bChunks[i];
+        // Normalize string chunks if case-insensitive
+        if (caseInsensitive &&
+            typeof aChunk === 'string' &&
+            typeof bChunk === 'string') {
+            aChunk = aChunk.toLowerCase();
+            bChunk = bChunk.toLowerCase();
+        }
+        // Compare types: number vs string
+        if (typeof aChunk !== typeof bChunk) {
+            return typeof aChunk === 'string' ? 1 : -1;
+        }
+        // Compare same-type chunks
+        if (aChunk !== bChunk) {
+            if (typeof aChunk === 'number' && typeof bChunk === 'number') {
+                return aChunk - bChunk;
+            }
+            if (typeof aChunk === 'string' && typeof bChunk === 'string') {
+                if (localeAware) {
+                    const cmp = aChunk.localeCompare(bChunk, undefined, {
+                        sensitivity: caseInsensitive ? 'accent' : 'variant',
+                    });
+                    if (cmp !== 0)
+                        return cmp;
+                }
+                return aChunk < bChunk ? -1 : 1;
+            }
+        }
+    }
+    return aChunks.length - bChunks.length;
+}

package/dist/date/Chronos.d.ts

@@ -44,7 +44,7 @@ export declare class Chronos {
     get isoMonth(): number;
     /** Gets the time value in milliseconds since midnight, January 1, 1970 UTC. */
     get unix(): number;
-    /** @public @instance Returns a debug-friendly string for console.log or util.inspect */
+    /** @public @instance Returns a debug-friendly string for `console.log` or `util.inspect`. */
     inspect(): string;
     /** @public @instance Clones and returns a new Chronos instance with the same date. */
     clone(): Chronos;
@@ -72,7 +72,7 @@ export declare class Chronos {
     getTimeStamp(): number;
     /**
      * @public @instance Returns the current date and time in a specified format in local time.
-     * @description Default format is dd, `MMM DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55:379`
+     * @description Default format is dd, `mmm DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55:379`
      *
      * @param options - Configure format string and whether to format using utc offset.
      * @returns Formatted date string in desired format.
@@ -81,14 +81,14 @@ export declare class Chronos {
     /**
      * @public @instance Formats the date into a custom string format (local time).
      *
-     * @param format - The desired format (Default format is `dd, MMM DD, YYYY HH:mm:ss:mss` = `Sun, Apr 06, 2025 16:11:55:379`).
+     * @param format - The desired format (Default format is `dd, mmm DD, YYYY HH:mm:ss:mss` = `Sun, Apr 06, 2025 16:11:55:379`).
      * @param useUTC - Optional `useUTC` to get the formatted time using UTC Offset, defaults to `false`. Equivalent to `formatUTC()` method if set to `true`.
      * @returns Formatted date string in desired format (in local time unless `useUTC` passed as `true`).
      */
     format(format?: string, useUTC?: boolean): string;
     /**
      * @public @instance Formats the date into a strict custom string format (local time).
-     * @description Select from `5,100+` pre-defined formats.
+     * @description Select from `21,000+` pre-defined formats.
      *
      * @param format - The desired format (Default format is `dd, mmm DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55`).
      * @param useUTC - Optional `useUTC` to get the formatted time using UTC Offset, defaults to `false`. Equivalent to `formatUTC()` method if set to `true`.
@@ -98,7 +98,7 @@ export declare class Chronos {
     /**
      * @public @instance Formats the date into a custom string format (UTC time).
      *
-     * @param format - The desired format (Default format is `dd, MMM DD, YYYY HH:mm:ss:mss` = `Sun, Apr 06, 2025 16:11:55:379`).
+     * @param format - The desired format (Default format is `dd, mmm DD, YYYY HH:mm:ss:mss` = `Sun, Apr 06, 2025 16:11:55:379`).
      * @returns Formatted date string in desired format (UTC time).
      */
     formatUTC(format?: string): string;
@@ -322,7 +322,7 @@ export declare class Chronos {
     toLocal(): Chronos;
     /**
      * @public @static Returns the current date and time in a specified format in local time.
-     * * Default format is dd, `MMM DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55:379`
+     * * Default format is dd, `mmm DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55:379`
      * @param options - Configure format string and whether to format using utc offset.
      * @returns Formatted date string in desired format.
      */
@@ -350,5 +350,35 @@ export declare class Chronos {
      * @param dates Date inputs.
      */
     static max(...dates: (number | string | Date | Chronos)[]): Chronos;
+    /**
+     * @public @static Checks if the year in the date string is a leap year.
+     * - A year is a leap year if it is divisible by 4, but not divisible by 100, unless it is also divisible by 400.
+     * - For example, 2000 and 2400 are leap years, but 1900 and 2100 are not.
+     * @returns `true` if the year is a leap year, `false` otherwise.
+     */
+    static isLeapYear(date: number | string | Date | Chronos): boolean;
+    /**
+     * @public @static Checks if the given value is a valid `Date` object.
+     * - A value is considered valid if it is an instance of the built-in `Date` class.
+     * - This does not check whether the date itself is valid (e.g., `new Date('invalid')`).
+     * @param value - The value to test.
+     * @returns `true` if the value is a valid Date object, otherwise `false`.
+     */
+    static isValidDate(value: unknown): value is Date;
+    /**
+     * @public @static Checks if the given value is a valid date string.
+     * - A value is considered a valid date string if it is a string and can be parsed by `Date.parse()`.
+     * - This uses the native JavaScript date parser internally.
+     * @param value - The value to test.
+     * @returns `true` if the value is a valid date string, otherwise `false`.
+     */
+    static isDateString(value: unknown): value is string;
+    /**
+     * @public @static Checks if the given value is an instance of `Chronos`.
+     * - Useful for verifying Chronos objects in type guards or validations.
+     * @param value - The value to test.
+     * @returns `true` if the value is an instance of `Chronos`, otherwise `false`.
+     */
+    static isValidChronos(value: unknown): value is Chronos;
 }
 //# sourceMappingURL=Chronos.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Chronos.d.ts","sourceRoot":"","sources":["../../src/date/Chronos.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Chronos.d.ts","sourceRoot":"","sources":["../../src/date/Chronos.ts"],"names":[],"mappings":"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"}

package/dist/date/Chronos.js

@@ -1,8 +1,11 @@
-import { DAYS, MONTHS, ORIGIN, sortedFormats, TIME_ZONES } from './constants';
+import { isString } from '../guards/primitives';
+import { getOrdinal } from '../number/utilities';
+import { DAYS, MONTHS, ORIGIN, sortedFormats, TIME_ZONE_LABELS, TIME_ZONES, } from './constants';
 import { isValidUTCOffSet } from './guards';
-import { extractMinutesFromUTC } from './utils';
+import { extractMinutesFromUTC, formatUTCOffset } from './utils';
 export class Chronos {
     #date;
+    #offset;
     [ORIGIN];
     /**
      * * Creates a new immutable `Chronos` instance.
@@ -17,6 +20,7 @@ export class Chronos {
         const date = this.#toNewDate(value);
         this.#date = date;
         this[ORIGIN] = 'root';
+        this.#offset = `UTC${this.getUTCOffset()}`;
     }
     *[Symbol.iterator]() {
         yield ['year', this.year];
@@ -42,6 +46,8 @@ export class Chronos {
     }
     get [Symbol.toStringTag]() {
         switch (this[ORIGIN]) {
+            case 'timeZone':
+                return this.toISOString().replace('Z', this.#offset.slice(3));
             case 'toUTC':
             case 'utc':
                 return this.#toLocalISOString().replace(this.getUTCOffset(), 'Z');
@@ -50,9 +56,11 @@ export class Chronos {
         }
     }
     /** @private @instance Method to tag origin of the `Chronos` instance. */
-    #withOrigin(origin) {
+    #withOrigin(origin, offset) {
         const instance = new Chronos(this.#date);
         instance[ORIGIN] = origin;
+        if (offset)
+            instance.#offset = offset;
         return instance;
     }
     /**
@@ -95,8 +103,6 @@ export class Chronos {
             yy: String(year).slice(-2),
             M: String(month + 1),
             MM: String(month + 1).padStart(2, '0'),
-            MMM: MONTHS[month].slice(0, 3),
-            MMMM: MONTHS[month],
             mmm: MONTHS[month].slice(0, 3),
             mmmm: MONTHS[month],
             d: DAYS[day].slice(0, 2),
@@ -104,6 +110,7 @@ export class Chronos {
             ddd: DAYS[day],
             D: String(date),
             DD: String(date).padStart(2, '0'),
+            Do: getOrdinal(date),
             H: String(hours),
             HH: String(hours).padStart(2, '0'),
             h: String(hours % 12 || 12),
@@ -193,7 +200,7 @@ export class Chronos {
     get unix() {
         return this.#date.getTime();
     }
-    /** @public @instance Returns a debug-friendly string for console.log or util.inspect */
+    /** @public @instance Returns a debug-friendly string for `console.log` or `util.inspect`. */
     inspect() {
         return `[Chronos ${this.toLocalISOString()}]`;
     }
@@ -211,11 +218,27 @@ export class Chronos {
     }
     /** @public @instance Gets the native `Date` instance (read-only). */
     toDate() {
-        return new Date(this.#date);
+        switch (this[ORIGIN]) {
+            case 'toUTC':
+            case 'utc': {
+                const mins = extractMinutesFromUTC(`UTC${this.getUTCOffset()}`);
+                const date = this.addMinutes(mins);
+                return date.toDate();
+            }
+            default:
+                return new Date(this.#date);
+        }
     }
     /** @public @instance Returns a string representation of a date. The format of the string depends on the locale. */
     toString() {
         switch (this[ORIGIN]) {
+            case 'timeZone': {
+                const gmt = this.#offset.replace('UTC', 'GMT').replace(':', '');
+                const label = TIME_ZONE_LABELS[this.#offset] ?? this.#offset;
+                return this.#date
+                    .toString()
+                    .replace(/GMT[+-]\d{4} \([^)]+\)/, `${gmt} (${label})`);
+            }
             case 'toUTC':
             case 'utc': {
                 const mins = extractMinutesFromUTC(`UTC${this.getUTCOffset()}`);
@@ -229,6 +252,7 @@ export class Chronos {
     /** @public @instance Returns ISO string with local time zone offset */
     toLocalISOString() {
         switch (this[ORIGIN]) {
+            case 'timeZone':
             case 'toUTC':
             case 'utc': {
                 const mins = extractMinutesFromUTC(`UTC${this.getUTCOffset()}`);
@@ -242,6 +266,8 @@ export class Chronos {
     /** @public @instance Returns a date as a string value in ISO format. */
     toISOString() {
         switch (this[ORIGIN]) {
+            case 'timeZone':
+                return this.#toLocalISOString().replace(this.getUTCOffset(), this.#offset.slice(3));
             case 'toUTC':
             case 'utc':
                 return this.#toLocalISOString().replace(this.getUTCOffset(), 'Z');
@@ -265,44 +291,44 @@ export class Chronos {
     }
     /**
      * @public @instance Returns the current date and time in a specified format in local time.
-     * @description Default format is dd, `MMM DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55:379`
+     * @description Default format is dd, `mmm DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55:379`
      *
      * @param options - Configure format string and whether to format using utc offset.
      * @returns Formatted date string in desired format.
      */
     today(options) {
-        const { format = 'dd, MMM DD, YYYY HH:mm:ss', useUTC = false } = options || {};
+        const { format = 'dd, mmm DD, YYYY HH:mm:ss', useUTC = false } = options || {};
         const today = new Date();
         return new Chronos(today).#format(format, useUTC);
     }
     /**
      * @public @instance Formats the date into a custom string format (local time).
      *
-     * @param format - The desired format (Default format is `dd, MMM DD, YYYY HH:mm:ss:mss` = `Sun, Apr 06, 2025 16:11:55:379`).
+     * @param format - The desired format (Default format is `dd, mmm DD, YYYY HH:mm:ss:mss` = `Sun, Apr 06, 2025 16:11:55:379`).
      * @param useUTC - Optional `useUTC` to get the formatted time using UTC Offset, defaults to `false`. Equivalent to `formatUTC()` method if set to `true`.
      * @returns Formatted date string in desired format (in local time unless `useUTC` passed as `true`).
      */
-    format(format = 'dd, MMM DD, YYYY HH:mm:ss:mss', useUTC = false) {
+    format(format = 'dd, mmm DD, YYYY HH:mm:ss:mss', useUTC = false) {
         return this.#format(format, useUTC);
     }
     /**
      * @public @instance Formats the date into a strict custom string format (local time).
-     * @description Select from `5,100+` pre-defined formats.
+     * @description Select from `21,000+` pre-defined formats.
      *
      * @param format - The desired format (Default format is `dd, mmm DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55`).
      * @param useUTC - Optional `useUTC` to get the formatted time using UTC Offset, defaults to `false`. Equivalent to `formatUTC()` method if set to `true`.
      * @returns Formatted date string in desired strict format (in local time unless `useUTC` passed as `true`).
      */
     formatStrict(format = 'dd, mmm DD, YYYY HH:mm:ss', useUTC = false) {
-        return this.format(format, useUTC);
+        return this.#format(format, useUTC);
     }
     /**
      * @public @instance Formats the date into a custom string format (UTC time).
      *
-     * @param format - The desired format (Default format is `dd, MMM DD, YYYY HH:mm:ss:mss` = `Sun, Apr 06, 2025 16:11:55:379`).
+     * @param format - The desired format (Default format is `dd, mmm DD, YYYY HH:mm:ss:mss` = `Sun, Apr 06, 2025 16:11:55:379`).
      * @returns Formatted date string in desired format (UTC time).
      */
-    formatUTC(format = 'dd, MMM DD, YYYY HH:mm:ss:mss') {
+    formatUTC(format = 'dd, mmm DD, YYYY HH:mm:ss:mss') {
         switch (this[ORIGIN]) {
             case 'toUTC':
             case 'utc':
@@ -379,15 +405,18 @@ export class Chronos {
      */
     timeZone(zone) {
         let offset;
+        let stringOffset;
         if (isValidUTCOffSet(zone)) {
             offset = extractMinutesFromUTC(zone);
+            stringOffset = zone;
         }
         else {
             offset = TIME_ZONES[zone] ?? TIME_ZONES['UTC'];
+            stringOffset = formatUTCOffset(offset);
         }
         const utc = this.#date.getTime() + this.#date.getTimezoneOffset() * 60 * 1000;
         const adjusted = new Date(utc + offset * 60 * 1000);
-        return new Chronos(adjusted).#withOrigin('timeZone');
+        return new Chronos(adjusted).#withOrigin('timeZone', stringOffset);
     }
     /**
      * @public @instance Checks if the year is a leap year.
@@ -951,12 +980,12 @@ export class Chronos {
     }
     /**
      * @public @static Returns the current date and time in a specified format in local time.
-     * * Default format is dd, `MMM DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55:379`
+     * * Default format is dd, `mmm DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55:379`
      * @param options - Configure format string and whether to format using utc offset.
      * @returns Formatted date string in desired format.
      */
     static today(options) {
-        const { format = 'dd, MMM DD, YYYY HH:mm:ss', useUTC = false } = options || {};
+        const { format = 'dd, mmm DD, YYYY HH:mm:ss', useUTC = false } = options || {};
         const today = new Date();
         return new Chronos(today).#format(format, useUTC);
     }
@@ -1017,4 +1046,43 @@ export class Chronos {
     static max(...dates) {
         return new Chronos(Math.max(...dates.map((d) => new Chronos(d).valueOf()))).#withOrigin('max');
     }
+    /**
+     * @public @static Checks if the year in the date string is a leap year.
+     * - A year is a leap year if it is divisible by 4, but not divisible by 100, unless it is also divisible by 400.
+     * - For example, 2000 and 2400 are leap years, but 1900 and 2100 are not.
+     * @returns `true` if the year is a leap year, `false` otherwise.
+     */
+    static isLeapYear(date) {
+        const year = new Chronos(date).year;
+        return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+    }
+    /**
+     * @public @static Checks if the given value is a valid `Date` object.
+     * - A value is considered valid if it is an instance of the built-in `Date` class.
+     * - This does not check whether the date itself is valid (e.g., `new Date('invalid')`).
+     * @param value - The value to test.
+     * @returns `true` if the value is a valid Date object, otherwise `false`.
+     */
+    static isValidDate(value) {
+        return value instanceof Date;
+    }
+    /**
+     * @public @static Checks if the given value is a valid date string.
+     * - A value is considered a valid date string if it is a string and can be parsed by `Date.parse()`.
+     * - This uses the native JavaScript date parser internally.
+     * @param value - The value to test.
+     * @returns `true` if the value is a valid date string, otherwise `false`.
+     */
+    static isDateString(value) {
+        return isString(value) && !isNaN(Date.parse(value));
+    }
+    /**
+     * @public @static Checks if the given value is an instance of `Chronos`.
+     * - Useful for verifying Chronos objects in type guards or validations.
+     * @param value - The value to test.
+     * @returns `true` if the value is an instance of `Chronos`, otherwise `false`.
+     */
+    static isValidChronos(value) {
+        return value instanceof Chronos;
+    }
 }

package/dist/date/constants.d.ts

@@ -1,16 +1,17 @@
+import type { UTCOffSet } from './types';
 export declare const ORIGIN: unique symbol;
 export declare const DAYS: readonly ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
 export declare const MONTHS: readonly ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"];
 export declare const YEAR_FORMATS: readonly ["YYYY", "YY", "yyyy", "yy"];
-export declare const MONTH_FORMATS: readonly ["M", "MM", "MMM", "MMMM", "mmm", "mmmm"];
-export declare const DATE_FORMATS: readonly ["DD", "D"];
+export declare const MONTH_FORMATS: readonly ["M", "MM", "mmm", "mmmm"];
+export declare const DATE_FORMATS: readonly ["DD", "D", "Do"];
 export declare const DAY_FORMATS: readonly ["d", "dd", "ddd"];
 export declare const HOUR_FORMATS: readonly ["H", "HH", "hh", "h"];
 export declare const MINUTE_FORMATS: readonly ["mm", "m"];
 export declare const SECOND_FORMATS: readonly ["ss", "s"];
 export declare const MILLISECOND_FORMATS: readonly ["ms", "mss"];
 export declare const TIME_FORMATS: readonly ["a", "A"];
-export declare const sortedFormats: ("a" | "M" | "D" | "A" | "YYYY" | "YY" | "yyyy" | "yy" | "MM" | "MMM" | "MMMM" | "mmm" | "mmmm" | "DD" | "d" | "dd" | "ddd" | "H" | "HH" | "hh" | "h" | "mm" | "m" | "ss" | "s" | "ms" | "mss")[];
+export declare const sortedFormats: ("a" | "M" | "D" | "A" | "YYYY" | "YY" | "yyyy" | "yy" | "MM" | "mmm" | "mmmm" | "DD" | "Do" | "d" | "dd" | "ddd" | "H" | "HH" | "hh" | "h" | "mm" | "m" | "ss" | "s" | "ms" | "mss")[];
 export declare const TIME_ZONES: {
     /** International Date Line West (Baker Island, Howland Island) */
     readonly IDLW: number;
@@ -289,4 +290,5 @@ export declare const TIME_ZONES: {
     /** Petropavlovsk-Kamchatsky Time (Russia) */
     readonly PETT: number;
 };
+export declare const TIME_ZONE_LABELS: Record<UTCOffSet, string>;
 //# sourceMappingURL=constants.d.ts.map

package/dist/date/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/date/constants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/date/constants.ts"],"names":[],"mappings":"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"}

package/dist/date/constants.js

@@ -23,8 +23,8 @@ export const MONTHS = [
     'December',
 ];
 export const YEAR_FORMATS = ['YYYY', 'YY', 'yyyy', 'yy'];
-export const MONTH_FORMATS = ['M', 'MM', 'MMM', 'MMMM', 'mmm', 'mmmm'];
-export const DATE_FORMATS = ['DD', 'D'];
+export const MONTH_FORMATS = ['M', 'MM', 'mmm', 'mmmm'];
+export const DATE_FORMATS = ['DD', 'D', 'Do'];
 export const DAY_FORMATS = ['d', 'dd', 'ddd'];
 export const HOUR_FORMATS = ['H', 'HH', 'hh', 'h'];
 export const MINUTE_FORMATS = ['mm', 'm'];
@@ -326,3 +326,59 @@ export const TIME_ZONES = {
     /** Petropavlovsk-Kamchatsky Time (Russia) */
     PETT: 12 * 60,
 };
+export const TIME_ZONE_LABELS = {
+    'UTC-12:00': 'Baker Island Time',
+    'UTC-11:30': 'Niue Time',
+    'UTC-11:00': 'Samoa Standard Time',
+    'UTC-10:30': 'Marquesas Time',
+    'UTC-10:00': 'Hawaii-Aleutian Standard Time',
+    'UTC-09:30': 'Marquesas Time',
+    'UTC-09:00': 'Alaska Standard Time',
+    'UTC-08:30': 'Pitcairn Standard Time',
+    'UTC-08:00': 'Pacific Standard Time',
+    'UTC-07:30': 'Mountain Standard Time (Unofficial)',
+    'UTC-07:00': 'Mountain Standard Time',
+    'UTC-06:30': 'Central America Time (Unofficial)',
+    'UTC-06:00': 'Central Standard Time',
+    'UTC-05:30': 'Venezuelan Standard Time (Historical)',
+    'UTC-05:00': 'Eastern Standard Time',
+    'UTC-04:30': 'Venezuelan Standard Time',
+    'UTC-04:00': 'Atlantic Standard Time',
+    'UTC-03:30': 'Newfoundland Standard Time',
+    'UTC-03:00': 'Argentina Standard Time',
+    'UTC-02:30': 'Mid-Atlantic Time (Unofficial)',
+    'UTC-02:00': 'South Georgia Time',
+    'UTC-01:30': 'Azores Time (Unofficial)',
+    'UTC-01:00': 'Cape Verde Time',
+    'UTC+00:00': 'Greenwich Mean Time',
+    'UTC+00:30': 'British Summer Time (Historical)',
+    'UTC+01:00': 'Central European Time',
+    'UTC+01:30': 'Central Africa Time (Unofficial)',
+    'UTC+02:00': 'Eastern European Time',
+    'UTC+02:30': 'Israel Standard Time (Historical)',
+    'UTC+03:00': 'Arabian Standard Time',
+    'UTC+03:30': 'Iran Standard Time',
+    'UTC+04:00': 'Gulf Standard Time',
+    'UTC+04:30': 'Afghanistan Time',
+    'UTC+05:00': 'Pakistan Standard Time',
+    'UTC+05:30': 'Indian Standard Time',
+    'UTC+05:45': 'Nepal Time',
+    'UTC+06:00': 'Bangladesh Standard Time',
+    'UTC+06:30': 'Cocos Islands Time',
+    'UTC+07:00': 'Indochina Time',
+    'UTC+07:30': 'Western Indonesia Time (Unofficial)',
+    'UTC+08:00': 'China Standard Time',
+    'UTC+08:30': 'North Korea Standard Time',
+    'UTC+08:45': 'Australian Central Western Standard Time',
+    'UTC+09:00': 'Japan Standard Time',
+    'UTC+09:30': 'Australian Central Standard Time',
+    'UTC+10:00': 'Australian Eastern Standard Time',
+    'UTC+10:30': 'Lord Howe Standard Time',
+    'UTC+11:00': 'Solomon Islands Time',
+    'UTC+11:30': 'Norfolk Island Time',
+    'UTC+12:00': 'New Zealand Standard Time',
+    'UTC+12:45': 'Chatham Islands Time',
+    'UTC+13:00': 'Phoenix Island Time',
+    'UTC+13:45': 'Tokelau Time (Unofficial)',
+    'UTC+14:00': 'Line Islands Time',
+};

package/dist/date/types.d.ts

@@ -48,9 +48,9 @@ export type Second = (typeof SECOND_FORMATS)[number];
 export type Millisecond = (typeof MILLISECOND_FORMATS)[number];
 export type TimeFormats = (typeof TIME_FORMATS)[number];
 export type ChronosFormat = Year | Month | Day | Date | Hour | Minute | Second | Millisecond | TimeFormats;
-export type ChronosDate = number | string | Date | Chronos;
-/** * All valid granular parts. */
-export type DateParts = `${Date} ${Exclude<Month, 'M' | 'MM' | 'MMM' | 'MMMM'>}` | `${Day}, ${Date} ${Exclude<Month, 'M' | 'MM' | 'MMM' | 'MMMM'>}` | `${Exclude<Month, 'M' | 'MM' | 'MMM' | 'MMMM'>} ${Date}, ${Exclude<Year, 'yyyy' | 'yy'>}` | `${Date} ${Exclude<Month, 'M' | 'MM' | 'MMM' | 'MMMM'>}, ${Exclude<Year, 'yyyy' | 'yy'>}` | `${Day}, ${Exclude<Month, 'M' | 'MM' | 'MMM' | 'MMMM'>} ${Date}, ${Exclude<Year, 'yyyy' | 'yy'>}` | `${Day}, ${Date} ${Exclude<Month, 'M' | 'MM' | 'MMM' | 'MMMM'>}, ${Exclude<Year, 'yyyy' | 'yy'>}` | `${Date}/${Exclude<Month, 'MMM' | 'MMMM' | 'mmm' | 'mmmm'>}/${Exclude<Year, 'yyyy' | 'yy'>}` | `${Exclude<Month, 'MMM' | 'MMMM' | 'mmm' | 'mmmm'>}/${Date}/${Exclude<Year, 'yyyy' | 'yy'>}` | `${Exclude<Month, 'MMM' | 'MMMM' | 'mmm' | 'mmmm'>}-${Date}-${Exclude<Year, 'yyyy' | 'yy'>}` | `${Date}-${Exclude<Month, 'MMM' | 'MMMM' | 'mmm' | 'mmmm'>}-${Exclude<Year, 'yyyy' | 'yy'>}` | `${Exclude<Year, 'yyyy' | 'yy'>}-${Exclude<Month, 'MMM' | 'MMMM' | 'mmm' | 'mmmm'>}-${Date}` | `${Exclude<Year, 'yyyy' | 'yy'>}/${Exclude<Month, 'MMM' | 'MMMM' | 'mmm' | 'mmmm'>}/${Date}` | `${Exclude<Year, 'yyyy' | 'yy'>}-${Date}-${Exclude<Month, 'MMM' | 'MMMM' | 'mmm' | 'mmmm'>}` | `${Exclude<Year, 'yyyy' | 'yy'>}/${Date}/${Exclude<Month, 'MMM' | 'MMMM' | 'mmm' | 'mmmm'>}`;
+/** Standard date formats. */
+export type DateParts = `${Date} ${Exclude<Month, 'M' | 'MM'>}` | `${Exclude<Month, 'M' | 'MM'>} ${Date}` | `${Day}, ${Date} ${Exclude<Month, 'M' | 'MM'>}` | `${Day}, ${Exclude<Month, 'M' | 'MM'>} ${Date}` | `${Exclude<Month, 'M' | 'MM'>} ${Date}, ${Year}` | `${Date} ${Exclude<Month, 'M' | 'MM'>}, ${Year}` | `${Exclude<Month, 'M' | 'MM'>} ${Date} ${Year}` | `${Date} ${Exclude<Month, 'M' | 'MM'>} ${Year}` | `${Day}, ${Exclude<Month, 'M' | 'MM'>} ${Date}, ${Year}` | `${Day}, ${Date} ${Exclude<Month, 'M' | 'MM'>}, ${Year}` | `${Day}, ${Exclude<Month, 'M' | 'MM'>} ${Date} ${Year}` | `${Day}, ${Date} ${Exclude<Month, 'M' | 'MM'>} ${Year}` | `${Exclude<Date, 'Do'>}.${Exclude<Month, 'mmm' | 'mmmm'>}.${Year}` | `${Year}.${Exclude<Month, 'mmm' | 'mmmm'>}.${Exclude<Date, 'Do'>}` | `${Exclude<Date, 'Do'>}/${Exclude<Month, 'mmm' | 'mmmm'>}/${Year}` | `${Exclude<Date, 'Do'>}-${Exclude<Month, 'mmm' | 'mmmm'>}-${Year}` | `${Exclude<Month, 'mmm' | 'mmmm'>}/${Exclude<Date, 'Do'>}/${Year}` | `${Exclude<Month, 'mmm' | 'mmmm'>}-${Exclude<Date, 'Do'>}-${Year}` | `${Year}-${Exclude<Month, 'mmm' | 'mmmm'>}-${Exclude<Date, 'Do'>}` | `${Year}/${Exclude<Month, 'mmm' | 'mmmm'>}/${Exclude<Date, 'Do'>}` | `${Year}-${Exclude<Date, 'Do'>}-${Exclude<Month, 'mmm' | 'mmmm'>}` | `${Year}/${Exclude<Date, '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. */
@@ -78,6 +78,69 @@ export type ChronosMethods = {
         [key in K]: (...args: any[]) => Chronos;
     } ? K : never;
 }[keyof typeof Chronos];
+export interface ChronosStatics {
+    (date?: number | string | Date | Chronos): Chronos;
+    /**
+     * * Returns the current date and time in a specified format in local time.
+     * * Default format is dd, `MMM DD, YYYY HH:mm:ss` = `Sun, Apr 06, 2025 16:11:55:379`
+     * @param options - Configure format string and whether to format using utc offset.
+     * @returns Formatted date string in desired format.
+     */
+    today(options?: FormatOptions): string;
+    /**
+     * * Returns the number of milliseconds elapsed since midnight, January 1, 1970 Universal Coordinated Time (UTC).
+     * * It basically calls `Date.now()`.
+     * @returns The number of milliseconds elapsed since the Unix epoch.
+     */
+    now(): number;
+    /** * Parses a date string with a given format (partial support) */
+    parse(dateStr: string, format: string): Chronos;
+    /**
+     * * Creates UTC Chronos
+     * @param dateLike Date input to create utc time.
+     */
+    utc(dateLike: number | string | Date | Chronos): Chronos;
+    /**
+     * * Returns earliest Chronos
+     * @param dates Date inputs.
+     */
+    min(...dates: (number | string | Date | Chronos)[]): Chronos;
+    /**
+     * * Returns latest Chronos
+     * @param dates Date inputs.
+     */
+    max(...dates: (number | string | Date | Chronos)[]): Chronos;
+    /**
+     * * Checks if the year in the date string is a leap year.
+     * - A year is a leap year if it is divisible by 4, but not divisible by 100, unless it is also divisible by 400.
+     * - For example, 2000 and 2400 are leap years, but 1900 and 2100 are not.
+     * @returns `true` if the year is a leap year, `false` otherwise.
+     */
+    isLeapYear(date: number | string | Date | Chronos): boolean;
+    /**
+     * * Checks if the given value is a valid `Date` object.
+     * - A value is considered valid if it is an instance of the built-in `Date` class.
+     * - This does not check whether the date itself is valid (e.g., `new Date('invalid')`).
+     * @param value - The value to test.
+     * @returns `true` if the value is a valid Date object, otherwise `false`.
+     */
+    isValidDate(value: unknown): value is Date;
+    /**
+     * * Checks if the given value is a valid date string.
+     * - A value is considered a valid date string if it is a string and can be parsed by `Date.parse()`.
+     * - This uses the native JavaScript date parser internally.
+     * @param value - The value to test.
+     * @returns `true` if the value is a valid date string, otherwise `false`.
+     */
+    isDateString(value: unknown): value is string;
+    /**
+     * * Checks if the given value is an instance of `Chronos`.
+     * - Useful for verifying Chronos objects in type guards or validations.
+     * @param value - The value to test.
+     * @returns `true` if the value is an instance of `Chronos`, otherwise `false`.
+     */
+    isValidChronos(value: unknown): value is Chronos;
+}
 export type TimeZone = keyof typeof TIME_ZONES;
 export type PositiveUTCHour = '+00' | '+01' | '+02' | '+03' | '+04' | '+05' | '+06' | '+07' | '+08' | '+09' | '+10' | '+11' | '+12' | '+13' | '+14';
 export type NegativeUTCHour = '-00' | '-01' | '-02' | '-03' | '-04' | '-05' | '-06' | '-07' | '-08' | '-09' | '-10' | '-11' | '-12' | '-13' | '-14';

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/date/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/date/types.ts"],"names":[],"mappings":"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"}

package/dist/date/utils.d.ts

@@ -46,4 +46,11 @@ export declare function extractTimeFromUTC(utc: UTCOffSet): `-${Time}` | Time;
  * @returns The total minutes elapsed since `00:00`.
  */
 export declare function extractMinutesFromUTC(utc: UTCOffSet): number;
+/**
+ * * Converts a minute-based offset to a UTC offset string in the format `UTC±HH:MM`.
+ *
+ * @param minutes - The offset in minutes (positive or negative).
+ * @returns A formatted UTC offset string like `UTC+05:30` or `UTC-04:00`.
+ */
+export declare function formatUTCOffset(minutes: number): UTCOffSet;
 //# sourceMappingURL=utils.d.ts.map

package/dist/date/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/date/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,GAAG,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAI3E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,GAAG,IAAI,GAAG,MAAM,CAU/D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,WAE9D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,IAAI,EAAE,GAAG,IAAI,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAE5D"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/date/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,GAAG,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAI3E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,GAAG,IAAI,GAAG,MAAM,CAU/D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,WAE9D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,IAAI,EAAE,GAAG,IAAI,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAM1D"}

package/dist/date/utils.js

@@ -61,3 +61,16 @@ export function extractTimeFromUTC(utc) {
 export function extractMinutesFromUTC(utc) {
     return getTotalMinutes(extractTimeFromUTC(utc));
 }
+/**
+ * * Converts a minute-based offset to a UTC offset string in the format `UTC±HH:MM`.
+ *
+ * @param minutes - The offset in minutes (positive or negative).
+ * @returns A formatted UTC offset string like `UTC+05:30` or `UTC-04:00`.
+ */
+export function formatUTCOffset(minutes) {
+    const sign = minutes < 0 ? '-' : '+';
+    const abs = Math.abs(minutes);
+    const hours = String(Math.floor(abs / 60)).padStart(2, '0');
+    const mins = String(abs % 60).padStart(2, '0');
+    return `UTC${sign}${hours}:${mins}`;
+}

package/dist/index.d.ts

@@ -7,7 +7,7 @@ export { calculateHCF as calculateGCD, calculateHCF, calculateLCM as calculateLC
 export { isEven, isEven as isEvenNumber, isFibonacci, isMultiple, isOdd, isOdd as isOddNumber, isFibonacci as isParOfFibonacci, isFibonacci as isParOfFibonacciSeries, isPerfectSquare, } from './number/guards';
 export { numberToWords as convertNumberToWords, convertToRomanNumerals, numberToWords, } from './number/convert';
 export { findPrimeNumbers, findPrimeNumbers as getPrimeNumbers, isPrime, isPrime as isPrimeNumber, } from './number/prime';
-export { clampNumber, formatCurrency as convertNumberToCurrency, formatCurrency, getRandomFloat as getRandomDecimal, getRandomFloat, roundToNearest as roundNumber, roundToNearest as roundNumberToNearestInterval, roundToNearest, roundToNearest as roundToNearestInterval, } from './number/utilities';
+export { getOrdinal as cardinalToOrdinal, clampNumber, formatCurrency as convertNumberToCurrency, getOrdinal as convertNumberToOrdinal, getOrdinal as convertToOrdinal, formatCurrency, getOrdinal, getOrdinal as getOrdinalNumber, getRandomFloat as getRandomDecimal, getRandomFloat, getOrdinal as numberToOrdinal, roundToNearest as roundNumber, roundToNearest as roundNumberToNearestInterval, roundToNearest, roundToNearest as roundToNearestInterval, } from './number/utilities';
 export { getNumbersInRange } from './number/range';
 export { getColorForInitial } from './colors/initials';
 export { generateRandomColorInHexRGB, generateRandomHSLColor, } from './colors/random';
@@ -16,10 +16,11 @@ export { Color, Color as Colour } from './colors/Color';
 export { getGreeting as generateGreeting, getGreeting, getGreeting as greet, } from './date/greet';
 export { isLeapYear, isValidTime, isValidTime as isValidTimeString, isValidUTCOffSet as isValidUTC, isValidUTCOffSet, } from './date/guards';
 export { Chronos, Chronos as Chronus } from './date/Chronos';
-export { chronos, chronos as chronosjs, chronos as chronosts, chronos as chronus, chronos as chronusjs, chronos as chronusts, extractHourMinute, extractMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, getCurrentDateTime, getCurrentDateTime as getCurrentTime, extractMinutesFromUTC as getMinutesFromUTC, extractTimeFromUTC as getTimeStringFromUTC, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, extractMinutesFromUTC as getTotalMinutesFromUTC, } from './date/utils';
+export { chronos, chronos as chronosjs, chronos as chronosts, chronos as chronus, chronos as chronusjs, chronos as chronusts, formatUTCOffset as convertMinutesToUTCOffset, extractHourMinute, extractMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, formatUTCOffset, getCurrentDateTime, getCurrentDateTime as getCurrentTime, extractMinutesFromUTC as getMinutesFromUTC, extractTimeFromUTC as getTimeStringFromUTC, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, extractMinutesFromUTC as getTotalMinutesFromUTC, formatUTCOffset as minutesToUTCOffset, } from './date/utils';
 export { filterArrayOfObjects, flattenArray, getLastArrayElement, isInvalidOrEmptyArray, isInvalidOrEmptyArray as isValidEmptyArray, shuffleArray, } from './array/basics';
 export { sortAnArray } from './array/sort';
 export { createOptionsArray, moveArrayElement, removeDuplicatesFromArray, rotateArray, splitArray, } from './array/transform';
+export { naturalSort as compareNaturally, naturalSort as compareSorter, naturalSort, naturalSort as naturalSortForString, } from './array/utils';
 export { createControlledFormData as convertIntoFormData, createControlledFormData, createControlledFormData as createFormData, } from './form/convert';
 export { isCustomFile, isCustomFileArray, isFileArray, isFileList, isFileUpload, isOriginFileObj, isValidFormData, } from './form/guards';
 export { cloneObject, countObjectFields } from './object/basics';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -9,7 +9,7 @@ export { calculateHCF as calculateGCD, calculateHCF, calculateLCM as calculateLC
 export { isEven, isEven as isEvenNumber, isFibonacci, isMultiple, isOdd, isOdd as isOddNumber, isFibonacci as isParOfFibonacci, isFibonacci as isParOfFibonacciSeries, isPerfectSquare, } from './number/guards';
 export { numberToWords as convertNumberToWords, convertToRomanNumerals, numberToWords, } from './number/convert';
 export { findPrimeNumbers, findPrimeNumbers as getPrimeNumbers, isPrime, isPrime as isPrimeNumber, } from './number/prime';
-export { clampNumber, formatCurrency as convertNumberToCurrency, formatCurrency, getRandomFloat as getRandomDecimal, getRandomFloat, roundToNearest as roundNumber, roundToNearest as roundNumberToNearestInterval, roundToNearest, roundToNearest as roundToNearestInterval, } from './number/utilities';
+export { getOrdinal as cardinalToOrdinal, clampNumber, formatCurrency as convertNumberToCurrency, getOrdinal as convertNumberToOrdinal, getOrdinal as convertToOrdinal, formatCurrency, getOrdinal, getOrdinal as getOrdinalNumber, getRandomFloat as getRandomDecimal, getRandomFloat, getOrdinal as numberToOrdinal, roundToNearest as roundNumber, roundToNearest as roundNumberToNearestInterval, roundToNearest, roundToNearest as roundToNearestInterval, } from './number/utilities';
 export { getNumbersInRange } from './number/range';
 // ! Color Utilities
 export { getColorForInitial } from './colors/initials';
@@ -20,11 +20,12 @@ export { Color, Color as Colour } from './colors/Color';
 export { getGreeting as generateGreeting, getGreeting, getGreeting as greet, } from './date/greet';
 export { isLeapYear, isValidTime, isValidTime as isValidTimeString, isValidUTCOffSet as isValidUTC, isValidUTCOffSet, } from './date/guards';
 export { Chronos, Chronos as Chronus } from './date/Chronos';
-export { chronos, chronos as chronosjs, chronos as chronosts, chronos as chronus, chronos as chronusjs, chronos as chronusts, extractHourMinute, extractMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, getCurrentDateTime, getCurrentDateTime as getCurrentTime, extractMinutesFromUTC as getMinutesFromUTC, extractTimeFromUTC as getTimeStringFromUTC, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, extractMinutesFromUTC as getTotalMinutesFromUTC, } from './date/utils';
+export { chronos, chronos as chronosjs, chronos as chronosts, chronos as chronus, chronos as chronusjs, chronos as chronusts, formatUTCOffset as convertMinutesToUTCOffset, extractHourMinute, extractMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, formatUTCOffset, getCurrentDateTime, getCurrentDateTime as getCurrentTime, extractMinutesFromUTC as getMinutesFromUTC, extractTimeFromUTC as getTimeStringFromUTC, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, extractMinutesFromUTC as getTotalMinutesFromUTC, formatUTCOffset as minutesToUTCOffset, } from './date/utils';
 // ! Array Utilities
 export { filterArrayOfObjects, flattenArray, getLastArrayElement, isInvalidOrEmptyArray, isInvalidOrEmptyArray as isValidEmptyArray, shuffleArray, } from './array/basics';
 export { sortAnArray } from './array/sort';
 export { createOptionsArray, moveArrayElement, removeDuplicatesFromArray, rotateArray, splitArray, } from './array/transform';
+export { naturalSort as compareNaturally, naturalSort as compareSorter, naturalSort, naturalSort as naturalSortForString, } from './array/utils';
 // ! Form Utilities
 export { createControlledFormData as convertIntoFormData, createControlledFormData, createControlledFormData as createFormData, } from './form/convert';
 export { isCustomFile, isCustomFileArray, isFileArray, isFileList, isFileUpload, isOriginFileObj, isValidFormData, } from './form/guards';

package/dist/number/utilities.d.ts

@@ -1,3 +1,4 @@
+import type { Numeric } from '../types';
 import type { CurrencyCode, LocaleCode } from './types';
 /**
  * * Rounds a number to the nearest specified interval.
@@ -37,4 +38,15 @@ export declare const clampNumber: (value: number, min: number, max: number) => n
  * @example randomFloat(1.5, 3.5) → 2.84623
  */
 export declare const getRandomFloat: (min: number, max: number) => number;
+/**
+ * * Returns the ordinal suffix for a given number (e.g., 1 -> 'st', 2 -> 'nd', 3 -> 'rd', 4 -> 'th' etc.).
+ * @description The function handles special cases for 11, 12, and 13, which all use 'th' despite the last digit.
+ * If the `withNumber` parameter is `true`, the function returns the number along with its ordinal suffix (e.g., "1st").
+ * Otherwise, it returns only the ordinal suffix (e.g., "st").
+ *
+ * @param n - The number or number string to get the ordinal suffix for.
+ * @param withNumber - Whether to include the number along with its ordinal suffix (defaults to `true`).
+ * @returns The appropriate ordinal suffix, optionally with the number (e.g., '1st' or 'st`, '2nd' or 'nd' and so on.).
+ */
+export declare const getOrdinal: (n: Numeric, withNumber?: boolean) => string;
 //# sourceMappingURL=utilities.d.ts.map

package/dist/number/utilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../src/number/utilities.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,UAAW,MAAM,wBAAiB,MACrB,CAAC;AAEzC;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,UACnB,MAAM,GAAG,GAAG,MAAM,EAAE,aACjB,YAAY,WACb,UAAU,KACjB,MAQF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,UAAW,MAAM,OAAO,MAAM,OAAO,MAAM,KAAG,MAClC,CAAC;AAErC;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,QAAS,MAAM,OAAO,MAAM,KAAG,MAEzD,CAAC"}
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../src/number/utilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,UAAW,MAAM,wBAAiB,MACrB,CAAC;AAEzC;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,UACnB,MAAM,GAAG,GAAG,MAAM,EAAE,aACjB,YAAY,WACb,UAAU,KACjB,MAQF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,UAAW,MAAM,OAAO,MAAM,OAAO,MAAM,KAAG,MAClC,CAAC;AAErC;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,QAAS,MAAM,OAAO,MAAM,KAAG,MAEzD,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,MAAO,OAAO,2BAAsB,MAiB1D,CAAC"}

package/dist/number/utilities.js

@@ -45,3 +45,31 @@ export const clampNumber = (value, min, max) => Math.max(min, Math.min(value, ma
 export const getRandomFloat = (min, max) => {
     return Math.random() * (max - min) + min;
 };
+/**
+ * * Returns the ordinal suffix for a given number (e.g., 1 -> 'st', 2 -> 'nd', 3 -> 'rd', 4 -> 'th' etc.).
+ * @description The function handles special cases for 11, 12, and 13, which all use 'th' despite the last digit.
+ * If the `withNumber` parameter is `true`, the function returns the number along with its ordinal suffix (e.g., "1st").
+ * Otherwise, it returns only the ordinal suffix (e.g., "st").
+ *
+ * @param n - The number or number string to get the ordinal suffix for.
+ * @param withNumber - Whether to include the number along with its ordinal suffix (defaults to `true`).
+ * @returns The appropriate ordinal suffix, optionally with the number (e.g., '1st' or 'st`, '2nd' or 'nd' and so on.).
+ */
+export const getOrdinal = (n, withNumber = true) => {
+    const remainder10 = Number(n) % 10;
+    const remainder100 = Number(n) % 100;
+    let suffix;
+    if (remainder10 === 1 && remainder100 !== 11) {
+        suffix = 'st';
+    }
+    else if (remainder10 === 2 && remainder100 !== 12) {
+        suffix = 'nd';
+    }
+    else if (remainder10 === 3 && remainder100 !== 13) {
+        suffix = 'rd';
+    }
+    else {
+        suffix = 'th';
+    }
+    return withNumber ? String(n).concat(suffix) : suffix;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "3.8.1",
+  "version": "3.8.4",
   "description": "A versatile collection of smart, efficient, and reusable utility functions for everyday development needs.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",