nhb-toolbox 3.8.2 → 3.8.5

package/dist/date/Chronos.d.ts

@@ -21,6 +21,9 @@ export declare class Chronos {
      * @returns The primitive value based on the hint.
      */
     [Symbol.toPrimitive](hint: string): string | number;
+    [Symbol.replace](string: string, replacement: string): string;
+    [Symbol.search](string: string): number;
+    [Symbol.split](string: string): string[];
     get [Symbol.toStringTag](): string;
     /** Gets the full year of the date. */
     get year(): number;
@@ -44,7 +47,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 +75,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,7 +84,7 @@ 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`).
      */
@@ -98,7 +101,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 +325,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.
      */
@@ -333,7 +336,29 @@ export declare class Chronos {
      * @returns The number of milliseconds elapsed since the Unix epoch.
      */
     static now(): number;
-    /** @public @static Parses a date string with a given format (partial support) */
+    /**
+     * @public @static Parses a date string with a given format (partial support)
+     *
+     * * **Supported format tokens**:
+     * - `YYYY`: Full year (e.g., 2023)
+     * - `YY`: Two-digit year (e.g., 23 for 2023, 99 for 1999)
+     * - `MM`: Month (01-12)
+     * - `DD`: Day of the month (01-31)
+     * - `HH`: Hour (00-23)
+     * - `mm`: Minute (00-59)
+     * - `ss`: Second (00-59)
+     *
+     * **Example**:
+     * ```ts
+     * Chronos.parse('23-12-31 15:30:45', 'YY-MM-DD HH:mm:ss');
+     * // returns Chronos instance with the parsed date 2023-12-31T15:30:45
+     * ```
+     *
+     * @param {string} dateStr - The date string to be parsed
+     * @param {string} format - The format of the date string. Tokens like `YYYY`, `MM`, `DD`, `HH`, `mm`, `ss` are used to specify the structure.
+     * @returns {Chronos} - A new `Chronos` instance representing the parsed date.
+     * @throws {Error} - If the date string does not match the format.
+     */
     static parse(dateStr: string, format: string): Chronos;
     /**
      * @public @static Creates UTC Chronos

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,10 +1,11 @@
 import { isString } from '../guards/primitives';
 import { getOrdinal } from '../number/utilities';
-import { DAYS, MONTHS, ORIGIN, sortedFormats, TIME_ZONES } from './constants';
+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.
@@ -19,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,8 +44,40 @@ export class Chronos {
             return this.valueOf();
         return this.toLocalISOString();
     }
+    [Symbol.replace](string, replacement) {
+        switch (this[ORIGIN]) {
+            case 'timeZone':
+            case 'toUTC':
+            case 'utc':
+                return string.replace(this.toISOString().replace(/\.\d+(Z|[+-]\d{2}:\d{2})?$/, ''), replacement);
+            default:
+                return string.replace(this.toLocalISOString().replace(/\.\d+(Z|[+-]\d{2}:\d{2})?$/, ''), replacement);
+        }
+    }
+    [Symbol.search](string) {
+        switch (this[ORIGIN]) {
+            case 'timeZone':
+            case 'toUTC':
+            case 'utc':
+                return string.indexOf(this.toISOString().replace(/\.\d+(Z|[+-]\d{2}:\d{2})?$/, ''));
+            default:
+                return string.indexOf(this.toLocalISOString().replace(/\.\d+(Z|[+-]\d{2}:\d{2})?$/, ''));
+        }
+    }
+    [Symbol.split](string) {
+        switch (this[ORIGIN]) {
+            case 'timeZone':
+            case 'toUTC':
+            case 'utc':
+                return string.split(this.toISOString().replace(/\.\d+(Z|[+-]\d{2}:\d{2})?$/, ''));
+            default:
+                return string.split(this.toLocalISOString().replace(/\.\d+(Z|[+-]\d{2}:\d{2})?$/, ''));
+        }
+    }
     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');
@@ -51,10 +85,18 @@ export class Chronos {
                 return this.#toLocalISOString();
         }
     }
-    /** @private @instance Method to tag origin of the `Chronos` instance. */
-    #withOrigin(origin) {
+    /**
+     * @private @instance Method to tag origin of the `Chronos` instance.
+     *
+     * @param origin Origin of the instance, the method name from where it was created.
+     * @param offset Optional UTC offset in `UTC+12:00` format.
+     * @returns The `Chronos` instance with the specified origin.
+     */
+    #withOrigin(origin, offset) {
         const instance = new Chronos(this.#date);
         instance[ORIGIN] = origin;
+        if (offset)
+            instance.#offset = offset;
         return instance;
     }
     /**
@@ -104,7 +146,7 @@ export class Chronos {
             ddd: DAYS[day],
             D: String(date),
             DD: String(date).padStart(2, '0'),
-            Do: String(date) + getOrdinal(date),
+            Do: getOrdinal(date),
             H: String(hours),
             HH: String(hours).padStart(2, '0'),
             h: String(hours % 12 || 12),
@@ -194,7 +236,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()}]`;
     }
