@coreui/vue-pro 5.9.0 → 5.11.0

package/dist/esm/components/calendar/utils.d.ts

@@ -1,17 +1,83 @@
-import type { DisabledDate } from './CCalendar';
+import type { DisabledDate, SelectionTypes, ViewTypes } from './types';
+/**
+ * Converts an ISO week string to a Date object representing the Monday of that week.
+ * @param isoWeek - The ISO week string (e.g., "2023W05" or "2023w05").
+ * @returns The Date object for the Monday of the specified week, or null if invalid.
+ */
 export declare const convertIsoWeekToDate: (isoWeek: string) => Date;
-export declare const convertToDateObject: (date: Date | string, selectionType?: "day" | "week" | "month" | "year") => Date;
-export declare const convertToLocalDate: (d: Date, locale: string, options?: {}) => string;
-export declare const convertToLocalTime: (d: Date, locale: string, options?: {}) => string;
+/**
+ * Converts a date string or Date object to a Date object based on selection type.
+ * @param date - The date to convert.
+ * @param selectionType - The type of selection ('day', 'week', 'month', 'year').
+ * @returns The corresponding Date object or null if invalid.
+ */
+export declare const convertToDateObject: (date: Date | string, selectionType?: SelectionTypes) => Date;
+/**
+ * Creates groups from an array.
+ * @param arr - The array to group.
+ * @param numberOfGroups - Number of groups to create.
+ * @returns An array of grouped arrays.
+ */
 export declare const createGroupsInArray: <T>(arr: T[], numberOfGroups: number) => T[][];
-export declare const getCalendarDate: (calendarDate: Date, order: number, view: "days" | "months" | "years") => Date;
-export declare const getCurrentYear: () => number;
-export declare const getCurrentMonth: () => number;
-export declare const getDateBySelectionType: (date: Date | null, selectionType: "day" | "week" | "month" | "year") => string | Date | null;
-export declare const getMonthName: (month: number, locale: string) => string;
-export declare const getMonthsNames: (locale: string) => string[];
-export declare const getYears: (year: number) => number[];
+/**
+ * Adjusts the calendar date based on order and view type.
+ * @param calendarDate - The current calendar date.
+ * @param order - The order to adjust by.
+ * @param view - The current view type.
+ * @returns The adjusted Date object.
+ */
+export declare const getCalendarDate: (calendarDate: Date, order: number, view: ViewTypes) => Date;
+/**
+ * Formats a date based on the selection type.
+ * @param date - The date to format.
+ * @param selectionType - The type of selection ('day', 'week', 'month', 'year').
+ * @returns A formatted date string or the original Date object.
+ */
+export declare const getDateBySelectionType: (date: Date | null, selectionType: SelectionTypes) => string | Date | null;
+/**
+ * Retrieves the first available date within a range that is not disabled.
+ * @param startDate - Start date of the range.
+ * @param endDate - End date of the range.
+ * @param min - Minimum allowed date.
+ * @param max - Maximum allowed date.
+ * @param disabledDates - Criteria for disabled dates.
+ * @returns The first available Date object or null if none found.
+ */
+export declare const getFirstAvailableDateInRange: (startDate: Date, endDate: Date, min?: Date | null, max?: Date | null, disabledDates?: DisabledDate | DisabledDate[]) => Date | null;
+/**
+ * Retrieves an array of month names based on locale and format.
+ * @param locale - The locale string (e.g., 'en-US').
+ * @param format - The format of the month names ('short' or 'long').
+ * @returns An array of month names.
+ */
+export declare const getMonthsNames: (locale: string, format?: "short" | "long") => string[];
+/**
+ * Retrieves an array of selectable dates from the given element.
+ * @param element - The HTML element to search for selectable dates.
+ * @param selector - The CSS selector used to identify selectable dates. Defaults to 'tr[tabindex="0"], td[tabindex="0"]'.
+ * @returns An array of HTMLElements representing the selectable dates.
+ */
+export declare const getSelectableDates: (element: HTMLElement, selector?: string) => HTMLElement[];
+/**
+ * Generates an array of years centered around a given year.
+ * @param year - The central year.
+ * @param range - The number of years before and after the central year.
+ * @returns An array of years.
+ */
+export declare const getYears: (year: number, range?: number) => number[];
+/**
+ * Calculates the ISO week number for a given date.
+ * @param date - The date to calculate the week number for.
+ * @returns The ISO week number.
+ */
 export declare const getWeekNumber: (date: Date) => number;
