nhb-toolbox 4.26.45 → 4.26.50

package/CHANGELOG.md

@@ -6,6 +6,11 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.26.50] - 2025-11-14
+
+- **Updated** `TimeZoneIdentifier` type: now **excludes** `Factory` and *time zone abbreviations* already present in `TimeZone` literal type. **Created** new `$TimeZoneIdentifier` type as *replacement*.
+- **Replaced** `TIME_ZONE_IDS` with `Intl.supportedValuesOf('timeZone')` API to get *time zone identifier* to reduce the `timeZonePlugin` size. `TIME_ZONE_IDS` is still in the codebase to generate *types*.
+
 ## [4.26.45] - 2025-11-13
 
 - **Removed** *time zone id* `'Factory'` from `TIME_ZONE_IDS` and **replaced** `'EDT'` with `'EST5EDT'` to fix the *issue with getting time zone details* using `Intl` API.

package/dist/cjs/date/Chronos.js

@@ -159,12 +159,17 @@ class Chronos {
         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;
+        try {
+            const tzDetails = new Intl.DateTimeFormat('en', {
+                timeZone: tzId,
+                timeZoneName: 'long',
+            }).formatToParts(this.#date);
+            const tzPart = tzDetails.find((p) => p.type === 'timeZoneName');
+            return tzPart?.value;
+        }
+        catch {
+            return undefined;
+        }
     }
     #format(format, useUTC = false) {
         const year = useUTC ? this.#date.getUTCFullYear() : this.#date.getFullYear();

package/dist/cjs/date/guards.js

@@ -23,7 +23,7 @@ function isValidUTCOffset(value) {
     return (0, primitives_1.isString)(value) ? /^UTC[+-]?\d{1,2}:\d{2}$/.test(value) : false;
 }
 function isValidTimeZoneId(value) {
-    return (0, primitives_1.isString)(value) ? value in timezone_1.TIME_ZONE_IDS : false;
+    return (0, primitives_1.isString)(value) ? value !== 'Factory' && value in timezone_1.TIME_ZONE_IDS : false;
 }
 function isLeapYear(year) {
     const $year = (0, utilities_1.normalizeNumber)(year);

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

@@ -7,15 +7,15 @@ const timezone_1 = require("../timezone");
 const utils_1 = require("../utils");
 const timeZonePlugin = (ChronosClass) => {
     const { internalDate: $Date, withOrigin } = ChronosClass[constants_1.INTERNALS];
+    const TZ_IDS = Intl.supportedValuesOf('timeZone');
     const _isGMT = (factor) => {
         return factor === 'UTC+00:00' || factor === 'UTC-00:00';
     };
-    const TZ_NAME_ABBR_MAP = new Map(Object.entries(timezone_1.TIME_ZONES).map(([tzAbbr, { offset, tzName }]) => [
-        offset,
-        { tzAbbr, tzName },
-    ]));
     const _isLabelKey = (offset) => {
-        return offset in timezone_1.TIME_ZONE_LABELS;
+        return offset ? offset in timezone_1.TIME_ZONE_LABELS : false;
+    };
+    const _isValidTzAbbr = (tz) => {
+        return tz in timezone_1.TIME_ZONES;
     };
     const _resolveTzName = (offset) => {
         if (_isLabelKey(offset)) {
@@ -23,6 +23,51 @@ const timeZonePlugin = (ChronosClass) => {
         }
         return undefined;
     };
+    const _getTimeZoneDetails = (tzId, date) => {
+        const TZ_NAME_TYPES = ['long', 'longOffset'];
+        const obj = { tzId };
+        for (const type of TZ_NAME_TYPES) {
+            const key = type === 'long' ? 'tzName' : 'offset';
+            try {
+                const parts = new Intl.DateTimeFormat('en', {
+                    timeZone: tzId,
+                    timeZoneName: type,
+                }).formatToParts(date);
+                const tzPart = parts.find((p) => p.type === 'timeZoneName');
+                const value = type === 'longOffset' ?
+                    tzPart?.value === 'GMT' ?
+                        'UTC+00:00'
+                        : tzPart?.value?.replace(/^GMT/, 'UTC')
+                    : tzPart?.value;
+                obj[key] = value;
+            }
+            catch {
+                obj[key] = undefined;
+            }
+        }
+        return obj;
+    };
+    const TZ_ID_MAP = new Map(TZ_IDS.reduce((tzIds, id) => {
+        const { offset } = _getTimeZoneDetails(id);
+        if (offset) {
+            const arr = tzIds.get(offset) ?? [];
+            arr.push(id);
+            tzIds.set(offset, arr);
+        }
+        return tzIds;
+    }, new Map()));
+    const TZ_NAME_ABBR_MAP = new Map(Object.entries(timezone_1.TIME_ZONES).map(([tzAbbr, { offset, tzName }]) => [
+        offset,
+        { tzAbbr, tzName },
+    ]));
+    const _getTimeZoneId = (utc) => {
+        const tzIds = TZ_ID_MAP.get(utc);
+        if (!tzIds || tzIds?.length === 0)
+            return undefined;
+        if (tzIds?.length === 1)
+            return tzIds[0];
+        return tzIds;
+    };
     const _getTimeZoneName = (zone, date) => {
         if (_isGMT(zone))
             return 'Greenwich Mean Time';
@@ -33,34 +78,14 @@ const timeZonePlugin = (ChronosClass) => {
             }
             return tzName;
         }
-        else if ((0, guards_1.isValidTimeZoneId)(zone)) {
-            const { offset, tzName } = timezone_1.TIME_ZONE_IDS[zone];
-            const { tzNameLongOffset, tzNameLong } = (0, utils_1.getTimeZoneDetails)(zone, date);
-            const convertedOffset = tzNameLongOffset?.replace(/^GMT/, 'UTC') ?? '';
-            const resolvedName = _resolveTzName(offset);
-            const priorityName = convertedOffset === offset ? tzNameLong : resolvedName;
-            return tzName || priorityName || resolvedName || tzNameLong;
+        else if (_isValidTzAbbr(zone)) {
+            return timezone_1.TIME_ZONES[zone].tzName;
         }
         else {
-            return zone in timezone_1.TIME_ZONES ?
-                timezone_1.TIME_ZONES[zone].tzName
-                : _resolveTzName(timezone_1.TIME_ZONES[zone]?.offset);
+            const { offset, tzName } = _getTimeZoneDetails(zone, date);
+            return tzName || _resolveTzName(offset);
         }
     };
-    const TZ_ID_MAP = new Map(Object.entries(timezone_1.TIME_ZONE_IDS).reduce((acc, [id, { offset }]) => {
-        const arr = acc.get(offset) ?? [];
-        arr.push(id);
-        acc.set(offset, arr);
-        return acc;
-    }, new Map()));
-    const _getTimeZoneId = (utc) => {
-        const tzIds = TZ_ID_MAP.get(utc);
-        if (!tzIds || tzIds?.length === 0)
-            return undefined;
-        if (tzIds?.length === 1)
-            return tzIds[0];
-        return tzIds;
-    };
     ChronosClass.prototype.timeZone = function (zone) {
         let offset;
         let tzId;
@@ -68,13 +93,13 @@ const timeZonePlugin = (ChronosClass) => {
             offset = zone;
             tzId = _getTimeZoneId(offset) || offset;
         }
-        else if ((0, guards_1.isValidTimeZoneId)(zone)) {
-            offset = timezone_1.TIME_ZONE_IDS[zone].offset;
-            tzId = zone;
+        else if (_isValidTzAbbr(zone)) {
+            offset = timezone_1.TIME_ZONES[zone].offset;
+            tzId = _getTimeZoneId(offset) || offset;
         }
         else {
-            offset = zone in timezone_1.TIME_ZONES ? timezone_1.TIME_ZONES[zone].offset : timezone_1.TIME_ZONES['UTC'].offset;
-            tzId = _getTimeZoneId(offset) || offset;
+            offset = _getTimeZoneDetails(zone, $Date(this)).offset || timezone_1.TIME_ZONES['UTC'].offset;
+            tzId = zone;
         }
         const $zone = zone || offset;
         const tzName = _getTimeZoneName($zone, $Date(this)) ?? offset;
@@ -121,7 +146,7 @@ const timeZonePlugin = (ChronosClass) => {
         const zone = _getTimeZoneName(tzMapKey, $Date(this)) ?? UTC;
         if (TZ_ABBR_CACHE.has(`name-${zone}`))
             return TZ_ABBR_CACHE.get(zone);
-        const customAbbr = (0, guards_1.isValidUTCOffset)(zone) || (0, guards_1.isValidTimeZoneId)(zone) ? zone : _abbreviate(zone);
+        const customAbbr = (0, guards_1.isValidUTCOffset)(zone) ? zone : _abbreviate(zone);
         TZ_ABBR_CACHE.set(`name-${zone}`, customAbbr);
         return customAbbr;
     };

package/dist/cjs/date/timezone.js

@@ -2861,6 +2861,10 @@ exports.TIME_ZONE_IDS = /* @__PURE__ */ Object.freeze({
         tzName: 'Central European Time',
         offset: 'UTC+01:00',
     },
+    Factory: {
+        tzName: undefined,
+        offset: 'UTC+00:00',
+    },
     GB: {
         tzName: 'Greenwich Mean Time',
         offset: 'UTC+00:00',

package/dist/cjs/date/utils.js

@@ -44,13 +44,18 @@ function getTimeZoneDetails(tzId, date) {
     const $tzId = tzId || Intl.DateTimeFormat().resolvedOptions().timeZone;
     const obj = { tzIdentifier: $tzId };
     for (const type of TZ_NAME_TYPES) {
-        const parts = new Intl.DateTimeFormat('en', {
-            timeZone: $tzId,
-            timeZoneName: type,
-        }).formatToParts(date);
-        const tzPart = parts.find((p) => p.type === 'timeZoneName');
         const key = `tzName${type[0].toUpperCase()}${type.slice(1)}`;
-        obj[key] = tzPart?.value;
+        try {
+            const parts = new Intl.DateTimeFormat('en', {
+                timeZone: $tzId,
+                timeZoneName: type,
+            }).formatToParts(date);
+            const tzPart = parts.find((p) => p.type === 'timeZoneName');
+            obj[key] = tzPart?.value;
+        }
+        catch {
+            obj[key] = undefined;
+        }
     }
     return obj;
 }

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

@@ -1,7 +1,7 @@
 import type { Enumerate, NumberRange } from '../number/types';
 import type { LooseLiteral, TupleOf } from '../utils/types';
 import { INTERNALS } from './constants';
-import type { $UTCOffset, ChronosInput, ChronosInternals, ChronosMethods, ChronosObject, ChronosPlugin, ChronosWithOptions, DateRangeOptions, DateTimeFormatOptions, FormatOptions, LocalesArguments, Milliseconds, MonthName, Quarter, RangeWithDates, RelativeDateRange, RelativeRangeOptions, StrictFormat, TimeParts, TimeUnit, TimeUnitValue, TimeZone, TimeZoneId, TimeZoneIdentifier, TimeZoneName, UTCOffset, WeekDay } from './types';
+import type { $TimeZoneIdentifier, $UTCOffset, ChronosInput, ChronosInternals, ChronosMethods, ChronosObject, ChronosPlugin, ChronosWithOptions, DateRangeOptions, DateTimeFormatOptions, FormatOptions, LocalesArguments, Milliseconds, MonthName, Quarter, RangeWithDates, RelativeDateRange, RelativeRangeOptions, StrictFormat, TimeParts, TimeUnit, TimeUnitValue, TimeZone, TimeZoneId, TimeZoneName, UTCOffset, WeekDay } from './types';
 /**
  * * Creates a new immutable `Chronos` instance.
  *
@@ -55,18 +55,18 @@ export declare class Chronos {
     /**
      * Represents the current timezone context, which can be a single identifier, an array of equivalent identifiers, or a UTC offset.
      *
-     * - **`TimeZoneIdentifier`** — e.g., `"Asia/Dhaka"`. Returned when the {@link timeZone} method has not been invoked. It is default behaviour.
-     * - **Array of `TimeZoneIdentifier`** — e.g., `['Asia/Kathmandu', 'Asia/Katmandu']`, used when multiple timezones share the same UTC offset such as `"UTC+05:45"`.
-     * - **`UTCOffset`** — e.g., `"UTC+06:45"` or `"UTC+02:15"`, returned when no named timezone corresponds to a given offset.
+     * - **{@link $TimeZoneIdentifier}** — e.g., `"Asia/Dhaka"`. Returned when the {@link timeZone} method has not been invoked. It is default behaviour.
+     * - **Array of {@link $TimeZoneIdentifier}** — e.g., `['Asia/Kathmandu', 'Asia/Katmandu']`, used when multiple timezones share the same UTC offset such as `"UTC+05:45"`.
+     * - **{@link UTCOffset}** — e.g., `"UTC+06:45"` or `"UTC+02:15"`, returned when no named timezone corresponds to a given offset.
      *
      * @remarks
-     * - By default, when {@link timeZone} is not applied, a single `TimeZoneIdentifier` string is provided.
+     * - By default, when {@link timeZone} is not applied, a single {@link $TimeZoneIdentifier} string is provided.
      * - When applied, it may instead return a single identifier string, an array of equivalent identifiers or a UTC offset string.
      * - To retrieve the local system's native timezone identifier, use the {@link $getNativeTimeZoneId} instance method.
      */
     timeZoneId: TimeZoneId;
     /** Tracker to identify the instance created by {@link timeZone} method */
-    protected $tzTracker?: TimeZoneIdentifier | TimeZone | UTCOffset;
+    protected $tzTracker?: $TimeZoneIdentifier | TimeZone | UTCOffset;
     /**
      * * Creates a new immutable `Chronos` instance.
      *
@@ -161,7 +161,7 @@ export declare class Chronos {
      *
      * @returns The resolved time zone name or its IANA identifier as a fallback.
      */
-    $getNativeTimeZoneName(tzId?: TimeZoneIdentifier): 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.
      *
@@ -171,7 +171,7 @@ export declare class Chronos {
      *
      * @returns The local system's IANA time zone identifier.
      */
-    $getNativeTimeZoneId(): TimeZoneIdentifier;
+    $getNativeTimeZoneId(): $TimeZoneIdentifier;
     /** Gets the full year of the date. */
     get year(): number;
     /** Gets the month (0-11) of the date. */
@@ -246,7 +246,7 @@ export declare class Chronos {
     /**
      * @instance Formats the date into a predefined strict string format using local time or UTC.
      *
-     * @remarks Offers `over 26,500` predefined formats with full IntelliSense support.
+     * @remarks Offers `over 21,300` predefined formats with full IntelliSense support.
      *
      * @param format - The desired format string. Defaults to `'dd, mmm DD, YYYY HH:mm:ss'`
      *                 (e.g., `'Sun, Apr 06, 2025 16:11:55'`).

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

@@ -1,5 +1,5 @@
 import type { Numeric } from '../types/index';
-import type { ClockTime, TimeZoneIdentifier, UTCOffset } from './types';
+import type { $TimeZoneIdentifier, ClockTime, UTCOffset } from './types';
 /**
  * * Checks if the provided value is a valid time string in "HH:MM" format.
  *
@@ -15,11 +15,11 @@ export declare function isValidTime(value: unknown): value is ClockTime;
  */
 export declare function isValidUTCOffset(value: unknown): value is UTCOffset;
 /**
- * * Checks if the provided value is a valid timezone identifier from {@link https://en.wikipedia.org/wiki/List_of_tz_database_time_zones IANA TZ Database} (e.g. `"Africa/Harare"`).
+ * * Checks if the provided value is a valid timezone identifier (excluding `'Factory'`) from {@link https://en.wikipedia.org/wiki/List_of_tz_database_time_zones IANA TZ Database} (e.g. `"Africa/Harare"`).
  * @param value Timezone id to check.
  * @returns `true` if the value is a valid timezone id, `false` otherwise.
  */
-export declare function isValidTimeZoneId(value: unknown): value is TimeZoneIdentifier;
+export declare function isValidTimeZoneId(value: unknown): value is $TimeZoneIdentifier;
 /**
  * * Checks if the year is a leap year.
  *

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

@@ -7,7 +7,7 @@ declare module '../Chronos' {
         /**
          * @instance Creates a new instance of `Chronos` for the specified time zone identifier.
          *
-         * @remarks Using time zone identifier to create time zone instance is the best option.
+         * @remarks Using time zone identifier to create time zone instance is the best option as it extract info from {@link Intl} API.
          *
          * @param tzId - Time zone identifier (e.g., `'Africa/Harare'`). See: {@link https://en.wikipedia.org/wiki/List_of_tz_database_time_zones IANA TZ Database on Wikipedia}.
          * @returns A new instance of `Chronos` with time in the given time zone identifier. Invalid input sets time-zone to `UTC`.
@@ -16,14 +16,14 @@ declare module '../Chronos' {
         /**
          * @instance Creates a new instance of `Chronos` for the specified abbreviated time zone name.
          *
-         * @remarks Use abbreviated time zone name to create time zone instance only when you can't figure out the time zone identifier.
+         * @remarks Use abbreviated time zone name to create time zone instance only when you can't figure out the time zone identifier {@link TimeZoneIdentifier}.
          *
          * @param zone - Standard time zone abbreviation (e.g., `'IST'`, `'UTC'`, `'EST'` etc.). See: {@link https://en.wikipedia.org/wiki/List_of_time_zone_abbreviations Time zone abbreviations on Wikipedia}.
          * @returns A new instance of `Chronos` with time in the given time zone abbreviation. Invalid input sets time-zone to `UTC`.
          */
         timeZone(zone: TimeZone): ChronosConstructor;
         /**
-         * @instance Creates a new instance of `Chronos` for the specified utc offset.
+         * @instance Creates a new instance of `Chronos` for the specified UTC offset.
          *
          * @remarks Use UTC offset only to create a fictional/unlisted time zone instance.
          *
@@ -31,6 +31,18 @@ declare module '../Chronos' {
          * @returns A new instance of `Chronos` with time in the given utc offset. Invalid input sets time-zone to `UTC`.
          */
         timeZone(utc: UTCOffset): ChronosConstructor;
+        /**
+         * @instance Creates a new instance of `Chronos` for the specified time zone id, abbreviation or UTC offset.
+         *
+         * @remarks
+         * - Using time zone identifier to create time zone instance is the best option as it extract info from {@link Intl} API.
+         * - Use abbreviated time zone name to create time zone instance only when you can't figure out the time zone identifier.
+         * - Use UTC offset only to create a fictional/unlisted time zone instance.
+         *
+         * @param tz - A time zone identifier ({@link TimeZoneIdentifier}), time zone abbreviation {@link TimeZone}, or UTC offset {@link UTCOffset}.
+         * @returns A new instance of `Chronos` with time in the given parameter. Invalid input sets time zone to `UTC`.
+         */
+        timeZone(tz: TimeZoneIdentifier | TimeZone | UTCOffset): ChronosConstructor;
         /**
          * @instance Returns the current time zone name as a full descriptive string (e.g. `"Bangladesh Standard Time"`).
          *

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

@@ -2861,6 +2861,10 @@ export declare const TIME_ZONE_IDS: Readonly<{
         readonly tzName: "Central European Time";
         readonly offset: "UTC+01:00";
     };
+    readonly Factory: {
+        readonly tzName: undefined;
+        readonly offset: "UTC+00:00";
+    };
     readonly GB: {
         readonly tzName: "Greenwich Mean Time";
         readonly offset: "UTC+00:00";

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

@@ -50,13 +50,13 @@ export interface GreetingConfigs {
 /** Time zone details object */
 export type TimeZoneDetails = {
     /** IANA time zone identifier */
-    tzIdentifier: LooseLiteral<TimeZoneIdentifier>;
+    tzIdentifier: $TimeZoneIdentifier;
     /** Long localized form (e.g., `'Pacific Standard Time'`, `'Nordamerikanische Westküsten-Normalzeit'`) */
-    tzNameLong?: LooseLiteral<TimeZoneName>;
+    tzNameLong: LooseLiteral<TimeZoneName> | undefined;
     /** Long generic non-location format (e.g.: `'Pacific Time'`, `'Nordamerikanische Westküstenzeit'`) */
-    tzNameLongGeneric?: LooseLiteral<TimeZoneName>;
+    tzNameLongGeneric: LooseLiteral<TimeZoneName> | undefined;
     /** Long localized GMT format, prefixed with `"GMT"` (e.g., `"GMT-08:00"`) */
-    tzNameLongOffset?: LooseLiteral<`GMT${$UTCOffset}`>;
+    tzNameLongOffset: LooseLiteral<`GMT${$UTCOffset}`> | undefined;
 };
 /** Name of time unit from `year` to `millisecond` */
 export type TimeUnit = 'year' | 'month' | 'day' | 'week' | 'hour' | 'minute' | 'second' | 'millisecond';
@@ -89,14 +89,14 @@ export type DateParts = `${MonthDate} ${Exclude<Month, 'M' | 'MM'>}` | `${Exclud
 /** 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 DateTimeISO = 'YYYY-MM-DDTHH:mm:ss.mssZZ';
-type DateTimeConnector = ' ' | ', ' | '; ' | ' - ' | 'T';
+type DateTimeConnector = ' ' | ', ' | '; ' | ' - ';
 /** Pre-defined literal types for formatting date and time. Optionally can pass any string. */
 export type StrictFormat = LooseLiteral<DateTimeISO | DateParts | TimeParts | `${DateParts}${DateTimeConnector}${TimeParts}`>;
 /** Locale arguments for `toLocaleString` method. Includes `BCP47` tags and `Intl.Locale`. */
 export type LocalesArguments = LocaleCode | Intl.Locale | Array<LocaleCode | Intl.Locale>;
 /** Format options for `toLocaleString` method. Extends `Intl.DateTimeFormatOptions `to update `timeZone` option. */
 export interface DateTimeFormatOptions extends Intl.DateTimeFormatOptions {
-    timeZone?: TimeZoneIdentifier;
+    timeZone?: $TimeZoneIdentifier;
 }
 /** Iterable `Chronos` object properties */
 export interface ChronosObject {
@@ -172,7 +172,7 @@ export interface ChronosInternals {
      * @param tzTracker Optional tracker to identify the instance created by {@link timeZone} method.
      * @returns The `Chronos` instance with the specified origin and other properties.
      */
-    withOrigin(instance: Chronos, method: PluginMethods, offset?: UTCOffset, tzName?: string, tzId?: TimeZoneId, tzTracker?: TimeZoneIdentifier | TimeZone | UTCOffset): Chronos;
+    withOrigin(instance: Chronos, method: PluginMethods, offset?: UTCOffset, tzName?: LooseLiteral<TimeZoneName>, tzId?: TimeZoneId, tzTracker?: $TimeZoneIdentifier | TimeZone | UTCOffset): Chronos;
     /**
      * * Access to `#toNewDate` private method
      * * Creates a new `Date` object from a Chronos input
@@ -227,14 +227,16 @@ export type ChronosInput = number | string | Date | Chronos;
 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}) */
+/** 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;
 /** Full time zone names from Wikipedia and IANA time zone database. */
-export type TimeZoneName = NonNullable<(typeof TIME_ZONE_LABELS)[$TZLabelKey] | (typeof TIME_ZONES)[TimeZone]['tzName'] | (typeof TIME_ZONE_IDS)[TimeZoneIdentifier]['tzName']>;
-/** Timezone identifier (from {@link https://en.wikipedia.org/wiki/List_of_tz_database_time_zones IANA TZ Database on Wikipedia}) */
-export type TimeZoneIdentifier = keyof typeof TIME_ZONE_IDS;
-/** Timezone identifier, array of timezone identifiers or UTC offset. */
-export type TimeZoneId = TimeZoneIdentifier | TimeZoneIdentifier[] | UTCOffset;
+export type TimeZoneName = NonNullable<(typeof TIME_ZONE_LABELS)[$TZLabelKey] | (typeof TIME_ZONES)[TimeZone]['tzName'] | (typeof TIME_ZONE_IDS)[$TimeZoneIdentifier]['tzName']>;
+/** Time zone identifier (from {@link https://en.wikipedia.org/wiki/List_of_tz_database_time_zones IANA TZ Database on Wikipedia}) excluding `'Factory'`. */
+export type $TimeZoneIdentifier = Exclude<keyof typeof TIME_ZONE_IDS, 'Factory'>;
+/** Time zone identifier (from {@link https://en.wikipedia.org/wiki/List_of_tz_database_time_zones IANA TZ Database on Wikipedia}) excluding `'Factory'` & abbreviations present in {@link TimeZone}. */
+export type TimeZoneIdentifier = Exclude<$TimeZoneIdentifier, TimeZone>;
+/** Time zone identifier, array of timezone identifiers or UTC offset. */
+export type TimeZoneId = $TimeZoneIdentifier | $TimeZoneIdentifier[] | UTCOffset;
 /** Positive UTC hours */
 export type PositiveUTCHour = `+0${Enumerate<10>}` | `+${NumberRange<10, 14>}`;
 /** Negative UTC hours */

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

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

package/dist/esm/date/Chronos.js

@@ -156,12 +156,17 @@ export class Chronos {
         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;
+        try {
+            const tzDetails = new Intl.DateTimeFormat('en', {
+                timeZone: tzId,
+                timeZoneName: 'long',
+            }).formatToParts(this.#date);
+            const tzPart = tzDetails.find((p) => p.type === 'timeZoneName');
+            return tzPart?.value;
+        }
+        catch {
+            return undefined;
+        }
     }
     #format(format, useUTC = false) {
         const year = useUTC ? this.#date.getUTCFullYear() : this.#date.getFullYear();

package/dist/esm/date/guards.js

@@ -16,7 +16,7 @@ export function isValidUTCOffset(value) {
     return isString(value) ? /^UTC[+-]?\d{1,2}:\d{2}$/.test(value) : false;
 }
 export function isValidTimeZoneId(value) {
-    return isString(value) ? value in TIME_ZONE_IDS : false;
+    return isString(value) ? value !== 'Factory' && value in TIME_ZONE_IDS : false;
 }
 export function isLeapYear(year) {
     const $year = normalizeNumber(year);

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

@@ -1,18 +1,18 @@
 import { INTERNALS } from '../constants.js';
-import { isValidTimeZoneId, isValidUTCOffset } from '../guards.js';
-import { TIME_ZONES, TIME_ZONE_IDS, TIME_ZONE_LABELS } from '../timezone.js';
-import { getTimeZoneDetails, extractMinutesFromUTC } from '../utils.js';
+import { isValidUTCOffset } from '../guards.js';
+import { TIME_ZONES, TIME_ZONE_LABELS } from '../timezone.js';
+import { extractMinutesFromUTC } from '../utils.js';
 export const timeZonePlugin = (ChronosClass) => {
     const { internalDate: $Date, withOrigin } = ChronosClass[INTERNALS];
+    const TZ_IDS = Intl.supportedValuesOf('timeZone');
     const _isGMT = (factor) => {
         return factor === 'UTC+00:00' || factor === 'UTC-00:00';
     };
-    const TZ_NAME_ABBR_MAP = new Map(Object.entries(TIME_ZONES).map(([tzAbbr, { offset, tzName }]) => [
-        offset,
-        { tzAbbr, tzName },
-    ]));
     const _isLabelKey = (offset) => {
-        return offset in TIME_ZONE_LABELS;
+        return offset ? offset in TIME_ZONE_LABELS : false;
+    };
+    const _isValidTzAbbr = (tz) => {
+        return tz in TIME_ZONES;
     };
     const _resolveTzName = (offset) => {
         if (_isLabelKey(offset)) {
@@ -20,6 +20,51 @@ export const timeZonePlugin = (ChronosClass) => {
         }
         return undefined;
     };
+    const _getTimeZoneDetails = (tzId, date) => {
+        const TZ_NAME_TYPES = ['long', 'longOffset'];
+        const obj = { tzId };
+        for (const type of TZ_NAME_TYPES) {
+            const key = type === 'long' ? 'tzName' : 'offset';
+            try {
+                const parts = new Intl.DateTimeFormat('en', {
+                    timeZone: tzId,
+                    timeZoneName: type,
+                }).formatToParts(date);
+                const tzPart = parts.find((p) => p.type === 'timeZoneName');
+                const value = type === 'longOffset' ?
+                    tzPart?.value === 'GMT' ?
+                        'UTC+00:00'
+                        : tzPart?.value?.replace(/^GMT/, 'UTC')
+                    : tzPart?.value;
+                obj[key] = value;
+            }
+            catch {
+                obj[key] = undefined;
+            }
+        }
+        return obj;
+    };
+    const TZ_ID_MAP = new Map(TZ_IDS.reduce((tzIds, id) => {
+        const { offset } = _getTimeZoneDetails(id);
+        if (offset) {
+            const arr = tzIds.get(offset) ?? [];
+            arr.push(id);
+            tzIds.set(offset, arr);
+        }
+        return tzIds;
+    }, new Map()));
+    const TZ_NAME_ABBR_MAP = new Map(Object.entries(TIME_ZONES).map(([tzAbbr, { offset, tzName }]) => [
+        offset,
+        { tzAbbr, tzName },
+    ]));
+    const _getTimeZoneId = (utc) => {
+        const tzIds = TZ_ID_MAP.get(utc);
+        if (!tzIds || tzIds?.length === 0)
+            return undefined;
+        if (tzIds?.length === 1)
+            return tzIds[0];
+        return tzIds;
+    };
     const _getTimeZoneName = (zone, date) => {
         if (_isGMT(zone))
             return 'Greenwich Mean Time';
@@ -30,34 +75,14 @@ export const timeZonePlugin = (ChronosClass) => {
             }
             return tzName;
         }
-        else if (isValidTimeZoneId(zone)) {
-            const { offset, tzName } = TIME_ZONE_IDS[zone];
-            const { tzNameLongOffset, tzNameLong } = getTimeZoneDetails(zone, date);
-            const convertedOffset = tzNameLongOffset?.replace(/^GMT/, 'UTC') ?? '';
-            const resolvedName = _resolveTzName(offset);
-            const priorityName = convertedOffset === offset ? tzNameLong : resolvedName;
-            return tzName || priorityName || resolvedName || tzNameLong;
+        else if (_isValidTzAbbr(zone)) {
+            return TIME_ZONES[zone].tzName;
         }
         else {
-            return zone in TIME_ZONES ?
-                TIME_ZONES[zone].tzName
-                : _resolveTzName(TIME_ZONES[zone]?.offset);
+            const { offset, tzName } = _getTimeZoneDetails(zone, date);
+            return tzName || _resolveTzName(offset);
         }
     };
-    const TZ_ID_MAP = new Map(Object.entries(TIME_ZONE_IDS).reduce((acc, [id, { offset }]) => {
-        const arr = acc.get(offset) ?? [];
-        arr.push(id);
-        acc.set(offset, arr);
-        return acc;
-    }, new Map()));
-    const _getTimeZoneId = (utc) => {
-        const tzIds = TZ_ID_MAP.get(utc);
-        if (!tzIds || tzIds?.length === 0)
-            return undefined;
-        if (tzIds?.length === 1)
-            return tzIds[0];
-        return tzIds;
-    };
     ChronosClass.prototype.timeZone = function (zone) {
         let offset;
         let tzId;
@@ -65,13 +90,13 @@ export const timeZonePlugin = (ChronosClass) => {
             offset = zone;
             tzId = _getTimeZoneId(offset) || offset;
         }
-        else if (isValidTimeZoneId(zone)) {
-            offset = TIME_ZONE_IDS[zone].offset;
-            tzId = zone;
+        else if (_isValidTzAbbr(zone)) {
+            offset = TIME_ZONES[zone].offset;
+            tzId = _getTimeZoneId(offset) || offset;
         }
         else {
-            offset = zone in TIME_ZONES ? TIME_ZONES[zone].offset : TIME_ZONES['UTC'].offset;
-            tzId = _getTimeZoneId(offset) || offset;
+            offset = _getTimeZoneDetails(zone, $Date(this)).offset || TIME_ZONES['UTC'].offset;
+            tzId = zone;
         }
         const $zone = zone || offset;
         const tzName = _getTimeZoneName($zone, $Date(this)) ?? offset;
@@ -118,7 +143,7 @@ export const timeZonePlugin = (ChronosClass) => {
         const zone = _getTimeZoneName(tzMapKey, $Date(this)) ?? UTC;
         if (TZ_ABBR_CACHE.has(`name-${zone}`))
             return TZ_ABBR_CACHE.get(zone);
-        const customAbbr = isValidUTCOffset(zone) || isValidTimeZoneId(zone) ? zone : _abbreviate(zone);
+        const customAbbr = isValidUTCOffset(zone) ? zone : _abbreviate(zone);
         TZ_ABBR_CACHE.set(`name-${zone}`, customAbbr);
         return customAbbr;
     };

package/dist/esm/date/timezone.js

@@ -2858,6 +2858,10 @@ export const TIME_ZONE_IDS = /* @__PURE__ */ Object.freeze({
         tzName: 'Central European Time',
         offset: 'UTC+01:00',
     },
+    Factory: {
+        tzName: undefined,
+        offset: 'UTC+00:00',
+    },
     GB: {
         tzName: 'Greenwich Mean Time',
         offset: 'UTC+00:00',

package/dist/esm/date/utils.js

@@ -34,13 +34,18 @@ export function getTimeZoneDetails(tzId, date) {
     const $tzId = tzId || Intl.DateTimeFormat().resolvedOptions().timeZone;
     const obj = { tzIdentifier: $tzId };
     for (const type of TZ_NAME_TYPES) {
-        const parts = new Intl.DateTimeFormat('en', {
-            timeZone: $tzId,
-            timeZoneName: type,
-        }).formatToParts(date);
-        const tzPart = parts.find((p) => p.type === 'timeZoneName');
         const key = `tzName${type[0].toUpperCase()}${type.slice(1)}`;
-        obj[key] = tzPart?.value;
+        try {
+            const parts = new Intl.DateTimeFormat('en', {
+                timeZone: $tzId,
+                timeZoneName: type,
+            }).formatToParts(date);
+            const tzPart = parts.find((p) => p.type === 'timeZoneName');
+            obj[key] = tzPart?.value;
+        }
+        catch {
+            obj[key] = undefined;
+        }
     }
     return obj;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.26.45",
+  "version": "4.26.50",
   "description": "A versatile collection of smart, efficient, and reusable utility functions, classes and types for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",