igniteui-webcomponents 6.4.0 → 6.5.0

package/components/calendar/helpers.js

@@ -1,10 +1,13 @@
-import { asNumber, findElementFromEventPath, first, isEmpty, isString, last, modulo, } from '../common/util.js';
-import { CalendarDay, daysInWeek, toCalendarDay, } from './model.js';
+import { asNumber, findElementFromEventPath, first, isString, last, modulo, } from '../common/util.js';
+import { CalendarDay, DAYS_IN_WEEK, toCalendarDay, } from './model.js';
 import { DateRangeType, } from './types.js';
 export const MONTHS_PER_ROW = 3;
 export const YEARS_PER_ROW = 3;
 export const YEARS_PER_PAGE = 15;
-const DaysMap = {
+const CALENDAR_CELLS = 42;
+const ISO_DATE_PATTERN = /^\d{4}/;
+const TIME_PATTERN = /^\d{2}/;
+const WEEK_DAYS_MAP = {
     sunday: 0,
     monday: 1,
     tuesday: 2,
@@ -17,13 +20,13 @@ export function isValidDate(date) {
     return Number.isNaN(date.valueOf()) ? null : date;
 }
 export function parseISODate(string) {
-    if (/^\d{4}/.test(string)) {
-        const time = !string.includes('T') ? 'T00:00:00' : '';
-        return isValidDate(new Date(`${string}${time}`));
+    if (ISO_DATE_PATTERN.test(string)) {
+        const timeComponent = !string.includes('T') ? 'T00:00:00' : '';
+        return isValidDate(new Date(`${string}${timeComponent}`));
     }
-    if (/^\d{2}/.test(string)) {
-        const date = first(new Date().toISOString().split('T'));
-        return isValidDate(new Date(`${date}T${string}`));
+    if (TIME_PATTERN.test(string)) {
+        const today = first(new Date().toISOString().split('T'));
+        return isValidDate(new Date(`${today}T${string}`));
     }
     return null;
 }
@@ -56,9 +59,10 @@ export function convertToDates(value) {
         return null;
     }
     const values = [];
-    const iterator = isString(value) ? value.split(',') : value;
-    for (const each of iterator) {
-        const date = convertToDate(isString(each) ? each.trim() : each);
+    const sources = isString(value) ? value.split(',') : value;
+    for (const source of sources) {
+        const trimmed = isString(source) ? source.trim() : source;
+        const date = convertToDate(trimmed);
         if (date) {
             values.push(date);
         }
@@ -70,18 +74,21 @@ export function getViewElement(event) {
     return element ? asNumber(element.dataset.value, -1) : -1;
 }
 export function getWeekDayNumber(value) {
-    return DaysMap[value];
+    return WEEK_DAYS_MAP[value];
 }
 export function areSameMonth(first, second) {
-    const [a, b] = [toCalendarDay(first), toCalendarDay(second)];
+    const a = toCalendarDay(first);
+    const b = toCalendarDay(second);
     return a.year === b.year && a.month === b.month;
 }
 export function isNextMonth(target, origin) {
-    const [a, b] = [toCalendarDay(target), toCalendarDay(origin)];
+    const a = toCalendarDay(target);
+    const b = toCalendarDay(origin);
     return a.year === b.year ? a.month > b.month : a.year > b.year;
 }
 export function isPreviousMonth(target, origin) {
-    const [a, b] = [toCalendarDay(target), toCalendarDay(origin)];
+    const a = toCalendarDay(target);
+    const b = toCalendarDay(origin);
     return a.year === b.year ? a.month < b.month : a.year < b.year;
 }
 export function* calendarRange(options) {
@@ -110,10 +117,10 @@ export function* calendarRange(options) {
 export function* generateMonth(value, firstWeekDay) {
     const { year, month } = toCalendarDay(value);
     const start = new CalendarDay({ year, month });
-    const offset = modulo(start.day - firstWeekDay, daysInWeek);
+    const offset = modulo(start.day - firstWeekDay, DAYS_IN_WEEK);
     yield* calendarRange({
         start: start.add('day', -offset),
-        end: 42,
+        end: CALENDAR_CELLS,
     });
 }
 export function getYearRange(current, range) {
@@ -124,23 +131,28 @@ export function getYearRange(current, range) {
 export function isDateInRanges(date, ranges) {
     const value = toCalendarDay(date);
     return ranges.some((range) => {
-        const days = (range.dateRange ?? []).map((day) => toCalendarDay(day));
+        if (!range.dateRange?.length) {
+            return range.type === DateRangeType.Weekdays
+                ? !value.weekend
+                : range.type === DateRangeType.Weekends
+                    ? value.weekend
+                    : false;
+        }
+        const days = range.dateRange.map((day) => toCalendarDay(day));
+        const firstDay = first(days);
         switch (range.type) {
             case DateRangeType.After:
-                return value.greaterThan(first(days));
+                return value.greaterThan(firstDay);
             case DateRangeType.Before:
-                return value.lessThan(first(days));
+                return value.lessThan(firstDay);
             case DateRangeType.Between: {
-                const min = Math.min(first(days).timestamp, last(days).timestamp);
-                const max = Math.max(first(days).timestamp, last(days).timestamp);
+                const lastDay = last(days);
+                const min = Math.min(firstDay.timestamp, lastDay.timestamp);
+                const max = Math.max(firstDay.timestamp, lastDay.timestamp);
                 return value.timestamp >= min && value.timestamp <= max;
             }
             case DateRangeType.Specific:
                 return days.some((day) => day.equalTo(value));
-            case DateRangeType.Weekdays:
-                return !value.weekend;
-            case DateRangeType.Weekends:
-                return value.weekend;
             default:
                 return false;
         }
@@ -161,6 +173,6 @@ export function createDateConstraints(min, max, disabledDates) {
         });
     }
     constraints.push(...(disabledDates ?? []));
-    return !isEmpty(constraints) ? constraints : undefined;
+    return constraints.length > 0 ? constraints : undefined;
 }
 //# sourceMappingURL=helpers.js.map

package/components/calendar/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/components/calendar/helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  asNumber,\n  findElementFromEventPath,\n  first,\n  isEmpty,\n  isString,\n  last,\n  modulo,\n} from '../common/util.js';\nimport type { DateRangeValue } from '../date-range-picker/date-range-picker.js';\nimport {\n  CalendarDay,\n  type CalendarRangeParams,\n  type DayParameter,\n  daysInWeek,\n  toCalendarDay,\n} from './model.js';\nimport {\n  type DateRangeDescriptor,\n  DateRangeType,\n  type WeekDays,\n} from './types.js';\n\n/* Constants */\n\nexport const MONTHS_PER_ROW = 3;\nexport const YEARS_PER_ROW = 3;\nexport const YEARS_PER_PAGE = 15;\n\nconst DaysMap = {\n  sunday: 0,\n  monday: 1,\n  tuesday: 2,\n  wednesday: 3,\n  thursday: 4,\n  friday: 5,\n  saturday: 6,\n};\n\n/* Converter functions */\n\nexport function isValidDate(date: Date) {\n  return Number.isNaN(date.valueOf()) ? null : date;\n}\n\nexport function parseISODate(string: string) {\n  if (/^\\d{4}/.test(string)) {\n    const time = !string.includes('T') ? 'T00:00:00' : '';\n    return isValidDate(new Date(`${string}${time}`));\n  }\n\n  if (/^\\d{2}/.test(string)) {\n    const date = first(new Date().toISOString().split('T'));\n    return isValidDate(new Date(`${date}T${string}`));\n  }\n\n  return null;\n}\n\n/**\n * Converts the given value to a Date object.\n *\n * If the value is already a valid Date object, it is returned directly.\n * If the value is a string, it is parsed into a Date object.\n * If the value is null or undefined, null is returned.\n * If the parsing fails, null is returned.\n */\nexport function convertToDate(value?: Date | string | null): Date | null {\n  if (!value) {\n    return null;\n  }\n\n  return isString(value) ? parseISODate(value) : isValidDate(value);\n}\n\n/**\n * Converts the given value to a DateRangeValue object.\n *\n * If the value is already a valid DateRangeValue object, it is returned directly.\n * If the value is a string, it is parsed to object and returned if it fields are valid dates.\n * If the value is null or undefined, null is returned.\n * If the parsing fails, null is returned.\n */\nexport function convertToDateRange(\n  value?: DateRangeValue | string | null\n): DateRangeValue | null {\n  if (!value) {\n    return null;\n  }\n\n  if (isString(value)) {\n    const obj = JSON.parse(value);\n    const start = convertToDate(obj.start);\n    const end = convertToDate(obj.end);\n    return {\n      start: start ? CalendarDay.from(start).native : null,\n      end: end ? CalendarDay.from(end).native : null,\n    };\n  }\n  return value;\n}\n\n/**\n * Converts a Date object to an ISO 8601 string.\n *\n * If the `value` is a `Date` object, it is converted to an ISO 8601 string.\n * If the `value` is null or undefined, null is returned.\n */\nexport function getDateFormValue(value: Date | null) {\n  return value ? value.toISOString() : null;\n}\n\n/**\n * Converts a comma-separated string of ISO 8601 dates or an array of Date objects | ISO 8601 strings into\n * an array of Date objects.\n *\n * If the `value` is null or undefined, null is returned.\n * If the `value` is an array of `Date` objects, a filtered array of valid `Date` objects is returned.\n * If the `value` is a string, it is split by commas and each part is parsed into a `Date` object.\n * If the parsing fails for any date, it is skipped.\n */\nexport function convertToDates(value?: (Date | string)[] | string | null) {\n  if (!value) {\n    return null;\n  }\n\n  const values: Date[] = [];\n  const iterator = isString(value) ? value.split(',') : value;\n\n  for (const each of iterator) {\n    const date = convertToDate(isString(each) ? each.trim() : each);\n    if (date) {\n      values.push(date);\n    }\n  }\n\n  return values;\n}\n\n/**\n * Returns the value of the selected/activated element (day/month/year) in the calendar view.\n */\nexport function getViewElement(event: Event) {\n  const element = findElementFromEventPath<HTMLElement>('[data-value]', event);\n  return element ? asNumber(element.dataset.value, -1) : -1;\n}\n\nexport function getWeekDayNumber(value: WeekDays) {\n  return DaysMap[value];\n}\n\nexport function areSameMonth(first: DayParameter, second: DayParameter) {\n  const [a, b] = [toCalendarDay(first), toCalendarDay(second)];\n  return a.year === b.year && a.month === b.month;\n}\n\nexport function isNextMonth(target: DayParameter, origin: DayParameter) {\n  const [a, b] = [toCalendarDay(target), toCalendarDay(origin)];\n  return a.year === b.year ? a.month > b.month : a.year > b.year;\n}\n\nexport function isPreviousMonth(target: DayParameter, origin: DayParameter) {\n  const [a, b] = [toCalendarDay(target), toCalendarDay(origin)];\n  return a.year === b.year ? a.month < b.month : a.year < b.year;\n}\n\n/**\n * Returns a generator yielding day values between `start` and `end` (non-inclusive by default)\n * by a given `unit` as a step.\n * To include the end date set the `inclusive` option to true.\n *\n * @remarks\n * By default, `unit` is set to 'day'.\n */\nexport function* calendarRange(\n  options: CalendarRangeParams\n): Generator<CalendarDay, void, unknown> {\n  const { start, end, unit = 'day', inclusive = false } = options;\n\n  let currentDate = toCalendarDay(start);\n  const endDate =\n    typeof end === 'number'\n      ? toCalendarDay(start).add(unit, end)\n      : toCalendarDay(end);\n\n  const isReversed = endDate.lessThan(currentDate);\n  const step = isReversed ? -1 : 1;\n\n  const shouldContinue = () => {\n    if (inclusive) {\n      return isReversed\n        ? currentDate.greaterThanOrEqual(endDate)\n        : currentDate.lessThanOrEqual(endDate);\n    }\n    return isReversed\n      ? currentDate.greaterThan(endDate)\n      : currentDate.lessThan(endDate);\n  };\n\n  while (shouldContinue()) {\n    yield currentDate;\n    currentDate = currentDate.add(unit, step);\n  }\n}\n\nexport function* generateMonth(value: DayParameter, firstWeekDay: number) {\n  const { year, month } = toCalendarDay(value);\n\n  const start = new CalendarDay({ year, month });\n  const offset = modulo(start.day - firstWeekDay, daysInWeek);\n  yield* calendarRange({\n    start: start.add('day', -offset),\n    end: 42,\n  });\n}\n\nexport function getYearRange(current: DayParameter, range: number) {\n  const year = toCalendarDay(current).year;\n  const start = Math.floor(year / range) * range;\n  return { start, end: start + range - 1 };\n}\n\nexport function isDateInRanges(\n  date: DayParameter,\n  ranges: DateRangeDescriptor[]\n) {\n  const value = toCalendarDay(date);\n\n  return ranges.some((range) => {\n    const days = (range.dateRange ?? []).map((day) => toCalendarDay(day));\n\n    switch (range.type) {\n      case DateRangeType.After:\n        return value.greaterThan(first(days));\n\n      case DateRangeType.Before:\n        return value.lessThan(first(days));\n\n      case DateRangeType.Between: {\n        const min = Math.min(first(days).timestamp, last(days).timestamp);\n        const max = Math.max(first(days).timestamp, last(days).timestamp);\n        return value.timestamp >= min && value.timestamp <= max;\n      }\n\n      case DateRangeType.Specific:\n        return days.some((day) => day.equalTo(value));\n\n      case DateRangeType.Weekdays:\n        return !value.weekend;\n\n      case DateRangeType.Weekends:\n        return value.weekend;\n\n      default:\n        return false;\n    }\n  });\n}\n\nexport function createDateConstraints(\n  min: Date | null,\n  max: Date | null,\n  disabledDates?: DateRangeDescriptor[]\n) {\n  const constraints: DateRangeDescriptor[] = [];\n\n  if (min) {\n    constraints.push({\n      type: DateRangeType.Before,\n      dateRange: [min],\n    });\n  }\n\n  if (max) {\n    constraints.push({\n      type: DateRangeType.After,\n      dateRange: [max],\n    });\n  }\n\n  constraints.push(...(disabledDates ?? []));\n\n  return !isEmpty(constraints) ? constraints : undefined;\n}\n"]}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/components/calendar/helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  asNumber,\n  findElementFromEventPath,\n  first,\n  isString,\n  last,\n  modulo,\n} from '../common/util.js';\nimport type { DateRangeValue } from '../date-range-picker/date-range-picker.js';\nimport {\n  CalendarDay,\n  type CalendarRangeParams,\n  DAYS_IN_WEEK,\n  type DayParameter,\n  toCalendarDay,\n} from './model.js';\nimport {\n  type DateRangeDescriptor,\n  DateRangeType,\n  type WeekDays,\n} from './types.js';\n\n/* Constants */\n\nexport const MONTHS_PER_ROW = 3;\nexport const YEARS_PER_ROW = 3;\nexport const YEARS_PER_PAGE = 15;\n\nconst CALENDAR_CELLS = 42; // 6 weeks × 7 days\nconst ISO_DATE_PATTERN = /^\\d{4}/;\nconst TIME_PATTERN = /^\\d{2}/;\nconst WEEK_DAYS_MAP = {\n  sunday: 0,\n  monday: 1,\n  tuesday: 2,\n  wednesday: 3,\n  thursday: 4,\n  friday: 5,\n  saturday: 6,\n};\n\n/* Converter functions */\n\nexport function isValidDate(date: Date): Date | null {\n  return Number.isNaN(date.valueOf()) ? null : date;\n}\n\nexport function parseISODate(string: string): Date | null {\n  // ISO date format (YYYY-MM-DD)\n  if (ISO_DATE_PATTERN.test(string)) {\n    const timeComponent = !string.includes('T') ? 'T00:00:00' : '';\n    return isValidDate(new Date(`${string}${timeComponent}`));\n  }\n\n  // Time format (HH:MM:SS)\n  if (TIME_PATTERN.test(string)) {\n    const today = first(new Date().toISOString().split('T'));\n    return isValidDate(new Date(`${today}T${string}`));\n  }\n\n  return null;\n}\n\n/**\n * Converts the given value to a Date object.\n *\n * If the value is already a valid Date object, it is returned directly.\n * If the value is a string, it is parsed into a Date object.\n * If the value is null or undefined, null is returned.\n * If the parsing fails, null is returned.\n */\nexport function convertToDate(value?: Date | string | null): Date | null {\n  if (!value) {\n    return null;\n  }\n\n  return isString(value) ? parseISODate(value) : isValidDate(value);\n}\n\n/**\n * Converts the given value to a DateRangeValue object.\n *\n * If the value is already a valid DateRangeValue object, it is returned directly.\n * If the value is a string, it is parsed to object and returned if it fields are valid dates.\n * If the value is null or undefined, null is returned.\n * If the parsing fails, null is returned.\n */\nexport function convertToDateRange(\n  value?: DateRangeValue | string | null\n): DateRangeValue | null {\n  if (!value) {\n    return null;\n  }\n\n  if (isString(value)) {\n    const obj = JSON.parse(value);\n    const start = convertToDate(obj.start);\n    const end = convertToDate(obj.end);\n    return {\n      start: start ? CalendarDay.from(start).native : null,\n      end: end ? CalendarDay.from(end).native : null,\n    };\n  }\n  return value;\n}\n\n/**\n * Converts a Date object to an ISO 8601 string.\n *\n * If the `value` is a `Date` object, it is converted to an ISO 8601 string.\n * If the `value` is null or undefined, null is returned.\n */\nexport function getDateFormValue(value: Date | null): string | null {\n  return value ? value.toISOString() : null;\n}\n\n/**\n * Converts a comma-separated string of ISO 8601 dates or an array of Date objects | ISO 8601 strings into\n * an array of Date objects.\n *\n * If the `value` is null or undefined, null is returned.\n * If the `value` is an array of `Date` objects, a filtered array of valid `Date` objects is returned.\n * If the `value` is a string, it is split by commas and each part is parsed into a `Date` object.\n * If the parsing fails for any date, it is skipped.\n */\nexport function convertToDates(\n  value?: (Date | string)[] | string | null\n): Date[] | null {\n  if (!value) {\n    return null;\n  }\n\n  const values: Date[] = [];\n  const sources = isString(value) ? value.split(',') : value;\n\n  for (const source of sources) {\n    const trimmed = isString(source) ? source.trim() : source;\n    const date = convertToDate(trimmed);\n    if (date) {\n      values.push(date);\n    }\n  }\n\n  return values;\n}\n\n/**\n * Returns the value of the selected/activated element (day/month/year) in the calendar view.\n */\nexport function getViewElement(event: Event): number {\n  const element = findElementFromEventPath<HTMLElement>('[data-value]', event);\n  return element ? asNumber(element.dataset.value, -1) : -1;\n}\n\nexport function getWeekDayNumber(value: WeekDays): number {\n  return WEEK_DAYS_MAP[value];\n}\n\nexport function areSameMonth(\n  first: DayParameter,\n  second: DayParameter\n): boolean {\n  const a = toCalendarDay(first);\n  const b = toCalendarDay(second);\n  return a.year === b.year && a.month === b.month;\n}\n\nexport function isNextMonth(\n  target: DayParameter,\n  origin: DayParameter\n): boolean {\n  const a = toCalendarDay(target);\n  const b = toCalendarDay(origin);\n  return a.year === b.year ? a.month > b.month : a.year > b.year;\n}\n\nexport function isPreviousMonth(\n  target: DayParameter,\n  origin: DayParameter\n): boolean {\n  const a = toCalendarDay(target);\n  const b = toCalendarDay(origin);\n  return a.year === b.year ? a.month < b.month : a.year < b.year;\n}\n\n/**\n * Returns a generator yielding day values between `start` and `end` (non-inclusive by default)\n * by a given `unit` as a step.\n * To include the end date set the `inclusive` option to true.\n *\n * @remarks\n * By default, `unit` is set to 'day'.\n */\nexport function* calendarRange(\n  options: CalendarRangeParams\n): Generator<CalendarDay, void, unknown> {\n  const { start, end, unit = 'day', inclusive = false } = options;\n\n  let currentDate = toCalendarDay(start);\n  const endDate =\n    typeof end === 'number'\n      ? toCalendarDay(start).add(unit, end)\n      : toCalendarDay(end);\n\n  const isReversed = endDate.lessThan(currentDate);\n  const step = isReversed ? -1 : 1;\n\n  const shouldContinue = () => {\n    if (inclusive) {\n      return isReversed\n        ? currentDate.greaterThanOrEqual(endDate)\n        : currentDate.lessThanOrEqual(endDate);\n    }\n    return isReversed\n      ? currentDate.greaterThan(endDate)\n      : currentDate.lessThan(endDate);\n  };\n\n  while (shouldContinue()) {\n    yield currentDate;\n    currentDate = currentDate.add(unit, step);\n  }\n}\n\nexport function* generateMonth(\n  value: DayParameter,\n  firstWeekDay: number\n): Generator<CalendarDay, void, unknown> {\n  const { year, month } = toCalendarDay(value);\n\n  const start = new CalendarDay({ year, month });\n  const offset = modulo(start.day - firstWeekDay, DAYS_IN_WEEK);\n  yield* calendarRange({\n    start: start.add('day', -offset),\n    end: CALENDAR_CELLS,\n  });\n}\n\nexport function getYearRange(\n  current: DayParameter,\n  range: number\n): { start: number; end: number } {\n  const year = toCalendarDay(current).year;\n  const start = Math.floor(year / range) * range;\n  return { start, end: start + range - 1 };\n}\n\nexport function isDateInRanges(\n  date: DayParameter,\n  ranges: DateRangeDescriptor[]\n): boolean {\n  const value = toCalendarDay(date);\n\n  return ranges.some((range) => {\n    if (!range.dateRange?.length) {\n      return range.type === DateRangeType.Weekdays\n        ? !value.weekend\n        : range.type === DateRangeType.Weekends\n          ? value.weekend\n          : false;\n    }\n\n    const days = range.dateRange.map((day) => toCalendarDay(day));\n    const firstDay = first(days);\n\n    switch (range.type) {\n      case DateRangeType.After:\n        return value.greaterThan(firstDay);\n\n      case DateRangeType.Before:\n        return value.lessThan(firstDay);\n\n      case DateRangeType.Between: {\n        const lastDay = last(days);\n        const min = Math.min(firstDay.timestamp, lastDay.timestamp);\n        const max = Math.max(firstDay.timestamp, lastDay.timestamp);\n        return value.timestamp >= min && value.timestamp <= max;\n      }\n\n      case DateRangeType.Specific:\n        return days.some((day) => day.equalTo(value));\n\n      default:\n        return false;\n    }\n  });\n}\n\nexport function createDateConstraints(\n  min: Date | null,\n  max: Date | null,\n  disabledDates?: DateRangeDescriptor[]\n): DateRangeDescriptor[] | undefined {\n  const constraints: DateRangeDescriptor[] = [];\n\n  if (min) {\n    constraints.push({\n      type: DateRangeType.Before,\n      dateRange: [min],\n    });\n  }\n\n  if (max) {\n    constraints.push({\n      type: DateRangeType.After,\n      dateRange: [max],\n    });\n  }\n\n  constraints.push(...(disabledDates ?? []));\n\n  return constraints.length > 0 ? constraints : undefined;\n}\n"]}

package/components/calendar/model.d.ts

@@ -11,7 +11,7 @@ type CalendarDayParams = {
     month: number;
     date?: number;
 };
-export declare const daysInWeek = 7;
+export declare const DAYS_IN_WEEK = 7;
 export declare function toCalendarDay(date: DayParameter): CalendarDay;
 export declare class CalendarDay {
     private readonly _date;
@@ -29,7 +29,7 @@ export declare class CalendarDay {
      *  first < second // -1
      * ```
      */
-    static compare(first: DayParameter, second: DayParameter): 0 | 1 | -1;
+    static compare(first: DayParameter, second: DayParameter): number;
     constructor(args: CalendarDayParams);
     /** Returns a copy of this instance. */
     clone(): CalendarDay;
@@ -48,7 +48,13 @@ export declare class CalendarDay {
     get date(): number;
     /** Returns the timestamp since epoch in milliseconds. */
     get timestamp(): number;
-    /** Returns the current week number. */
+    /**
+     * Returns the ISO 8601 week number.
+     *
+     * @remarks
+     * Week 1 is the week containing the first Thursday of the year.
+     * Weeks start on Monday. Some years can have 53 weeks.
+     */
     get week(): number;
     /** Returns the underlying native date instance. */
     get native(): Date;

package/components/calendar/model.js

@@ -1,5 +1,7 @@
-export const daysInWeek = 7;
-const millisecondsInDay = 86400000;
+export const DAYS_IN_WEEK = 7;
+const MILLISECONDS_PER_DAY = 86400000;
+const WEEKDAY_MIN = 1;
+const WEEKDAY_MAX = 5;
 export function toCalendarDay(date) {
     return date instanceof Date ? CalendarDay.from(date) : date;
 }
@@ -35,13 +37,12 @@ export class CalendarDay {
         const year = args.year ?? this.year;
         const month = args.month ?? this.month;
         const date = args.date ?? this.date;
-        const temp = new Date(year, month, date);
-        if (date > 0 && temp.getMonth() !== month) {
-            return new CalendarDay({
-                year,
-                month,
-                date: new Date(year, month + 1, 0).getDate(),
-            });
+        if (date > 0) {
+            const temp = new Date(year, month, date);
+            if (temp.getMonth() !== month) {
+                const lastDayOfMonth = new Date(year, month + 1, 0).getDate();
+                return new CalendarDay({ year, month, date: lastDayOfMonth });
+            }
         }
         return new CalendarDay({ year, month, date });
     }
@@ -64,7 +65,7 @@ export class CalendarDay {
                 result._date.setDate(result.date + value);
                 return result;
             default:
-                throw new Error('Invalid interval');
+                throw new Error(`Invalid interval: ${unit}`);
         }
     }
     get day() {
@@ -83,30 +84,39 @@ export class CalendarDay {
         return this._date.getTime();
     }
     get week() {
-        const firstDay = new CalendarDay({ year: this.year, month: 0 }).timestamp;
-        const currentDay = (this.timestamp - firstDay + millisecondsInDay) / millisecondsInDay;
-        return Math.ceil(currentDay / daysInWeek);
+        const target = new Date(this._date);
+        const dayNum = target.getDay() || 7;
+        target.setDate(target.getDate() + 4 - dayNum);
+        const yearStart = new Date(target.getFullYear(), 0, 1);
+        const weekNo = Math.ceil(((target.getTime() - yearStart.getTime()) / MILLISECONDS_PER_DAY + 1) /
+            DAYS_IN_WEEK);
+        return weekNo;
     }
     get native() {
         return new Date(this._date);
     }
     get weekend() {
-        return this.day < 1 || this.day > 5;
+        return this.day < WEEKDAY_MIN || this.day > WEEKDAY_MAX;
     }
     equalTo(value) {
-        return this.timestamp === toCalendarDay(value).timestamp;
+        const other = toCalendarDay(value).timestamp;
+        return this.timestamp === other;
     }
     greaterThan(value) {
-        return this.timestamp > toCalendarDay(value).timestamp;
+        const other = toCalendarDay(value).timestamp;
+        return this.timestamp > other;
     }
     greaterThanOrEqual(value) {
-        return this.timestamp >= toCalendarDay(value).timestamp;
+        const other = toCalendarDay(value).timestamp;
+        return this.timestamp >= other;
     }
     lessThan(value) {
-        return this.timestamp < toCalendarDay(value).timestamp;
+        const other = toCalendarDay(value).timestamp;
+        return this.timestamp < other;
     }
     lessThanOrEqual(value) {
-        return this.timestamp <= toCalendarDay(value).timestamp;
+        const other = toCalendarDay(value).timestamp;
+        return this.timestamp <= other;
     }
     toString() {
         return `${this.native}`;

package/components/calendar/model.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../src/components/calendar/model.ts"],"names":[],"mappings":"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","sourcesContent":["export type DayParameter = CalendarDay | Date;\n\nexport type CalendarRangeParams = {\n  start: DayParameter;\n  end: DayParameter | number;\n  unit?: DayInterval;\n  inclusive?: boolean;\n};\n\ntype DayInterval = 'year' | 'quarter' | 'month' | 'week' | 'day';\n\ntype CalendarDayParams = {\n  year: number;\n  month: number;\n  date?: number;\n};\n\nexport const daysInWeek = 7;\nconst millisecondsInDay = 86400000;\n\nexport function toCalendarDay(date: DayParameter) {\n  return date instanceof Date ? CalendarDay.from(date) : date;\n}\n\nfunction checkRollover(original: CalendarDay, modified: CalendarDay) {\n  return original.date !== modified.date ? modified.set({ date: 0 }) : modified;\n}\n\n/* blazorSuppress */\nexport class CalendarDay {\n  private readonly _date: Date;\n\n  /** Constructs and returns the current day. */\n  public static get today() {\n    return CalendarDay.from(new Date());\n  }\n\n  /** Constructs a new CalendarDay instance from a Date object. */\n  public static from(date: Date) {\n    return new CalendarDay({\n      year: date.getFullYear(),\n      month: date.getMonth(),\n      date: date.getDate(),\n    });\n  }\n\n  /**\n   * Compares the date portion of two date objects.\n   *\n   * @returns\n   * ```\n   *  first === second // 0\n   *  first > second // 1\n   *  first < second // -1\n   * ```\n   */\n  public static compare(first: DayParameter, second: DayParameter) {\n    const a = toCalendarDay(first);\n    const b = toCalendarDay(second);\n\n    if (a.equalTo(b)) {\n      return 0;\n    }\n    return a.greaterThan(b) ? 1 : -1;\n  }\n\n  constructor(args: CalendarDayParams) {\n    this._date = new Date(args.year, args.month, args.date ?? 1);\n  }\n\n  /** Returns a copy of this instance. */\n  public clone() {\n    return CalendarDay.from(this._date);\n  }\n\n  /**\n   * Returns a new instance with values replaced.\n   */\n  public set(args: Partial<CalendarDayParams>) {\n    const year = args.year ?? this.year;\n    const month = args.month ?? this.month;\n    const date = args.date ?? this.date;\n\n    const temp = new Date(year, month, date);\n\n    if (date > 0 && temp.getMonth() !== month) {\n      return new CalendarDay({\n        year,\n        month,\n        date: new Date(year, month + 1, 0).getDate(),\n      });\n    }\n\n    return new CalendarDay({ year, month, date });\n  }\n\n  public add(unit: DayInterval, value: number) {\n    const result = this.clone();\n    switch (unit) {\n      case 'year':\n        result._date.setFullYear(result.year + value);\n        return checkRollover(this, result);\n      case 'quarter':\n        result._date.setMonth(result.month + 3 * value);\n        return checkRollover(this, result);\n      case 'month':\n        result._date.setMonth(result.month + value);\n        return checkRollover(this, result);\n      case 'week':\n        result._date.setDate(result.date + 7 * value);\n        return result;\n      case 'day':\n        result._date.setDate(result.date + value);\n        return result;\n      default:\n        throw new Error('Invalid interval');\n    }\n  }\n\n  /** Returns the day of the week (Sunday = 0). */\n  public get day() {\n    return this._date.getDay();\n  }\n\n  /** Returns the full year. */\n  public get year() {\n    return this._date.getFullYear();\n  }\n\n  /** Returns the month. */\n  public get month() {\n    return this._date.getMonth();\n  }\n\n  /** Returns the date */\n  public get date() {\n    return this._date.getDate();\n  }\n\n  /** Returns the timestamp since epoch in milliseconds. */\n  public get timestamp() {\n    return this._date.getTime();\n  }\n\n  /** Returns the current week number. */\n  public get week() {\n    const firstDay = new CalendarDay({ year: this.year, month: 0 }).timestamp;\n    const currentDay =\n      (this.timestamp - firstDay + millisecondsInDay) / millisecondsInDay;\n    return Math.ceil(currentDay / daysInWeek);\n  }\n\n  /** Returns the underlying native date instance. */\n  public get native() {\n    return new Date(this._date);\n  }\n\n  /**\n   * Whether the current date is a weekend day.\n   *\n   * @remarks\n   * This is naive, since it does not account for locale specifics.\n   */\n  public get weekend() {\n    return this.day < 1 || this.day > 5;\n  }\n\n  public equalTo(value: DayParameter) {\n    return this.timestamp === toCalendarDay(value).timestamp;\n  }\n\n  public greaterThan(value: DayParameter) {\n    return this.timestamp > toCalendarDay(value).timestamp;\n  }\n\n  public greaterThanOrEqual(value: DayParameter) {\n    return this.timestamp >= toCalendarDay(value).timestamp;\n  }\n\n  public lessThan(value: DayParameter) {\n    return this.timestamp < toCalendarDay(value).timestamp;\n  }\n\n  public lessThanOrEqual(value: DayParameter) {\n    return this.timestamp <= toCalendarDay(value).timestamp;\n  }\n\n  public toString() {\n    return `${this.native}`;\n  }\n}\n"]}
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../src/components/calendar/model.ts"],"names":[],"mappings":"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","sourcesContent":["export type DayParameter = CalendarDay | Date;\n\nexport type CalendarRangeParams = {\n  start: DayParameter;\n  end: DayParameter | number;\n  unit?: DayInterval;\n  inclusive?: boolean;\n};\n\ntype DayInterval = 'year' | 'quarter' | 'month' | 'week' | 'day';\n\ntype CalendarDayParams = {\n  year: number;\n  month: number;\n  date?: number;\n};\n\nexport const DAYS_IN_WEEK = 7;\nconst MILLISECONDS_PER_DAY = 86400000;\nconst WEEKDAY_MIN = 1; // Monday\nconst WEEKDAY_MAX = 5; // Friday\n\nexport function toCalendarDay(date: DayParameter): CalendarDay {\n  return date instanceof Date ? CalendarDay.from(date) : date;\n}\n\nfunction checkRollover(\n  original: CalendarDay,\n  modified: CalendarDay\n): CalendarDay {\n  return original.date !== modified.date ? modified.set({ date: 0 }) : modified;\n}\n\n/* blazorSuppress */\nexport class CalendarDay {\n  private readonly _date: Date;\n\n  /** Constructs and returns the current day. */\n  public static get today(): CalendarDay {\n    return CalendarDay.from(new Date());\n  }\n\n  /** Constructs a new CalendarDay instance from a Date object. */\n  public static from(date: Date): CalendarDay {\n    return new CalendarDay({\n      year: date.getFullYear(),\n      month: date.getMonth(),\n      date: date.getDate(),\n    });\n  }\n\n  /**\n   * Compares the date portion of two date objects.\n   *\n   * @returns\n   * ```\n   *  first === second // 0\n   *  first > second // 1\n   *  first < second // -1\n   * ```\n   */\n  public static compare(first: DayParameter, second: DayParameter): number {\n    const a = toCalendarDay(first);\n    const b = toCalendarDay(second);\n\n    if (a.equalTo(b)) {\n      return 0;\n    }\n    return a.greaterThan(b) ? 1 : -1;\n  }\n\n  constructor(args: CalendarDayParams) {\n    this._date = new Date(args.year, args.month, args.date ?? 1);\n  }\n\n  /** Returns a copy of this instance. */\n  public clone(): CalendarDay {\n    return CalendarDay.from(this._date);\n  }\n\n  /**\n   * Returns a new instance with values replaced.\n   */\n  public set(args: Partial<CalendarDayParams>): CalendarDay {\n    const year = args.year ?? this.year;\n    const month = args.month ?? this.month;\n    const date = args.date ?? this.date;\n\n    // Clamp date to the last day of the month if it exceeds the month's days\n    if (date > 0) {\n      const temp = new Date(year, month, date);\n      if (temp.getMonth() !== month) {\n        const lastDayOfMonth = new Date(year, month + 1, 0).getDate();\n        return new CalendarDay({ year, month, date: lastDayOfMonth });\n      }\n    }\n\n    return new CalendarDay({ year, month, date });\n  }\n\n  public add(unit: DayInterval, value: number): CalendarDay {\n    const result = this.clone();\n\n    switch (unit) {\n      case 'year':\n        result._date.setFullYear(result.year + value);\n        return checkRollover(this, result);\n      case 'quarter':\n        result._date.setMonth(result.month + 3 * value);\n        return checkRollover(this, result);\n      case 'month':\n        result._date.setMonth(result.month + value);\n        return checkRollover(this, result);\n      case 'week':\n        result._date.setDate(result.date + 7 * value);\n        return result;\n      case 'day':\n        result._date.setDate(result.date + value);\n        return result;\n      default:\n        throw new Error(`Invalid interval: ${unit}`);\n    }\n  }\n\n  /** Returns the day of the week (Sunday = 0). */\n  public get day(): number {\n    return this._date.getDay();\n  }\n\n  /** Returns the full year. */\n  public get year(): number {\n    return this._date.getFullYear();\n  }\n\n  /** Returns the month. */\n  public get month(): number {\n    return this._date.getMonth();\n  }\n\n  /** Returns the date */\n  public get date(): number {\n    return this._date.getDate();\n  }\n\n  /** Returns the timestamp since epoch in milliseconds. */\n  public get timestamp(): number {\n    return this._date.getTime();\n  }\n\n  /**\n   * Returns the ISO 8601 week number.\n   *\n   * @remarks\n   * Week 1 is the week containing the first Thursday of the year.\n   * Weeks start on Monday. Some years can have 53 weeks.\n   */\n  public get week(): number {\n    const target = new Date(this._date);\n\n    const dayNum = target.getDay() || 7;\n    target.setDate(target.getDate() + 4 - dayNum);\n\n    const yearStart = new Date(target.getFullYear(), 0, 1);\n\n    // Calculate full weeks to nearest Thursday\n    const weekNo = Math.ceil(\n      ((target.getTime() - yearStart.getTime()) / MILLISECONDS_PER_DAY + 1) /\n        DAYS_IN_WEEK\n    );\n\n    return weekNo;\n  }\n\n  /** Returns the underlying native date instance. */\n  public get native(): Date {\n    return new Date(this._date);\n  }\n\n  /**\n   * Whether the current date is a weekend day.\n   *\n   * @remarks\n   * This is naive, since it does not account for locale specifics.\n   */\n  public get weekend(): boolean {\n    return this.day < WEEKDAY_MIN || this.day > WEEKDAY_MAX;\n  }\n\n  public equalTo(value: DayParameter): boolean {\n    const other = toCalendarDay(value).timestamp;\n    return this.timestamp === other;\n  }\n\n  public greaterThan(value: DayParameter): boolean {\n    const other = toCalendarDay(value).timestamp;\n    return this.timestamp > other;\n  }\n\n  public greaterThanOrEqual(value: DayParameter): boolean {\n    const other = toCalendarDay(value).timestamp;\n    return this.timestamp >= other;\n  }\n\n  public lessThan(value: DayParameter): boolean {\n    const other = toCalendarDay(value).timestamp;\n    return this.timestamp < other;\n  }\n\n  public lessThanOrEqual(value: DayParameter): boolean {\n    const other = toCalendarDay(value).timestamp;\n    return this.timestamp <= other;\n  }\n\n  public toString(): string {\n    return `${this.native}`;\n  }\n}\n"]}

package/components/calendar/months-view/months-view.d.ts

@@ -1,4 +1,4 @@
-import { LitElement } from 'lit';
+import { LitElement, type TemplateResult } from 'lit';
 import type { Constructor } from '../../common/mixins/constructor.js';
 import { CalendarDay } from '../model.js';
 import type { IgcCalendarComponentEventMap } from '../types.js';
@@ -17,7 +17,7 @@ export default class IgcMonthsViewComponent extends IgcMonthsViewComponent_base
     static styles: import("lit").CSSResult;
     static register(): void;
     private _value;
-    private activeMonth;
+    private _activeMonth?;
     /** Тhe current value of the calendar. */
     set value(value: Date);
     get value(): Date;
@@ -25,15 +25,14 @@ export default class IgcMonthsViewComponent extends IgcMonthsViewComponent_base
     locale: string;
     /** The format of the month. Defaults to long. */
     monthFormat: 'numeric' | '2-digit' | 'long' | 'short' | 'narrow';
-    private get _monthOptions();
-    private _ariaMonthOptions;
     constructor();
+    /** @internal */
     connectedCallback(): void;
+    protected _handleInteraction(event: Event): void;
     /** Focuses the active date. */
     focusActiveDate(options?: FocusOptions): void;
-    protected handleInteraction(event: Event): void;
-    protected renderMonth(entry: CalendarDay, now: CalendarDay): import("lit-html").TemplateResult<1>;
-    protected render(): Generator<import("lit-html").TemplateResult<1>, void, unknown>;
+    protected _renderMonth(month: CalendarDay, now: CalendarDay, ariaFormatter: Intl.DateTimeFormat, labelFormatter: Intl.DateTimeFormat): TemplateResult;
+    protected render(): Generator<TemplateResult>;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/components/calendar/months-view/months-view.js

@@ -8,7 +8,6 @@ var IgcMonthsViewComponent_1;
 import { getDateFormatter } from 'igniteui-i18n-core';
 import { html, LitElement } from 'lit';
 import { property, query, state } from 'lit/decorators.js';
-import { range } from 'lit/directives/range.js';
 import { addThemingController } from '../../../theming/theming-controller.js';
 import { addKeybindings } from '../../common/controllers/key-bindings.js';
 import { blazorIndirectRender } from '../../common/decorators/blazorIndirectRender.js';
@@ -21,6 +20,7 @@ import { areSameMonth, getViewElement, MONTHS_PER_ROW } from '../helpers.js';
 import { CalendarDay } from '../model.js';
 import { all } from '../themes/year-month.js';
 import { styles } from '../themes/year-month-view.base.css.js';
+const MONTHS = Array.from({ length: 12 }, (_, i) => i);
 let IgcMonthsViewComponent = class IgcMonthsViewComponent extends EventEmitterMixin(LitElement) {
     static { IgcMonthsViewComponent_1 = this; }
     static { this.tagName = 'igc-months-view'; }
@@ -34,64 +34,61 @@ let IgcMonthsViewComponent = class IgcMonthsViewComponent extends EventEmitterMi
     get value() {
         return this._value.native;
     }
-    get _monthOptions() {
-        return { month: this.monthFormat };
-    }
     constructor() {
         super();
         this._value = CalendarDay.today;
         this.locale = 'en';
         this.monthFormat = 'long';
-        this._ariaMonthOptions = {
-            month: 'long',
-            year: 'numeric',
-        };
         addThemingController(this, all);
-        addKeybindings(this).setActivateHandler(this.handleInteraction);
-        addSafeEventListener(this, 'click', this.handleInteraction);
+        addKeybindings(this).setActivateHandler(this._handleInteraction);
+        addSafeEventListener(this, 'click', this._handleInteraction);
     }
     connectedCallback() {
         super.connectedCallback();
         this.role = 'grid';
     }
-    focusActiveDate(options) {
-        this.activeMonth.focus(options);
-    }
-    handleInteraction(event) {
+    _handleInteraction(event) {
         const value = getViewElement(event);
         if (value !== -1) {
             this._value = this._value.set({ month: value });
             this.emitEvent('igcChange', { detail: this.value });
         }
     }
-    renderMonth(entry, now) {
-        const ariaLabel = getDateFormatter().formatDateTime(entry.native, this.locale, this._ariaMonthOptions);
-        const value = getDateFormatter().formatDateTime(entry.native, this.locale, this._monthOptions);
-        const active = areSameMonth(this._value, entry);
-        const current = areSameMonth(now, entry);
-        const selected = this._value.month === entry.month;
+    focusActiveDate(options) {
+        this._activeMonth?.focus(options);
+    }
+    _renderMonth(month, now, ariaFormatter, labelFormatter) {
+        const active = areSameMonth(this._value, month);
+        const current = areSameMonth(now, month);
+        const selected = this._value.month === month.month;
         return html `
       <span part=${partMap({ month: true, selected, current })}>
         <span
           role="gridcell"
-          data-value=${entry.month}
+          data-value=${month.month}
           part=${partMap({ 'month-inner': true, selected, current })}
           aria-selected=${selected}
-          aria-label=${ariaLabel}
+          aria-label=${ariaFormatter.format(month.native)}
           tabindex=${active ? 0 : -1}
         >
-          ${value}
+          ${labelFormatter.format(month.native)}
         </span>
       </span>
     `;
     }
     *render() {
         const now = CalendarDay.today;
-        const months = Array.from(range(12));
-        for (const row of chunk(months, MONTHS_PER_ROW)) {
+        const ariaFormatter = getDateFormatter().getIntlFormatter(this.locale, {
+            month: 'long',
+            year: 'numeric',
+        });
+        const labelFormatter = getDateFormatter().getIntlFormatter(this.locale, {
+            month: this.monthFormat,
+        });
+        for (const row of chunk(MONTHS, MONTHS_PER_ROW)) {
             yield html `
         <div part="months-row" role="row">
-          ${row.map((month) => this.renderMonth(this._value.set({ month }), now))}
+          ${row.map((month) => this._renderMonth(this._value.set({ month }), now, ariaFormatter, labelFormatter))}
         </div>
       `;
         }
@@ -102,7 +99,7 @@ __decorate([
 ], IgcMonthsViewComponent.prototype, "_value", void 0);
 __decorate([
     query('[tabindex="0"]')
-], IgcMonthsViewComponent.prototype, "activeMonth", void 0);
+], IgcMonthsViewComponent.prototype, "_activeMonth", void 0);
 __decorate([
     property({ attribute: false })
 ], IgcMonthsViewComponent.prototype, "value", null);

package/components/calendar/months-view/months-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"months-view.js","sourceRoot":"","sources":["../../../../src/components/calendar/months-view/months-view.ts"],"names":[],"mappings":"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","sourcesContent":["import { getDateFormatter } from 'igniteui-i18n-core';\nimport { html, LitElement } from 'lit';\nimport { property, query, state } from 'lit/decorators.js';\nimport { range } from 'lit/directives/range.js';\nimport { addThemingController } from '../../../theming/theming-controller.js';\nimport { addKeybindings } from '../../common/controllers/key-bindings.js';\nimport { blazorIndirectRender } from '../../common/decorators/blazorIndirectRender.js';\nimport { blazorSuppressComponent } from '../../common/decorators/blazorSuppressComponent.js';\nimport { registerComponent } from '../../common/definitions/register.js';\nimport type { Constructor } from '../../common/mixins/constructor.js';\nimport { EventEmitterMixin } from '../../common/mixins/event-emitter.js';\nimport { partMap } from '../../common/part-map.js';\nimport { addSafeEventListener, chunk } from '../../common/util.js';\nimport { areSameMonth, getViewElement, MONTHS_PER_ROW } from '../helpers.js';\nimport { CalendarDay } from '../model.js';\nimport { all } from '../themes/year-month.js';\nimport { styles } from '../themes/year-month-view.base.css.js';\nimport type { IgcCalendarComponentEventMap } from '../types.js';\n\n/**\n * Instantiate a months view as a separate component in the calendar.\n *\n * @element igc-months-view\n *\n * @csspart months-row - The months row container.\n * @csspart month - The month container.\n * @csspart month-inner - The inner month container.\n */\n@blazorIndirectRender\n@blazorSuppressComponent\nexport default class IgcMonthsViewComponent extends EventEmitterMixin<\n  IgcCalendarComponentEventMap,\n  Constructor<LitElement>\n>(LitElement) {\n  public static readonly tagName = 'igc-months-view';\n  public static styles = styles;\n\n  /* blazorSuppress */\n  public static register() {\n    registerComponent(IgcMonthsViewComponent);\n  }\n\n  @state()\n  private _value = CalendarDay.today;\n\n  @query('[tabindex=\"0\"]')\n  private activeMonth!: HTMLElement;\n\n  /** Тhe current value of the calendar. */\n  @property({ attribute: false })\n  public set value(value: Date) {\n    this._value = CalendarDay.from(value);\n  }\n\n  public get value() {\n    return this._value.native;\n  }\n\n  /** Sets the locale used for formatting and displaying the dates. */\n  @property()\n  public locale = 'en';\n\n  /** The format of the month. Defaults to long. */\n  @property({ attribute: 'month-format' })\n  public monthFormat: 'numeric' | '2-digit' | 'long' | 'short' | 'narrow' =\n    'long';\n\n  private get _monthOptions(): Intl.DateTimeFormatOptions {\n    return { month: this.monthFormat };\n  }\n\n  private _ariaMonthOptions: Intl.DateTimeFormatOptions = {\n    month: 'long',\n    year: 'numeric',\n  };\n\n  constructor() {\n    super();\n\n    addThemingController(this, all);\n    addKeybindings(this).setActivateHandler(this.handleInteraction);\n    addSafeEventListener(this, 'click', this.handleInteraction);\n  }\n\n  public override connectedCallback() {\n    super.connectedCallback();\n    this.role = 'grid';\n  }\n\n  /** Focuses the active date. */\n  public focusActiveDate(options?: FocusOptions) {\n    this.activeMonth.focus(options);\n  }\n\n  protected handleInteraction(event: Event) {\n    const value = getViewElement(event);\n\n    if (value !== -1) {\n      this._value = this._value.set({ month: value });\n      this.emitEvent('igcChange', { detail: this.value });\n    }\n  }\n\n  protected renderMonth(entry: CalendarDay, now: CalendarDay) {\n    const ariaLabel = getDateFormatter().formatDateTime(\n      entry.native,\n      this.locale,\n      this._ariaMonthOptions\n    );\n    const value = getDateFormatter().formatDateTime(\n      entry.native,\n      this.locale,\n      this._monthOptions\n    );\n\n    const active = areSameMonth(this._value, entry);\n    const current = areSameMonth(now, entry);\n    const selected = this._value.month === entry.month;\n\n    return html`\n      <span part=${partMap({ month: true, selected, current })}>\n        <span\n          role=\"gridcell\"\n          data-value=${entry.month}\n          part=${partMap({ 'month-inner': true, selected, current })}\n          aria-selected=${selected}\n          aria-label=${ariaLabel}\n          tabindex=${active ? 0 : -1}\n        >\n          ${value}\n        </span>\n      </span>\n    `;\n  }\n\n  protected override *render() {\n    const now = CalendarDay.today;\n    const months = Array.from(range(12));\n\n    for (const row of chunk(months, MONTHS_PER_ROW)) {\n      yield html`\n        <div part=\"months-row\" role=\"row\">\n          ${row.map((month) =>\n            this.renderMonth(this._value.set({ month }), now)\n          )}\n        </div>\n      `;\n    }\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'igc-months-view': IgcMonthsViewComponent;\n  }\n}\n"]}
+{"version":3,"file":"months-view.js","sourceRoot":"","sources":["../../../../src/components/calendar/months-view/months-view.ts"],"names":[],"mappings":"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","sourcesContent":["import { getDateFormatter } from 'igniteui-i18n-core';\nimport { html, LitElement, type TemplateResult } from 'lit';\nimport { property, query, state } from 'lit/decorators.js';\nimport { addThemingController } from '../../../theming/theming-controller.js';\nimport { addKeybindings } from '../../common/controllers/key-bindings.js';\nimport { blazorIndirectRender } from '../../common/decorators/blazorIndirectRender.js';\nimport { blazorSuppressComponent } from '../../common/decorators/blazorSuppressComponent.js';\nimport { registerComponent } from '../../common/definitions/register.js';\nimport type { Constructor } from '../../common/mixins/constructor.js';\nimport { EventEmitterMixin } from '../../common/mixins/event-emitter.js';\nimport { partMap } from '../../common/part-map.js';\nimport { addSafeEventListener, chunk } from '../../common/util.js';\nimport { areSameMonth, getViewElement, MONTHS_PER_ROW } from '../helpers.js';\nimport { CalendarDay } from '../model.js';\nimport { all } from '../themes/year-month.js';\nimport { styles } from '../themes/year-month-view.base.css.js';\nimport type { IgcCalendarComponentEventMap } from '../types.js';\n\nconst MONTHS = Array.from({ length: 12 }, (_, i) => i);\n\n/**\n * Instantiate a months view as a separate component in the calendar.\n *\n * @element igc-months-view\n *\n * @csspart months-row - The months row container.\n * @csspart month - The month container.\n * @csspart month-inner - The inner month container.\n */\n@blazorIndirectRender\n@blazorSuppressComponent\nexport default class IgcMonthsViewComponent extends EventEmitterMixin<\n  IgcCalendarComponentEventMap,\n  Constructor<LitElement>\n>(LitElement) {\n  public static readonly tagName = 'igc-months-view';\n  public static styles = styles;\n\n  /* blazorSuppress */\n  public static register(): void {\n    registerComponent(IgcMonthsViewComponent);\n  }\n\n  //#region Internal State\n\n  @state()\n  private _value = CalendarDay.today;\n\n  @query('[tabindex=\"0\"]')\n  private _activeMonth?: HTMLElement;\n\n  //#endregion\n\n  //#region Public attributes and properties\n\n  /** Тhe current value of the calendar. */\n  @property({ attribute: false })\n  public set value(value: Date) {\n    this._value = CalendarDay.from(value);\n  }\n\n  public get value(): Date {\n    return this._value.native;\n  }\n\n  /** Sets the locale used for formatting and displaying the dates. */\n  @property()\n  public locale = 'en';\n\n  /** The format of the month. Defaults to long. */\n  @property({ attribute: 'month-format' })\n  public monthFormat: 'numeric' | '2-digit' | 'long' | 'short' | 'narrow' =\n    'long';\n\n  //#endregion\n\n  //#region Lifecycle methods\n\n  constructor() {\n    super();\n\n    addThemingController(this, all);\n    addKeybindings(this).setActivateHandler(this._handleInteraction);\n    addSafeEventListener(this, 'click', this._handleInteraction);\n  }\n\n  /** @internal */\n  public override connectedCallback(): void {\n    super.connectedCallback();\n    this.role = 'grid';\n  }\n\n  //#endregion\n\n  //#region Event Handlers\n\n  protected _handleInteraction(event: Event): void {\n    const value = getViewElement(event);\n\n    if (value !== -1) {\n      this._value = this._value.set({ month: value });\n      this.emitEvent('igcChange', { detail: this.value });\n    }\n  }\n\n  //#endregion\n\n  //#region Public Methods\n\n  /** Focuses the active date. */\n  public focusActiveDate(options?: FocusOptions): void {\n    this._activeMonth?.focus(options);\n  }\n\n  //#endregion\n\n  protected _renderMonth(\n    month: CalendarDay,\n    now: CalendarDay,\n    ariaFormatter: Intl.DateTimeFormat,\n    labelFormatter: Intl.DateTimeFormat\n  ): TemplateResult {\n    const active = areSameMonth(this._value, month);\n    const current = areSameMonth(now, month);\n    const selected = this._value.month === month.month;\n\n    return html`\n      <span part=${partMap({ month: true, selected, current })}>\n        <span\n          role=\"gridcell\"\n          data-value=${month.month}\n          part=${partMap({ 'month-inner': true, selected, current })}\n          aria-selected=${selected}\n          aria-label=${ariaFormatter.format(month.native)}\n          tabindex=${active ? 0 : -1}\n        >\n          ${labelFormatter.format(month.native)}\n        </span>\n      </span>\n    `;\n  }\n\n  protected override *render(): Generator<TemplateResult> {\n    const now = CalendarDay.today;\n\n    const ariaFormatter = getDateFormatter().getIntlFormatter(this.locale, {\n      month: 'long',\n      year: 'numeric',\n    });\n    const labelFormatter = getDateFormatter().getIntlFormatter(this.locale, {\n      month: this.monthFormat,\n    });\n\n    for (const row of chunk(MONTHS, MONTHS_PER_ROW)) {\n      yield html`\n        <div part=\"months-row\" role=\"row\">\n          ${row.map((month) =>\n            this._renderMonth(\n              this._value.set({ month }),\n              now,\n              ariaFormatter,\n              labelFormatter\n            )\n          )}\n        </div>\n      `;\n    }\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'igc-months-view': IgcMonthsViewComponent;\n  }\n}\n"]}

package/components/calendar/years-view/years-view.d.ts

@@ -1,4 +1,4 @@
-import { LitElement } from 'lit';
+import { LitElement, type TemplateResult } from 'lit';
 import type { Constructor } from '../../common/mixins/constructor.js';
 import { CalendarDay } from '../model.js';
 import type { IgcCalendarComponentEventMap } from '../types.js';
@@ -17,7 +17,7 @@ export default class IgcYearsViewComponent extends IgcYearsViewComponent_base {
     static styles: import("lit").CSSResult;
     static register(): void;
     private _value;
-    private activeYear;
+    private _activeYear?;
     /** Тhe current value of the calendar. */
     set value(value: Date);
     get value(): Date;
@@ -28,10 +28,11 @@ export default class IgcYearsViewComponent extends IgcYearsViewComponent_base {
     yearsPerPage: number;
     constructor();
     connectedCallback(): void;
+    protected _handleInteraction(event: Event): void;
+    /** Focuses the active year element. */
     focusActiveDate(options?: FocusOptions): void;
-    protected handleInteraction(event: Event): void;
-    protected renderYear(year: number, now: CalendarDay): import("lit-html").TemplateResult<1>;
-    protected render(): Generator<import("lit-html").TemplateResult<1>, void, unknown>;
+    protected _renderYear(year: number, now: CalendarDay): TemplateResult;
+    protected render(): Generator<TemplateResult>;
 }
 declare global {
     interface HTMLElementTagNameMap {