nhb-toolbox 4.28.71 → 4.28.80

package/CHANGELOG.md

@@ -4,6 +4,17 @@
 
 All notable changes to the package will be documented here.
 
+## [4.28.80] - 2026-02-07
+
+- **Moved** `getDatesInRange` method to `Chronos` *plugin system*, usable via `dateRangePlugin`.
+- **Updated** `Timestamp` type to `ISOTimeString` and removed *branding* for better clarity and consistency across the codebase.
+  - `Chronos` methods `toISOString()` and `toLocalISOString()`; and `getTimestamp` utility now return `ISOTimeString` type.
+  - `Chronos` method `getDatesInRange(...)` now return `ISOTimeString[]` instead of `string[]`.
+
+## [4.28.72] - 2026-02-06
+
+- **Updated** *tsdoc* for the overload signatures of `getTimestamp` utility to clarify the behavior.
+
 ## [4.28.71] - 2026-02-06
 
 - **Fixed** an *issue* in `reconstruct` method of `Chronos` class where the *internal state* of the reconstructed instance was not properly when the timezone offset is different from the local system's timezone offset.

package/README.md

@@ -515,31 +515,31 @@ debounceAction(fetchResults, 300);
 
 ## 🔗 Related Packages
 
-<div title="React Hooks: nhb-hooks" style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
   <a target="_blank" href="https://www.npmjs.com/package/nhb-hooks">
     <img src="https://img.shields.io/badge/React_Hooks-nhb--hooks-blue" alt="nhb-hooks" />
   </a>
 </div>
 
-<div title="IndexedDB ORM: locality-idb" style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
   <a target="_blank" href="https://www.npmjs.com/package/locality-idb">
     <img src="https://img.shields.io/badge/IndexedDB_ORM-locality--idb-darkviolet" alt="locality-idb" />
   </a>
 </div>
 
-<div title="Development Scripts: nhb-scripts" style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
   <a target="_blank" href="https://www.npmjs.com/package/nhb-scripts">
     <img src="https://img.shields.io/badge/Development_Scripts-nhb--scripts-red" alt="nhb-scripts" />
   </a>
 </div>
 
-<div title="Express Server Scaffolder: nhb-express" style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
   <a target="_blank" href="https://www.npmjs.com/package/nhb-express">
     <img src="https://img.shields.io/badge/Express_Server_Scaffolder-nhb--express-orange" alt="nhb-express" />
   </a>
 </div>
 
-<div title="Anagram Generator: nhb-anagram-generator" style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
   <a target="_blank" href="https://www.npmjs.com/package/nhb-anagram-generator">
     <img src="https://img.shields.io/badge/Anagram_Generator-nhb--anagram--generator-teal" alt="nhb-anagram-generator" />
   </a>

package/dist/cjs/date/Chronos.js

@@ -2,7 +2,6 @@
 var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.INTERNALS = exports.Chronus = exports.chronusts = exports.chronusjs = exports.chronus = exports.chronosts = exports.chronosjs = exports.chronos = exports.Chronos = void 0;
-const non_primitives_1 = require("../guards/non-primitives");
 const primitives_1 = require("../guards/primitives");
 const constants_1 = require("./constants");
 const guards_1 = require("./guards");
