nhb-toolbox 4.26.41 → 4.26.45

package/CHANGELOG.md

@@ -6,6 +6,14 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [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.
+
+## [4.26.44] - 2025-11-13
+
+- **Fixed** issues with passing optional *time zone id* in `Chronos` method `$getNativeTimeZoneName` and `getTimeZoneDetails` utility.
+
 ## [4.26.41] - 2025-11-12
 
 - **Updated** *tsdoc* for some `Chronos` *methods* and `getTimeZoneDetails` utility.

package/dist/cjs/date/Chronos.js

@@ -129,7 +129,7 @@ class Chronos {
     }
     $getNativeTimeZoneName(tzId) {
         const $tzId = tzId || this.$getNativeTimeZoneId();
-        return this.#getNativeTzName(tzId) ?? $tzId;
+        return this.#getNativeTzName($tzId) ?? $tzId;
     }
     $getNativeTimeZoneId() {
         return Intl.DateTimeFormat().resolvedOptions().timeZone;

package/dist/cjs/date/timezone.js

@@ -2461,9 +2461,9 @@ exports.TIME_ZONE_IDS = /* @__PURE__ */ Object.freeze({
         tzName: 'Eastern Standard Time',
         offset: 'UTC-05:00',
     },
-    EDT: {
-        tzName: 'Eastern Daylight Time',
-        offset: 'UTC-04:00',
+    EST5EDT: {
+        tzName: 'Eastern Standard Tim',
+        offset: 'UTC-05:00',
     },
     'Etc/GMT': {
         tzName: 'Greenwich Mean Time',
@@ -2861,10 +2861,6 @@ 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

@@ -41,10 +41,11 @@ function formatUTCOffset(minutes) {
 }
 function getTimeZoneDetails(tzId, date) {
     const TZ_NAME_TYPES = ['long', 'longGeneric', 'longOffset'];
-    const obj = { tzIdentifier: tzId };
+    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,
+            timeZone: $tzId,
             timeZoneName: type,
         }).formatToParts(date);
         const tzPart = parts.find((p) => p.type === 'timeZoneName');

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

@@ -849,7 +849,7 @@ export declare const TIME_ZONES: Readonly<{
         readonly offset: "UTC+05:00";
     };
 }>;
-/** Record of unique standard time-zone labels/names for their corresponding UTC offsets as (`{ UTCOffset: timeZoneName }`). */
+/** Record of unique standard time-zone labels/names for their corresponding UTC offsets as (`{ utcOffset: timeZoneName }`). */
 export declare const TIME_ZONE_LABELS: Readonly<{
     readonly 'UTC-12:00': "Baker Island Time";
     readonly 'UTC-11:00': "Samoa Standard Time";
@@ -895,7 +895,7 @@ export declare const TIME_ZONE_LABELS: Readonly<{
     readonly 'UTC+13:00': "Phoenix Island Time";
     readonly 'UTC+14:00': "Line Islands Time";
 }>;
-/** Record of timezone identifiers (from {@link https://en.wikipedia.org/wiki/List_of_tz_database_time_zones IANA TZ Database on Wikipedia}) against their corresponding UTC offsets and full timezone names. */
+/** Record of 597 timezone identifiers (from {@link https://en.wikipedia.org/wiki/List_of_tz_database_time_zones IANA TZ Database on Wikipedia}) against their corresponding UTC offsets and full timezone names. */
 export declare const TIME_ZONE_IDS: Readonly<{
     readonly 'Africa/Abidjan': {
         readonly tzName: "Greenwich Mean Time";
@@ -2461,9 +2461,9 @@ export declare const TIME_ZONE_IDS: Readonly<{
         readonly tzName: "Eastern Standard Time";
         readonly offset: "UTC-05:00";
     };
-    readonly EDT: {
-        readonly tzName: "Eastern Daylight Time";
-        readonly offset: "UTC-04:00";
+    readonly EST5EDT: {
+        readonly tzName: "Eastern Standard Tim";
+        readonly offset: "UTC-05:00";
     };
     readonly 'Etc/GMT': {
         readonly tzName: "Greenwich Mean Time";
@@ -2861,10 +2861,6 @@ 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

@@ -14,7 +14,7 @@ export type ClockMinute = `0${Enumerate<10>}` | `${NumberRange<10, 59>}`;
 export type ClockSecond = `0${Enumerate<10>}` | `${NumberRange<10, 59>}`;
 /** - Time in "HH:MM" format. */
 export type ClockTime = `${ClockHour}:${ClockMinute}`;
-/** Normal time in `H:m`m format which does not follow the strict limit up to 23 hours, hour can be any number and minute can be numeric string from `00` to `59` */
+/** Normal time in `H:mm` format which does not follow the strict limit up to 23 hours, hour can be any number and minute can be numeric string from `00` to `59` */
 export type HourMinutes = `${number}:${ClockMinute}`;
 /** - Configuration options for greeting. */
 export interface GreetingConfigs {
@@ -47,20 +47,20 @@ export interface GreetingConfigs {
     /** Default greeting message if no period matches. */
     defaultMessage?: string;
 }
-/** Time zone details */
+/** Time zone details object */
 export type TimeZoneDetails = {
-    /** Time zone identifier */
+    /** IANA time zone identifier */
     tzIdentifier: LooseLiteral<TimeZoneIdentifier>;
-    /** Full time zone name */
+    /** Long localized form (e.g., `'Pacific Standard Time'`, `'Nordamerikanische Westküsten-Normalzeit'`) */
     tzNameLong?: LooseLiteral<TimeZoneName>;
-    /** Full time zone name but omits specific location */
+    /** Long generic non-location format (e.g.: `'Pacific Time'`, `'Nordamerikanische Westküstenzeit'`) */
     tzNameLongGeneric?: LooseLiteral<TimeZoneName>;
-    /** Time zone offset from `UTC`, prefixed with `"GMT"` */
+    /** Long localized GMT format, prefixed with `"GMT"` (e.g., `"GMT-08:00"`) */
     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` */
+/** Name of time unit from `year` to `millisecond`, excluding `week` */
 export type FromNowUnit = Exclude<TimeUnit, 'week'>;
 /** Conditional value for {@link TimeUnit} */
 export type TimeUnitValue<Unit extends TimeUnit> = Unit extends 'month' ? NumberRange<1, 12> : Unit extends 'week' ? NumberRange<1, 53> : Unit extends 'day' ? NumberRange<1, 31> : Unit extends 'hour' ? Enumerate<24> : Unit extends 'minute' | 'second' ? Enumerate<60> : Unit extends 'millisecond' ? Milliseconds : number;

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

@@ -59,6 +59,6 @@ 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.
  * @param date Optional date for which to resolve the information.
- * @returns Object containing identifier, names, and offset.
+ * @returns Object containing time zone identifier, names, and offset.
  */
 export declare function getTimeZoneDetails(tzId?: TimeZoneIdentifier, date?: Date): TimeZoneDetails;

package/dist/esm/date/Chronos.js

@@ -126,7 +126,7 @@ export class Chronos {
     }
     $getNativeTimeZoneName(tzId) {
         const $tzId = tzId || this.$getNativeTimeZoneId();
-        return this.#getNativeTzName(tzId) ?? $tzId;
+        return this.#getNativeTzName($tzId) ?? $tzId;
     }
     $getNativeTimeZoneId() {
         return Intl.DateTimeFormat().resolvedOptions().timeZone;

package/dist/esm/date/timezone.js

@@ -2458,9 +2458,9 @@ export const TIME_ZONE_IDS = /* @__PURE__ */ Object.freeze({
         tzName: 'Eastern Standard Time',
         offset: 'UTC-05:00',
     },
-    EDT: {
-        tzName: 'Eastern Daylight Time',
-        offset: 'UTC-04:00',
+    EST5EDT: {
+        tzName: 'Eastern Standard Tim',
+        offset: 'UTC-05:00',
     },
     'Etc/GMT': {
         tzName: 'Greenwich Mean Time',
@@ -2858,10 +2858,6 @@ 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

@@ -31,10 +31,11 @@ export function formatUTCOffset(minutes) {
 }
 export function getTimeZoneDetails(tzId, date) {
     const TZ_NAME_TYPES = ['long', 'longGeneric', 'longOffset'];
-    const obj = { tzIdentifier: tzId };
+    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,
+            timeZone: $tzId,
             timeZoneName: type,
         }).formatToParts(date);
         const tzPart = parts.find((p) => p.type === 'timeZoneName');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.26.41",
+  "version": "4.26.45",
   "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",
@@ -44,7 +44,6 @@
     "@types/node": "^24.10.1",
     "@typescript-eslint/eslint-plugin": "^8.46.4",
     "@typescript-eslint/parser": "^8.46.4",
-    "chalk": "^5.6.2",
     "eslint": "^9.39.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",