nhb-toolbox 4.26.64 → 4.26.69

package/CHANGELOG.md

@@ -6,6 +6,17 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.26.69] - 2025-11-18
+
+- **Updated** *return type* of `sanitizeData` utility:
+  - **Fixed** *return type* when keys are ignored by *removing those keys* using `SanitizedData`, `OmitPath` and other new `type helpers`.
+  - **Fixed** the *return type* when it is called with `_return = 'partial'` parameter by *making all the nested properties optional*.
+    - **Created** new *utility type* `$DeepPartial` to satisfy this *return type*.
+
+## [4.26.66] - 2025-11-17
+
+- **Changed** the signature of `Chronos` `get()` method to `get<Unit extends TimeUnit>(unit: Unit): TimeUnitValue<Unit>` to align with `set()` method.
+
 ## [4.26.64] - 2025-11-17
 
 ### 🕧 Fixes in Chronos

package/dist/cjs/date/Chronos.js

@@ -60,22 +60,22 @@ class Chronos {
         yield ['minute', this.minute];
         yield ['second', this.second];
         yield ['millisecond', this.millisecond];
-        yield ['timestamp', this.timestamp];
+        yield ['timestamp', this.getTimeStamp()];
         yield ['unix', this.unix];
     }
     [Symbol.toPrimitive](hint) {
         if (hint === 'number')
-            return this.valueOf();
+            return this.getTimeStamp();
         return this.toLocalISOString();
     }
     [Symbol.replace](string, replacement) {
-        return string.replace(this.#removeUTCFromISO(true), replacement);
+        return string.replace(this.#removeUTCFromISO(), replacement);
     }
     [Symbol.search](string) {
-        return string.indexOf(this.#removeUTCFromISO(true));
+        return string.indexOf(this.#removeUTCFromISO());
     }
     [Symbol.split](string) {
-        return string.split(this.#removeUTCFromISO(true));
+        return string.split(this.#removeUTCFromISO());
     }
     [Symbol.match](string) {
         const [datePart, timePart] = this.toLocalISOString().split('.')[0].split('T');
@@ -154,7 +154,6 @@ class Chronos {
         const minutes = _getUnitValue('Minutes');
         const seconds = _getUnitValue('Seconds');
         const milliseconds = _getUnitValue('Milliseconds');
-        const timeZone = useUTC ? 'Z' : this.getTimeZoneOffset();
         const dateComponents = {
             YYYY: String(year),
             YY: String(year).slice(-2),
@@ -182,7 +181,7 @@ class Chronos {
             mss: String(milliseconds).padStart(3, '0'),
             a: hours < 12 ? 'am' : 'pm',
             A: hours < 12 ? 'AM' : 'PM',
-            ZZ: timeZone,
+            ZZ: useUTC ? 'Z' : this.getTimeZoneOffset(),
         };
         const tokenRegex = new RegExp(`^(${constants_1.SORTED_TIME_FORMATS.join('|')})`);
         let result = '';
@@ -208,10 +207,11 @@ class Chronos {
         }
         return result;
     }
-    #removeUTCFromISO(local = false) {
+    #removeUTCFromISO(local = true) {
+        const search = /\.\d+(Z|[+-]\d{2}:\d{2})?$/;
         return local ?
-            this.toLocalISOString().replace(/\.\d+(Z|[+-]\d{2}:\d{2})?$/, '')
-            : this.toISOString().replace(/\.\d+(Z|[+-]\d{2}:\d{2})?$/, '');
+            this.toLocalISOString().replace(search, '')
+            : this.toISOString().replace(search, '');
     }
     get year() {
         return this.#date.getFullYear();
@@ -269,7 +269,7 @@ class Chronos {
         const targetOffset = (0, utils_1.extractMinutesFromUTC)(this.#offset);
         const systemOffset = this.getUTCOffsetMinutes();
         const adjustmentMs = (targetOffset - systemOffset) * 60_000;
-        return new Date(this.#date.getTime() - adjustmentMs);
+        return new Date(this.#timestamp - adjustmentMs);
     }
     toString() {
         return this.#format('dd mmm DD YYYY HH:mm:ss ')
@@ -322,31 +322,25 @@ class Chronos {
         return (0, guards_1.isLeapYear)(year ?? this.year);
     }
     isEqual(other) {
-        const time = _a.#cast(other);
-        return this.#timestamp === time.#timestamp;
+        return this.#timestamp === _a.#cast(other).#timestamp;
     }
     isEqualOrBefore(other) {
-        const time = _a.#cast(other);
-        return this.#timestamp <= time.#timestamp;
+        return this.#timestamp <= _a.#cast(other).#timestamp;
     }
     isEqualOrAfter(other) {
-        const time = _a.#cast(other);
-        return this.#timestamp >= time.#timestamp;
+        return this.#timestamp >= _a.#cast(other).#timestamp;
     }
     isSame(other, unit, weekStartsOn = 0) {
-        const time = _a.#cast(other);
         return (this.startOf(unit, weekStartsOn).#timestamp ===
-            time.startOf(unit, weekStartsOn).#timestamp);
+            _a.#cast(other).startOf(unit, weekStartsOn).#timestamp);
     }
     isBefore(other, unit, weekStartsOn = 0) {
-        const time = _a.#cast(other);
         return (this.startOf(unit, weekStartsOn).#timestamp <
-            time.startOf(unit, weekStartsOn).#timestamp);
+            _a.#cast(other).startOf(unit, weekStartsOn).#timestamp);
     }
     isAfter(other, unit, weekStartsOn = 0) {
-        const time = _a.#cast(other);
         return (this.startOf(unit, weekStartsOn).#timestamp >
-            time.startOf(unit, weekStartsOn).#timestamp);
+            _a.#cast(other).startOf(unit, weekStartsOn).#timestamp);
     }
     isSameOrBefore(other, unit, weekStartsOn = 0) {
         return (this.isSame(other, unit, weekStartsOn) || this.isBefore(other, unit, weekStartsOn));
@@ -355,9 +349,9 @@ class Chronos {
         return (this.isSame(other, unit, weekStartsOn) || this.isAfter(other, unit, weekStartsOn));
     }
     isBetween(start, end, inclusive = '()') {
-        const s = new _a(start).valueOf();
-        const e = new _a(end).valueOf();
-        const t = this.valueOf();
+        const s = _a.#cast(start).getTimeStamp();
+        const e = _a.#cast(end).getTimeStamp();
+        const t = this.getTimeStamp();
         switch (inclusive) {
             case '[]':
                 return t >= s && t <= e;
@@ -466,21 +460,21 @@ class Chronos {
     get(unit) {
         switch (unit) {
             case 'year':
-                return this.#date.getFullYear();
+                return this.year;
             case 'month':
-                return this.#date.getMonth();
+                return this.isoMonth;
             case 'day':
-                return this.#date.getDate();
+                return this.date;
             case 'week':
                 return this.getWeek();
             case 'hour':
-                return this.#date.getHours();
+                return this.hour;
             case 'minute':
-                return this.#date.getMinutes();
+                return this.minute;
             case 'second':
-                return this.#date.getSeconds();
+                return this.second;
             case 'millisecond':
-                return this.#date.getMilliseconds();
+                return this.millisecond;
         }
     }
     set(unit, value) {
@@ -514,7 +508,7 @@ class Chronos {
     }
     diff(other, unit) {
         const time = _a.#cast(other);
-        const msDiff = this.#date.getTime() - time.#date.getTime();
+        const msDiff = this.#timestamp - time.#timestamp;
         switch (unit) {
             case 'millisecond':
                 return msDiff;
@@ -540,7 +534,7 @@ class Chronos {
         }
     }
     calendar(baseDate) {
-        const base = baseDate ? new _a(baseDate) : new _a();
+        const base = baseDate ? _a.#cast(baseDate) : new _a();
         const input = this.startOf('day');
         const comparison = base.startOf('day');
         const diff = input.diff(comparison, 'day');
@@ -651,12 +645,12 @@ class Chronos {
     }
     toUTC() {
         const offset = this.getTimeZoneOffsetMinutes();
-        const utc = new Date(this.#date.getTime() - offset * 60 * 1000);
+        const utc = new Date(this.#timestamp - offset * 60 * 1000);
         return new _a(utc).#withOrigin('toUTC', 'UTC+00:00', 'Greenwich Mean Time', 'UTC');
     }
     toLocal() {
         const offset = this.getTimeZoneOffsetMinutes() - this.getUTCOffsetMinutes();
-        const localTime = new Date(this.#date.getTime() - offset * 60 * 1000);
+        const localTime = new Date(this.#timestamp - offset * 60 * 1000);
         return new _a(localTime).#withOrigin('toLocal');
     }
     day(index) {
@@ -671,10 +665,10 @@ class Chronos {
         if (options) {
             if ('from' in options || 'to' in options) {
                 if (options?.from) {
-                    startDate = new _a(options?.from);
+                    startDate = _a.#cast(options?.from);
                 }
                 if (options?.to) {
-                    endDate = new _a(options?.to);
+                    endDate = _a.#cast(options?.to);
                 }
             }
             else if ('span' in options || 'unit' in options) {
@@ -771,8 +765,7 @@ class Chronos {
     }
     static today(options) {
         const { format = 'dd, mmm DD, YYYY HH:mm:ss', useUTC = false } = options || {};
-        const today = new Date();
-        return new _a(today).#format(format, useUTC);
+        return new _a().#format(format, useUTC);
     }
     static yesterday() {
         const today = new Date();
@@ -790,7 +783,7 @@ class Chronos {
     static utc(dateLike) {
         const chronos = new _a(dateLike);
         const offset = chronos.getTimeZoneOffsetMinutes();
-        const utc = new Date(chronos.#date.getTime() - offset * 60 * 1000);
+        const utc = new Date(chronos.#timestamp - offset * 60 * 1000);
         return new _a(utc).#withOrigin('utc', 'UTC+00:00', 'Greenwich Mean Time', 'UTC');
     }
     static formatTimePart(time, format) {
@@ -806,10 +799,10 @@ class Chronos {
         if (options) {
             if ('from' in options || 'to' in options) {
                 if (options?.from) {
-                    startDate = new _a(options?.from);
+                    startDate = _a.#cast(options?.from);
                 }
                 if (options?.to) {
-                    endDate = new _a(options?.to);
+                    endDate = _a.#cast(options?.to);
                 }
             }
             else if ('span' in options || 'unit' in options) {
@@ -834,7 +827,7 @@ class Chronos {
         let winner = _a.#cast(dates[0]);
         for (const d of dates) {
             const c = _a.#cast(d);
-            if (c.timestamp < winner.timestamp) {
+            if (c.getTimeStamp() < winner.getTimeStamp()) {
                 winner = c;
             }
         }
@@ -844,7 +837,7 @@ class Chronos {
         let winner = _a.#cast(dates[0]);
         for (const d of dates) {
             const c = _a.#cast(d);
-            if (c.timestamp > winner.timestamp) {
+            if (c.getTimeStamp() > winner.getTimeStamp()) {
                 winner = c;
             }
         }
@@ -861,7 +854,7 @@ class Chronos {
             }
         }
         else {
-            year = date instanceof _a ? date.year : new _a(date).year;
+            year = _a.#cast(date).year;
         }
         return (0, guards_1.isLeapYear)(year);
     }

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

@@ -418,9 +418,9 @@ export declare class Chronos {
     subtract(number: number, unit: TimeUnit): Chronos;
     /**
      * @instance Gets the value of a specific time unit from the date.
-     * @param unit The unit to retrieve.
+     * @param unit The unit to retrieve. Type of return value is determined by `unit`.
      */
-    get(unit: TimeUnit): number;
+    get<Unit extends TimeUnit>(unit: Unit): TimeUnitValue<Unit>;
     /**
      * @instance Returns a new `Chronos` instance with the specified unit set to the given value.
      * @param unit The unit to modify. Type of `value` is determined by `unit`.

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

@@ -82,7 +82,7 @@ export type Second = (typeof SECOND_FORMATS)[number];
 export type Millisecond = (typeof MILLISECOND_FORMATS)[number];
 /** Time formats in either capital or lowercase `am/pm` format */
 export type TimeFormats = (typeof TIME_FORMATS)[number];
-/** Represents a valid unit suffix for {@link Date} getter methods (e.g., 'getFullYear', 'getMonth' etc.). */
+/** Represents a unit suffix for {@link Date} getter methods (e.g., `'FullYear'` in `'getFullYear'`, `'Month'` in `'getMonth'` etc.). */
 export type $DateUnit = 'FullYear' | 'Month' | 'Day' | 'Date' | 'Hours' | 'Minutes' | 'Seconds' | 'Milliseconds';
 /** Standard union formats for `Chronos`. */
 export type ChronosFormat = Year | Month | Day | MonthDate | Hour | Minute | Second | Millisecond | TimeFormats | 'ZZ';
@@ -314,7 +314,7 @@ export interface RelativeRangeOptions {
     span?: number;
     /** - Unit of time to advance the date range. Defaults to `'week'`.  Controlled by the `span` option. */
     unit?: 'year' | 'month' | 'week' | 'day';
-    /** - Output format — return as local ISO string or UTC ISO string. Defaults to `'local'`. */
+    /** - Output format: return as local ISO string or UTC ISO string. Defaults to `'local'`. */
     format?: 'local' | 'utc';
     /** Whether to round the dates in the range to the start of the day. Default is `false`. */
     roundDate?: boolean;
@@ -358,7 +358,7 @@ export interface RelativeDateRange {
     span?: number;
     /** - Unit of time to advance the date range. Defaults to `'week'`.  Controlled by the `span` option. */
     unit?: 'year' | 'month' | 'week' | 'day';
-    /** - Output format — return as local ISO string or UTC ISO string. Defaults to `'local'`. */
+    /** - Output format: return as local ISO string or UTC ISO string. Defaults to `'local'`. */
     format?: 'local' | 'utc';
     /**
      * An array of weekdays to exclude from the date range.

package/dist/dts/object/sanitize.d.ts

@@ -1,5 +1,5 @@
-import type { Any, FlattenPartial, PartialOrRequired } from '../types/index';
-import type { GenericObject, SanitizeOptions } from './types';
+import type { Any, PartialOrRequired } from '../types/index';
+import type { DotNotationKey, GenericObject, SanitizedData, SanitizeOptions } from './types';
 /**
  * * Trims all the words in a string.
  *
@@ -23,7 +23,7 @@ export declare function sanitizeData(input: string[]): string[];
  * @param _return - By default return type is as it is, passing this parameter `true` makes the return type `Partial<T>`.
  * @returns A new object with the specified modifications.
  */
-export declare function sanitizeData<T extends GenericObject, B extends PartialOrRequired = 'required'>(object: T, options?: SanitizeOptions<T>, _return?: B): B extends 'partial' ? FlattenPartial<T> : T;
+export declare function sanitizeData<Data extends GenericObject, Ignored extends DotNotationKey<Data> = never, PoR extends PartialOrRequired = 'required'>(object: Data, options?: SanitizeOptions<Data, Ignored>, _return?: PoR): SanitizedData<Data, Ignored, PoR>;
 /**
  * * Sanitizes a deeply nested array that may contain arrays, objects or other (mixed) data types.
  * * Preserves structure while removing empty values and trimming strings and other operations.
@@ -33,7 +33,7 @@ export declare function sanitizeData<T extends GenericObject, B extends PartialO
  * @param _return - By default return type is as it is, passing this parameter `partial` makes the return type `Partial<T>`.
  * @returns A new sanitized array with the specified modifications.
  */
-export declare function sanitizeData<T extends GenericObject, B extends PartialOrRequired = 'required'>(array: T[], options?: SanitizeOptions<T>, _return?: B): B extends 'partial' ? FlattenPartial<T>[] : T[];
+export declare function sanitizeData<Data extends GenericObject, Ignored extends DotNotationKey<Data> = never, PoR extends PartialOrRequired = 'required'>(array: Data[], options?: SanitizeOptions<Data, Ignored>, _return?: PoR): Array<SanitizedData<Data, Ignored, PoR>>;
 /**
  * * Parse an object of stringified values into their appropriate primitive types.
  *

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

@@ -1,5 +1,5 @@
-import type { AdvancedTypes, NormalPrimitive, ValidArray } from '../types/index';
-import type { $UnionToIntersection, Prettify, Split, Tuple } from '../utils/types';
+import type { AdvancedTypes, NormalPrimitive, PartialOrRequired, ValidArray } from '../types/index';
+import type { $DeepPartial, $UnionToIntersection, Prettify, Split, Tuple } from '../utils/types';
 import type { COUNTRIES } from './countries';
 /** - Generic object with `unknown` value */
 export type StrictObject = Record<string, unknown>;
@@ -103,13 +103,13 @@ export type DeepKeys<T extends GenericObject> = T extends AdvancedTypes ? never
 /** - Converts the union of keys from {@link DeepKeys<T>} into a tuple. */
 export type DeepKeysTuple<T extends GenericObject> = Tuple<DeepKeys<T>>;
 /** - Options for `sanitizeData` utility. */
-export interface SanitizeOptions<T> {
+export interface SanitizeOptions<T, Ignored extends DotNotationKey<T>> {
     /**
      * An array of dot-notation keys to exclude from the sanitized output.
      * This is only applicable when sanitizing plain objects or arrays of objects.
      * When applied to nested or irregular array structures, behavior may be inconsistent or partially ignored.
      */
-    keysToIgnore?: DotNotationKey<T>[];
+    keysToIgnore?: Ignored[];
     /** Whether to trim string values. Defaults to `true`. */
     trimStrings?: boolean;
     /** Whether to exclude nullish (`null` or `undefined`) values. Defaults to `false`. */
@@ -125,6 +125,85 @@ export interface SanitizeOptions<T> {
      */
     requiredKeys?: '*' | DotNotationKey<T>[];
 }
+/**
+ * * Produces sanitized output data by omitting keys in `keysToIgnore` from {@link SanitizeOptions} and optionally applying partial deep nesting based on `_return` parameter.
+ *
+ * @remarks
+ * - When `PoR` is `'partial'`, all nested properties become optional after path omission.
+ * - When `PoR` is `'required'`, the resulting type keeps full property requirements.
+ * - Intended for return type of `sanitizeData` utility.
+ */
+export type SanitizedData<Data extends GenericObject, Ignored extends DotNotationKey<Data>, PoR extends PartialOrRequired> = PoR extends 'partial' ? $DeepPartial<OmitPath<Data, Ignored>> : OmitPath<Data, Ignored>;
+/**
+ * * Extracts only the string keys from an object type.
+ *
+ * @remarks
+ * - Useful when iterating over object keys inside template-literal-based utility types,
+ * because TypeScript may include `symbol` keys in `keyof T`, which cannot be used in
+ * template literal types.
+ * - By filtering to `string`, all keys become safe for path operations.
+ *
+ * @example
+ * type A = { a: number; b: string; 1: boolean; [Symbol.iterator]: () => void };
+ * type Keys = ExtractStringKey<A>;
+ * // Result: "a" | "b"
+ */
+export type ExtractStringKey<T> = Extract<keyof T, string>;
+/**
+ * * Joins a parent key and a child key into a dot-notation path.
+ *
+ * @remarks
+ * - If the parent path is an empty string, the child key is returned as-is.
+ * - Otherwise, the function produces `"parent.child"` formatting.
+ *
+ * @example
+ * type A = $JoinDotKey<'', 'user'>;          // "user"
+ * type B = $JoinDotKey<'settings', 'theme'>; // "settings.theme"
+ */
+export type $JoinDotKey<Parent extends string, Key extends string> = Parent extends '' ? Key : `${Parent}.${Key}`;
+/**
+ * * Checks whether a dot-notation path starts with the specified prefix.
+ *
+ * @remarks
+ * A path is considered a match if it is **exactly equal** to the prefix, or begins with `"prefix."`.
+ *
+ * @example
+ * type A = $DoesPathStartWith<'settings.timeout', 'settings'>; // true
+ * type B = $DoesPathStartWith<'settings', 'settings'>;         // true
+ * type C = $DoesPathStartWith<'user.name', 'settings'>;        // false
+ */
+export type $DoesPathStartWith<Path extends string, Prefix extends string> = Path extends Prefix | `${Prefix}.${string}` ? true : false;
+/** Recursive utility that removes a specific dot-notation path from an object. */
+type $OmitPath<T extends GenericObject, I extends string, P extends string = ''> = Prettify<{
+    [K in ExtractStringKey<T> as $DoesPathStartWith<$JoinDotKey<P, K>, I> extends true ? never : K]: T[K] extends GenericObject ? T[K] extends AdvancedTypes ? T[K] : $OmitPath<T[K], I, $JoinDotKey<P, K>> : T[K];
+}>;
+/**
+ * * Removes a dot-notation path from an object type while preserving its original shape.
+ *
+ * @remarks
+ * - It excludes the specified dot path, but **retains the full structure** of the parent object.
+ * - Only the targeted property is removed.
+ *
+ * @example
+ * type Input = {
+ *   settings: {
+ *     timeout: number;
+ *     theme: string;
+ *   };
+ *   version: string;
+ * };
+ *
+ * type Clean = OmitPath<Input, "settings.timeout">;
+ *
+ * // Result:
+ * // {
+ * //   settings: {
+ * //     theme: string;
+ * //   };
+ * //   version: string;
+ * // }
+ */
+export type OmitPath<Object extends GenericObject, Ignored extends DotNotationKey<Object>> = $OmitPath<Object, Ignored>;
 /** Options for `convertObjectValues` utility */
 export interface ConvertObjectOptions<T extends GenericObject, Key extends NumericDotKey<T>, C extends 'string' | 'number'> {
     /** Array of keys (properties) to convert to `number` or `string` */

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

@@ -75,28 +75,45 @@ export type KeysOfUnion<T> = T extends T ? keyof T : never;
  * * Recursively makes all potential standard js object properties optional.
  *
  * @remarks
- * - It excludes complex types like `Array`, `Map`, `File`, `Date`, `Chronos` etc. from being recursively partial.
- * - Please, refer to {@link AdvancedTypes} to learn more about these complex types.
+ * - It excludes keys of complex types like `Array`, `Map`, `File`, `Date`, `Chronos` etc. from being recursively partial.
+ * - Please, refer to {@link AdvancedTypes} to allow these complex types.
+ * - Also refer to {@link $DeepPartial} for less strict version.
  *
  * @example
  * type Config = { a: string; nested: { b: number } };
  * type PartialConfig = DeepPartial<Config>;
  * // { a?: string; nested?: { b?: number } }
  */
-export type DeepPartial<T> = {
+export type DeepPartial<T> = Prettify<{
     [K in keyof T]?: T[K] extends AdvancedTypes ? T[K] : T[K] extends object ? DeepPartial<T[K]> : T[K];
-};
+}>;
+/**
+ * * Recursively makes all potential standard js object (also object in array) properties optional.
+ *
+ * @remarks
+ * - It excludes keys of complex types like `Map`, `File`, `Date`, `Chronos` etc. from being recursively partial.
+ * - Please, refer to {@link AdvancedTypes} to allow these complex types.
+ * - Also refer to {@link DeepPartial} for more strict version.
+ *
+ * @example
+ * type Config = { a: string; nested: { b: number }[] };
+ * type PartialConfig = $DeepPartial<Config>;
+ * // { a?: string; nested?: { b?: number; }[]; }
+ */
+export type $DeepPartial<T> = Prettify<{
+    [K in keyof T]?: T[K] extends Array<infer El> ? Array<$DeepPartial<El>> : T[K] extends AdvancedTypes ? T[K] : $DeepPartial<T[K]>;
+}>;
 /**
  * * Recursively makes all properties in any object or array type optional.
  *
  * @example
  * type Config = { a: string; nested: { b: number } };
- * type PartialConfig = DeepPartial<Config>;
+ * type PartialConfig = DeepPartialAll<Config>;
  * // { a?: string; nested?: { b?: number } }
  */
-export type DeepPartialAll<T> = T extends Array<infer El> ? Array<DeepPartialAll<El>> : {
+export type DeepPartialAll<T> = T extends Array<infer El> ? Array<DeepPartialAll<El>> : Prettify<{
     [K in keyof T]?: DeepPartialAll<T[K]>;
-};
+}>;
 /**
  * * Removes `readonly` modifiers from all properties of an object type.
  *

package/dist/esm/date/Chronos.js

@@ -57,22 +57,22 @@ export class Chronos {
         yield ['minute', this.minute];
         yield ['second', this.second];
         yield ['millisecond', this.millisecond];
-        yield ['timestamp', this.timestamp];
+        yield ['timestamp', this.getTimeStamp()];
         yield ['unix', this.unix];
     }
     [Symbol.toPrimitive](hint) {
         if (hint === 'number')
-            return this.valueOf();
+            return this.getTimeStamp();
         return this.toLocalISOString();
     }
     [Symbol.replace](string, replacement) {
-        return string.replace(this.#removeUTCFromISO(true), replacement);
+        return string.replace(this.#removeUTCFromISO(), replacement);
     }
     [Symbol.search](string) {
-        return string.indexOf(this.#removeUTCFromISO(true));
+        return string.indexOf(this.#removeUTCFromISO());
     }
     [Symbol.split](string) {
-        return string.split(this.#removeUTCFromISO(true));
+        return string.split(this.#removeUTCFromISO());
     }
     [Symbol.match](string) {
         const [datePart, timePart] = this.toLocalISOString().split('.')[0].split('T');
@@ -151,7 +151,6 @@ export class Chronos {
         const minutes = _getUnitValue('Minutes');
         const seconds = _getUnitValue('Seconds');
         const milliseconds = _getUnitValue('Milliseconds');
-        const timeZone = useUTC ? 'Z' : this.getTimeZoneOffset();
         const dateComponents = {
             YYYY: String(year),
             YY: String(year).slice(-2),
@@ -179,7 +178,7 @@ export class Chronos {
             mss: String(milliseconds).padStart(3, '0'),
             a: hours < 12 ? 'am' : 'pm',
             A: hours < 12 ? 'AM' : 'PM',
-            ZZ: timeZone,
+            ZZ: useUTC ? 'Z' : this.getTimeZoneOffset(),
         };
         const tokenRegex = new RegExp(`^(${SORTED_TIME_FORMATS.join('|')})`);
         let result = '';
@@ -205,10 +204,11 @@ export class Chronos {
         }
         return result;
     }
-    #removeUTCFromISO(local = false) {
+    #removeUTCFromISO(local = true) {
+        const search = /\.\d+(Z|[+-]\d{2}:\d{2})?$/;
         return local ?
-            this.toLocalISOString().replace(/\.\d+(Z|[+-]\d{2}:\d{2})?$/, '')
-            : this.toISOString().replace(/\.\d+(Z|[+-]\d{2}:\d{2})?$/, '');
+            this.toLocalISOString().replace(search, '')
+            : this.toISOString().replace(search, '');
     }
     get year() {
         return this.#date.getFullYear();
@@ -266,7 +266,7 @@ export class Chronos {
         const targetOffset = extractMinutesFromUTC(this.#offset);
         const systemOffset = this.getUTCOffsetMinutes();
         const adjustmentMs = (targetOffset - systemOffset) * 60_000;
-        return new Date(this.#date.getTime() - adjustmentMs);
+        return new Date(this.#timestamp - adjustmentMs);
     }
     toString() {
         return this.#format('dd mmm DD YYYY HH:mm:ss ')
@@ -319,31 +319,25 @@ export class Chronos {
         return isLeapYear(year ?? this.year);
     }
     isEqual(other) {
-        const time = _a.#cast(other);
-        return this.#timestamp === time.#timestamp;
+        return this.#timestamp === _a.#cast(other).#timestamp;
     }
     isEqualOrBefore(other) {
-        const time = _a.#cast(other);
-        return this.#timestamp <= time.#timestamp;
+        return this.#timestamp <= _a.#cast(other).#timestamp;
     }
     isEqualOrAfter(other) {
-        const time = _a.#cast(other);
-        return this.#timestamp >= time.#timestamp;
+        return this.#timestamp >= _a.#cast(other).#timestamp;
     }
     isSame(other, unit, weekStartsOn = 0) {
-        const time = _a.#cast(other);
         return (this.startOf(unit, weekStartsOn).#timestamp ===
-            time.startOf(unit, weekStartsOn).#timestamp);
+            _a.#cast(other).startOf(unit, weekStartsOn).#timestamp);
     }
     isBefore(other, unit, weekStartsOn = 0) {
-        const time = _a.#cast(other);
         return (this.startOf(unit, weekStartsOn).#timestamp <
-            time.startOf(unit, weekStartsOn).#timestamp);
+            _a.#cast(other).startOf(unit, weekStartsOn).#timestamp);
     }
     isAfter(other, unit, weekStartsOn = 0) {
-        const time = _a.#cast(other);
         return (this.startOf(unit, weekStartsOn).#timestamp >
-            time.startOf(unit, weekStartsOn).#timestamp);
+            _a.#cast(other).startOf(unit, weekStartsOn).#timestamp);
     }
     isSameOrBefore(other, unit, weekStartsOn = 0) {
         return (this.isSame(other, unit, weekStartsOn) || this.isBefore(other, unit, weekStartsOn));
@@ -352,9 +346,9 @@ export class Chronos {
         return (this.isSame(other, unit, weekStartsOn) || this.isAfter(other, unit, weekStartsOn));
     }
     isBetween(start, end, inclusive = '()') {
-        const s = new _a(start).valueOf();
-        const e = new _a(end).valueOf();
-        const t = this.valueOf();
+        const s = _a.#cast(start).getTimeStamp();
+        const e = _a.#cast(end).getTimeStamp();
+        const t = this.getTimeStamp();
         switch (inclusive) {
             case '[]':
                 return t >= s && t <= e;
@@ -463,21 +457,21 @@ export class Chronos {
     get(unit) {
         switch (unit) {
             case 'year':
-                return this.#date.getFullYear();
+                return this.year;
             case 'month':
-                return this.#date.getMonth();
+                return this.isoMonth;
             case 'day':
-                return this.#date.getDate();
+                return this.date;
             case 'week':
                 return this.getWeek();
             case 'hour':
-                return this.#date.getHours();
+                return this.hour;
             case 'minute':
-                return this.#date.getMinutes();
+                return this.minute;
             case 'second':
-                return this.#date.getSeconds();
+                return this.second;
             case 'millisecond':
-                return this.#date.getMilliseconds();
+                return this.millisecond;
         }
     }
     set(unit, value) {
@@ -511,7 +505,7 @@ export class Chronos {
     }
     diff(other, unit) {
         const time = _a.#cast(other);
-        const msDiff = this.#date.getTime() - time.#date.getTime();
+        const msDiff = this.#timestamp - time.#timestamp;
         switch (unit) {
             case 'millisecond':
                 return msDiff;
@@ -537,7 +531,7 @@ export class Chronos {
         }
     }
     calendar(baseDate) {
-        const base = baseDate ? new _a(baseDate) : new _a();
+        const base = baseDate ? _a.#cast(baseDate) : new _a();
         const input = this.startOf('day');
         const comparison = base.startOf('day');
         const diff = input.diff(comparison, 'day');
@@ -648,12 +642,12 @@ export class Chronos {
     }
     toUTC() {
         const offset = this.getTimeZoneOffsetMinutes();
-        const utc = new Date(this.#date.getTime() - offset * 60 * 1000);
+        const utc = new Date(this.#timestamp - offset * 60 * 1000);
         return new _a(utc).#withOrigin('toUTC', 'UTC+00:00', 'Greenwich Mean Time', 'UTC');
     }
     toLocal() {
         const offset = this.getTimeZoneOffsetMinutes() - this.getUTCOffsetMinutes();
-        const localTime = new Date(this.#date.getTime() - offset * 60 * 1000);
+        const localTime = new Date(this.#timestamp - offset * 60 * 1000);
         return new _a(localTime).#withOrigin('toLocal');
     }
     day(index) {
@@ -668,10 +662,10 @@ export class Chronos {
         if (options) {
             if ('from' in options || 'to' in options) {
                 if (options?.from) {
-                    startDate = new _a(options?.from);
+                    startDate = _a.#cast(options?.from);
                 }
                 if (options?.to) {
-                    endDate = new _a(options?.to);
+                    endDate = _a.#cast(options?.to);
                 }
             }
             else if ('span' in options || 'unit' in options) {
@@ -768,8 +762,7 @@ export class Chronos {
     }
     static today(options) {
         const { format = 'dd, mmm DD, YYYY HH:mm:ss', useUTC = false } = options || {};
-        const today = new Date();
-        return new _a(today).#format(format, useUTC);
+        return new _a().#format(format, useUTC);
     }
     static yesterday() {
         const today = new Date();
@@ -787,7 +780,7 @@ export class Chronos {
     static utc(dateLike) {
         const chronos = new _a(dateLike);
         const offset = chronos.getTimeZoneOffsetMinutes();
-        const utc = new Date(chronos.#date.getTime() - offset * 60 * 1000);
+        const utc = new Date(chronos.#timestamp - offset * 60 * 1000);
         return new _a(utc).#withOrigin('utc', 'UTC+00:00', 'Greenwich Mean Time', 'UTC');
     }
     static formatTimePart(time, format) {
@@ -803,10 +796,10 @@ export class Chronos {
         if (options) {
             if ('from' in options || 'to' in options) {
                 if (options?.from) {
-                    startDate = new _a(options?.from);
+                    startDate = _a.#cast(options?.from);
                 }
                 if (options?.to) {
-                    endDate = new _a(options?.to);
+                    endDate = _a.#cast(options?.to);
                 }
             }
             else if ('span' in options || 'unit' in options) {
@@ -831,7 +824,7 @@ export class Chronos {
         let winner = _a.#cast(dates[0]);
         for (const d of dates) {
             const c = _a.#cast(d);
-            if (c.timestamp < winner.timestamp) {
+            if (c.getTimeStamp() < winner.getTimeStamp()) {
                 winner = c;
             }
         }
@@ -841,7 +834,7 @@ export class Chronos {
         let winner = _a.#cast(dates[0]);
         for (const d of dates) {
             const c = _a.#cast(d);
-            if (c.timestamp > winner.timestamp) {
+            if (c.getTimeStamp() > winner.getTimeStamp()) {
                 winner = c;
             }
         }
@@ -858,7 +851,7 @@ export class Chronos {
             }
         }
         else {
-            year = date instanceof _a ? date.year : new _a(date).year;
+            year = _a.#cast(date).year;
         }
         return isLeapYear(year);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.26.64",
+  "version": "4.26.69",
   "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",