@dereekb/dbx-form 13.4.0 → 13.4.2

package/fesm2022/dereekb-dbx-form-calendar.mjs

@@ -15,8 +15,7 @@ import * as i1$1 from '@dereekb/dbx-core';
 import { TimezoneAbbreviationPipe, switchMapDbxInjectionComponentConfig, DbxInjectionComponent } from '@dereekb/dbx-core';
 import { toSignal, toObservable } from '@angular/core/rxjs-interop';
 import { MatDialog } from '@angular/material/dialog';
-import * as i1$5 from 'angular-calendar';
-import { CalendarModule } from 'angular-calendar';
+import { CalendarMonthViewComponent, CalendarDatePipe } from 'angular-calendar';
 import { DbxCalendarStore, prepareAndSortCalendarEvents, DbxCalendarBaseComponent } from '@dereekb/dbx-web/calendar';
 import * as i2 from '@angular/forms';
 import { FormGroup, FormControl, FormsModule, ReactiveFormsModule } from '@angular/forms';
@@ -27,9 +26,15 @@ import { MatDatepickerModule } from '@angular/material/datepicker';
 import { NgClass } from '@angular/common';
 import * as i1$4 from '@angular/material/icon';
 import { MatIconModule } from '@angular/material/icon';
-import * as i1$6 from '@ngx-formly/core';
+import * as i1$5 from '@ngx-formly/core';
 import { FormlyModule } from '@ngx-formly/core';
 
