@clr/angular 18.0.0 → 18.1.0

package/fesm2022/clr-angular-forms-datepicker.mjs

@@ -211,6 +211,27 @@ function datesAreEqual(date1, date2) {
     }
 }
 
+/*
+ * Copyright (c) 2016-2026 Broadcom. All Rights Reserved.
+ * The term "Broadcom" refers to Broadcom Inc. and/or its subsidiaries.
+ * This software is released under MIT license.
+ * The full license information can be found in LICENSE in the root directory of this project.
+ */
+/**
+ * Index of the day of the week, matching JavaScript's Date.getDay() convention.
+ * Used to override the locale-derived first day of the week in the date picker.
+ */
+var ClrWeekday;
+(function (ClrWeekday) {
+    ClrWeekday[ClrWeekday["Sunday"] = 0] = "Sunday";
+    ClrWeekday[ClrWeekday["Monday"] = 1] = "Monday";
+    ClrWeekday[ClrWeekday["Tuesday"] = 2] = "Tuesday";
+    ClrWeekday[ClrWeekday["Wednesday"] = 3] = "Wednesday";
+    ClrWeekday[ClrWeekday["Thursday"] = 4] = "Thursday";
+    ClrWeekday[ClrWeekday["Friday"] = 5] = "Friday";
+    ClrWeekday[ClrWeekday["Saturday"] = 6] = "Saturday";
+})(ClrWeekday || (ClrWeekday = {}));
+
 /*
  * Copyright (c) 2016-2026 Broadcom. All Rights Reserved.
  * The term "Broadcom" refers to Broadcom Inc. and/or its subsidiaries.
@@ -223,7 +244,7 @@ function datesAreEqual(date1, date2) {
 class LocaleHelperService {
     constructor(locale) {
         this.locale = locale;
-        this._firstDayOfWeek = 0;
+        this._firstDayOfWeek = ClrWeekday.Sunday;
         this.initializeLocaleData();
     }
     get firstDayOfWeek() {
@@ -245,12 +266,26 @@ class LocaleHelperService {
     get localeDateFormat() {
         return this._localeDateFormat;
     }
+    /**
+     * Overrides the first day of the week regardless of locale.
+     * Accepts a `ClrWeekday` value (Sunday=0 through Saturday=6), or null to revert to locale default.
+     * Incorrect values will revert to default value (Sunday).
+     */
+    updateFirstDayOfWeek(day) {
+        if (day === null || day < ClrWeekday.Sunday || day > ClrWeekday.Saturday) {
+            this.initializeLocaleFirstDayOfWeek();
+            this.initializeLocaleDays();
+            return;
+        }
+        this._firstDayOfWeek = day;
+        this.initializeLocaleDays();
+    }
     /**
      * Initializes the locale data.
      */
     initializeLocaleData() {
         // Order in which these functions is called is very important.
-        this.initializeFirstDayOfWeek();
+        this.initializeLocaleFirstDayOfWeek();
         this.initializeLocaleDateFormat();
         this.initializeLocaleMonthsAbbreviated();
         this.initializeLocaleMonthsWide();
@@ -265,14 +300,12 @@ class LocaleHelperService {
         const tempArr = [];
         const tempWideArr = getLocaleDayNames(this.locale, FormStyle.Standalone, TranslationWidth.Wide).slice();
         const tempNarrowArr = getLocaleDayNames(this.locale, FormStyle.Standalone, TranslationWidth.Narrow).slice();
-        // Get first day of the week based on the locale
-        const firstDayOfWeek = this.firstDayOfWeek;
         for (let i = 0; i < 7; i++) {
             tempArr.push({ day: tempWideArr[i], narrow: tempNarrowArr[i] });
         }
-        // Rearrange the tempArr to start with the first day of the week based on the locale.
-        if (firstDayOfWeek > 0) {
-            const prevDays = tempArr.splice(0, firstDayOfWeek);
+        // Rearrange the tempArr to start with the first day of the week based on the locale (default or override).
+        if (this.firstDayOfWeek > ClrWeekday.Sunday) {
+            const prevDays = tempArr.splice(0, this.firstDayOfWeek);
             tempArr.push(...prevDays);
         }
         this._localeDays = tempArr;
@@ -294,7 +327,7 @@ class LocaleHelperService {
     /**
      * Initializes the first day of the week based on the locale.
      */
-    initializeFirstDayOfWeek() {
+    initializeLocaleFirstDayOfWeek() {
         this._firstDayOfWeek = getLocaleFirstDayOfWeek(this.locale);
     }
     initializeLocaleDateFormat() {
@@ -2272,7 +2305,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImpor
  * The full license information can be found in LICENSE in the root directory of this project.
  */
 class ClrDateContainer extends ClrAbstractContainer {
-    constructor(renderer, elem, popoverService, dateNavigationService, datepickerEnabledService, dateFormControlService, dateIOService, commonStrings, focusService, viewManagerService, controlClassService, layoutService, ngControlService) {
+    constructor(renderer, elem, popoverService, dateNavigationService, datepickerEnabledService, dateFormControlService, dateIOService, commonStrings, focusService, viewManagerService, controlClassService, layoutService, ngControlService, localeHelperService) {
         super(layoutService, controlClassService, ngControlService);
         this.renderer = renderer;
         this.elem = elem;
@@ -2286,6 +2319,7 @@ class ClrDateContainer extends ClrAbstractContainer {
         this.controlClassService = controlClassService;
         this.layoutService = layoutService;
         this.ngControlService = ngControlService;
+        this.localeHelperService = localeHelperService;
         this.focus = false;
         this.popoverType = ClrPopoverType.DROPDOWN;
         this.subscriptions.push(focusService.focusChange.subscribe(state => {
@@ -2300,6 +2334,14 @@ class ClrDateContainer extends ClrAbstractContainer {
                 tagName === 'clr-date-range-container';
         }
     }
+    /**
+     * Overrides the locale-derived first day of the week for the calendar.
+     * Accepts a `ClrWeekday` value (Sunday=0 through Saturday=6).
+     * When not set, the first day of the week is determined by the Angular locale.
+     */
+    set firstDayOfWeek(value) {
+        this.localeHelperService.updateFirstDayOfWeek(value ?? null);
+    }
     /**
      * For date range picker actions buttons are shown by default
      */
@@ -2426,8 +2468,8 @@ class ClrDateContainer extends ClrAbstractContainer {
             }
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ClrDateContainer, deps: [{ token: i0.Renderer2 }, { token: i0.ElementRef }, { token: i1.ClrPopoverService }, { token: DateNavigationService }, { token: DatepickerEnabledService }, { token: DateFormControlService }, { token: DateIOService }, { token: i4.ClrCommonStringsService }, { token: i7.FormsFocusService }, { token: ViewManagerService }, { token: i7.ControlClassService }, { token: i7.LayoutService, optional: true }, { token: i7.NgControlService }], target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.1.3", type: ClrDateContainer, isStandalone: false, selector: "clr-date-container, clr-date-range-container", inputs: { showActionButtons: "showActionButtons", clrPosition: "clrPosition", rangeOptions: "rangeOptions", min: "min", max: "max" }, host: { properties: { "class.clr-date-container": "true", "class.clr-form-control-disabled": "isInputDateDisabled", "class.clr-form-control": "true", "class.clr-row": "addGrid()" } }, providers: [
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ClrDateContainer, deps: [{ token: i0.Renderer2 }, { token: i0.ElementRef }, { token: i1.ClrPopoverService }, { token: DateNavigationService }, { token: DatepickerEnabledService }, { token: DateFormControlService }, { token: DateIOService }, { token: i4.ClrCommonStringsService }, { token: i7.FormsFocusService }, { token: ViewManagerService }, { token: i7.ControlClassService }, { token: i7.LayoutService, optional: true }, { token: i7.NgControlService }, { token: LocaleHelperService }], target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.1.3", type: ClrDateContainer, isStandalone: false, selector: "clr-date-container, clr-date-range-container", inputs: { firstDayOfWeek: ["clrFirstDayOfWeek", "firstDayOfWeek"], showActionButtons: "showActionButtons", clrPosition: "clrPosition", rangeOptions: "rangeOptions", min: "min", max: "max" }, host: { properties: { "class.clr-date-container": "true", "class.clr-form-control-disabled": "isInputDateDisabled", "class.clr-form-control": "true", "class.clr-row": "addGrid()" } }, providers: [
             ControlIdService,
             LocaleHelperService,
             ControlClassService,
@@ -2566,7 +2608,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImpor
                 }]
         }], ctorParameters: () => [{ type: i0.Renderer2 }, { type: i0.ElementRef }, { type: i1.ClrPopoverService }, { type: DateNavigationService }, { type: DatepickerEnabledService }, { type: DateFormControlService }, { type: DateIOService }, { type: i4.ClrCommonStringsService }, { type: i7.FormsFocusService }, { type: ViewManagerService }, { type: i7.ControlClassService }, { type: i7.LayoutService, decorators: [{
                     type: Optional
-                }] }, { type: i7.NgControlService }], propDecorators: { showActionButtons: [{
+                }] }, { type: i7.NgControlService }, { type: LocaleHelperService }], propDecorators: { firstDayOfWeek: [{
+                type: Input,
+                args: ['clrFirstDayOfWeek']
+            }], showActionButtons: [{
                 type: Input,
                 args: ['showActionButtons']
             }], clrPosition: [{
@@ -3119,6 +3164,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImpor
                     type: Optional
                 }] }] });
 
+/*
+ * Copyright (c) 2016-2026 Broadcom. All Rights Reserved.
+ * The term "Broadcom" refers to Broadcom Inc. and/or its subsidiaries.
+ * This software is released under MIT license.
+ * The full license information can be found in LICENSE in the root directory of this project.
+ */
+
 /*
  * Copyright (c) 2016-2026 Broadcom. All Rights Reserved.
  * The term "Broadcom" refers to Broadcom Inc. and/or its subsidiaries.
@@ -3218,5 +3270,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { CLR_DATEPICKER_DIRECTIVES, ClrCalendar, ClrDateContainer, ClrDateInput, ClrDateInputBase, ClrDateInputValidator, ClrDatepickerActions, ClrDatepickerModule, ClrDatepickerViewManager, ClrDay, ClrDaypicker, ClrEndDateInput, ClrEndDateInputValidator, ClrMonthpicker, ClrStartDateInput, ClrStartDateInputValidator, ClrYearpicker };
+export { CLR_DATEPICKER_DIRECTIVES, ClrCalendar, ClrDateContainer, ClrDateInput, ClrDateInputBase, ClrDateInputValidator, ClrDatepickerActions, ClrDatepickerModule, ClrDatepickerViewManager, ClrDay, ClrDaypicker, ClrEndDateInput, ClrEndDateInputValidator, ClrMonthpicker, ClrStartDateInput, ClrStartDateInputValidator, ClrWeekday, ClrYearpicker };
 //# sourceMappingURL=clr-angular-forms-datepicker.mjs.map