nhb-toolbox 4.26.21 → 4.26.40

package/dist/cjs/number/constants.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PREFIX_MULTIPLIERS = exports.UNITS = exports.SUPPORTED_CURRENCIES = exports.CURRENCY_LOCALES = exports.LOCALE_CODES = exports.CURRENCY_CODES = exports.ORDINAL_TO_CARDINAL = exports.ORDINAL_UNDER_TEEN = exports.THOUSANDS = exports.TENS = exports.TEENS = exports.ONES = void 0;
-exports.ONES = Object.freeze([
+exports.ONES = /* @__PURE__ */ Object.freeze([
     '',
     'one',
     'two',
@@ -13,7 +13,7 @@ exports.ONES = Object.freeze([
     'eight',
     'nine',
 ]);
-exports.TEENS = Object.freeze([
+exports.TEENS = /* @__PURE__ */ Object.freeze([
     'ten',
     'eleven',
     'twelve',
@@ -25,7 +25,7 @@ exports.TEENS = Object.freeze([
     'eighteen',
     'nineteen',
 ]);
-exports.TENS = Object.freeze([
+exports.TENS = /* @__PURE__ */ Object.freeze([
     '',
     'ten',
     'twenty',
@@ -37,7 +37,7 @@ exports.TENS = Object.freeze([
     'eighty',
     'ninety',
 ]);
-exports.THOUSANDS = Object.freeze([
+exports.THOUSANDS = /* @__PURE__ */ Object.freeze([
     '',
     'thousand',
     'million',
@@ -46,7 +46,7 @@ exports.THOUSANDS = Object.freeze([
     'quadrillion',
     'quintillion',
 ]);
-exports.ORDINAL_UNDER_TEEN = Object.freeze({
+exports.ORDINAL_UNDER_TEEN = /* @__PURE__ */ Object.freeze({
     zero: 'zeroth',
     one: 'first',
     two: 'second',
@@ -61,7 +61,7 @@ exports.ORDINAL_UNDER_TEEN = Object.freeze({
     eleven: 'eleventh',
     twelve: 'twelfth',
 });
-exports.ORDINAL_TO_CARDINAL = Object.freeze({
+exports.ORDINAL_TO_CARDINAL = /* @__PURE__ */ Object.freeze({
     first: 'one',
     second: 'two',
     third: 'three',
@@ -90,7 +90,7 @@ exports.ORDINAL_TO_CARDINAL = Object.freeze({
     eightieth: 'eighty',
     ninetieth: 'ninety',
 });
-exports.CURRENCY_CODES = Object.freeze([
+exports.CURRENCY_CODES = /* @__PURE__ */ Object.freeze([
     'AED',
     'AFN',
     'ALL',
@@ -252,7 +252,7 @@ exports.CURRENCY_CODES = Object.freeze([
     'ZMW',
     'ZWL',
 ]);
-exports.LOCALE_CODES = Object.freeze([
+exports.LOCALE_CODES = /* @__PURE__ */ Object.freeze([
     'af-ZA',
     'am-ET',
     'ar-AE',
@@ -379,7 +379,7 @@ exports.LOCALE_CODES = Object.freeze([
     'zh-HK',
     'zh-TW',
 ]);
-exports.CURRENCY_LOCALES = Object.freeze({
+exports.CURRENCY_LOCALES = /* @__PURE__ */ Object.freeze({
     AED: 'ar-AE',
     AFN: 'fa-IR',
     ALL: 'sq-AL',
@@ -541,7 +541,7 @@ exports.CURRENCY_LOCALES = Object.freeze({
     ZMW: 'en-ZM',
     ZWL: 'en-ZW',
 });
-exports.SUPPORTED_CURRENCIES = Object.freeze([
+exports.SUPPORTED_CURRENCIES = /* @__PURE__ */ Object.freeze([
     'AUD',
     'BGN',
     'BRL',
@@ -574,7 +574,7 @@ exports.SUPPORTED_CURRENCIES = Object.freeze([
     'USD',
     'ZAR',
 ]);
-exports.UNITS = Object.freeze({
+exports.UNITS = /* @__PURE__ */ Object.freeze({
     m: 'Meter',
     km: 'Kilometer',
     mi: 'Mile',
@@ -606,7 +606,7 @@ exports.UNITS = Object.freeze({
     hz: 'Hertz',
     khz: 'Kilohertz',
 });
-exports.PREFIX_MULTIPLIERS = Object.freeze({
+exports.PREFIX_MULTIPLIERS = /* @__PURE__ */ Object.freeze({
     y: 1e-24,
     z: 1e-21,
     a: 1e-18,

package/dist/cjs/object/countries.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.COUNTRIES = void 0;
-exports.COUNTRIES = Object.freeze([
+exports.COUNTRIES = /* @__PURE__ */ Object.freeze([
     {
         country_name: 'Afghanistan',
         country_code: '93',

package/dist/cjs/pluralizer/rules.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.uncountables = exports.singularRules = exports.pluralRules = exports.irregularRules = void 0;
-exports.irregularRules = Object.freeze([
+exports.irregularRules = /* @__PURE__ */ Object.freeze([
     ['I', 'we'],
     ['me', 'us'],
     ['he', 'they'],
@@ -89,7 +89,7 @@ exports.irregularRules = Object.freeze([
     ['wolf', 'wolves'],
     ['yes', 'yeses'],
 ]);
-exports.pluralRules = Object.freeze([
+exports.pluralRules = /* @__PURE__ */ Object.freeze([
     [/s?$/i, 's'],
     [/(pe)(rson|ople)$/i, '$1ople'],
     [/(child)(?:ren)?$/i, '$1ren'],
@@ -126,7 +126,7 @@ exports.pluralRules = Object.freeze([
         '$1i',
     ],
 ]);
-exports.singularRules = Object.freeze([
+exports.singularRules = /* @__PURE__ */ Object.freeze([
     [/s$/i, ''],
     [/(\P{ASCII})$/u, '$1'],
     [/(pe)(rson|ople)$/i, '$1rson'],
@@ -188,7 +188,7 @@ exports.singularRules = Object.freeze([
         '$1us',
     ],
 ]);
-exports.uncountables = Object.freeze(new Set([
+exports.uncountables = /* @__PURE__ */ Object.freeze(new Set([
     'aircraft',
     'alcohol',
     'ammo',

package/dist/cjs/string/constants.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LOWERCASE = void 0;
-exports.LOWERCASE = Object.freeze([
+exports.LOWERCASE = /* @__PURE__ */ Object.freeze([
     'and',
     'but',
     'or',

package/dist/cjs/{utils → stylog}/constants.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CSS_16_COLORS = exports.ANSI_16_COLORS = exports.CSS_TEXT_STYLES = exports.ANSI_TEXT_STYLES = void 0;
-exports.ANSI_TEXT_STYLES = Object.freeze({
+exports.ANSI_TEXT_STYLES = /* @__PURE__ */ Object.freeze({
     bold: ['\x1b[1m', '\x1b[22m'],
     bolder: ['\x1b[1m', '\x1b[22m'],
     dim: ['\x1b[2m', '\x1b[22m'],
@@ -10,7 +10,7 @@ exports.ANSI_TEXT_STYLES = Object.freeze({
     strikethrough: ['\x1b[9m', '\x1b[29m'],
     inverse: ['\x1b[7m', '\x1b[27m'],
 });
-exports.CSS_TEXT_STYLES = Object.freeze({
+exports.CSS_TEXT_STYLES = /* @__PURE__ */ Object.freeze({
     bold: 'font-weight: bold',
     bolder: 'font-weight: bolder',
     dim: 'opacity: 0.7',
@@ -19,7 +19,7 @@ exports.CSS_TEXT_STYLES = Object.freeze({
     strikethrough: 'text-decoration: line-through',
     inverse: 'filter: invert(1)',
 });
-exports.ANSI_16_COLORS = Object.freeze({
+exports.ANSI_16_COLORS = /* @__PURE__ */ Object.freeze({
     black: [30, 39],
     red: [31, 39],
     green: [32, 39],
@@ -53,7 +53,7 @@ exports.ANSI_16_COLORS = Object.freeze({
     bgCyanBright: [106, 49],
     bgWhiteBright: [107, 49],
 });
-exports.CSS_16_COLORS = Object.freeze({
+exports.CSS_16_COLORS = /* @__PURE__ */ Object.freeze({
     black: '#000000',
     red: '#800000',
     green: '#008000',

package/dist/cjs/verbalizer/rules.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.baseRules = exports.pastParticipleRules = exports.pastRules = exports.irregularVerbs = void 0;
-exports.irregularVerbs = Object.freeze([
+exports.irregularVerbs = /* @__PURE__ */ Object.freeze([
     ['am', 'was', 'been'],
     ['is', 'was', 'been'],
     ['are', 'were', 'been'],
@@ -144,7 +144,7 @@ exports.irregularVerbs = Object.freeze([
     ['wind', 'wound', 'wound'],
     ['write', 'wrote', 'written'],
 ]);
-exports.pastRules = Object.freeze([
+exports.pastRules = /* @__PURE__ */ Object.freeze([
     [/([aeiou])y$/i, '$1yed'],
     [/e$/i, 'ed'],
     [/([aeiou])lf$/i, '$1lved'],
@@ -153,7 +153,7 @@ exports.pastRules = Object.freeze([
     [/([^aeiou])([aeiou])([^aeiou])$/i, '$1$2$3$3ed'],
     [/$/i, 'ed'],
 ]);
-exports.pastParticipleRules = Object.freeze([
+exports.pastParticipleRules = /* @__PURE__ */ Object.freeze([
     [/([aeiou])y$/i, '$1yed'],
     [/e$/i, 'ed'],
     [/([aeiou])lf$/i, '$1lved'],
@@ -162,7 +162,7 @@ exports.pastParticipleRules = Object.freeze([
     [/([^aeiou])([aeiou])([^aeiou])$/i, '$1$2$3$3ed'],
     [/$/i, 'ed'],
 ]);
-exports.baseRules = Object.freeze([
+exports.baseRules = /* @__PURE__ */ Object.freeze([
     [/([aeiou])yed$/i, '$1y'],
     [/^([^aeiouwy])ied$/i, '$1ie'],
     [/ied$/i, 'y'],

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

@@ -17,7 +17,7 @@ import type { $UTCOffset, ChronosInput, ChronosInternals, ChronosMethods, Chrono
  * **It also accepts number values as following:**
  * - **`year, month, date, hours, minutes, seconds, milliseconds`**: Individual components of a date-time to construct a `Chronos` instance.
  *   - **`year`**: A number representing the year. If the year is between 0 and 99, it will be assumed to be the year 1900 + the provided year.
- *   - **`month`**: A number between 1 and 12 representing the month (1 for January, 12 for December). It is adjusted internally to a 0-based index (0 for January, 11 for December).
+ *   - **`month`**: A number between 1 and 12 representing the month (1 for January, 12 for December).
  *   - **`date`**: A number between 1 and 31 representing the day of the month.
  *   - **`hours`**: A number between 0 and 23 representing the hour of the day.
  *   - **`minutes`**: A number between 0 and 59 representing the minutes past the hour.
@@ -49,7 +49,7 @@ export declare class Chronos {
      *
      * @remarks
      * - Invoking the {@link timeZone} method sets the timezone name that corresponds to the specified UTC offset, or the UTC offset itself if no name exists. For more details on this behavior, see {@link getTimeZoneName}.
-     * - To retrieve the local system's native timezone name (or its identifier if the name is unavailable), use the {@link $getNativeTimeZone} instance method.
+     * - To retrieve the local system's native timezone name (or its identifier if the name is unavailable), use the {@link $getNativeTimeZoneName} instance method.
      */
     timeZoneName: LooseLiteral<TimeZoneName>;
     /**
@@ -157,9 +157,11 @@ export declare class Chronos {
      * - This method always reflects the local machine's timezone, regardless of whether {@link timeZone}, {@link utc}, or {@link toUTC} methods have been applied.
      * - To access the timezone name of a modified or converted instance, use the {@link timeZoneName} public property instead.
      *
+     * @param tzId Optional time zone identifier to get time zone name for that identifier.
+     *
      * @returns The resolved timezone name or its IANA identifier as a fallback.
      */
-    $getNativeTimeZone(): LooseLiteral<TimeZoneName | TimeZoneIdentifier>;
+    $getNativeTimeZoneName(tzId?: TimeZoneIdentifier): LooseLiteral<TimeZoneName | TimeZoneIdentifier>;
     /**
      * @instance Retrieves the IANA time zone identifier (e.g., `"Asia/Dhaka"`, `"Africa/Harare"`) for the local system's current time zone.
      *
@@ -198,13 +200,13 @@ export declare class Chronos {
     get lastDateOfMonth(): NumberRange<28, 31>;
     /** @instance Returns a debug-friendly string for `console.log` or `util.inspect`. */
     inspect(): string;
-    /** @instance Enables JSON.stringify and logging in the console (in Browser environment) to show readable output. */
+    /** @instance Enables `JSON.stringify` to show readable output. Calls {@link toLocalISOString} method. */
     toJSON(): string;
-    /** @instance Enables arithmetic and comparison operations (e.g., +new Chronos()). */
+    /** @instance Enables arithmetic and comparison operations (e.g., `+new Chronos()`). Calls {@link getTimeStamp} method. */
     valueOf(): number;
-    /** @instance Clones and returns a new `Chronos` instance with the same date. */
+    /** @instance Clones and returns exactly same `Chronos` instance. */
     clone(): Chronos;
-    /** @instance Gets the native `Date` instance (read-only). */
+    /** @instance Gets the native `Date` instance of the current `Chronos`. */
     toDate(): Date;
     /** @instance Returns a string representation of a date. */
     toString(): string;
@@ -320,11 +322,11 @@ export declare class Chronos {
      * @returns `true` if the year is a leap year, `false` otherwise.
      */
     isLeapYear(year?: number): boolean;
-    /** @instance Checks if another date is exactly equal to this one */
+    /** @instance Checks if another date is exactly equal to this one. */
     isEqual(other: ChronosInput): boolean;
-    /** @instance Checks if another date is exactly equal to or before this one */
+    /** @instance Checks if another date is exactly equal to or before this one. */
     isEqualOrBefore(other: ChronosInput): boolean;
-    /** @instance Checks if another date is exactly equal to or after this one */
+    /** @instance Checks if another date is exactly equal to or after this one. */
     isEqualOrAfter(other: ChronosInput): boolean;
     /**
      * @instance Checks if another date is the same as this one in a specific unit.
@@ -489,7 +491,7 @@ export declare class Chronos {
      * - `Q3`: July to September
      * - `Q4`: October to December
      *
-     * This method strictly uses the **calendar year**. For fiscal quarters, use `toFiscalQuarter()` instead.
+     * This method strictly uses the **calendar year**. For fiscal quarters, use {@link toFiscalQuarter} instead.
      *
      * @example
      * new Chronos('2025-02-14').toQuarter(); // 1
@@ -752,12 +754,12 @@ export declare class Chronos {
      */
     static getDatesForDay(day: WeekDay, options?: DateRangeOptions): string[];
     /**
-     * @static Returns earliest Chronos
+     * @static Returns earliest Chronos.
      * @param dates Date inputs.
      */
     static min(...dates: ChronosInput[]): Chronos;
     /**
-     * @static Returns latest Chronos
+     * @static Returns latest Chronos.
      * @param dates Date inputs.
      */
     static max(...dates: ChronosInput[]): Chronos;

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

@@ -107,13 +107,13 @@ declare module '../Chronos' {
          */
         isBusinessHour(options?: BusinessOptionsWeekends): boolean;
         /**
-         * @instance Returns the academic year based on a typical start in July and end in June.
+         * @instance Returns the academic year based on a typical start in `July` and end in `June`.
          * @returns The academic year in format `YYYY-YYYY`.
          */
         toAcademicYear(): AcademicYear;
         /**
          * @instance Returns the fiscal quarter based on custom fiscal year start (defaults to July).
-         * @param startMonth - The fiscal year start month (1-12), default is July (7).
+         * @param startMonth - The fiscal year start month (1-12), default is July (`7`).
          * @returns The fiscal quarter (1-4).
          */
         toFiscalQuarter(startMonth?: NumberRange<1, 12>): Quarter;

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

@@ -4,6 +4,9 @@ declare module '../Chronos' {
     interface Chronos {
         /**
          * @instance Returns the full time duration breakdown between current input (start) and another time (to) as {@link TimeDuration} object.
+         *
+         * @remarks This method calculates the elapsed time difference (excludes the end day), if you need an inclusive calendar-style difference (counting both start and end days), adjust one day manually before calling `duration()`.
+         *
          * @param toTime The time to compare with. Defaults to `now`.
          * @param absolute If true, returns all values as positive numbers. Defaults to `true`.
          * @returns An object of time units: `years`, `months`, `days`, `hours`, `minutes`, `seconds`, `milliseconds` ({@link TimeDuration}).
@@ -11,6 +14,9 @@ declare module '../Chronos' {
         duration(toTime?: ChronosInput, absolute?: boolean): TimeDuration;
         /**
          * @instance Returns a human-readable formatted duration string between the current instance (start) and another time (to).
+         *
+         * @remarks This method calculates the elapsed time difference (excludes the end day), if you need an inclusive calendar-style difference (counting both start and end days), adjust one day manually before calling `durationString()`.
+         *
          * @param options {@link DurationOptions} to format duration string, including the time to compare with.
          * @returns A formatted duration string, e.g. `"2 hours, 5 minutes"` or `"2h 5m"`.
          */

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

@@ -34,32 +34,41 @@ declare module '../Chronos' {
         /**
          * @instance Returns the current time zone name as a full descriptive string (e.g. `"Bangladesh Standard Time"`).
          *
-         * @param utc Optional UTC offset in `"UTC+06:00"` format. When passed, it bypasses the current time zone offset.
-         * @returns Time zone name in full descriptive string or UTC offset if it is not a valid time zone.
-         *
          * @remarks
          * - This method uses a predefined mapping of UTC offsets to time zone names.
          * - If multiple time zones share the same UTC offset, it returns the **first match** from the predefined list.
          * - If no match is found (which is rare), it falls back to returning the UTC offset (e.g. `"UTC+06:00"`).
-         * - To retrieve the local system's native time zone name (or its identifier if the name is unavailable), use the {@link $getNativeTimeZone} instance method.
+         * - To retrieve the local system's native time zone name (or its identifier if the name is unavailable), use the {@link $getNativeTimeZoneName} instance method.
          * - To retrieve the local system's native time zone identifier, use the {@link $getNativeTimeZoneId} instance method.
+         *
+         * @param utc Optional UTC offset in `"UTC+06:00"` format. When passed, it bypasses the current time zone offset.
+         * @returns Time zone name in full descriptive string or UTC offset if it is not a valid time zone.
          */
         getTimeZoneName(utc?: UTCOffset): LooseLiteral<TimeZoneName | UTCOffset>;
         /**
          * @instance Returns the current time zone abbreviation (e.g. `"BST"` for `Bangladesh Standard Time`).
          *
-         * @param utc Optional UTC offset in `"UTC+06:00"` format. When passed, it bypasses the current time zone offset.
-         * @returns Time zone name in full descriptive string or UTC offset if it is not a valid time zone.
-         *
          * @remarks
          * - This method uses a predefined mapping of UTC offsets to abbreviated time zone codes.
          * - If multiple time zones share the same UTC offset, it returns the **first abbreviation** from the list.
          * - If no abbreviation is found it abbreviates full time zone name from {@link TIME_ZONE_LABELS} using UTC offset.
          * - If no match is found (for unlisted or fictional utc offset), it returns the UTC offset (e.g. `"UTC+06:00"`).
-         * - To retrieve the local system's native time zone name (or its identifier if the name is unavailable), use the {@link $getNativeTimeZone} instance method.
+         * - To retrieve the local system's native time zone name (or its identifier if the name is unavailable), use the {@link $getNativeTimeZoneName} instance method.
          * - To retrieve the local system's native time zone identifier, use the {@link $getNativeTimeZoneId} instance method.
+         *
+         * @param utc Optional UTC offset in `"UTC+06:00"` format. When passed, it bypasses the current time zone offset.
+         * @returns Time zone name in full descriptive string or UTC offset if it is not a valid time zone.
          */
         getTimeZoneNameShort(utc?: UTCOffset): LooseLiteral<TimeZone | UTCOffset>;
+        /**
+         * @instance Returns the current time zone abbreviation (e.g. `"BST"` for `Bangladesh Standard Time`).
+         *
+         * @remarks This method is an alias for {@link getTimeZoneNameShort}.
+         *
+         * @param utc Optional UTC offset in `"UTC+06:00"` format. When passed, it bypasses the current time zone offset.
+         * @returns Time zone name in full descriptive string or UTC offset if it is not a valid time zone.
+         */
+        getTimeZoneNameAbbr(utc?: UTCOffset): LooseLiteral<TimeZone | UTCOffset>;
     }
 }
 /** * Plugin to inject `timeZone` related methods */

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

@@ -249,7 +249,7 @@ export declare const TIME_ZONES: Readonly<{
         readonly offset: "UTC+07:00";
     };
     readonly DDUT: {
-        readonly tzName: "Dumont d'Urville Time (in French Antarctic Station)";
+        readonly tzName: "Dumont d'Urville Time (Antarctic Station in French)";
         readonly offset: "UTC+10:00";
     };
     readonly DFT: {
@@ -397,7 +397,7 @@ export declare const TIME_ZONES: Readonly<{
         readonly offset: "UTC+07:00";
     };
     readonly IDLW: {
-        readonly tzName: "International Date Line West time zone";
+        readonly tzName: "International Date Line West";
         readonly offset: "UTC-12:00";
     };
     readonly IDT: {
@@ -891,7 +891,7 @@ export declare const TIME_ZONE_LABELS: Readonly<{
     readonly 'UTC+10:30': "Lord Howe Standard Time";
     readonly 'UTC+11:00': "Central Pacific Standard Time";
     readonly 'UTC+12:00': "New Zealand Standard Time";
-    readonly 'UTC+12:45': "Chatham Islands Time";
+    readonly 'UTC+12:45': "Chatham Standard Time";
     readonly 'UTC+13:00': "Phoenix Island Time";
     readonly 'UTC+14:00': "Line Islands Time";
 }>;

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

@@ -47,6 +47,17 @@ export interface GreetingConfigs {
     /** Default greeting message if no period matches. */
     defaultMessage?: string;
 }
+/** Time zone details */
+export type TimeZoneDetails = {
+    /** Time zone identifier */
+    tzIdentifier: LooseLiteral<TimeZoneIdentifier>;
+    /** Full time zone name */
+    tzNameLong?: LooseLiteral<TimeZoneName>;
+    /** Full time zone name but omits specific location */
+    tzNameLongGeneric?: LooseLiteral<TimeZoneName>;
+    /** Time zone offset from `UTC`, prefixed with `"GMT"` */
+    tzNameLongOffset?: LooseLiteral<`GMT${$UTCOffset}`>;
+};
 /** Name of time unit from `year` to `millisecond` */
 export type TimeUnit = 'year' | 'month' | 'day' | 'week' | 'hour' | 'minute' | 'second' | 'millisecond';
 /** Name of time unit from `year` to `millisecond`, except `week` */
@@ -214,6 +225,7 @@ export type ChronosMethods = $InstanceMethods | $StaticMethods | $PluginMethods;
 export type ChronosInput = number | string | Date | Chronos;
 /** Represents key of `ChronosStatics` (each static method and property) */
 export type ChronosStaticKey = keyof ChronosStatics;
+/** Key of {@link TIME_ZONE_LABELS} ({@link UTCOffset}) */
 export type $TZLabelKey = keyof typeof TIME_ZONE_LABELS;
 /** Abbreviated time-zone names (from {@link https://en.wikipedia.org/wiki/List_of_time_zone_abbreviations time zone abbreviations on Wikipedia}) */
 export type TimeZone = keyof typeof TIME_ZONES;

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

@@ -1,5 +1,5 @@
 import type { Numeric } from '../types/index';
-import type { ClockTime, HourMinutes, UTCOffset } from './types';
+import type { ClockTime, HourMinutes, TimeZoneDetails, TimeZoneIdentifier, UTCOffset } from './types';
 /**
  * * Extracts the hour and minute from a time string in `HH:MM` or `-HH:MM` format.
  *
@@ -55,3 +55,10 @@ export declare function convertMinutesToTime(minutes: Numeric): HourMinutes;
  * @returns A formatted UTC offset string like `UTC+05:30` or `UTC-04:00`.
  */
 export declare function formatUTCOffset(minutes: Numeric): UTCOffset;
+/**
+ * * Retrieves comprehensive timezone details using the `Intl` API.
+ * @param tzId Optional timezone identifier; defaults to the system timezone.
+ * @param date Optional date for which to resolve the information.
+ * @returns Object containing identifier, names, and offset.
+ */
+export declare function getTimeZoneDetails(tzId?: TimeZoneIdentifier, date?: Date): TimeZoneDetails;

package/dist/dts/index.d.ts

@@ -43,7 +43,7 @@ export { isDateLike, isLeapYear, isValidTime, isValidTime as isValidTimeString,
 export { Chronos, Chronos as Chronus } from './date/Chronos';
 export { INTERNALS } from './date/constants';
 export { chronos, chronos as chronosjs, chronos as chronosts, chronos as chronus, chronos as chronusjs, chronos as chronusts, } from './date/chronos-fn';
-export { convertMinutesToTime as convertMinutesToHourMinutes, convertMinutesToTime, formatUTCOffset as convertMinutesToUTCOffset, extractHourMinute, extractMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, formatUTCOffset, getCurrentDateTime, getCurrentDateTime as getCurrentTime, convertMinutesToTime as getHourMinutesFromMinutes, extractMinutesFromUTC as getMinutesFromUTC, convertMinutesToTime as getTimeFromMinutes, extractTimeFromUTC as getTimeStringFromUTC, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, extractMinutesFromUTC as getTotalMinutesFromUTC, formatUTCOffset as minutesToUTCOffset, } from './date/utils';
+export { convertMinutesToTime as convertMinutesToHourMinutes, convertMinutesToTime, formatUTCOffset as convertMinutesToUTCOffset, extractHourMinute, extractMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, formatUTCOffset, getCurrentDateTime, getCurrentDateTime as getCurrentTime, convertMinutesToTime as getHourMinutesFromMinutes, extractMinutesFromUTC as getMinutesFromUTC, convertMinutesToTime as getTimeFromMinutes, extractTimeFromUTC as getTimeStringFromUTC, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, extractMinutesFromUTC as getTotalMinutesFromUTC, formatUTCOffset as minutesToUTCOffset, getTimeZoneDetails, } from './date/utils';
 export { filterArrayOfObjects, flattenArray, getLastArrayElement, isInvalidOrEmptyArray, isInvalidOrEmptyArray as isValidEmptyArray, shuffleArray, } from './array/basics';
 export { averageByField, averageByField as avgByField, groupAndAverageByField, groupAndAverageByField as groupAndAvgByField, groupAndSumByField, sumByField, sumFieldDifference, sumFieldDifference as totalDeltaByField, } from './array/calc';
 export { Finder } from './array/Finder';

package/dist/dts/{utils → stylog}/constants.d.ts

@@ -1,5 +1,5 @@
 import type { Hex6 } from '../colors/types';
-import type { AnsiSequence, TextStyle } from './stylog';
+import type { AnsiSequence, TextStyle } from './Stylog';
 /** ANSI styles for non-color text effects */
 export declare const ANSI_TEXT_STYLES: Record<TextStyle, AnsiSequence>;
 /** Browser CSS equivalents */
@@ -40,4 +40,4 @@ export declare const ANSI_16_COLORS: Readonly<{
     readonly bgWhiteBright: readonly [107, 49];
 }>;
 /** Browser CSS equivalents for ANSI 16 colors */
-export declare const CSS_16_COLORS: Readonly<Record<"black" | "white" | "red" | "purple" | "green" | "yellow" | "blue" | "cyan" | "bgBlack" | "bgWhite" | "bgRed" | "bgPurple" | "bgGreen" | "bgYellow" | "bgBlue" | "bgCyan" | "blackBright" | "redBright" | "greenBright" | "yellowBright" | "blueBright" | "purpleBright" | "cyanBright" | "whiteBright" | "bgBlackBright" | "bgRedBright" | "bgGreenBright" | "bgYellowBright" | "bgBlueBright" | "bgPurpleBright" | "bgCyanBright" | "bgWhiteBright", Hex6>>;
+export declare const CSS_16_COLORS: Readonly<Record<"black" | "white" | "red" | "purple" | "green" | "yellow" | "blue" | "cyan" | "blackBright" | "redBright" | "greenBright" | "yellowBright" | "blueBright" | "purpleBright" | "cyanBright" | "whiteBright" | "bgBlack" | "bgRed" | "bgGreen" | "bgYellow" | "bgBlue" | "bgPurple" | "bgCyan" | "bgWhite" | "bgBlackBright" | "bgRedBright" | "bgGreenBright" | "bgYellowBright" | "bgBlueBright" | "bgPurpleBright" | "bgCyanBright" | "bgWhiteBright", Hex6>>;

package/dist/dts/{utils → stylog}/helpers.d.ts

@@ -1,5 +1,5 @@
 import type { CSSColor, Hex6 } from '../colors/types';
-import type { Ansi16Value, AnsiSequence, BGColor, CSS16Color } from './stylog';
+import type { Ansi16Value, AnsiSequence, BGColor, CSS16Color } from './Stylog';
 /**
  * * Extract the CSS color name from a background-prefixed style key.
  *

package/dist/esm/colors/constants.js

@@ -1,4 +1,4 @@
-export const ALPHABET_COLOR_PALETTE = Object.freeze([
+export const ALPHABET_COLOR_PALETTE = /* @__PURE__ */ Object.freeze([
     '#00094C',
     '#00376E',
     '#005600',
@@ -26,7 +26,7 @@ export const ALPHABET_COLOR_PALETTE = Object.freeze([
     '#546F1C',
     '#824809',
 ]);
-export const NUMBER_COLOR_PALETTE = Object.freeze([
+export const NUMBER_COLOR_PALETTE = /* @__PURE__ */ Object.freeze([
     '#893213',
     '#A44C15',
     '#8B4513',

package/dist/esm/colors/css-colors.js

@@ -1,4 +1,4 @@
-export const CSS_COLORS = Object.freeze({
+export const CSS_COLORS = /* @__PURE__ */ Object.freeze({
     black: '#000000',
     silver: '#C0C0C0',
     gray: '#808080',

package/dist/esm/converter/constants.js

@@ -1,4 +1,4 @@
-export const UNITS = Object.freeze({
+export const UNITS = /* @__PURE__ */ Object.freeze({
     time: [
         'nanosecond',
         'microsecond',

package/dist/esm/date/Chronos.js

@@ -43,7 +43,7 @@ export class Chronos {
         this.origin = this.#ORIGIN;
         this.#offset = `UTC${this.getUTCOffset()}`;
         this.utcOffset = this.#offset;
-        this.timeZoneName = this.$getNativeTimeZone();
+        this.timeZoneName = this.$getNativeTimeZoneName();
         this.timeZoneId = this.$getNativeTimeZoneId();
     }
     *[Symbol.iterator]() {
@@ -124,13 +124,9 @@ export class Chronos {
     get [Symbol.isConcatSpreadable]() {
         return true;
     }
-    $getNativeTimeZone() {
-        const details = new Intl.DateTimeFormat(undefined, {
-            timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
-            timeZoneName: 'long',
-        }).formatToParts(this.toDate());
-        const tzPart = details.find((p) => p.type === 'timeZoneName');
-        return tzPart?.value ?? Intl.DateTimeFormat().resolvedOptions().timeZone;
+    $getNativeTimeZoneName(tzId) {
+        const $tzId = tzId || this.$getNativeTimeZoneId();
+        return this.#getNativeTzName(tzId) ?? $tzId;
     }
     $getNativeTimeZoneId() {
         return Intl.DateTimeFormat().resolvedOptions().timeZone;
@@ -159,6 +155,14 @@ export class Chronos {
         instance.native = instance.toDate();
         return instance;
     }
+    #getNativeTzName(tzId) {
+        const tzDetails = new Intl.DateTimeFormat('en', {
+            timeZone: tzId,
+            timeZoneName: 'long',
+        }).formatToParts(this.#date);
+        const tzPart = tzDetails.find((p) => p.type === 'timeZoneName');
+        return tzPart?.value;
+    }
     #format(format, useUTC = false) {
         const year = useUTC ? this.#date.getUTCFullYear() : this.#date.getFullYear();
         const month = useUTC ? this.#date.getUTCMonth() : this.#date.getMonth();
@@ -281,7 +285,7 @@ export class Chronos {
         return this.getTimeStamp();
     }
     clone() {
-        return new _a(this.#date).#withOrigin(this.#ORIGIN);
+        return new _a(this.#date).#withOrigin(this.#ORIGIN, this.#offset, this.timeZoneName, this.timeZoneId, this.$tzTracker);
     }
     toDate() {
         switch (this.#ORIGIN) {
@@ -625,7 +629,7 @@ export class Chronos {
         const input = this.startOf('day');
         const comparison = base.startOf('day');
         const diff = input.diff(comparison, 'day');
-        const timeStr = this.toDate().toLocaleString(undefined, {
+        const timeStr = this.toDate().toLocaleString('en', {
             hour: 'numeric',
             minute: '2-digit',
         });
@@ -635,7 +639,7 @@ export class Chronos {
             return `Tomorrow at ${timeStr}`;
         if (diff === -1)
             return `Yesterday at ${timeStr}`;
-        return this.toDate().toLocaleString(undefined, {
+        return this.toDate().toLocaleString('en', {
             month: 'long',
             day: '2-digit',
             year: 'numeric',