+/**
+ * Creates a Formly field configuration for a date schedule range picker with calendar-based selection.
+ *
+ * @param config - Optional schedule range field configuration overrides
+ * @returns A validated Formly field configuration for date schedule range selection
+ */
 function dateScheduleRangeField(config = {}) {
     const { key = 'schedule', appearance, hideCustomize, allowTextInput, filter, outputTimezone, initialSelectionState, computeSelectionResultRelativeToFilter, exclusions, defaultScheduleDays, minMaxDateRange, cellContentFactory, dialogContentConfig, customDetailsConfig } = config;
     const fieldConfig = {
@@ -80,6 +85,9 @@ const defaultCalendarScheduleSelectionCellContentFactory = (day) => {
             icon = 'check_box_outline_blank';
             text = 'Add';
             break;
+        default:
+            // meta.state is undefined when no metadata is attached to the day cell
+            break;
     }
     const result = {
         icon,
@@ -88,6 +96,12 @@ const defaultCalendarScheduleSelectionCellContentFactory = (day) => {
     return result;
 };
 
+/**
+ * Creates the default initial state for the calendar schedule selection store,
+ * using the current system timezone and all days of the week enabled.
+ *
+ * @returns A fresh CalendarScheduleSelectionState with default values
+ */
 function initialCalendarScheduleSelectionState() {
     const defaultScheduleDays = new Set([DateCellScheduleDayCode.WEEKDAY, DateCellScheduleDayCode.WEEKEND]);
     const allowedDaysOfWeek = expandDateCellScheduleDayCodesToDayOfWeekSet(defaultScheduleDays);
@@ -134,18 +148,42 @@ function calendarScheduleMinAndMaxDateRangeRelativeToFilter(x) {
     }
     return calendarScheduleMinAndMaxDateRange(input);
 }
+/**
+ * Computes the effective min and max date range by combining the filter and the explicit minMaxDateRange constraints.
+ *
+ * @param x - State containing filter and minMaxDateRange to compute from
+ * @returns A partial date range with the effective start and end boundaries
+ */
 function calendarScheduleMinAndMaxDateRange(x) {
     return {
         start: calendarScheduleMinDate(x) || undefined,
         end: calendarScheduleMaxDate(x) || undefined
     };
 }
+/**
+ * Returns the effective minimum date by taking the latest start date between the filter and minMaxDateRange.
+ *
+ * @param x - State containing filter and minMaxDateRange
+ * @returns The latest start date, or undefined if none
+ */
 function calendarScheduleMinDate(x) {
     return findMaxDate([x.filter?.start, x.minMaxDateRange?.start]);
 }
+/**
+ * Returns the effective maximum date by taking the earliest end date between the filter and minMaxDateRange.
+ *
+ * @param x - State containing filter and minMaxDateRange
+ * @returns The earliest end date, or undefined if none
+ */
 function calendarScheduleMaxDate(x) {
     return findMinDate([x.filter?.end, x.minMaxDateRange?.end]);
 }
+/**
+ * Returns whether the filter's start date is being used as the effective start for the selection result computation.
+ *
+ * @param x - State containing filter and computeSelectionResultRelativeToFilter
+ * @returns True if the filter start is being used for the selection result
+ */
 function calendarScheduleStartBeingUsedFromFilter(x) {
     return x.computeSelectionResultRelativeToFilter && x.filter?.start != null; // may be using either
 }
@@ -165,7 +203,7 @@ class DbxCalendarScheduleSelectionStore extends ComponentStore {
     minMaxDateRange$ = this.state$.pipe(map(calendarScheduleMinAndMaxDateRange), distinctUntilChanged(isSameDateRange), shareReplay(1));
     minDate$ = this.minMaxDateRange$.pipe(map((x) => x?.start), distinctUntilChanged(isSameDateDay), shareReplay(1));
     maxDate$ = this.minMaxDateRange$.pipe(map((x) => x?.end), distinctUntilChanged(isSameDateDay), shareReplay(1));
-    hasConfiguredMinMaxRange$ = this.minMaxDateRange$.pipe(map((x) => x != null && x.start != null && x.end != null), distinctUntilChanged(), shareReplay(1));
+    hasConfiguredMinMaxRange$ = this.minMaxDateRange$.pipe(map((x) => x?.start != null && x.end != null), distinctUntilChanged(), shareReplay(1));
     inputStart$ = this.state$.pipe(map((x) => x.inputStart), distinctUntilChanged(isSameDate), shareReplay(1));
     inputEnd$ = this.state$.pipe(map((x) => x.inputEnd), distinctUntilChanged(isSameDate), shareReplay(1));
     currentInputRange$ = this.state$.pipe(map(({ inputStart, inputEnd }) => ({ start: inputStart, end: inputEnd })), distinctUntilChanged((a, b) => isSameDateRange(a, b)), map((x) => ({ inputStart: x.start, inputEnd: x.end })), map((x) => {
@@ -279,6 +317,13 @@ class DbxCalendarScheduleSelectionStore extends ComponentStore {
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxCalendarScheduleSelectionStore, decorators: [{
             type: Injectable
         }], ctorParameters: () => [] });
+/**
+ * Updates the state with an initial selection (all or none) and applies it when no dates are currently toggled.
+ *
+ * @param state - The current selection state
+ * @param initialSelectionState - The initial selection mode ('all' or 'none')
+ * @returns The updated selection state
+ */
 function updateStateWithInitialSelectionState(state, initialSelectionState) {
     const { toggledIndexes } = state;
     if (toggledIndexes.size === 0 && initialSelectionState === 'all') {
@@ -286,6 +331,13 @@ function updateStateWithInitialSelectionState(state, initialSelectionState) {
     }
     return { ...state, initialSelectionState };
 }
+/**
+ * Updates the computeSelectionResultRelativeToFilter flag and recalculates the state if the value changed.
+ *
+ * @param currentState - The current selection state
+ * @param computeSelectionResultRelativeToFilter - Whether to compute results relative to the filter
+ * @returns The updated selection state
+ */
 function updateStateWithComputeSelectionResultRelativeToFilter(currentState, computeSelectionResultRelativeToFilter) {
     let state = { ...currentState, computeSelectionResultRelativeToFilter };
     if (Boolean(currentState.computeSelectionResultRelativeToFilter) !== Boolean(computeSelectionResultRelativeToFilter)) {
@@ -293,6 +345,13 @@ function updateStateWithComputeSelectionResultRelativeToFilter(currentState, com
     }
     return state;
 }
+/**
+ * Updates the state with date exclusions, converting input dates/ranges to cell indexes and reapplying the filter.
+ *
+ * @param state - The current selection state
+ * @param inputExclusions - Dates, date ranges, or cell indexes to exclude
+ * @returns The updated selection state with exclusions applied
+ */
 function updateStateWithExclusions(state, inputExclusions) {
     let computedExclusions;
     if (inputExclusions) {
@@ -303,6 +362,13 @@ function updateStateWithExclusions(state, inputExclusions) {
     state = { ...state, inputExclusions, computedExclusions };
     return updateStateWithFilter(state, state.filter);
 }
+/**
+ * Sets the min/max date range constraint on the state, normalizing start to startOfDay and end to endOfDay.
+ *
+ * @param state - The current selection state
+ * @param minMaxDateRange - The min/max boundary dates to enforce
+ * @returns The updated selection state with the boundary applied
+ */
 function updateStateWithMinMaxDateRange(state, minMaxDateRange) {
     if (minMaxDateRange != null && !isInfiniteDateRange(minMaxDateRange)) {
         state = {
@@ -318,6 +384,23 @@ function updateStateWithMinMaxDateRange(state, minMaxDateRange) {
     }
     return updateStateWithFilter(state, state.filter);
 }
+/**
+ * Applies a date cell schedule filter to the selection state, computing the enabled day function
+ * from the filter, exclusions, and min/max date range constraints.
+ *
+ * @param currentState - The current selection state
+ * @param inputFilter - The filter configuration to apply
+ * @returns The updated selection state with the filter applied
+ */
+/**
+ * Applies a date cell schedule filter to the selection state, computing the enabled day function
+ * from the filter, exclusions, and min/max date range constraints.
+ *
+ * @param currentState - The current selection state
+ * @param inputFilter - The filter configuration to apply
+ * @returns The updated selection state with the filter applied
+ */
+// eslint-disable-next-line sonarjs/cognitive-complexity
 function updateStateWithFilter(currentState, inputFilter) {
     const { computedExclusions: exclusions, minMaxDateRange, systemTimezone } = currentState;
     let isEnabledFilterDay = () => true;
@@ -412,7 +495,7 @@ function updateStateWithFilter(currentState, inputFilter) {
     }
     let nextState = { ...currentState, filter, isEnabledFilterDay };
     // For the same reason as above, use the filter's start date as the relative start if applicable.
-    if (filter && filter.start) {
+    if (filter?.start) {
         let startForSystemTimezone = filter.start;
         if (filter.timezone) {
             const timezoneNormal = dateTimezoneUtcNormal(filter.timezone);
@@ -433,6 +516,13 @@ function updateStateWithFilter(currentState, inputFilter) {
     }
     return nextState;
 }
+/**
+ * Updates the output timezone and transforms the current selection value to reflect the new timezone.
+ *
+ * @param state - The current selection state
+ * @param timezone - The target timezone string
+ * @returns The updated selection state with timezone-adjusted values
+ */
 function updateStateWithTimezoneValue(state, timezone) {
     const { currentSelectionValue } = state;
     const timezoneNormal = timezone ? dateTimezoneUtcNormal({ timezone }) : undefined;
@@ -452,6 +542,14 @@ function updateStateWithTimezoneValue(state, timezone) {
         return { ...state, outputTimezone: timezone, outputTimezoneNormal: timezoneNormal }; // no change in value
     }
 }
+/**
+ * Updates the state from an external date cell schedule range value, converting timezone-aware inputs
+ * to system time and synchronizing the internal selection indexes.
+ *
+ * @param state - The current selection state
+ * @param inputChange - The date cell schedule range to apply
+ * @returns The updated selection state
+ */
 function updateStateWithDateCellScheduleRangeValue(state, inputChange) {
     const { currentSelectionValue, systemTimezone } = state;
     const currentDateCellScheduleRange = currentSelectionValue?.dateScheduleRange; // current range is always in system time
@@ -492,6 +590,13 @@ function updateStateWithDateCellScheduleRangeValue(state, inputChange) {
         }
     }
 }
+/**
+ * Updates the default schedule day codes (used when no explicit schedule days are set) and recalculates allowed days.
+ *
+ * @param state - The current selection state
+ * @param change - The new default schedule day codes
+ * @returns The updated selection state
+ */
 function updateStateWithChangedDefaultScheduleDays(state, change) {
     const { defaultScheduleDays: currentDefaultScheduleDays } = state;
     const defaultScheduleDays = new Set(change ?? fullWeekDateCellScheduleDayCodes());
@@ -502,6 +607,13 @@ function updateStateWithChangedDefaultScheduleDays(state, change) {
         return finalizeUpdateStateWithChangedScheduleDays(state, { ...state, defaultScheduleDays });
     }
 }
+/**
+ * Updates the explicit schedule day codes override and recalculates allowed days of the week.
+ *
+ * @param state - The current selection state
+ * @param change - The new schedule day codes, or null/undefined to clear the override
+ * @returns The updated selection state
+ */
 function updateStateWithChangedScheduleDays(state, change) {
     const { scheduleDays: currentScheduleDays } = state;
     const scheduleDays = new Set(change ?? []);
@@ -524,6 +636,13 @@ function updateStateWithChangedScheduleDays(state, change) {
         return finalizeUpdateStateWithChangedScheduleDays(state, { ...state, scheduleDays: newScheduleDays ?? undefined });
     }
 }
+/**
+ * Switches between single and multiple selection mode, trimming the selection to a single value when switching to single mode.
+ *
+ * @param state - The current selection state
+ * @param selectionMode - The new selection mode
+ * @returns The updated selection state
+ */
 function updateStateWithSelectionMode(state, selectionMode) {
     const { selectionMode: currentSelectionMode } = state;
     if (currentSelectionMode !== selectionMode) {
@@ -540,6 +659,13 @@ function updateStateWithSelectionMode(state, selectionMode) {
         return state;
     }
 }
+/**
+ * Finalizes a schedule days change by recalculating allowed days of the week and updating toggled indexes accordingly.
+ *
+ * @param previousState - The state before the schedule days change
+ * @param nextState - The state with updated schedule day codes
+ * @returns The finalized selection state with recalculated allowed days and toggled indexes
+ */
 function finalizeUpdateStateWithChangedScheduleDays(previousState, nextState) {
     const previousScheduleDays = previousState.effectiveScheduleDays;
     const nextScheduleDays = nextState.scheduleDays ?? nextState.defaultScheduleDays;
@@ -557,8 +683,25 @@ function finalizeUpdateStateWithChangedScheduleDays(previousState, nextState) {
         });
     }
 }
+/**
+ * Applies date changes (toggle, add, remove, set, selectAll, or reset) to the calendar selection state,
+ * updating toggled indexes and input start/end accordingly.
+ *
+ * @param state - The current selection state
+ * @param change - The date changes to apply
+ * @returns The updated selection state
+ */
+/**
+ * Applies date changes (toggle, add, remove, set, selectAll, or reset) to the calendar selection state,
+ * updating toggled indexes and input start/end accordingly.
+ *
+ * @param state - The current selection state
+ * @param change - The date changes to apply
+ * @returns The updated selection state
+ */
+// eslint-disable-next-line sonarjs/cognitive-complexity
 function updateStateWithChangedDates(state, change) {
-    const { selectionMode, allowedDaysOfWeek, indexFactory, indexDayOfWeek, inputStart: currentInputStart, inputEnd: currentInputEnd, minMaxDateRange, filter } = state;
+    const { selectionMode, allowedDaysOfWeek, indexFactory, indexDayOfWeek, inputStart: currentInputStart, inputEnd: currentInputEnd, minMaxDateRange: _minMaxDateRange, filter: _filter } = state;
     const { start: minDateFromFilter, end: maxDateFromFilter } = calendarScheduleMinAndMaxDateRangeRelativeToFilter(state);
     let inputStart = currentInputStart;
     let inputEnd = currentInputEnd;
@@ -612,6 +755,9 @@ function updateStateWithChangedDates(state, change) {
                 inputEnd = null;
                 set = [];
                 break;
+            default:
+                // selectAll is undefined or null; no bulk selection change needed
+                break;
         }
         const inputSetIndexes = asIndexes(set);
         toggledIndexes = new Set(inputSetIndexes);
@@ -691,9 +837,22 @@ function updateStateWithChangedDates(state, change) {
         return noSelectionCalendarScheduleSelectionState(nextState);
     }
 }
+/**
+ * Clears all date selections from the state, retaining other configuration like schedule days and filter.
+ *
+ * @param state - The current selection state
+ * @returns The state with all selections cleared
+ */
 function noSelectionCalendarScheduleSelectionState(state) {
     return finalizeNewCalendarScheduleSelectionState({ ...state, toggledIndexes: new Set(), inputStart: null, inputEnd: null });
 }
+/**
+ * Updates the selection state with a new start/end date range, retaining toggled indexes within the new range bounds.
+ *
+ * @param state - The current selection state
+ * @param change - The new input start and end dates
+ * @returns The updated selection state
+ */
 function updateStateWithChangedRange(state, change) {
     const { inputStart: currentInputStart, inputEnd: currentInputEnd, indexFactory } = state;
     const { start: minDate, end: maxDate } = calendarScheduleMinAndMaxDateRange(state);
@@ -706,18 +865,30 @@ function updateStateWithChangedRange(state, change) {
     // retain all indexes that are within the new range
     const minIndex = indexFactory(inputStart);
     const maxIndex = indexFactory(inputEnd) + 1;
-    const currentIndexes = Array.from(state.toggledIndexes);
+    const currentIndexes = [...state.toggledIndexes];
     const isInCurrentRange = isIndexNumberInIndexRangeFunction({ minIndex, maxIndex });
     const excludedIndexesInNewRange = currentIndexes.filter(isInCurrentRange);
     const toggledIndexes = new Set(excludedIndexesInNewRange);
     const nextState = { ...state, toggledIndexes, inputStart, inputEnd };
     return finalizeNewCalendarScheduleSelectionState(nextState);
 }
+/**
+ * Finalizes a partially-built state by recomputing the isEnabledDay function and the current selection value.
+ *
+ * @param nextState - The partially-built selection state to finalize
+ * @returns The finalized selection state
+ */
 function finalizeNewCalendarScheduleSelectionState(nextState) {
     nextState.isEnabledDay = isEnabledDayInCalendarScheduleSelectionState(nextState);
     nextState.currentSelectionValue = computeScheduleSelectionValue(nextState);
     return nextState;
 }
+/**
+ * Builds a decision function that determines whether a given day index is enabled (selected) in the current state.
+ *
+ * @param state - The selection state to derive the enabled-day function from
+ * @returns A function that returns true if the given day is enabled/selected
+ */
 function isEnabledDayInCalendarScheduleSelectionState(state) {
     const { allowedDaysOfWeek, indexFactory, inputStart, inputEnd, indexDayOfWeek, systemTimezone } = state;
     let isInStartAndEndRange;
@@ -733,10 +904,16 @@ function isEnabledDayInCalendarScheduleSelectionState(state) {
         const isInSelectedRange = isInStartAndEndRange(index);
         const isSelected = state.toggledIndexes.has(index);
         const isAllowedDayOfWeek = allowedDaysOfWeek.has(dayOfWeek);
-        const result = isAllowedDayOfWeek && ((isInSelectedRange && !isSelected) || (isSelected && !isInSelectedRange));
-        return result;
+        return isAllowedDayOfWeek && ((isInSelectedRange && !isSelected) || (isSelected && !isInSelectedRange));
     };
 }
+/**
+ * Computes the output DateCellScheduleDateRange value from the current selection state,
+ * applying timezone offsets and filter-relative computations as needed.
+ *
+ * @param state - The current selection state to compute from
+ * @returns The computed selection value, or null if nothing is selected
+ */
 function computeScheduleSelectionValue(state) {
     const { indexFactory: systemIndexFactory, allowedDaysOfWeek, effectiveScheduleDays, indexDayOfWeek, computeSelectionResultRelativeToFilter, filter, systemTimezone } = state;
     let timezone = systemTimezone;
@@ -767,8 +944,8 @@ function computeScheduleSelectionValue(state) {
     }
     const excluded = computeSelectionResultRelativeToFilter
         ? allExcluded.filter((x) => {
-            const isExcludedIndex = allowedDaysOfWeek.has(indexDayOfWeek(x)); // ???
-            return isExcludedIndex;
+            // ???
+            return allowedDaysOfWeek.has(indexDayOfWeek(x));
         })
         : allExcluded;
     const offsetExcluded = excluded.map((x) => x - indexOffset); // set to the proper offset
@@ -792,6 +969,13 @@ function computeScheduleSelectionValue(state) {
         minMaxRange: { start, end }
     };
 }
+/**
+ * Computes the selected date range with its corresponding cell range and all excluded day indexes.
+ * Returns null if no days are selected.
+ *
+ * @param state - The current selection state
+ * @returns The range and exclusion data, or null if nothing is selected
+ */
 function computeScheduleSelectionRangeAndExclusion(state) {
     const { start: currentStart, isEnabledDay, isEnabledFilterDay, systemTimezone } = state;
     const dateFactory = dateCellTimingStartDateFactory({ startsAt: currentStart, timezone: systemTimezone });
@@ -802,8 +986,7 @@ function computeScheduleSelectionRangeAndExclusion(state) {
     const start = dateFactory(dateCellRange.i);
     const end = dateFactory(dateCellRange.to);
     const excluded = range(dateCellRange.i, dateCellRange.to + 1).filter((x) => {
-        const isExcludedIndex = !isEnabledDay(x) || !isEnabledFilterDay(x);
-        return isExcludedIndex;
+        return !isEnabledDay(x) || !isEnabledFilterDay(x);
     });
     const result = {
         dateCellRange,
@@ -813,15 +996,27 @@ function computeScheduleSelectionRangeAndExclusion(state) {
     };
     return result;
 }
+/**
+ * Computes the selected date range (start and end dates) from the current selection state.
+ *
+ * @param state - The current selection state
+ * @returns The selected date range, or undefined if nothing is selected
+ */
 function computeCalendarScheduleSelectionRange(state) {
     const dateFactory = dateCellTimingDateFactory({ startsAt: state.start, timezone: state.systemTimezone });
     const dateCellRange = computeCalendarScheduleSelectionDateCellRange(state);
     const dateRange = dateCellRange != null ? { start: dateFactory(dateCellRange.i), end: dateFactory(dateCellRange.to) } : undefined;
     return dateRange;
 }
+/**
+ * Computes the date cell index range (i, to) that spans all selected and toggled days in the current state.
+ *
+ * @param state - The current selection state
+ * @returns The cell range spanning all selected days, or undefined if nothing is selected
+ */
 function computeCalendarScheduleSelectionDateCellRange(state) {
     const { allowedDaysOfWeek, indexFactory, inputStart, inputEnd, indexDayOfWeek, isEnabledDay, isEnabledFilterDay } = state;
-    const enabledExclusionIndexes = Array.from(state.toggledIndexes).filter((i) => allowedDaysOfWeek.has(indexDayOfWeek(i)));
+    const enabledExclusionIndexes = [...state.toggledIndexes].filter((i) => allowedDaysOfWeek.has(indexDayOfWeek(i)));
     const minAndMaxSelectedValues = minAndMaxNumber(enabledExclusionIndexes);
     let startRange;
     let endRange;
@@ -898,7 +1093,7 @@ function provideCalendarScheduleSelectionStoreIfParentIsUnavailable() {
     return {
         provide: DbxCalendarScheduleSelectionStore,
         useFactory: (parentInjector, dbxCalendarScheduleSelectionStoreInjectionBlock, dbxCalendarScheduleSelectionStore) => {
-            if (!dbxCalendarScheduleSelectionStore || (dbxCalendarScheduleSelectionStore && dbxCalendarScheduleSelectionStoreInjectionBlock != null && dbxCalendarScheduleSelectionStoreInjectionBlock.dbxCalendarScheduleSelectionStore === dbxCalendarScheduleSelectionStore)) {
+            if (!dbxCalendarScheduleSelectionStore || (dbxCalendarScheduleSelectionStore && dbxCalendarScheduleSelectionStoreInjectionBlock?.dbxCalendarScheduleSelectionStore === dbxCalendarScheduleSelectionStore)) {
                 // create a new dbxCalendarScheduleSelectionStore to use
                 const injector = Injector.create({ providers: [{ provide: DbxCalendarScheduleSelectionStore }], parent: parentInjector });
                 dbxCalendarScheduleSelectionStore = injector.get(DbxCalendarScheduleSelectionStore);
@@ -909,10 +1104,21 @@ function provideCalendarScheduleSelectionStoreIfParentIsUnavailable() {
     };
 }
 
+/**
+ * Creates form fields for selecting which days of the week are enabled in a schedule selection calendar,
+ * wrapped in a responsive flex layout.
+ *
+ * @returns An array of Formly field configs with toggle fields for each day of the week
+ */
 function dbxScheduleSelectionCalendarDateDaysFormFields() {
     const fields = dbxScheduleSelectionCalendarDateDaysFormDayFields();
     return [flexLayoutWrapper(fields, { relative: true, size: 3 })];
 }
+/**
+ * Creates an array of toggle field configs, one for each day of the week, keyed by lowercase day name.
+ *
+ * @returns An array of toggle Formly field configs for each day of the week
+ */
 function dbxScheduleSelectionCalendarDateDaysFormDayFields() {
     return getDaysOfWeekNames(false).map((dayOfWeekName) => {
         return toggleField({
@@ -946,8 +1152,7 @@ class DbxScheduleSelectionCalendarDateDaysComponent {
     isFormModified = (value) => {
         const newSetValue = new Set(dateCellScheduleDayCodesFromEnabledDays(value));
         return this.dbxCalendarScheduleSelectionStore.scheduleDays$.pipe(map((currentSet) => {
-            const result = !dateCellScheduleDayCodesAreSetsEquivalent(newSetValue, currentSet);
-            return result;
+            return !dateCellScheduleDayCodesAreSetsEquivalent(newSetValue, currentSet);
         }));
     };
     updateScheduleDays = (value) => {
@@ -1005,7 +1210,7 @@ class DbxScheduleSelectionCalendarDateRangeComponent {
         end: new FormControl(null)
     });
     errorStateMatcher = {
-        isErrorState: (control, form) => {
+        isErrorState: (control, _form) => {
             if (control) {
                 return (control.invalid && (control.dirty || control.touched)) || (control.touched && this.range.invalid);
             }
@@ -1050,8 +1255,7 @@ class DbxScheduleSelectionCalendarDateRangeComponent {
     }), shareReplay(1));
     datePickerFilter$ = combineLatest([this.dbxCalendarScheduleSelectionStore.isEnabledFilterDayFunction$, this.dbxCalendarScheduleSelectionStore.isInAllowedDaysOfWeekFunction$]).pipe(map(([isEnabled, isAllowedDayOfWeek]) => {
         const fn = (date) => {
-            const result = date ? isAllowedDayOfWeek(date) && isEnabled(date) : true;
-            return result;
+            return date ? isAllowedDayOfWeek(date) && isEnabled(date) : true;
         };
         return fn;
     }), shareReplay(1));
@@ -1066,7 +1270,7 @@ class DbxScheduleSelectionCalendarDateRangeComponent {
             ? [
                 (control) => {
                     const range = control.value;
-                    if (!range || !range.start || !range.end) {
+                    if (!range?.start || !range.end) {
                         return { required: true };
                     }
                     return null;
@@ -1329,7 +1533,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
                 }]
         }], propDecorators: { disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }] } });
 
+/**
+ * Creates a factory that produces a beforeMonthViewRender handler for the schedule selection calendar.
+ * The handler applies CSS classes and metadata to each day cell based on the current selection state.
+ *
+ * @param inputModifyFn - Optional function to further customize each day cell after default processing
+ * @returns A factory function that accepts a state observable and produces a render handler
+ */
 function dbxScheduleSelectionCalendarBeforeMonthViewRenderFactory(inputModifyFn) {
+    // eslint-disable-next-line @typescript-eslint/no-empty-function
     const modifyFn = inputModifyFn || (() => { });
     return (state$) => {
         return (renderEvent) => {
@@ -1459,11 +1671,11 @@ class DbxScheduleSelectionCalendarComponent {
         this.beforeMonthViewRenderSignal()?.(renderEvent);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxScheduleSelectionCalendarComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.0", type: DbxScheduleSelectionCalendarComponent, isStandalone: true, selector: "dbx-schedule-selection-calendar", inputs: { config: { classPropertyName: "config", publicName: "config", isSignal: true, isRequired: false, transformFunction: null }, readonly: { classPropertyName: "readonly", publicName: "readonly", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { clickEvent: "clickEvent" }, providers: [DbxCalendarStore], ngImport: i0, template: "<dbx-calendar-base class=\"dbx-schedule-selection-calendar\" [ngClass]=\"readonlySignal() ? 'dbx-schedule-selection-calendar-readonly' : ''\">\n  <ng-container controls>\n    @if (showClearSelectionButtonSignal()) {\n      <dbx-schedule-selection-calendar-selection-toggle-button [disabled]=\"readonlySignal()\"></dbx-schedule-selection-calendar-selection-toggle-button>\n      <dbx-button-spacer></dbx-button-spacer>\n    }\n    <dbx-injection [config]=\"datePopoverButtonInjectionConfigSignal()\"></dbx-injection>\n  </ng-container>\n  <div class=\"dbx-calendar-content dbx-calendar-content-month\">\n    <mwl-calendar-month-view [refresh]=\"refresh$\" [viewDate]=\"viewDateSignal()!\" [events]=\"eventsSignal()\" (dayClicked)=\"dayClicked($event.day)\" (eventClicked)=\"eventClicked('Clicked', $event.event)\" (beforeViewRender)=\"beforeMonthViewRender($event)\" [cellTemplate]=\"monthDayCellTemplate\"></mwl-calendar-month-view>\n  </div>\n</dbx-calendar-base>\n\n<!-- Cell -->\n<ng-template #monthDayCellTemplate let-day=\"day\" let-locale=\"locale\">\n  <div class=\"cal-cell-top\">\n    @if (day.badgeTotal > 0) {\n      <span class=\"cal-day-badge\">{{ day.badgeTotal }}</span>\n    }\n    <span class=\"cal-day-number\">{{ day.date | calendarDate: 'monthViewDayNumber' : locale }}</span>\n  </div>\n  <dbx-schedule-selection-calendar-cell [day]=\"day\"></dbx-schedule-selection-calendar-cell>\n</ng-template>\n", dependencies: [{ kind: "directive", type: NgClass, selector: "[ngClass]", inputs: ["class", "ngClass"] }, { kind: "ngmodule", type: CalendarModule }, { kind: "component", type: i1$5.CalendarMonthViewComponent, selector: "mwl-calendar-month-view", inputs: ["viewDate", "events", "excludeDays", "activeDayIsOpen", "activeDay", "refresh", "locale", "tooltipPlacement", "tooltipTemplate", "tooltipAppendToBody", "tooltipDelay", "weekStartsOn", "headerTemplate", "cellTemplate", "openDayEventsTemplate", "eventTitleTemplate", "eventActionsTemplate", "weekendDays"], outputs: ["beforeViewRender", "dayClicked", "eventClicked", "columnHeaderClicked", "eventTimesChanged"] }, { kind: "component", type: DbxCalendarBaseComponent, selector: "dbx-calendar-base" }, { kind: "component", type: DbxInjectionComponent, selector: "dbx-injection, [dbxInjection], [dbx-injection]", inputs: ["config", "template"] }, { kind: "directive", type: DbxButtonSpacerDirective, selector: "dbx-button-spacer,[dbxButtonSpacer]" }, { kind: "component", type: DbxScheduleSelectionCalendarCellComponent, selector: "dbx-schedule-selection-calendar-cell", inputs: ["day"] }, { kind: "component", type: DbxScheduleSelectionCalendarSelectionToggleButtonComponent, selector: "dbx-schedule-selection-calendar-selection-toggle-button", inputs: ["disabled"] }, { kind: "pipe", type: i1$5.CalendarDatePipe, name: "calendarDate" }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.0", type: DbxScheduleSelectionCalendarComponent, isStandalone: true, selector: "dbx-schedule-selection-calendar", inputs: { config: { classPropertyName: "config", publicName: "config", isSignal: true, isRequired: false, transformFunction: null }, readonly: { classPropertyName: "readonly", publicName: "readonly", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { clickEvent: "clickEvent" }, providers: [DbxCalendarStore], ngImport: i0, template: "<dbx-calendar-base class=\"dbx-schedule-selection-calendar\" [ngClass]=\"readonlySignal() ? 'dbx-schedule-selection-calendar-readonly' : ''\">\n  <ng-container controls>\n    @if (showClearSelectionButtonSignal()) {\n      <dbx-schedule-selection-calendar-selection-toggle-button [disabled]=\"readonlySignal()\"></dbx-schedule-selection-calendar-selection-toggle-button>\n      <dbx-button-spacer></dbx-button-spacer>\n    }\n    <dbx-injection [config]=\"datePopoverButtonInjectionConfigSignal()\"></dbx-injection>\n  </ng-container>\n  <div class=\"dbx-calendar-content dbx-calendar-content-month\">\n    <mwl-calendar-month-view [refresh]=\"refresh$\" [viewDate]=\"viewDateSignal()!\" [events]=\"eventsSignal()\" (dayClicked)=\"dayClicked($event.day)\" (eventClicked)=\"eventClicked('Clicked', $event.event)\" (beforeViewRender)=\"beforeMonthViewRender($event)\" [cellTemplate]=\"monthDayCellTemplate\"></mwl-calendar-month-view>\n  </div>\n</dbx-calendar-base>\n\n<!-- Cell -->\n<ng-template #monthDayCellTemplate let-day=\"day\" let-locale=\"locale\">\n  <div class=\"cal-cell-top\">\n    @if (day.badgeTotal > 0) {\n      <span class=\"cal-day-badge\">{{ day.badgeTotal }}</span>\n    }\n    <span class=\"cal-day-number\">{{ day.date | calendarDate: 'monthViewDayNumber' : locale }}</span>\n  </div>\n  <dbx-schedule-selection-calendar-cell [day]=\"day\"></dbx-schedule-selection-calendar-cell>\n</ng-template>\n", dependencies: [{ kind: "directive", type: NgClass, selector: "[ngClass]", inputs: ["class", "ngClass"] }, { kind: "component", type: CalendarMonthViewComponent, selector: "mwl-calendar-month-view", inputs: ["viewDate", "events", "excludeDays", "activeDayIsOpen", "activeDay", "refresh", "locale", "tooltipPlacement", "tooltipTemplate", "tooltipAppendToBody", "tooltipDelay", "weekStartsOn", "headerTemplate", "cellTemplate", "openDayEventsTemplate", "eventTitleTemplate", "eventActionsTemplate", "weekendDays"], outputs: ["beforeViewRender", "dayClicked", "eventClicked", "columnHeaderClicked", "eventTimesChanged"] }, { kind: "component", type: DbxCalendarBaseComponent, selector: "dbx-calendar-base" }, { kind: "component", type: DbxInjectionComponent, selector: "dbx-injection, [dbxInjection], [dbx-injection]", inputs: ["config", "template"] }, { kind: "directive", type: DbxButtonSpacerDirective, selector: "dbx-button-spacer,[dbxButtonSpacer]" }, { kind: "component", type: DbxScheduleSelectionCalendarCellComponent, selector: "dbx-schedule-selection-calendar-cell", inputs: ["day"] }, { kind: "component", type: DbxScheduleSelectionCalendarSelectionToggleButtonComponent, selector: "dbx-schedule-selection-calendar-selection-toggle-button", inputs: ["disabled"] }, { kind: "pipe", type: CalendarDatePipe, name: "calendarDate" }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxScheduleSelectionCalendarComponent, decorators: [{
             type: Component,
-            args: [{ selector: 'dbx-schedule-selection-calendar', imports: [NgClass, CalendarModule, DbxCalendarBaseComponent, DbxInjectionComponent, DbxButtonSpacerDirective, DbxScheduleSelectionCalendarCellComponent, DbxScheduleSelectionCalendarSelectionToggleButtonComponent], providers: [DbxCalendarStore], changeDetection: ChangeDetectionStrategy.OnPush, standalone: true, template: "<dbx-calendar-base class=\"dbx-schedule-selection-calendar\" [ngClass]=\"readonlySignal() ? 'dbx-schedule-selection-calendar-readonly' : ''\">\n  <ng-container controls>\n    @if (showClearSelectionButtonSignal()) {\n      <dbx-schedule-selection-calendar-selection-toggle-button [disabled]=\"readonlySignal()\"></dbx-schedule-selection-calendar-selection-toggle-button>\n      <dbx-button-spacer></dbx-button-spacer>\n    }\n    <dbx-injection [config]=\"datePopoverButtonInjectionConfigSignal()\"></dbx-injection>\n  </ng-container>\n  <div class=\"dbx-calendar-content dbx-calendar-content-month\">\n    <mwl-calendar-month-view [refresh]=\"refresh$\" [viewDate]=\"viewDateSignal()!\" [events]=\"eventsSignal()\" (dayClicked)=\"dayClicked($event.day)\" (eventClicked)=\"eventClicked('Clicked', $event.event)\" (beforeViewRender)=\"beforeMonthViewRender($event)\" [cellTemplate]=\"monthDayCellTemplate\"></mwl-calendar-month-view>\n  </div>\n</dbx-calendar-base>\n\n<!-- Cell -->\n<ng-template #monthDayCellTemplate let-day=\"day\" let-locale=\"locale\">\n  <div class=\"cal-cell-top\">\n    @if (day.badgeTotal > 0) {\n      <span class=\"cal-day-badge\">{{ day.badgeTotal }}</span>\n    }\n    <span class=\"cal-day-number\">{{ day.date | calendarDate: 'monthViewDayNumber' : locale }}</span>\n  </div>\n  <dbx-schedule-selection-calendar-cell [day]=\"day\"></dbx-schedule-selection-calendar-cell>\n</ng-template>\n" }]
+            args: [{ selector: 'dbx-schedule-selection-calendar', imports: [NgClass, CalendarMonthViewComponent, CalendarDatePipe, DbxCalendarBaseComponent, DbxInjectionComponent, DbxButtonSpacerDirective, DbxScheduleSelectionCalendarCellComponent, DbxScheduleSelectionCalendarSelectionToggleButtonComponent], providers: [DbxCalendarStore], changeDetection: ChangeDetectionStrategy.OnPush, standalone: true, template: "<dbx-calendar-base class=\"dbx-schedule-selection-calendar\" [ngClass]=\"readonlySignal() ? 'dbx-schedule-selection-calendar-readonly' : ''\">\n  <ng-container controls>\n    @if (showClearSelectionButtonSignal()) {\n      <dbx-schedule-selection-calendar-selection-toggle-button [disabled]=\"readonlySignal()\"></dbx-schedule-selection-calendar-selection-toggle-button>\n      <dbx-button-spacer></dbx-button-spacer>\n    }\n    <dbx-injection [config]=\"datePopoverButtonInjectionConfigSignal()\"></dbx-injection>\n  </ng-container>\n  <div class=\"dbx-calendar-content dbx-calendar-content-month\">\n    <mwl-calendar-month-view [refresh]=\"refresh$\" [viewDate]=\"viewDateSignal()!\" [events]=\"eventsSignal()\" (dayClicked)=\"dayClicked($event.day)\" (eventClicked)=\"eventClicked('Clicked', $event.event)\" (beforeViewRender)=\"beforeMonthViewRender($event)\" [cellTemplate]=\"monthDayCellTemplate\"></mwl-calendar-month-view>\n  </div>\n</dbx-calendar-base>\n\n<!-- Cell -->\n<ng-template #monthDayCellTemplate let-day=\"day\" let-locale=\"locale\">\n  <div class=\"cal-cell-top\">\n    @if (day.badgeTotal > 0) {\n      <span class=\"cal-day-badge\">{{ day.badgeTotal }}</span>\n    }\n    <span class=\"cal-day-number\">{{ day.date | calendarDate: 'monthViewDayNumber' : locale }}</span>\n  </div>\n  <dbx-schedule-selection-calendar-cell [day]=\"day\"></dbx-schedule-selection-calendar-cell>\n</ng-template>\n" }]
         }], propDecorators: { clickEvent: [{ type: i0.Output, args: ["clickEvent"] }], config: [{ type: i0.Input, args: [{ isSignal: true, alias: "config", required: false }] }], readonly: [{ type: i0.Input, args: [{ isSignal: true, alias: "readonly", required: false }] }] } });
 
 /**
@@ -1690,7 +1902,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
 const importsAndExports$1 = [DbxFormCalendarDateScheduleRangeFieldComponent];
 class DbxFormDateScheduleRangeFieldModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxFormDateScheduleRangeFieldModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
-    static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "21.2.0", ngImport: i0, type: DbxFormDateScheduleRangeFieldModule, imports: [DbxFormCalendarDateScheduleRangeFieldComponent, i1$6.FormlyModule], exports: [DbxFormCalendarDateScheduleRangeFieldComponent] });
+    static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "21.2.0", ngImport: i0, type: DbxFormDateScheduleRangeFieldModule, imports: [DbxFormCalendarDateScheduleRangeFieldComponent, i1$5.FormlyModule], exports: [DbxFormCalendarDateScheduleRangeFieldComponent] });
     static ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: DbxFormDateScheduleRangeFieldModule, imports: [importsAndExports$1, FormlyModule.forChild({
                 types: [{ name: 'date-schedule-range', component: DbxFormCalendarDateScheduleRangeFieldComponent }]
             })] });