+/**
+ * Retrieves detailed information about each week in a month for calendar rendering.
+ * @param year - The year.
+ * @param month - The month (0-11).
+ * @param firstDayOfWeek - The first day of the week (0-6, where 0 is Sunday).
+ * @returns An array of week objects containing week numbers and day details.
+ */
 export declare const getMonthDetails: (year: number, month: number, firstDayOfWeek: number) => {
     weekNumber?: number;
     days: {
@@ -19,14 +85,113 @@ export declare const getMonthDetails: (year: number, month: number, firstDayOfWe
         month: string;
     }[];
 }[];
-export declare const isDisableDateInRange: (startDate?: Date | null, endDate?: Date | null, disabledDates?: DisabledDate | DisabledDate[]) => boolean;
+/**
+ * Checks if a date is disabled based on the 'date' period type.
+ * @param date - The date to check.
+ * @param min - Minimum allowed date.
+ * @param max - Maximum allowed date.
+ * @param disabledDates - Criteria for disabled dates.
+ * @returns True if the date is disabled, false otherwise.
+ */
 export declare const isDateDisabled: (date: Date, min?: Date | null, max?: Date | null, disabledDates?: DisabledDate | DisabledDate[]) => boolean;
-export declare const isDateInRange: (date: Date, start: Date | null, end: Date | null) => boolean | null;
-export declare const isDateSelected: (date: Date, start: Date | null, end: Date | null) => boolean | null;
-export declare const isEndDate: (date: Date, start: Date | null, end: Date | null) => boolean | null;
-export declare const isLastDayOfMonth: (date: Date) => boolean;
+/**
+ * Checks if a date is within a specified range.
+ * @param date - The date to check.
+ * @param start - Start date of the range.
+ * @param end - End date of the range.
+ * @returns True if the date is within the range, false otherwise.
+ */
+export declare const isDateInRange: (date: Date, start: Date | null, end: Date | null) => boolean;
+/**
+ * Checks if a date is selected based on start and end dates.
+ * @param date - The date to check.
+ * @param start - Start date.
+ * @param end - End date.
+ * @returns True if the date is selected, false otherwise.
+ */
+export declare const isDateSelected: (date: Date, start: Date | null, end: Date | null) => boolean;
+/**
+ * Determines if any date within a range is disabled.
+ * @param startDate - Start date of the range.
+ * @param endDate - End date of the range.
+ * @param disabledDates - Criteria for disabled dates.
+ * @returns True if any date in the range is disabled, false otherwise.
+ */
+export declare const isDisableDateInRange: (startDate?: Date | null, endDate?: Date | null, disabledDates?: DisabledDate | DisabledDate[]) => boolean;
+/**
+ * Checks if a month is disabled based on the 'month' period type.
+ * @param date - The date representing the month to check.
+ * @param min - Minimum allowed date.
+ * @param max - Maximum allowed date.
+ * @param disabledDates - Criteria for disabled dates.
+ * @returns True if the month is disabled, false otherwise.
+ */
+export declare const isMonthDisabled: (date: Date, min?: Date | null, max?: Date | null, disabledDates?: DisabledDate | DisabledDate[]) => boolean;
+/**
+ * Checks if a month is selected based on start and end dates.
+ * @param date - The date representing the month.
+ * @param start - Start date.
+ * @param end - End date.
+ * @returns True if the month is selected, false otherwise.
+ */
+export declare const isMonthSelected: (date: Date, start: Date | null, end: Date | null) => boolean;
+/**
+ * Checks if a month is within a specified range.
+ * @param date - The date representing the month.
+ * @param start - Start date.
+ * @param end - End date.
+ * @returns True if the month is within the range, false otherwise.
+ */
+export declare const isMonthInRange: (date: Date, start: Date | null, end: Date | null) => boolean;
+/**
+ * Checks if two dates are the same calendar date.
+ * @param date - First date.
+ * @param date2 - Second date.
+ * @returns True if both dates are the same, false otherwise.
+ */
 export declare const isSameDateAs: (date: Date | null, date2: Date | null) => boolean;
-export declare const isStartDate: (date: Date, start: Date | null, end: Date | null) => boolean | null;
+/**
+ * Checks if a date is today.
+ * @param date - The date to check.
+ * @returns True if the date is today, false otherwise.
+ */
 export declare const isToday: (date: Date) => boolean;
-export declare const isValidDate: (date: string) => number | false;
+/**
+ * Checks if a year is disabled based on the 'year' period type.
+ * @param date - The date representing the year to check.
+ * @param min - Minimum allowed date.
+ * @param max - Maximum allowed date.
+ * @param disabledDates - Criteria for disabled dates.
+ * @returns True if the year is disabled, false otherwise.
+ */
+export declare const isYearDisabled: (date: Date, min?: Date | null, max?: Date | null, disabledDates?: DisabledDate | DisabledDate[]) => boolean;
+/**
+ * Checks if a year is selected based on start and end dates.
+ * @param date - The date representing the year.
+ * @param start - Start date.
+ * @param end - End date.
+ * @returns True if the year matches the start's or end's year, false otherwise.
+ */
+export declare const isYearSelected: (date: Date, start: Date | null, end: Date | null) => boolean;
+/**
+ * Checks if a year is within a specified range.
+ * @param date - The date representing the year.
+ * @param start - Start date.
+ * @param end - End date.
+ * @returns True if the year's value lies between start's year and end's year, false otherwise.
+ */
+export declare const isYearInRange: (date: Date, start: Date | null, end: Date | null) => boolean;
+/**
+ * Removes the time component from a Date object.
+ * @param date - The original date.
+ * @returns A new Date object with the time set to 00:00:00.
+ */
 export declare const removeTimeFromDate: (date: Date) => Date;
+/**
+ * Copies the time (hours, minutes, seconds, milliseconds) from one Date to another.
+ *
+ * @param {Date} target - The date whose time will be updated.
+ * @param {Date | null} source - The date to copy the time from.
+ * @returns {Date} A new Date instance with the date from `target` and time from `source`.
+ */
+export declare const setTimeFromDate: (target: Date, source: Date | null) => Date;

package/dist/esm/components/calendar/utils.js

@@ -1,11 +1,20 @@
+/**
+ * Converts an ISO week string to a Date object representing the Monday of that week.
+ * @param isoWeek - The ISO week string (e.g., "2023W05" or "2023w05").
+ * @returns The Date object for the Monday of the specified week, or null if invalid.
+ */
 const convertIsoWeekToDate = (isoWeek) => {
-    const [year, week] = isoWeek.split(/w/i);
-    // Get date for 4th of January for year
-    const date = new Date(Number(year), 0, 4);
-    // Get previous Monday, add 7 days for each week after first
+    const [year, week] = isoWeek.split(/[Ww]/);
+    const date = new Date(Number(year), 0, 4); // 4th Jan is always in week 1
     date.setDate(date.getDate() - (date.getDay() || 7) + 1 + (Number(week) - 1) * 7);
     return date;
 };
+/**
+ * Converts a date string or Date object to a Date object based on selection type.
+ * @param date - The date to convert.
+ * @param selectionType - The type of selection ('day', 'week', 'month', 'year').
+ * @returns The corresponding Date object or null if invalid.
+ */
 const convertToDateObject = (date, selectionType) => {
     if (date instanceof Date) {
         return date;
@@ -20,12 +29,25 @@ const convertToDateObject = (date, selectionType) => {
     }
     return new Date(Date.parse(date));
 };
+/**
+ * Creates groups from an array.
+ * @param arr - The array to group.
+ * @param numberOfGroups - Number of groups to create.
+ * @returns An array of grouped arrays.
+ */
 const createGroupsInArray = (arr, numberOfGroups) => {
     const perGroup = Math.ceil(arr.length / numberOfGroups);
     return Array.from({ length: numberOfGroups })
         .fill('')
         .map((_, i) => arr.slice(i * perGroup, (i + 1) * perGroup));
 };
+/**
+ * Adjusts the calendar date based on order and view type.
+ * @param calendarDate - The current calendar date.
+ * @param order - The order to adjust by.
+ * @param view - The current view type.
+ * @returns The adjusted Date object.
+ */
 const getCalendarDate = (calendarDate, order, view) => {
     if (order !== 0 && view === 'days') {
         return new Date(calendarDate.getFullYear(), calendarDate.getMonth() + order, 1);
@@ -38,6 +60,12 @@ const getCalendarDate = (calendarDate, order, view) => {
     }
     return calendarDate;
 };
+/**
+ * Formats a date based on the selection type.
+ * @param date - The date to format.
+ * @param selectionType - The type of selection ('day', 'week', 'month', 'year').
+ * @returns A formatted date string or the original Date object.
+ */
 const getDateBySelectionType = (date, selectionType) => {
     if (date === null) {
         return null;
@@ -54,23 +82,42 @@ const getDateBySelectionType = (date, selectionType) => {
     }
     return date;
 };
-const getMonthsNames = (locale) => {
-    const months = [];
-    const d = new Date();
-    d.setDate(1);
-    for (let i = 0; i < 12; i++) {
-        d.setMonth(i);
-        months.push(d.toLocaleString(locale, { month: 'short' }));
-    }
-    return months;
+/**
+ * Retrieves an array of month names based on locale and format.
+ * @param locale - The locale string (e.g., 'en-US').
+ * @param format - The format of the month names ('short' or 'long').
+ * @returns An array of month names.
+ */
+const getMonthsNames = (locale, format = 'short') => {
+    return Array.from({ length: 12 }, (_, i) => {
+        return new Date(2000, i, 1).toLocaleString(locale, { month: format });
+    });
 };
-const getYears = (year) => {
-    const years = [];
-    for (let _year = year - 6; _year < year + 6; _year++) {
-        years.push(_year);
-    }
-    return years;
+/**
+ * Retrieves an array of selectable dates from the given element.
+ * @param element - The HTML element to search for selectable dates.
+ * @param selector - The CSS selector used to identify selectable dates. Defaults to 'tr[tabindex="0"], td[tabindex="0"]'.
+ * @returns An array of HTMLElements representing the selectable dates.
+ */
+const getSelectableDates = (element, selector = 'tr[tabindex="0"], td[tabindex="0"]') => {
+    return [...Element.prototype.querySelectorAll.call(element, selector)];
 };
+/**
+ * Generates an array of years centered around a given year.
+ * @param year - The central year.
+ * @param range - The number of years before and after the central year.
+ * @returns An array of years.
+ */
+const getYears = (year, range = 6) => {
+    return Array.from({ length: range * 2 }, (_, i) => year - range + i);
+};
+/**
+ * Retrieves leading days (from the previous month) for a calendar view.
+ * @param year - The year.
+ * @param month - The month (0-11).
+ * @param firstDayOfWeek - The first day of the week (0-6, where 0 is Sunday).
+ * @returns An array of leading day objects.
+ */
 const getLeadingDays = (year, month, firstDayOfWeek) => {
     // 0: sunday
     // 1: monday
@@ -91,6 +138,12 @@ const getLeadingDays = (year, month, firstDayOfWeek) => {
     }
     return dates;
 };
+/**
+ * Retrieves all days within a specific month.
+ * @param year - The year.
+ * @param month - The month (0-11).
+ * @returns An array of day objects.
+ */
 const getMonthDays = (year, month) => {
     const dates = [];
     const lastDay = new Date(year, month + 1, 0).getDate();
@@ -102,6 +155,14 @@ const getMonthDays = (year, month) => {
     }
     return dates;
 };
+/**
+ * Retrieves trailing days (from the next month) for a calendar view.
+ * @param year - The year.
+ * @param month - The month (0-11).
+ * @param leadingDays - Array of leading day objects.
+ * @param monthDays - Array of current month day objects.
+ * @returns An array of trailing day objects.
+ */
 const getTrailingDays = (year, month, leadingDays, monthDays) => {
     const dates = [];
     const days = 42 - (leadingDays.length + monthDays.length);
@@ -113,11 +174,28 @@ const getTrailingDays = (year, month, leadingDays, monthDays) => {
     }
     return dates;
 };
+/**
+ * Calculates the ISO week number for a given date.
+ * @param date - The date to calculate the week number for.
+ * @returns The ISO week number.
+ */
 const getWeekNumber = (date) => {
-    const week1 = new Date(date.getFullYear(), 0, 4);
-    return (1 +
-        Math.round(((date.getTime() - week1.getTime()) / 86_400_000 - 3 + ((week1.getDay() + 6) % 7)) / 7));
+    const tempDate = new Date(date.getTime());
+    tempDate.setHours(0, 0, 0, 0);
+    // Thursday in current week decides the year
+    tempDate.setDate(tempDate.getDate() + 3 - ((tempDate.getDay() + 6) % 7));
+    const week1 = new Date(tempDate.getFullYear(), 0, 4);
+    // Calculate full weeks to the date
+    const weekNumber = 1 + Math.round((tempDate.getTime() - week1.getTime()) / 86_400_000 / 7);
+    return weekNumber;
 };
+/**
+ * Retrieves detailed information about each week in a month for calendar rendering.
+ * @param year - The year.
+ * @param month - The month (0-11).
+ * @param firstDayOfWeek - The first day of the week (0-6, where 0 is Sunday).
+ * @returns An array of week objects containing week numbers and day details.
+ */
 const getMonthDetails = (year, month, firstDayOfWeek) => {
     const daysPrevMonth = getLeadingDays(year, month, firstDayOfWeek);
     const daysThisMonth = getMonthDays(year, month);
@@ -137,21 +215,14 @@ const getMonthDetails = (year, month, firstDayOfWeek) => {
     });
     return weeks;
 };
-const isDisableDateInRange = (startDate, endDate, disabledDates) => {
-    if (startDate && endDate) {
-        const date = new Date(startDate);
-        let disabled = false;
-        while (date < endDate) {
-            date.setDate(date.getDate() + 1);
-            if (isDateDisabled(date, null, null, disabledDates)) {
-                disabled = true;
-                break;
-            }
-        }
-        return disabled;
-    }
-    return false;
-};
+/**
+ * Checks if a date is disabled based on the 'date' period type.
+ * @param date - The date to check.
+ * @param min - Minimum allowed date.
+ * @param max - Maximum allowed date.
+ * @param disabledDates - Criteria for disabled dates.
+ * @returns True if the date is disabled, false otherwise.
+ */
 const isDateDisabled = (date, min, max, disabledDates) => {
     if (min && date < min) {
         return true;
@@ -159,6 +230,9 @@ const isDateDisabled = (date, min, max, disabledDates) => {
     if (max && date > max) {
         return true;
     }
+    if (disabledDates === undefined) {
+        return false;
+    }
     if (typeof disabledDates === 'function') {
         return disabledDates(date);
     }
@@ -180,15 +254,128 @@ const isDateDisabled = (date, min, max, disabledDates) => {
     }
     return false;
 };
+/**
+ * Checks if a date is within a specified range.
+ * @param date - The date to check.
+ * @param start - Start date of the range.
+ * @param end - End date of the range.
+ * @returns True if the date is within the range, false otherwise.
+ */
 const isDateInRange = (date, start, end) => {
     const _date = removeTimeFromDate(date);
     const _start = start ? removeTimeFromDate(start) : null;
     const _end = end ? removeTimeFromDate(end) : null;
-    return _start && _end && _start <= _date && _date <= _end;
+    return !!(_start && _end && _start <= _date && _date <= _end);
 };
+/**
+ * Checks if a date is selected based on start and end dates.
+ * @param date - The date to check.
+ * @param start - Start date.
+ * @param end - End date.
+ * @returns True if the date is selected, false otherwise.
+ */
 const isDateSelected = (date, start, end) => {
-    return (start && isSameDateAs(start, date)) || (end && isSameDateAs(end, date));
+    if (start !== null && isSameDateAs(start, date)) {
+        return true;
+    }
+    if (end !== null && isSameDateAs(end, date)) {
+        return true;
+    }
+    return false;
 };
+/**
+ * Determines if any date within a range is disabled.
+ * @param startDate - Start date of the range.
+ * @param endDate - End date of the range.
+ * @param disabledDates - Criteria for disabled dates.
+ * @returns True if any date in the range is disabled, false otherwise.
+ */
+const isDisableDateInRange = (startDate, endDate, disabledDates) => {
+    if (startDate && endDate) {
+        const date = new Date(startDate);
+        let disabled = false;
+        while (date < endDate) {
+            date.setDate(date.getDate() + 1);
+            if (isDateDisabled(date, null, null, disabledDates)) {
+                disabled = true;
+                break;
+            }
+        }
+        return disabled;
+    }
+    return false;
+};
+/**
+ * Checks if a month is disabled based on the 'month' period type.
+ * @param date - The date representing the month to check.
+ * @param min - Minimum allowed date.
+ * @param max - Maximum allowed date.
+ * @param disabledDates - Criteria for disabled dates.
+ * @returns True if the month is disabled, false otherwise.
+ */
+const isMonthDisabled = (date, min, max, disabledDates) => {
+    const current = date.getFullYear() * 12 + date.getMonth();
+    const _min = min ? min.getFullYear() * 12 + min.getMonth() : null;
+    const _max = max ? max.getFullYear() * 12 + max.getMonth() : null;
+    if (_min && current < _min) {
+        return true;
+    }
+    if (_max && current > _max) {
+        return true;
+    }
+    if (disabledDates === undefined) {
+        return false;
+    }
+    const start = min ? Math.max(date.getTime(), min.getTime()) : date;
+    const end = max
+        ? Math.min(date.getTime(), max.getTime())
+        : new Date(new Date().getFullYear(), 11, 31);
+    for (const currentDate = new Date(start); currentDate <= end; currentDate.setDate(currentDate.getDate() + 1)) {
+        if (!isDateDisabled(currentDate, min, max, disabledDates)) {
+            return false;
+        }
+    }
+    return false;
+};
+/**
+ * Checks if a month is selected based on start and end dates.
+ * @param date - The date representing the month.
+ * @param start - Start date.
+ * @param end - End date.
+ * @returns True if the month is selected, false otherwise.
+ */
+const isMonthSelected = (date, start, end) => {
+    const year = date.getFullYear();
+    const month = date.getMonth();
+    if (start !== null && year === start.getFullYear() && month === start.getMonth()) {
+        return true;
+    }
+    if (end !== null && year === end.getFullYear() && month === end.getMonth()) {
+        return true;
+    }
+    return false;
+};
+/**
+ * Checks if a month is within a specified range.
+ * @param date - The date representing the month.
+ * @param start - Start date.
+ * @param end - End date.
+ * @returns True if the month is within the range, false otherwise.
+ */
+const isMonthInRange = (date, start, end) => {
+    const year = date.getFullYear();
+    const month = date.getMonth();
+    const _start = start ? start.getFullYear() * 12 + start.getMonth() : null;
+    const _end = end ? end.getFullYear() * 12 + end.getMonth() : null;
+    const _date = year * 12 + month;
+    return !!(_start && _end && _start <= _date && _date <= _end);
+};
+/**
+ * Checks if two dates are the same calendar date.
+ * @param date - First date.
+ * @param date2 - Second date.
+ * @returns True if both dates are the same, false otherwise.
+ */
 const isSameDateAs = (date, date2) => {
     if (date instanceof Date && date2 instanceof Date) {
         return (date.getDate() === date2.getDate() &&
@@ -200,13 +387,102 @@ const isSameDateAs = (date, date2) => {
     }
     return false;
 };
+/**
+ * Checks if a date is today.
+ * @param date - The date to check.
+ * @returns True if the date is today, false otherwise.
+ */
 const isToday = (date) => {
     const today = new Date();
-    return (date.getDate() === today.getDate() &&
-        date.getMonth() === today.getMonth() &&
-        date.getFullYear() === today.getFullYear());
+    return isSameDateAs(date, today);
+};
+/**
+ * Checks if a year is disabled based on the 'year' period type.
+ * @param date - The date representing the year to check.
+ * @param min - Minimum allowed date.
+ * @param max - Maximum allowed date.
+ * @param disabledDates - Criteria for disabled dates.
+ * @returns True if the year is disabled, false otherwise.
+ */
+const isYearDisabled = (date, min, max, disabledDates) => {
+    const year = date.getFullYear();
+    const minYear = min ? min.getFullYear() : null;
+    const maxYear = max ? max.getFullYear() : null;
+    if (minYear && year < minYear) {
+        return true;
+    }
+    if (maxYear && year > maxYear) {
+        return true;
+    }
+    if (disabledDates === undefined) {
+        return false;
+    }
+    const start = min ? Math.max(date.getTime(), min.getTime()) : date;
+    const end = max
+        ? Math.min(date.getTime(), max.getTime())
+        : new Date(new Date().getFullYear(), 11, 31);
+    for (const currentDate = new Date(start); currentDate <= end; currentDate.setDate(currentDate.getDate() + 1)) {
+        if (!isDateDisabled(currentDate, min, max, disabledDates)) {
+            return false;
+        }
+    }
+    return false;
+};
+/**
+ * Checks if a year is selected based on start and end dates.
+ * @param date - The date representing the year.
+ * @param start - Start date.
+ * @param end - End date.
+ * @returns True if the year matches the start's or end's year, false otherwise.
+ */
+const isYearSelected = (date, start, end) => {
+    const year = date.getFullYear();
+    if (start !== null && year === start.getFullYear()) {
+        return true;
+    }
+    if (end !== null && year === end.getFullYear()) {
+        return true;
+    }
+    return false;
+};
+/**
+ * Checks if a year is within a specified range.
+ * @param date - The date representing the year.
+ * @param start - Start date.
+ * @param end - End date.
+ * @returns True if the year's value lies between start's year and end's year, false otherwise.
+ */
+const isYearInRange = (date, start, end) => {
+    const year = date.getFullYear();
+    const _start = start ? start.getFullYear() : null;
+    const _end = end ? end.getFullYear() : null;
+    return !!(_start && _end && _start <= year && year <= _end);
+};
+/**
+ * Removes the time component from a Date object.
+ * @param date - The original date.
+ * @returns A new Date object with the time set to 00:00:00.
+ */
+const removeTimeFromDate = (date) => {
+    const clearedDate = new Date(date);
+    clearedDate.setHours(0, 0, 0, 0);
+    return clearedDate;
+};
+/**
+ * Copies the time (hours, minutes, seconds, milliseconds) from one Date to another.
+ *
+ * @param {Date} target - The date whose time will be updated.
+ * @param {Date | null} source - The date to copy the time from.
+ * @returns {Date} A new Date instance with the date from `target` and time from `source`.
+ */
+const setTimeFromDate = (target, source) => {
+    if (!(source instanceof Date)) {
+        return target;
+    }
+    const result = new Date(target); // create a copy to avoid mutation
+    result.setHours(source.getHours(), source.getMinutes(), source.getSeconds(), source.getMilliseconds());
+    return result;
 };
-const removeTimeFromDate = (date) => new Date(date.getFullYear(), date.getMonth(), date.getDate());
 
-export { convertIsoWeekToDate, convertToDateObject, createGroupsInArray, getCalendarDate, getDateBySelectionType, getMonthDetails, getMonthsNames, getWeekNumber, getYears, isDateDisabled, isDateInRange, isDateSelected, isDisableDateInRange, isSameDateAs, isToday, removeTimeFromDate };
+export { convertIsoWeekToDate, convertToDateObject, createGroupsInArray, getCalendarDate, getDateBySelectionType, getMonthDetails, getMonthsNames, getSelectableDates, getWeekNumber, getYears, isDateDisabled, isDateInRange, isDateSelected, isDisableDateInRange, isMonthDisabled, isMonthInRange, isMonthSelected, isSameDateAs, isToday, isYearDisabled, isYearInRange, isYearSelected, removeTimeFromDate, setTimeFromDate };
 //# sourceMappingURL=utils.js.map