@@ -212,11 +254,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()}`);
@@ -230,6 +288,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()}`);
@@ -243,6 +302,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');
@@ -266,24 +327,24 @@ 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);
     }
     /**
@@ -300,10 +361,10 @@ export 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 = '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':
@@ -380,15 +441,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.
@@ -952,12 +1016,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);
     }
@@ -969,18 +1033,41 @@ export class Chronos {
     static now() {
         return Date.now();
     }
-    /** @public @static Parses a date string with a given format (partial support) */
+    /**
+     * @public @static Parses a date string with a given format (partial support)
+     *
+     * * **Supported format tokens**:
+     * - `YYYY`: Full year (e.g., 2023)
+     * - `YY`: Two-digit year (e.g., 23 for 2023, 99 for 1999)
+     * - `MM`: Month (01-12)
+     * - `DD`: Day of the month (01-31)
+     * - `HH`: Hour (00-23)
+     * - `mm`: Minute (00-59)
+     * - `ss`: Second (00-59)
+     *
+     * **Example**:
+     * ```ts
+     * Chronos.parse('23-12-31 15:30:45', 'YY-MM-DD HH:mm:ss');
+     * // returns Chronos instance with the parsed date 2023-12-31T15:30:45
+     * ```
+     *
+     * @param {string} dateStr - The date string to be parsed
+     * @param {string} format - The format of the date string. Tokens like `YYYY`, `MM`, `DD`, `HH`, `mm`, `ss` are used to specify the structure.
+     * @returns {Chronos} - A new `Chronos` instance representing the parsed date.
+     * @throws {Error} - If the date string does not match the format.
+     */
     static parse(dateStr, format) {
         const formatMap = {
             YYYY: 'year',
+            YY: 'year', // Support for two-digit year
             MM: 'month',
             DD: 'date',
             HH: 'hour',
             mm: 'minute',
             ss: 'second',
         };
-        const regex = format.replace(/YYYY|MM|DD|HH|mm|ss/g, (match) => {
-            return `(?<${match}>\\d{${match.length}})`;
+        const regex = format.replace(/YYYY|YY|MM|DD|HH|mm|ss/g, (match) => {
+            return `(?<${match}>\\d{${match.length}})`; // Adjust regex for each format token
         });
         const match = new RegExp(`^${regex}$`).exec(dateStr);
         if (!match?.groups) {
@@ -993,6 +1080,11 @@ export class Chronos {
             }
             return acc;
         }, {});
+        // Adjust for 2-digit year (YY) by assuming the year is in the 1900s or 2000s
+        if (values.year && values.year < 100) {
+            // Assuming 21st century for years < 100 (00-99 becomes 2000-2099)
+            values.year += 2000;
+        }
         return new Chronos(new Date(values.year ?? 1970, (values.month ?? 1) - 1, values.date ?? 1, values.hour ?? 0, values.minute ?? 0, values.second ?? 0)).#withOrigin('parse');
     }
     /**

package/dist/date/chronos-fn.d.ts

@@ -0,0 +1,43 @@
+import type { ChronosStatics } from './types';
+/**
+ * * Converts a date into a Chronos object.
+ * @description
+ * This function serves as a wrapper around the `Chronos` class constructor and allows you to create a new `Chronos` instance from various types of date representations.
+ * The following types of input are supported:
+ *
+ * - **`string`**: A string representing a date, which can be parsed by the JavaScript `Date` constructor.
+ *   Example: `"2023-12-31"`.
+ * - **`number`**: A timestamp representing the number of milliseconds since the Unix epoch.
+ *   Example: `1672531199000`.
+ * - **`Date`**: A JavaScript `Date` object.
+ * - **`Chronos`**: A `Chronos` instance created by the same constructor.
+ *
+ * This function also allows you to access static methods from the `Chronos` class, as it copies all static methods from `Chronos` to the `chronos` function itself.
+ * Therefore, static methods can be called either through the `Chronos` class directly or through the `chronos` function.
+ *
+ * @example
+ * Example usage:
+ *
+ * ```ts
+ * const chronosInstanceFn = chronos("2023-12-31");
+ * const chronosInstanceClass = new Chronos("2023-12-31");
+ * const sameInstanceFn = chronos.parse("2023-12-31", "YYYY-MM-DD");
+ * const sameInstanceClass = Chronos.parse("2023-12-31", "YYYY-MM-DD");
+ * ```
+ *
+ * @param date - The date value to be converted into a `Chronos` object.
+ * @returns new `Chronos` instance representing the provided date.
+ *
+ * @static
+ * @remarks
+ * Static methods can be accessed from both the `Chronos` class and the `chronos` function.
+ * Static methods from the `Chronos` class are copied over to the `chronos` function, so you can call them like:
+ * ```ts
+ * chronos.parse("2023-12-31", "YYYY-MM-DD");
+ * // Or
+ * Chronos.parse("2023-12-31", "YYYY-MM-DD");
+ * ```
+ */
+declare const chronos: ChronosStatics;
+export { chronos };
+//# sourceMappingURL=chronos-fn.d.ts.map

package/dist/date/chronos-fn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chronos-fn.d.ts","sourceRoot":"","sources":["../../src/date/chronos-fn.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,QAAA,MAAM,OAAO,EAEP,cAAc,CAAC;AAsBrB,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/date/chronos-fn.js

@@ -0,0 +1,62 @@
+import { Chronos } from '..';
+/**
+ * * Converts a date into a Chronos object.
+ * @description
+ * This function serves as a wrapper around the `Chronos` class constructor and allows you to create a new `Chronos` instance from various types of date representations.
+ * The following types of input are supported:
+ *
+ * - **`string`**: A string representing a date, which can be parsed by the JavaScript `Date` constructor.
+ *   Example: `"2023-12-31"`.
+ * - **`number`**: A timestamp representing the number of milliseconds since the Unix epoch.
+ *   Example: `1672531199000`.
+ * - **`Date`**: A JavaScript `Date` object.
+ * - **`Chronos`**: A `Chronos` instance created by the same constructor.
+ *
+ * This function also allows you to access static methods from the `Chronos` class, as it copies all static methods from `Chronos` to the `chronos` function itself.
+ * Therefore, static methods can be called either through the `Chronos` class directly or through the `chronos` function.
+ *
+ * @example
+ * Example usage:
+ *
+ * ```ts
+ * const chronosInstanceFn = chronos("2023-12-31");
+ * const chronosInstanceClass = new Chronos("2023-12-31");
+ * const sameInstanceFn = chronos.parse("2023-12-31", "YYYY-MM-DD");
+ * const sameInstanceClass = Chronos.parse("2023-12-31", "YYYY-MM-DD");
+ * ```
+ *
+ * @param date - The date value to be converted into a `Chronos` object.
+ * @returns new `Chronos` instance representing the provided date.
+ *
+ * @static
+ * @remarks
+ * Static methods can be accessed from both the `Chronos` class and the `chronos` function.
+ * Static methods from the `Chronos` class are copied over to the `chronos` function, so you can call them like:
+ * ```ts
+ * chronos.parse("2023-12-31", "YYYY-MM-DD");
+ * // Or
+ * Chronos.parse("2023-12-31", "YYYY-MM-DD");
+ * ```
+ */
+const chronos = ((date) => {
+    return new Chronos(date);
+});
+// Add static methods from Chronos class to the chronos function
+Object.getOwnPropertyNames(Chronos).forEach((method) => {
+    // Exclude non-method properties like `length`, `name`, `prototype`
+    if (method !== 'prototype' && method !== 'name' && method !== 'length') {
+        chronos[method] = Chronos[method];
+    }
+});
+// Add instance methods from Chronos prototype to chronos function
+Object.getOwnPropertyNames(Chronos.prototype).forEach((method) => {
+    // Skip the constructor method
+    if (method !== 'constructor') {
+        chronos[method] = function (...args) {
+            return this instanceof Chronos ?
+                this[method](...args)
+                : new Chronos()[method](...args); // Fallback to new Chronos instance
+        };
+    }
+});
+export { chronos };

package/dist/date/constants.d.ts

@@ -1,3 +1,4 @@
+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"];
@@ -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

@@ -326,3 +326,60 @@ export const TIME_ZONES = {
     /** Petropavlovsk-Kamchatsky Time (Russia) */
     PETT: 12 * 60,
 };
+export const TIME_ZONE_LABELS = {
+    'UTC-12:00': 'Baker Island Time', // and Howland Island
+    // 'UTC-11:30': 'Niue Time',
+    // 'UTC-11:00': 'Niue Time',
+    'UTC-11:00': 'Samoa Standard Time',
+    // 'UTC-10:30': 'Marquesas Time',
+    'UTC-10:00': 'Hawaii-Aleutian Standard Time',
+    'UTC-09:30': 'Marquesas Islands Time',
+    'UTC-09:00': 'Alaskan 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': 'SA Eastern Standard Time',
+    'UTC-02:30': 'Mid-Atlantic Time (Unofficial)',
+    'UTC-02:00': 'Mid-Atlantic Standard 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 Standard Time',
+    'UTC+01:30': 'Central Africa Time (Unofficial)',
+    'UTC+02:00': 'Eastern European Standard Time',
+    'UTC+02:30': 'Israel Standard Time (Historical)',
+    'UTC+03:00': 'Arab 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': 'India Standard Time',
+    'UTC+05:45': 'Nepal Standard Time',
+    'UTC+06:00': 'Bangladesh Standard Time',
+    'UTC+06:30': 'Myanmar Standard Time',
+    'UTC+07:00': 'Indochina Standard Time',
+    'UTC+07:30': 'Western Indonesia Time (Unofficial)',
+    'UTC+08:00': 'China Standard Time',
+    'UTC+08:30': 'North Korea Standard Time',
+    'UTC+08:45': 'South-Western Australia Standard Time',
+    'UTC+09:00': 'Japan Standard Time',
+    'UTC+09:30': 'Central Australia Standard Time',
+    'UTC+10:00': 'Eastern Australia Standard Time',
+    'UTC+10:30': 'Lord Howe Standard Time',
+    'UTC+11:00': 'Central Pacific Standard 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

@@ -78,6 +78,91 @@ 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;
+    /**
+     * @public @static Parses a date string with a given format (partial support)
+     *
+     * * **Supported format tokens**:
+     * - `YYYY`: Full year (e.g., 2023)
+     * - `YY`: Two-digit year (e.g., 23 for 2023, 99 for 1999)
+     * - `MM`: Month (01-12)
+     * - `DD`: Day of the month (01-31)
+     * - `HH`: Hour (00-23)
+     * - `mm`: Minute (00-59)
+     * - `ss`: Second (00-59)
+     *
+     * **Example**:
+     * ```ts
+     * Chronos.parse('23-12-31 15:30:45', 'YY-MM-DD HH:mm:ss');
+     * // returns Chronos instance with the parsed date 2023-12-31T15:30:45
+     * ```
+     *
+     * @param {string} dateStr - The date string to be parsed
+     * @param {string} format - The format of the date string. Tokens like `YYYY`, `MM`, `DD`, `HH`, `mm`, `ss` are used to specify the structure.
+     * @returns {Chronos} - A new `Chronos` instance representing the parsed date.
+     * @throws {Error} - If the date string does not match the format.
+     */
+    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

@@ -1,4 +1,3 @@
-import { Chronos } from './Chronos';
 import type { Time, UTCOffSet } from './types';
 /**
  * * Extracts the hour and minute from a time string in `HH:MM` or `-HH:MM` format.
@@ -21,17 +20,6 @@ export declare function getTotalMinutes(time: `-${Time}` | Time): number;
  * @returns The current date and time as a `Date` object.
  */
 export declare function getCurrentDateTime(): Date;
-/**
- * * Converts a date into a Chronos object.
- *
- * @param date - A date value. It can be a `string`, `number`, `Date`, or `Chronos` object.
- * - If a string is provided, it should be in a format that can be parsed by the Date constructor.
- * - If a number is provided, it should be a timestamp (milliseconds since the Unix epoch).
- * - If a Date object is provided, it will be used as is.
- * - If a Chronos object is provided, it will be converted to a Date object.
- * @returns A new Chronos object representing the provided date.
- */
-export declare function chronos(date?: number | string | Date | Chronos): Chronos;
 /**
  * * Extract Time in `HH:MM` format from given UTC value.
  *
@@ -46,4 +34,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,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;AAgBD;;;;;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

@@ -1,4 +1,3 @@
-import { Chronos } from './Chronos';
 /**
  * * Extracts the hour and minute from a time string in `HH:MM` or `-HH:MM` format.
  *
@@ -30,19 +29,19 @@ export function getTotalMinutes(time) {
 export function getCurrentDateTime() {
     return new Date();
 }
-/**
- * * Converts a date into a Chronos object.
- *
- * @param date - A date value. It can be a `string`, `number`, `Date`, or `Chronos` object.
- * - If a string is provided, it should be in a format that can be parsed by the Date constructor.
- * - If a number is provided, it should be a timestamp (milliseconds since the Unix epoch).
- * - If a Date object is provided, it will be used as is.
- * - If a Chronos object is provided, it will be converted to a Date object.
- * @returns A new Chronos object representing the provided date.
- */
-export function chronos(date) {
-    return new Chronos(date);
-}
+// /**
+//  * * Converts a date into a Chronos object.
+//  *
+//  * @param date - A date value. It can be a `string`, `number`, `Date`, or `Chronos` object.
+//  * - If a string is provided, it should be in a format that can be parsed by the Date constructor.
+//  * - If a number is provided, it should be a timestamp (milliseconds since the Unix epoch).
+//  * - If a Date object is provided, it will be used as is.
+//  * - If a Chronos object is provided, it will be converted to a Date object.
+//  * @returns A new Chronos object representing the provided date.
+//  */
+// export function chronos(date?: number | string | Date | Chronos) {
+// 	return new Chronos(date);
+// }
 /**
  * * Extract Time in `HH:MM` format from given UTC value.
  *
@@ -61,3 +60,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,11 +16,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, } from './date/chronos-fn';
+export { 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 } from './array/utils';
+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,12 +20,13 @@ 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, } from './date/chronos-fn';
+export { 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 } from './array/utils';
+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,5 +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;
-export declare const getOrdinal: (n: number) => string;
+/**
+ * * 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;AAEF,eAAO,MAAM,UAAU,MAAO,MAAM,KAAG,MAQtC,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,14 +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;
 };
-export const getOrdinal = (n) => {
-    const remainder10 = n % 10;
-    const remainder100 = n % 100;
-    if (remainder10 === 1 && remainder100 !== 11)
-        return 'st';
-    if (remainder10 === 2 && remainder100 !== 12)
-        return 'nd';
-    if (remainder10 === 3 && remainder100 !== 13)
-        return 'rd';
-    return 'th';
+/**
+ * * 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/dist/object/objectify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"objectify.d.ts","sourceRoot":"","sources":["../../src/object/objectify.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,UAAU,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,aAAa,cAAc,CAAC,EAAE,KAAG,CAuCvE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,aAAa,cACjD,CAAC,EAAE,KACb,aAyBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,aAAa,UACpD,CAAC,KACP,CAmBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,aAAa,UACvD,CAAC,KACP,aAkCF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,aAAa,cAC/C,CAAC,iBACE,cAAc,CAAC,CAAC,CAAC,KAC9B,cAAc,CAAC,CAAC,CAwBlB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC5B,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,aAAa,cAEX,CAAC,iBACE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,KAClD,cAAc,CAAC,CAAC,CAyBlB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GACtC,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,aAAa,cAEX,CAAC,iBACE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,KAClD,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAwBtC,CAAC"}
+{"version":3,"file":"objectify.d.ts","sourceRoot":"","sources":["../../src/object/objectify.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAO,cAAc,EAAE,MAAM,UAAU,CAAC;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,aAAa,cAAc,CAAC,EAAE,KAAG,CAuCvE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,aAAa,cACjD,CAAC,EAAE,KACb,aAyBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,aAAa,UACpD,CAAC,KACP,CAmBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,aAAa,UACvD,CAAC,KACP,aAkCF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,aAAa,cAC/C,CAAC,iBACE,cAAc,CAAC,CAAC,CAAC,KAC9B,cAAc,CAAC,CAAC,CAwBlB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC5B,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,aAAa,cAEX,CAAC,iBACE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,KAClD,cAAc,CAAC,CAAC,CAyBlB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GACtC,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,aAAa,cAEX,CAAC,iBACE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,KAClD,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAwBtC,CAAC"}

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
 /** Uncontrolled any to use for edge cases */
-export type UncontrolledAny = any;
+export type Any = any;
 declare const __brand: unique symbol;
 type Brand<B> = {
     [__brand]: B;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC;AAElC,OAAO,CAAC,MAAM,OAAO,EAAE,OAAO,MAAM,CAAC;AACrC,KAAK,KAAK,CAAC,CAAC,IAAI;IAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAEjC,6BAA6B;AAC7B,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;KAChC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,CAAC,GAAG,KAAK;CACxE,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,IAC3E;KACE,CAAC,IAAI,MAAM,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CACxD,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAC/B,GACA,CAAC,GACA,KAAK;CACP,CAAC,MAAM,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1B;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,IAAI;KAC5E,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,CAAC,GAAG,KAAK;CACxE,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,IACjE,mBAAmB,CAAC,CAAC,CAAC,GACtB,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAExB;;;GAGG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,IAAI;KACpE,CAAC,IAAI,mBAAmB,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACjD,CAAC;AAEF,2CAA2C;AAC3C,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,OAAO,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,CAAC;AAElE,2CAA2C;AAG3C,2CAA2C;AAC3C,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;AAE3C,+BAA+B;AAC/B,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAErE,8CAA8C;AAC9C,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;KAC5B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,GAAG,CAAC,GAAG,KAAK;CAClD,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,0EAA0E;AAC1E,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;KACtC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,CAAC,GAAG,KAAK;CAClE,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,4BAA4B;AAC5B,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;AAE/D,4BAA4B;AAC5B,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAExD,gDAAgD;AAChD,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAEpD,kDAAkD;AAClD,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,YAAY,IAAI,CAC/C,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAClB,IAAI,CAAC;AAEV,mDAAmD;AACnD,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,YAAY,IAAI,CACjD,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAClB,IAAI,CAAC;AAEV,iCAAiC;AACjC,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAElE,mCAAmC;AACnC,MAAM,MAAM,aAAa,GACtB,KAAK,CAAC,OAAO,CAAC,GACd,IAAI,GACJ,QAAQ,GACR,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,GACzB,OAAO,CAAC,OAAO,CAAC,GAChB,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,GACrB,GAAG,CAAC,OAAO,CAAC,GACZ,SAAS,GACT,YAAY,GACZ,aAAa,CAAC,OAAO,CAAC,GACtB,OAAO,CAAC,OAAO,CAAC,GAChB,KAAK,GACL,SAAS,GACT,UAAU,GACV,cAAc,GACd,WAAW,GACX,SAAS,GACT,QAAQ,GACR,MAAM,GACN,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/package.json

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