@bbn/bbn 1.0.462 → 1.0.464

package/dist/date.d.ts

@@ -43,7 +43,18 @@ declare class bbnDateTool {
     guessUnit(valueInMs: number): string | null;
     diff(date: any, unit?: string, abs?: boolean): number;
     calendar(format: string): string;
-    getWeekDay(n: 0 | 1 | 2 | 3 | 4 | 5 | 6, mode?: string, locale?: string): any;
+    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

@@ -496,11 +496,11 @@ class bbnDateTool {
         }
         return str;
     }
-    getWeekDay(n, mode = 'long', locale) {
+    getWeekday(n, mode = 'long', locale) {
         if (!mode) {
-            const letter = this.getWeekDay(n, 'narrow', locale);
-            const abbr = this.getWeekDay(n, 'short', locale);
-            const full = this.getWeekDay(n, 'long', locale);
+            const letter = this.getWeekday(n, 'narrow', locale);
+            const abbr = this.getWeekday(n, 'short', locale);
+            const full = this.getWeekday(n, 'long', locale);
             return {
                 letter,
                 abbr,
@@ -531,6 +531,76 @@ class bbnDateTool {
         const base = new Date(2023, 0, 1 + n);
         return base.toLocaleDateString([locale || bbn.env.lang, ...navigator.languages], { weekday: m });
     }
+    getWeekdayIndex(name, locale) {
+        const loc = locale || bbn.env.lang;
+        const input = name.trim().toLowerCase();
+        // Build a localized map only once per locale (optional optimization)
+        const langs = [loc, ...navigator.languages];
+        for (let i = 0; i < langs.length; i++) {
+            if (!langs[i]) {
+                continue;
+            }
+            const formatter = new Intl.DateTimeFormat(langs[i], { weekday: "long" });
+            // Generate localized weekday names for Sun → Sat
+            for (let i = 0; i < 7; i++) {
+                // 2023-01-01 was Sunday
+                const date = new Date(2023, 0, 1 + i);
+                const localized = formatter.format(date).toLowerCase();
+                if (localized === input) {
+                    return i; // JS weekday number
+                }
+            }
+        }
+        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.462",
+  "version": "1.0.464",
   "description": "Javascript toolkit",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",