@bbn/bbn 1.0.463 → 1.0.464

package/dist/date.d.ts

@@ -45,6 +45,16 @@ declare class bbnDateTool {
     calendar(format: string): string;
     getWeekday(n: 0 | 1 | 2 | 3 | 4 | 5 | 6, mode?: string, locale?: string): any;
     getWeekdayIndex(name: string, locale?: string): number;
+    /**
+     * Returns a NEW date that is the next (or previous if past=true)
+     * occurrence of the given weekday, starting from this.#value.
+     *
+     * @param {number|string} weekday - Weekday index (0=Sunday…6=Saturday)
+     *                                 or a localized weekday name.
+     * @param {boolean} past - If true → return previous occurrence instead of next.
+     * @param {string} [locale] - Optional locale for weekday names.
+     */
+    setWeekday(weekday: any, past: boolean, locale: any): bbnDateTool;
     copy(): Date;
     /**
      * Returns a NEW bbnDateTool at the start of the given unit.

package/dist/date.js

@@ -553,6 +553,54 @@ class bbnDateTool {
         }
         throw new Error(`Unknown weekday name '${name}' for locale '${loc}'`);
     }
+    /**
+     * Returns a NEW date that is the next (or previous if past=true)
+     * occurrence of the given weekday, starting from this.#value.
+     *
+     * @param {number|string} weekday - Weekday index (0=Sunday…6=Saturday)
+     *                                 or a localized weekday name.
+     * @param {boolean} past - If true → return previous occurrence instead of next.
+     * @param {string} [locale] - Optional locale for weekday names.
+     */
+    setWeekday(weekday, past = false, locale) {
+        let targetDay;
+        if (typeof weekday === "string") {
+            // Use your previously defined reverse method:
+            weekday = this.getWeekdayIndex(weekday, locale);
+        }
+        // --- Normalize weekday ---
+        if (typeof weekday === "number") {
+            if (weekday < 0 || weekday > 6) {
+                throw new RangeError("weekday number must be between 0 and 6");
+            }
+            targetDay = weekday;
+        }
+        else {
+            throw new TypeError("weekday must be a number (0–6) or a string");
+        }
+        const currentDay = this.weekday; // JS weekday (0–6)
+        let diff;
+        if (!past) {
+            // ---------- NEXT occurrence ----------
+            diff = (targetDay - currentDay + 7) % 7;
+            if (diff === 0) {
+                diff = 7; // next week if same day
+            }
+        }
+        else {
+            // ---------- PREVIOUS occurrence ----------
+            diff = (currentDay - targetDay + 7) % 7;
+            if (diff === 0) {
+                diff = 7; // previous week if same day
+            }
+            diff = -diff;
+        }
+        const d = this.copy();
+        d.setDate(d.getDate() + diff);
+        // Rebuild object keeping hours/min/sec from original
+        d.setHours(this.hours, this.minutes, this.seconds, 0);
+        return new bbnDateTool(d);
+    }
     copy() {
         return new Date(__classPrivateFieldGet(this, _bbnDateTool_value, "f").getTime());
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bbn/bbn",
-  "version": "1.0.463",
+  "version": "1.0.464",
   "description": "Javascript toolkit",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",