@@ -592,44 +591,6 @@ class Chronos {
     monthName(index) {
         return constants_1.MONTHS[index ?? this.month];
     }
-    getDatesInRange(options) {
-        let startDate = this.clone(), endDate = this.addWeeks(4);
-        const { format = 'local', onlyDays, skipDays, roundDate = false } = options ?? {};
-        if (options) {
-            if ('from' in options || 'to' in options) {
-                if (options?.from)
-                    startDate = _a.#cast(options.from);
-                if (options?.to)
-                    endDate = _a.#cast(options.to);
-            }
-            else if ('span' in options || 'unit' in options) {
-                const { span = 4, unit = 'week' } = options;
-                endDate = startDate.add(span, unit);
-            }
-        }
-        if (roundDate) {
-            startDate = startDate.startOf('day');
-            endDate = endDate.startOf('day');
-        }
-        const skipSet = new Set(((0, non_primitives_1.isValidArray)(onlyDays) ? onlyDays
-            : (0, non_primitives_1.isValidArray)(skipDays) ? skipDays
-                : []).map((day) => ((0, primitives_1.isNumber)(day) ? day : constants_1.DAYS.indexOf(day))));
-        const dates = [];
-        const startTime = startDate.#timestamp;
-        const endTime = endDate.#timestamp;
-        const step = (startTime <= endTime ? 1 : -1) * constants_1.MS_PER_DAY;
-        const totalDays = Math.floor(Math.abs(endTime - startTime) / constants_1.MS_PER_DAY);
-        for (let i = 0; i <= totalDays; i++) {
-            const ts = startTime + i * step;
-            const wDay = new Date(ts).getDay();
-            const include = (0, non_primitives_1.isValidArray)(onlyDays) ? skipSet.has(wDay) : !skipSet.has(wDay);
-            if (include) {
-                const chr = new _a(ts).#withOrigin('clone', startDate.#offset, startDate.timeZoneName, startDate.timeZoneId, startDate.$tzTracker);
-                dates.push(format === 'local' ? chr.toLocalISOString() : chr.toISOString());
-            }
-        }
-        return dates;
-    }
     static parse(dateStr, format) {
         const tokenPatterns = {
             YYYY: '(?<YYYY>\\d{4})',
@@ -814,9 +775,9 @@ class Chronos {
         }
         const { native, origin, utcOffset, timeZoneName, timeZoneId, $tzTracker } = value;
         const offsetMins = (0, utils_1.extractMinutesFromUTC)(utcOffset);
-        const instance = new _a(native);
-        const diffMins = instance.getTimeZoneOffsetMinutes() - offsetMins;
-        const target = instance.utcOffset === utcOffset ? instance : instance.add(-diffMins, 'minute');
+        const chr = new _a(native);
+        const diffMins = chr.getTimeZoneOffsetMinutes() - offsetMins;
+        const target = chr.utcOffset === utcOffset ? chr : chr.add(-diffMins, 'minute');
         return target.#withOrigin(origin, utcOffset, timeZoneName, timeZoneId, $tzTracker);
     }
     static use(plugin) {

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

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dateRangePlugin = void 0;
+const non_primitives_1 = require("../../guards/non-primitives");
+const primitives_1 = require("../../guards/primitives");
+const Chronos_1 = require("../Chronos");
+const constants_1 = require("../constants");
+const dateRangePlugin = ($Chronos) => {
+    const { internalDate: $Date, cast, withOrigin, offset } = $Chronos[Chronos_1.INTERNALS];
+    $Chronos.prototype.getDatesInRange = function (options) {
+        let startDate = this.clone(), endDate = this.addWeeks(4);
+        const { format = 'local', onlyDays, skipDays, roundDate = false } = options ?? {};
+        if (options) {
+            if ('from' in options || 'to' in options) {
+                if (options?.from)
+                    startDate = cast(options.from);
+                if (options?.to)
+                    endDate = cast(options.to);
+            }
+            else if ('span' in options || 'unit' in options) {
+                const { span = 4, unit = 'week' } = options;
+                endDate = startDate.add(span, unit);
+            }
+        }
+        if (roundDate) {
+            startDate = startDate.startOf('day');
+            endDate = endDate.startOf('day');
+        }
+        const skippedDays = (0, non_primitives_1.isValidArray)(onlyDays) ? onlyDays
+            : (0, non_primitives_1.isValidArray)(skipDays) ? skipDays
+                : [];
+        const skipSet = new Set(skippedDays.map((day) => ((0, primitives_1.isNumber)(day) ? day : constants_1.DAYS.indexOf(day))));
+        const dates = [];
+        const startTime = $Date(startDate).getTime();
+        const endTime = $Date(endDate).getTime();
+        const step = (startTime <= endTime ? 1 : -1) * constants_1.MS_PER_DAY;
+        const totalDays = Math.floor(Math.abs(endTime - startTime) / constants_1.MS_PER_DAY);
+        for (let i = 0; i <= totalDays; i++) {
+            const ts = startTime + i * step;
+            const wDay = new Date(ts).getDay();
+            const include = (0, non_primitives_1.isValidArray)(onlyDays) ? skipSet.has(wDay) : !skipSet.has(wDay);
+            if (include) {
+                const chr = withOrigin(new $Chronos(ts), 'clone', offset(this), startDate.timeZoneName, startDate.timeZoneId, startDate.$tzTracker);
+                dates.push(format === 'local' ? chr.toLocalISOString() : chr.toISOString());
+            }
+        }
+        return dates;
+    };
+};
+exports.dateRangePlugin = dateRangePlugin;

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 { $NativeTzNameOrId, $TimeZoneIdentifier, $UTCOffset, ChronosInput, ChronosInternals, ChronosMethods, ChronosObject, ChronosPlugin, ChronosProperties, ChronosWithOptions, DateRangeOptions, DateTimeFormatOptions, FormatOptions, LocalesArguments, Milliseconds, MonthName, Quarter, RangeWithDates, RelativeDateRange, RelativeRangeOptions, StrictFormat, TimeOnlyFormat, TimeUnit, TimeUnitValue, TimeZone, TimeZoneId, TimeZoneIdNative, TimeZoneName, UTCOffset, WeekDay } from './types';
+import type { $NativeTzNameOrId, $TimeZoneIdentifier, $UTCOffset, ChronosInput, ChronosInternals, ChronosMethods, ChronosObject, ChronosPlugin, ChronosProperties, ChronosWithOptions, DateRangeOptions, DateTimeFormatOptions, FormatOptions, ISOTimeString, LocalesArguments, Milliseconds, MonthName, Quarter, RelativeRangeOptions, StrictFormat, TimeOnlyFormat, TimeUnit, TimeUnitValue, TimeZone, TimeZoneId, TimeZoneIdNative, TimeZoneName, UTCOffset, WeekDay } from './types';
 /**
  * @class Creates a new immutable `Chronos` instance.
  *      - **Note**: *If a date is provided **without a time component**, the instance will default to `00:00:00.000` UTC
@@ -208,9 +208,9 @@ export declare class Chronos {
     /** @instance Returns a string representation of a date. */
     toString(): string;
     /** @instance Returns ISO time string in appropriate time zone with offset. */
-    toLocalISOString(): string;
+    toLocalISOString(): ISOTimeString;
     /** @instance Returns a date as a string value in ISO format (UTC). */
-    toISOString(): string;
+    toISOString(): ISOTimeString;
     /**
      * @instance Wrapper over native {@link Date.toLocaleString} with improved type system.
      * @description Converts a date and time to a string by using the current or specified locale.
@@ -548,66 +548,6 @@ export declare class Chronos {
      * @returns Name of the month, e.g., `'January'`, `'February'` etc.
      */
     monthName(index?: Enumerate<12>): MonthName;
-    /**
-     * @instance Returns an array of ISO date strings within a specific date range.
-     *
-     * - If the input is a fixed range (`from` and `to`), it includes all dates between them.
-     * - If the input is a relative range (`span` and `unit`), it starts from current date and goes forward.
-     * - If `skipDays` are provided, matching weekdays are excluded from the result.
-     *
-     * @param options - Configuration for the date range. Accepts a fixed (`RangeWithDates`) format.
-     * @returns Array of ISO date strings in either local or UTC format, excluding any skipped weekdays if specified.
-     *
-     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/calculation#getdatesinrange docs} for details.
-     *
-     * @remarks
-     * - When using `Chronos` instances for `from` and/or `to`, ensure both are created in the **same time zone** to avoid mismatched boundaries.
-     * - Mixing zones may shift the interpreted start or end by several hours, which can cause the range to include or exclude incorrect weekdays.
-     *
-     * @example
-     * // Using a fixed date range:
-     * new Chronos().getDatesInRange({ from: '2025-01-01', to: '2025-01-03' });
-     * // → ['2025-01-01T00:00:00+06:00', '2025-01-02T00:00:00+06:00', '2025-01-03T00:00:00+06:00']
-     *
-     * @example
-     * // Using a relative date range with skipDays:
-     * new Chronos().getDatesInRange({ span: 7, unit: 'day', skipDays: ['Saturday', 'Sunday'] });
-     * // → Array of 7 dates excluding weekends
-     *
-     * @example
-     * // UTC format:
-     * new Chronos().getDatesInRange({ span: 2, unit: 'day', format: 'utc' });
-     * // → ['2025-06-16T00:00:00.000Z', '2025-06-17T00:00:00.000Z']
-     */
-    getDatesInRange(options?: RangeWithDates): string[];
-    /**
-     * @instance Returns an array of ISO date strings within a specific date range.
-     *
-     * - If the input is a fixed range (`from` and `to`), it includes all dates between them.
-     * - If the input is a relative range (`span` and `unit`), it starts from current date and goes forward.
-     * - If `skipDays` are provided, matching weekdays are excluded from the result.
-     *
-     * @param options - Configuration for the date range. Accepts a relative (`RelativeDateRange`) format.
-     * @returns Array of ISO date strings in either local or UTC format, excluding any skipped weekdays if specified.
-     *
-     * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/calculation#getdatesinrange docs} for details.
-     *
-     * @example
-     * // Using a relative date range with skipDays:
-     * new Chronos().getDatesInRange({ span: 7, unit: 'day', skipDays: ['Saturday', 'Sunday'] });
-     * // → Array of 7 dates excluding weekends
-     *
-     * @example
-     * // UTC format:
-     * new Chronos().getDatesInRange({ span: 2, unit: 'day', format: 'utc' });
-     * // → ['2025-06-16T00:00:00.000Z', '2025-06-17T00:00:00.000Z']
-     *
-     * @example
-     * // Using a fixed date range:
-     * new Chronos().getDatesInRange({ from: '2025-01-01', to: '2025-01-03' });
-     * // → ['2025-01-01T00:00:00+06:00', '2025-01-02T00:00:00+06:00', '2025-01-03T00:00:00+06:00']
-     */
-    getDatesInRange(options?: RelativeDateRange): string[];
     /**
      * @static Parses a date string with a given format (limited support only).
      *

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

@@ -17,7 +17,7 @@ export declare const SECOND_FORMATS: readonly ["ss", "s"];
 export declare const MILLISECOND_FORMATS: readonly ["ms", "mss"];
 export declare const TIME_FORMATS: readonly ["a", "A"];
 export declare const EXTRA_FORMATS: readonly ["Z", "ZZ", "S", "SS"];
-export declare const SORTED_TIME_FORMATS: readonly ("MM" | "SS" | "ms" | "DD" | "D" | "Do" | "M" | "mmm" | "mmmm" | "d" | "dd" | "ddd" | "YYYY" | "YY" | "yyyy" | "yy" | "H" | "HH" | "hh" | "h" | "mm" | "m" | "a" | "A" | "ss" | "s" | "mss" | "S" | "Z" | "ZZ")[];
+export declare const SORTED_TIME_FORMATS: readonly ("MM" | "SS" | "ms" | "Z" | "DD" | "D" | "Do" | "M" | "mmm" | "mmmm" | "d" | "dd" | "ddd" | "YYYY" | "YY" | "yyyy" | "yy" | "H" | "HH" | "hh" | "h" | "mm" | "m" | "a" | "A" | "ss" | "s" | "mss" | "S" | "ZZ")[];
 /** Ranges for day parts. */
 export declare const DATE_PART_RANGES: Readonly<Record<DayPart, [ClockHour, ClockHour]>>;
 /** Western Zodiac Signs */

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

@@ -0,0 +1,67 @@
+import type { $Chronos, ISOTimeString, RangeWithDates, RelativeDateRange } from '../types';
+declare module '../Chronos' {
+    interface Chronos {
+        /**
+         * @instance Returns an array of ISO date-time strings within a specific date range.
+         *
+         * - If the input is a fixed range (`from` and `to`), it includes all dates between them.
+         * - If the input is a relative range (`span` and `unit`), it starts from current date and goes forward.
+         * - If `skipDays` are provided, matching weekdays are excluded from the result.
+         *
+         * @param options - Configuration for the date range. Accepts a fixed (`RangeWithDates`) format.
+         * @returns Array of ISO date-time strings in either local or UTC format, excluding any skipped weekdays if specified.
+         *
+         * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/calculation#getdatesinrange docs} for details.
+         *
+         * @remarks
+         * - When using `Chronos` instances for `from` and/or `to`, ensure both are created in the **same time zone** to avoid mismatched boundaries.
+         * - Mixing zones may shift the interpreted start or end by several hours, which can cause the range to include or exclude incorrect weekdays.
+         *
+         * @example
+         * // Using a fixed date range:
+         * new Chronos().getDatesInRange({ from: '2025-01-01', to: '2025-01-03' });
+         * // → ['2025-01-01T00:00:00+06:00', '2025-01-02T00:00:00+06:00', '2025-01-03T00:00:00+06:00']
+         *
+         * @example
+         * // Using a relative date range with skipDays:
+         * new Chronos().getDatesInRange({ span: 7, unit: 'day', skipDays: ['Saturday', 'Sunday'] });
+         * // → Array of 7 dates excluding weekends
+         *
+         * @example
+         * // UTC format:
+         * new Chronos().getDatesInRange({ span: 2, unit: 'day', format: 'utc' });
+         * // → ['2025-06-16T00:00:00.000Z', '2025-06-17T00:00:00.000Z']
+         */
+        getDatesInRange(options?: RangeWithDates): ISOTimeString[];
+        /**
+         * @instance Returns an array of ISO date-time strings within a specific date range.
+         *
+         * - If the input is a fixed range (`from` and `to`), it includes all dates between them.
+         * - If the input is a relative range (`span` and `unit`), it starts from current date and goes forward.
+         * - If `skipDays` are provided, matching weekdays are excluded from the result.
+         *
+         * @param options - Configuration for the date range. Accepts a relative (`RelativeDateRange`) format.
+         * @returns Array of ISO date-time strings in either local or UTC format, excluding any skipped weekdays if specified.
+         *
+         * - Please refer to {@link https://toolbox.nazmul-nhb.dev/docs/classes/Chronos/calculation#getdatesinrange docs} for details.
+         *
+         * @example
+         * // Using a relative date range with skipDays:
+         * new Chronos().getDatesInRange({ span: 7, unit: 'day', skipDays: ['Saturday', 'Sunday'] });
+         * // → Array of 7 dates excluding weekends
+         *
+         * @example
+         * // UTC format:
+         * new Chronos().getDatesInRange({ span: 2, unit: 'day', format: 'utc' });
+         * // → ['2025-06-16T00:00:00.000Z', '2025-06-17T00:00:00.000Z']
+         *
+         * @example
+         * // Using a fixed date range:
+         * new Chronos().getDatesInRange({ from: '2025-01-01', to: '2025-01-03' });
+         * // → ['2025-01-01T00:00:00+06:00', '2025-01-02T00:00:00+06:00', '2025-01-03T00:00:00+06:00']
+         */
+        getDatesInRange(options?: RelativeDateRange): ISOTimeString[];
+    }
+}
+/** * Plugin to inject `getDatesInRange` related method */
+export declare const dateRangePlugin: ($Chronos: $Chronos) => void;

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

@@ -1,5 +1,5 @@
 import type { $BnOnes, BanglaDigit, Enumerate, LocaleCode, NumberRange } from '../number/types';
-import type { Branded, Maybe } from '../types/index';
+import type { Maybe } from '../types/index';
 import type { LooseLiteral, RangeTuple, Repeat, Split } from '../utils/types';
 import type { Chronos } from './Chronos';
 import type { ChronosStatics } from './chronos-statics';
@@ -295,8 +295,8 @@ export type $UTCOffset = `${PositiveUTCHour | NegativeUTCHour}:${UTCMinute}`;
 export type UTCOffset = `UTC${$UTCOffset}`;
 /** GMT offset in `GMT±HH:mm` or simply `GMT` format */
 export type $GMTOffset = `GMT${$UTCOffset}` | 'GMT';
-/** Timestamp string type in ISO 8601 format */
-export type Timestamp = Branded<string, 'Timestamp'>;
+/** ISO timestamp string type in ISO 8601 format */
+export type ISOTimeString = `${number}-${number}-${number}T${number}:${number}:${number}.${number}${'Z' | $UTCOffset}`;
 /** Valid argument type accepted by `Date` constructor */
 export type DateArgs = string | number | Date;
 /** Type for ISO date format options */

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

@@ -1,5 +1,5 @@
 import type { Numeric } from '../types/index';
-import type { $TimeZoneIdentifier, ClockTime, DateArgs, DateFormatOptions, HourMinutes, ISODateFormat, TimeOnlyFormat, TimeZoneDetails, TimeZoneIdNative, Timestamp, TimestampOptions, UTCOffset } from './types';
+import type { $TimeZoneIdentifier, ClockTime, DateArgs, DateFormatOptions, HourMinutes, ISODateFormat, ISOTimeString, TimeOnlyFormat, TimestampOptions, TimeZoneDetails, TimeZoneIdNative, UTCOffset } from './types';
 /**
  * * Extracts the hour and minute from a time string in `HH:MM` or `-HH:MM` format.
  *
@@ -117,18 +117,11 @@ export declare function formatDate(options?: DateFormatOptions): string;
  */
 export declare function formatTimePart(time: string, format?: TimeOnlyFormat): string;
 /**
- * * Get timestamp in ISO 8601 format.
- *
- * @param value - Date value to convert to timestamp. Supported formats include:
- * - `Date` object → e.g., `new Date()`
- * - Date string → e.g., `'2025-04-06'`, `'2025-04-06 16:11:55'`, `'April 6, 2025 16:11:55'` etc.
- * - Timestamp number → e.g., `1712748715000`
- *
- * @remarks If the provided {@link value} is invalid, the current date and time will be used.
+ * * Get timestamp in ISO 8601 format for the current date and time.
  *
  * @returns Timestamp string in ISO 8601 format.
  */
-export declare function getTimestamp(): Timestamp;
+export declare function getTimestamp(): ISOTimeString;
 /**
  * * Get timestamp in ISO 8601 format.
  *
@@ -144,7 +137,7 @@ export declare function getTimestamp(): Timestamp;
  *
  * @returns Timestamp string in ISO 8601 format.
  */
-export declare function getTimestamp(value: DateArgs, format?: ISODateFormat): Timestamp;
+export declare function getTimestamp(value: DateArgs, format?: ISODateFormat): ISOTimeString;
 /**
  * * Get timestamp in ISO 8601 format.
  *
@@ -152,8 +145,8 @@ export declare function getTimestamp(value: DateArgs, format?: ISODateFormat): T
  *
  * @remarks
  * - If the provided {@link TimestampOptions.value value} is invalid, the current date and time will be used.
- * - Use `format: 'local'` to include the current system timezone offset.
+ * - Use {@link TimestampOptions.format format}: `'local'` to include the current system time & timezone offset.
  *
  * @returns Timestamp string in ISO 8601 format.
  */
-export declare function getTimestamp(options?: TimestampOptions): Timestamp;
+export declare function getTimestamp(options: TimestampOptions): ISOTimeString;

package/dist/esm/date/Chronos.js

@@ -1,5 +1,4 @@
 var _a;
-import { isValidArray } from '../guards/non-primitives.js';
 import { isNumber, isString } from '../guards/primitives.js';
 import { DAYS, INTERNALS, MONTHS, MS_PER_DAY } from './constants.js';
 import { isLeapYear } from './guards.js';
@@ -589,44 +588,6 @@ export class Chronos {
     monthName(index) {
         return MONTHS[index ?? this.month];
     }
-    getDatesInRange(options) {
-        let startDate = this.clone(), endDate = this.addWeeks(4);
-        const { format = 'local', onlyDays, skipDays, roundDate = false } = options ?? {};
-        if (options) {
-            if ('from' in options || 'to' in options) {
-                if (options?.from)
-                    startDate = _a.#cast(options.from);
-                if (options?.to)
-                    endDate = _a.#cast(options.to);
-            }
-            else if ('span' in options || 'unit' in options) {
-                const { span = 4, unit = 'week' } = options;
-                endDate = startDate.add(span, unit);
-            }
-        }
-        if (roundDate) {
-            startDate = startDate.startOf('day');
-            endDate = endDate.startOf('day');
-        }
-        const skipSet = new Set((isValidArray(onlyDays) ? onlyDays
-            : isValidArray(skipDays) ? skipDays
-                : []).map((day) => (isNumber(day) ? day : DAYS.indexOf(day))));
-        const dates = [];
-        const startTime = startDate.#timestamp;
-        const endTime = endDate.#timestamp;
-        const step = (startTime <= endTime ? 1 : -1) * MS_PER_DAY;
-        const totalDays = Math.floor(Math.abs(endTime - startTime) / MS_PER_DAY);
-        for (let i = 0; i <= totalDays; i++) {
-            const ts = startTime + i * step;
-            const wDay = new Date(ts).getDay();
-            const include = isValidArray(onlyDays) ? skipSet.has(wDay) : !skipSet.has(wDay);
-            if (include) {
-                const chr = new _a(ts).#withOrigin('clone', startDate.#offset, startDate.timeZoneName, startDate.timeZoneId, startDate.$tzTracker);
-                dates.push(format === 'local' ? chr.toLocalISOString() : chr.toISOString());
-            }
-        }
-        return dates;
-    }
     static parse(dateStr, format) {
         const tokenPatterns = {
             YYYY: '(?<YYYY>\\d{4})',
@@ -811,9 +772,9 @@ export class Chronos {
         }
         const { native, origin, utcOffset, timeZoneName, timeZoneId, $tzTracker } = value;
         const offsetMins = extractMinutesFromUTC(utcOffset);
-        const instance = new _a(native);
-        const diffMins = instance.getTimeZoneOffsetMinutes() - offsetMins;
-        const target = instance.utcOffset === utcOffset ? instance : instance.add(-diffMins, 'minute');
+        const chr = new _a(native);
+        const diffMins = chr.getTimeZoneOffsetMinutes() - offsetMins;
+        const target = chr.utcOffset === utcOffset ? chr : chr.add(-diffMins, 'minute');
         return target.#withOrigin(origin, utcOffset, timeZoneName, timeZoneId, $tzTracker);
     }
     static use(plugin) {

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

@@ -0,0 +1,46 @@
+import { isValidArray } from '../../guards/non-primitives.js';
+import { isNumber } from '../../guards/primitives.js';
+import { INTERNALS } from '../Chronos.js';
+import { DAYS, MS_PER_DAY } from '../constants.js';
+export const dateRangePlugin = ($Chronos) => {
+    const { internalDate: $Date, cast, withOrigin, offset } = $Chronos[INTERNALS];
+    $Chronos.prototype.getDatesInRange = function (options) {
+        let startDate = this.clone(), endDate = this.addWeeks(4);
+        const { format = 'local', onlyDays, skipDays, roundDate = false } = options ?? {};
+        if (options) {
+            if ('from' in options || 'to' in options) {
+                if (options?.from)
+                    startDate = cast(options.from);
+                if (options?.to)
+                    endDate = cast(options.to);
+            }
+            else if ('span' in options || 'unit' in options) {
+                const { span = 4, unit = 'week' } = options;
+                endDate = startDate.add(span, unit);
+            }
+        }
+        if (roundDate) {
+            startDate = startDate.startOf('day');
+            endDate = endDate.startOf('day');
+        }
+        const skippedDays = isValidArray(onlyDays) ? onlyDays
+            : isValidArray(skipDays) ? skipDays
+                : [];
+        const skipSet = new Set(skippedDays.map((day) => (isNumber(day) ? day : DAYS.indexOf(day))));
+        const dates = [];
+        const startTime = $Date(startDate).getTime();
+        const endTime = $Date(endDate).getTime();
+        const step = (startTime <= endTime ? 1 : -1) * MS_PER_DAY;
+        const totalDays = Math.floor(Math.abs(endTime - startTime) / MS_PER_DAY);
+        for (let i = 0; i <= totalDays; i++) {
+            const ts = startTime + i * step;
+            const wDay = new Date(ts).getDay();
+            const include = isValidArray(onlyDays) ? skipSet.has(wDay) : !skipSet.has(wDay);
+            if (include) {
+                const chr = withOrigin(new $Chronos(ts), 'clone', offset(this), startDate.timeZoneName, startDate.timeZoneId, startDate.$tzTracker);
+                dates.push(format === 'local' ? chr.toLocalISOString() : chr.toISOString());
+            }
+        }
+        return dates;
+    };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.28.71",
+  "version": "4.28.80",
   "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",
@@ -253,6 +253,11 @@
       "import": "./dist/esm/date/plugins/businessPlugin.js",
       "require": "./dist/cjs/date/plugins/businessPlugin.js"
     },
+    "./plugins/dateRangePlugin": {
+      "types": "./dist/dts/date/plugins/dateRangePlugin.d.ts",
+      "import": "./dist/esm/date/plugins/dateRangePlugin.js",
+      "require": "./dist/cjs/date/plugins/dateRangePlugin.js"
+    },
     "./plugins/dayPartPlugin": {
       "types": "./dist/dts/date/plugins/dayPartPlugin.d.ts",
       "import": "./dist/esm/date/plugins/dayPartPlugin.js",
@@ -387,6 +392,9 @@
       "plugins/businessPlugin": [
         "dist/dts/date/plugins/businessPlugin.d.ts"
       ],
+      "plugins/dateRangePlugin": [
+        "dist/dts/date/plugins/dateRangePlugin.d.ts"
+      ],
       "plugins/dayPartPlugin": [
         "dist/dts/date/plugins/dayPartPlugin.d.ts"
       ],