nhb-toolbox 3.9.70 → 3.9.73

package/dist/date/Chronos.d.ts

@@ -242,20 +242,23 @@ export declare class Chronos {
      * @instance Checks if another date is the same as this one in a specific unit.
      * @param other The other date to compare.
      * @param unit The unit to compare.
+     * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`.
      */
-    isSame(other: ChronosInput, unit: TimeUnit): boolean;
+    isSame(other: ChronosInput, unit: TimeUnit, weekStartsOn?: number): boolean;
     /**
      * @instance Checks if this date is before another date in a specific unit.
      * @param other The other date to compare.
+     * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`.
      * @param unit The unit to compare.
      */
-    isBefore(other: ChronosInput, unit: TimeUnit): boolean;
+    isBefore(other: ChronosInput, unit: TimeUnit, weekStartsOn?: number): boolean;
     /**
      * @instance Checks if this date is after another date in a specific unit.
      * @param other The other date to compare.
      * @param unit The unit to compare.
+     * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`.
      */
-    isAfter(other: ChronosInput, unit: TimeUnit): boolean;
+    isAfter(other: ChronosInput, unit: TimeUnit, weekStartsOn?: number): boolean;
     /**
      * @instance Checks if the current date is between the given start and end dates.
      *
@@ -406,13 +409,15 @@ export declare class Chronos {
     /**
      * @instance Returns a new Chronos instance at the start of a given unit.
      * @param unit The unit to reset (e.g., year, month, day).
+     * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`.
      */
-    startOf(unit: TimeUnit): Chronos;
+    startOf(unit: TimeUnit, weekStartsOn?: number): Chronos;
     /**
      * @instance Returns a new Chronos instance at the end of a given unit.
      * @param unit The unit to adjust (e.g., year, month, day).
+     * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`.
      */
-    endOf(unit: TimeUnit): Chronos;
+    endOf(unit: TimeUnit, weekStartsOn?: number): Chronos;
     /**
      * @instance Returns a new Chronos instance with the specified unit added.
      * @param amount The amount to add (can be negative).
@@ -458,12 +463,30 @@ export declare class Chronos {
      */
     setWeek(week: number): Chronos;
     /**
-     * @instance Calculates the ISO week number of the year.
-     * @returns Week number (1-53).
+     * @instance Calculates the ISO 8601 week number of the year.
+     *
+     * ISO weeks start on Monday, and the first week of the year is the one containing January 4th.
+     *
+     * @returns Week number (1–53).
      */
     getWeek(): number;
-    /** @instance Returns ISO week year */
-    getWeekYear(): number;
+    /**
+     * @instance Calculates the week number of the year based on custom week start.
+     * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`.
+     * @returns Week number (1-53).
+     */
+    getWeekOfYear(weekStartsOn?: number): number;
+    /**
+     * @instance Returns the ISO week-numbering year for the current date.
+     *
+     * The ISO week-numbering year may differ from the calendar year.
+     * For example, January 1st may fall in the last ISO week of the previous year.
+     *
+     * @param weekStartsOn Optional: Defines the start day of the week (0 = Sunday, 1 = Monday).
+     *                     Defaults to 0 (Sunday). Use 1 for strict ISO 8601.
+     * @returns The ISO week-numbering year.
+     */
+    getWeekYear(weekStartsOn?: number): number;
     /** @instance Returns day of year (1 - 366) */
     getDayOfYear(): number;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"Chronos.d.ts","sourceRoot":"","sources":["../../src/date/Chronos.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Chronos.d.ts","sourceRoot":"","sources":["../../src/date/Chronos.ts"],"names":[],"mappings":"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"}

package/dist/date/Chronos.js

@@ -515,31 +515,34 @@ export class Chronos {
      * @instance Checks if another date is the same as this one in a specific unit.
      * @param other The other date to compare.
      * @param unit The unit to compare.
+     * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`.
      */
-    isSame(other, unit) {
+    isSame(other, unit, weekStartsOn = 0) {
         const time = new Chronos(other);
-        return (this.startOf(unit).toDate().getTime() ===
-            time.startOf(unit).toDate().getTime());
+        return (this.startOf(unit, weekStartsOn).toDate().getTime() ===
+            time.startOf(unit, weekStartsOn).toDate().getTime());
     }
     /**
      * @instance Checks if this date is before another date in a specific unit.
      * @param other The other date to compare.
+     * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`.
      * @param unit The unit to compare.
      */
-    isBefore(other, unit) {
+    isBefore(other, unit, weekStartsOn = 0) {
         const time = new Chronos(other);
-        return (this.startOf(unit).toDate().getTime() <
-            time.startOf(unit).toDate().getTime());
+        return (this.startOf(unit, weekStartsOn).toDate().getTime() <
+            time.startOf(unit, weekStartsOn).toDate().getTime());
     }
     /**
      * @instance Checks if this date is after another date in a specific unit.
      * @param other The other date to compare.
      * @param unit The unit to compare.
+     * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`.
      */
-    isAfter(other, unit) {
+    isAfter(other, unit, weekStartsOn = 0) {
         const time = new Chronos(other);
-        return (this.startOf(unit).toDate().getTime() >
-            time.startOf(unit).toDate().getTime());
+        return (this.startOf(unit, weekStartsOn).toDate().getTime() >
+            time.startOf(unit, weekStartsOn).toDate().getTime());
     }
     /**
      * @instance Checks if the current date is between the given start and end dates.
@@ -883,8 +886,9 @@ export class Chronos {
     /**
      * @instance Returns a new Chronos instance at the start of a given unit.
      * @param unit The unit to reset (e.g., year, month, day).
+     * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`.
      */
-    startOf(unit) {
+    startOf(unit, weekStartsOn = 0) {
         const d = new Date(this.#date);
         switch (unit) {
             case 'year':
@@ -896,8 +900,8 @@ export class Chronos {
                 d.setHours(0, 0, 0, 0);
                 break;
             case 'week': {
-                const day = d.getDay(); // 0 (Sun) - 6 (Sat)
-                const diff = (day + 6) % 7; // convert Sunday=0 to 6, Monday=1 to 0, etc.
+                const day = d.getDay();
+                const diff = (day - weekStartsOn + 7) % 7;
                 d.setDate(d.getDate() - diff);
                 d.setHours(0, 0, 0, 0);
                 break;
@@ -922,9 +926,10 @@ export class Chronos {
     /**
      * @instance Returns a new Chronos instance at the end of a given unit.
      * @param unit The unit to adjust (e.g., year, month, day).
+     * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`.
      */
-    endOf(unit) {
-        return this.startOf(unit)
+    endOf(unit, weekStartsOn = 0) {
+        return this.startOf(unit, weekStartsOn)
             .add(1, unit)
             .add(-1, 'millisecond')
             .#withOrigin('endOf');
@@ -1133,21 +1138,42 @@ export class Chronos {
         return new Chronos(d).#withOrigin('setWeek');
     }
     /**
-     * @instance Calculates the ISO week number of the year.
-     * @returns Week number (1-53).
+     * @instance Calculates the ISO 8601 week number of the year.
+     *
+     * ISO weeks start on Monday, and the first week of the year is the one containing January 4th.
+     *
+     * @returns Week number (1–53).
      */
     getWeek() {
-        // ISO week starts on Monday
-        const target = this.startOf('week').add(3, 'day');
-        const firstThursday = new Chronos(new Date(target.year, 0, 4))
-            .startOf('week')
-            .add(3, 'day');
-        const week = target.diff(firstThursday, 'week');
-        return week;
-    }
-    /** @instance Returns ISO week year */
-    getWeekYear() {
-        const d = this.startOf('week').add(3, 'day'); // Thursday of current ISO week
+        const target = this.startOf('week', 1).add(3, 'day'); // Thursday of current ISO week
+        const firstThursday = new Chronos(target.year, 1, 4) // January 4
+            .startOf('week', 1)
+            .add(3, 'day'); // Thursday of first ISO week
+        return target.diff(firstThursday, 'week') + 1;
+    }
+    /**
+     * @instance Calculates the week number of the year based on custom week start.
+     * @param weekStartsOn Optional: Day the week starts on (0 = Sunday, 1 = Monday). Default is `0`.
+     * @returns Week number (1-53).
+     */
+    getWeekOfYear(weekStartsOn = 0) {
+        const startOfYear = new Chronos(this.year, 1, 1);
+        const startOfFirstWeek = startOfYear.startOf('week', weekStartsOn);
+        const week = this.startOf('week', weekStartsOn).diff(startOfFirstWeek, 'week');
+        return week + 1;
+    }
+    /**
+     * @instance Returns the ISO week-numbering year for the current date.
+     *
+     * The ISO week-numbering year may differ from the calendar year.
+     * For example, January 1st may fall in the last ISO week of the previous year.
+     *
+     * @param weekStartsOn Optional: Defines the start day of the week (0 = Sunday, 1 = Monday).
+     *                     Defaults to 0 (Sunday). Use 1 for strict ISO 8601.
+     * @returns The ISO week-numbering year.
+     */
+    getWeekYear(weekStartsOn = 0) {
+        const d = this.startOf('week', weekStartsOn).add(3, 'day'); // Thursday of current ISO week
         return d.year;
     }
     /** @instance Returns day of year (1 - 366) */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "3.9.70",
+  "version": "3.9.73",
   "description": "A versatile collection of smart, efficient, and reusable utility functions for everyday development needs.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -15,6 +15,7 @@
     "type": "git",
     "url": "git+https://github.com/nazmul-nhb/nhb-toolbox.git"
   },
+  "homepage": "https://nhb-toolbox.vercel.app",
   "keywords": [
     "toolbox",
     "utility",
@@ -60,6 +61,7 @@
     "lint": "node scripts/lint.mjs",
     "fix": "node scripts/fix.mjs",
     "commit": "node scripts/commit.mjs",
-    "check": "node scripts/jsDoc.mjs"
+    "jsDoc": "node scripts/jsDoc.mjs",
+    "count": "node scripts/exports.mjs"
   }
 }