@salt-ds/date-components 0.0.0-snapshot-20260330155807

package/dist-es/calendar/useCalendar.js

@@ -0,0 +1,462 @@
+import { useBreakpoint, resolveResponsiveValue, useControlled } from '@salt-ds/core';
+import { useCallback, useMemo, useEffect } from 'react';
+import { useLocalization } from '../localization-provider/LocalizationProvider.js';
+import { createSingleSelectionAnnouncement, createRangeSelectionAnnouncement } from './internal/createAnnouncement.js';
+import { generateDatesForMonth } from './internal/utils.js';
+import { useCalendarSelection, isDateRangeSelection } from './useCalendarSelection.js';
+import { useDateSelectionAnnouncer } from './useDateSelectionAnnouncer.js';
+
+const defaultIsDayUnselectable = () => false;
+const defaultIsDayHighlighted = () => false;
+function useCalendar(props) {
+  const {
+    dateAdapter,
+    defaultDates: { minDate: defaultMinDate, maxDate: defaultMaxDate }
+  } = useLocalization();
+  const {
+    createAnnouncement,
+    timezone,
+    defaultSelectedDate,
+    defaultVisibleMonth = dateAdapter.today(timezone),
+    hideOutOfRangeDates,
+    hoveredDate: hoveredDateProp,
+    focusedDate: focusedDateProp,
+    focusedDateRef,
+    isDayHighlighted = defaultIsDayHighlighted,
+    isDayUnselectable = defaultIsDayUnselectable,
+    multiselect,
+    maxDate = defaultMaxDate,
+    minDate = defaultMinDate,
+    numberOfVisibleMonths = 1,
+    onHoveredDateChange,
+    onSelectionChange,
+    onVisibleMonthChange,
+    onFocusedDateChange,
+    select,
+    selectedDate: selectedDateProp,
+    selectionVariant,
+    visibleMonth: visibleMonthProp,
+    startDateOffset,
+    endDateOffset
+  } = props;
+  const { matchedBreakpoints } = useBreakpoint();
+  const responsiveNumberOfVisibleMonths = resolveResponsiveValue(numberOfVisibleMonths, matchedBreakpoints) ?? 1;
+  const [hoveredDate, setHoveredDateState] = useControlled({
+    controlled: hoveredDateProp,
+    default: void 0,
+    name: "Calendar",
+    state: "hoveredDate"
+  });
+  const setHoveredDate = useCallback(
+    (event, date) => {
+      setHoveredDateState(date);
+      onHoveredDateChange == null ? void 0 : onHoveredDateChange(event, date);
+    },
+    [onHoveredDateChange]
+  );
+  const [visibleMonth, setVisibleMonthState] = useControlled({
+    controlled: useMemo(
+      () => visibleMonthProp ? dateAdapter.startOf(visibleMonthProp, "month") : void 0,
+      [visibleMonthProp, dateAdapter]
+    ),
+    // biome-ignore lint/correctness/useExhaustiveDependencies: just on mount
+    default: useMemo(
+      () => dateAdapter.startOf(defaultVisibleMonth, "month"),
+      []
+    ),
+    name: "Calendar",
+    state: "visibleMonth"
+  });
+  const isOutsideAllowedDates = useCallback(
+    (date) => {
+      if (dateAdapter.compare(date, minDate) < 0) {
+        return -1;
+      }
+      if (dateAdapter.compare(date, maxDate) > 0) {
+        return 1;
+      }
+      return 0;
+    },
+    [dateAdapter, maxDate, minDate]
+  );
+  const isOutsideAllowedMonths = useCallback(
+    (date) => {
+      const startOfMonth = dateAdapter.startOf(date, "month");
+      const endOfMonth = dateAdapter.endOf(date, "month");
+      return dateAdapter.compare(endOfMonth, minDate) < 0 || dateAdapter.compare(startOfMonth, maxDate) > 0;
+    },
+    [dateAdapter, minDate, maxDate]
+  );
+  const isOutsideAllowedYears = useCallback(
+    (date) => {
+      const startOfYear = dateAdapter.startOf(date, "year");
+      const endOfYear = dateAdapter.endOf(date, "year");
+      return dateAdapter.compare(endOfYear, minDate) < 0 || dateAdapter.compare(startOfYear, maxDate) > 0;
+    },
+    [dateAdapter, minDate, maxDate]
+  );
+  const isDaySelectable = useCallback(
+    (date) => !(date && (isDayUnselectable(date) || isOutsideAllowedDates(date) !== 0)),
+    [isDayUnselectable, isOutsideAllowedDates]
+  );
+  const isDayVisible = useCallback(
+    (date) => {
+      if (!date) {
+        return false;
+      }
+      const startInsideDays = dateAdapter.startOf(visibleMonth, "month");
+      if (dateAdapter.compare(date, startInsideDays) < 0) return false;
+      const endVisibleMonth = dateAdapter.add(visibleMonth, {
+        months: responsiveNumberOfVisibleMonths - 1
+      });
+      const endInsideDays = dateAdapter.endOf(endVisibleMonth, "month");
+      return !(dateAdapter.compare(date, endInsideDays) > 0);
+    },
+    [dateAdapter, responsiveNumberOfVisibleMonths, visibleMonth]
+  );
+  const selectionManager = useCalendarSelection({
+    defaultSelectedDate,
+    selectedDate: selectedDateProp,
+    isDaySelectable,
+    isOutsideAllowedDates,
+    multiselect,
+    onSelectionChange,
+    select,
+    selectionVariant,
+    startDateOffset,
+    endDateOffset
+  });
+  const {
+    state: { selectedDate },
+    helpers: {
+      isSelected,
+      isSameDay,
+      setSelectedDate,
+      isSelectedStart,
+      isSelectedSpan,
+      isSelectedEnd
+    }
+  } = selectionManager;
+  const isHovered = useCallback(
+    (date) => {
+      return !!hoveredDate && dateAdapter.isSame(date, hoveredDate, "day");
+    },
+    [dateAdapter, hoveredDate]
+  );
+  const isHoveredStart = useCallback(
+    (date) => {
+      if (selectionVariant === "range" && hoveredDate && dateAdapter.isSame(date, hoveredDate, "day")) {
+        const dateRanges = Array.isArray(selectedDate) ? selectedDate : [selectedDate];
+        const allDatesPopulated = dateRanges.every(
+          (range) => (range == null ? void 0 : range.startDate) && (range == null ? void 0 : range.endDate)
+        );
+        const startDateMatches = dateRanges.some(
+          (range) => (range == null ? void 0 : range.startDate) && dateAdapter.isSame(date, range.startDate, "day")
+        );
+        const firstIncompleteRange = dateRanges.find(
+          (range) => (range == null ? void 0 : range.startDate) && !(range == null ? void 0 : range.endDate)
+        );
+        const newDateRangeRequired = (firstIncompleteRange == null ? void 0 : firstIncompleteRange.startDate) && dateAdapter.compare(date, firstIncompleteRange.startDate) < 0;
+        return allDatesPopulated || startDateMatches || newDateRangeRequired;
+      }
+      if (selectionVariant === "offset" && hoveredDate) {
+        const startDate = startDateOffset ? startDateOffset(hoveredDate) : hoveredDate;
+        return dateAdapter.isSame(date, startDate, "day") && (!isDaySelectable || isDaySelectable(date));
+      }
+      return false;
+    },
+    [
+      dateAdapter,
+      selectionVariant,
+      selectedDate,
+      hoveredDate,
+      isDaySelectable,
+      startDateOffset
+    ]
+  );
+  const getDefaultFocusedDate = () => {
+    if (selectedDate && (selectionVariant === "range" || selectionVariant === "offset")) {
+      const getFocusableDate = (result, selection) => {
+        if ((selection == null ? void 0 : selection.startDate) && isDayVisible(selection.startDate)) {
+          return [...result, selection.startDate];
+        }
+        if ((selection == null ? void 0 : selection.endDate) && isDayVisible(selection.endDate)) {
+          return [...result, selection.endDate];
+        }
+        return result;
+      };
+      let focusableSelectedDates;
+      if (!multiselect) {
+        focusableSelectedDates = [selectedDate];
+      } else {
+        focusableSelectedDates = selectedDate;
+      }
+      const selectionInMonth = focusableSelectedDates.reduce(getFocusableDate, []).sort((a, b) => dateAdapter.compare(a, b));
+      if (selectionInMonth.length > 0) {
+        return selectionInMonth[0];
+      }
+    } else if (selectedDate && selectionVariant === "single") {
+      const focusableSelectedDate = multiselect ? selectedDate == null ? void 0 : selectedDate[0] : selectedDate;
+      if (focusableSelectedDate && isDayVisible(focusableSelectedDate)) {
+        return focusableSelectedDate;
+      }
+    }
+    if ((isDaySelectable == null ? void 0 : isDaySelectable(dateAdapter.today(timezone))) && isDayVisible(dateAdapter.today(timezone))) {
+      return dateAdapter.today(timezone);
+    }
+    const firstSelectableDate = generateDatesForMonth(
+      dateAdapter,
+      visibleMonth
+    ).find((visibleDay) => visibleDay && (isDaySelectable == null ? void 0 : isDaySelectable(visibleDay)));
+    if (firstSelectableDate) {
+      return firstSelectableDate;
+    }
+    return null;
+  };
+  const [focusedDate, setFocusedDateState] = useControlled({
+    controlled: focusedDateProp,
+    // biome-ignore lint/correctness/useExhaustiveDependencies: initial value only
+    default: useMemo(() => getDefaultFocusedDate(), []),
+    name: "Calendar",
+    state: "focusedDate"
+  });
+  const focusableDate = useMemo(() => {
+    const dates = [];
+    if (Array.isArray(selectedDate)) {
+      for (const selection of selectedDate) {
+        if (isDateRangeSelection(selection)) {
+          if (selection.startDate && isDayVisible(selection.startDate)) {
+            dates.push(selection.startDate);
+          } else if (selection.endDate && isDayVisible(selection.endDate)) {
+            dates.push(selection.endDate);
+          }
+        } else if (isDayVisible(selection)) {
+          dates.push(selection);
+        }
+      }
+    } else if (selectedDate) {
+      if (isDateRangeSelection(selectedDate)) {
+        if (selectedDate.startDate && isDayVisible(selectedDate.startDate)) {
+          dates.push(selectedDate.startDate);
+        } else if (selectedDate.endDate && isDayVisible(selectedDate.endDate)) {
+          dates.push(selectedDate.endDate);
+        }
+      } else if (isDayVisible(selectedDate)) {
+        dates.push(selectedDate);
+      }
+    }
+    if (focusedDate && visibleMonth && dateAdapter.isSame(focusedDate, visibleMonth, "month")) {
+      dates.push(focusedDate);
+      return dates[0];
+    }
+    if (dates.length === 0 && isDaySelectable(dateAdapter.today(timezone)) && isDayVisible(dateAdapter.today(timezone))) {
+      dates.push(dateAdapter.today(timezone));
+    }
+    if (dates.length === 0 || !dates.some(isDayVisible)) {
+      const firstSelectableDate = generateDatesForMonth(
+        dateAdapter,
+        visibleMonth
+      ).find((visibleDay) => visibleDay && isDaySelectable(visibleDay));
+      if (firstSelectableDate) {
+        dates.push(firstSelectableDate);
+      }
+    }
+    return dates.length ? dates[0] : null;
+  }, [
+    dateAdapter,
+    focusedDate,
+    isDaySelectable,
+    isDayVisible,
+    selectedDate,
+    timezone,
+    visibleMonth
+  ]);
+  const isHoveredSpan = useCallback(
+    (date) => {
+      if (selectionVariant === "range") {
+        const dateRanges = Array.isArray(selectedDate) ? selectedDate : [selectedDate];
+        return dateRanges.some((range) => {
+          if (isDateRangeSelection(range) && dateAdapter.isValid(range.startDate) && !dateAdapter.isValid(range.endDate) && isOutsideAllowedDates(range.startDate) === 0 && hoveredDate) {
+            const isForwardRange = dateAdapter.compare(hoveredDate, range.startDate) > 0 && dateAdapter.compare(date, range.startDate) > 0 && dateAdapter.compare(date, hoveredDate) < 0;
+            const isValidDayHovered = !isDaySelectable || isDaySelectable(hoveredDate);
+            return isForwardRange && isValidDayHovered;
+          }
+          return false;
+        });
+      }
+      if (selectionVariant === "offset" && hoveredDate) {
+        const startDate = startDateOffset ? startDateOffset(hoveredDate) : hoveredDate;
+        const endDate = endDateOffset ? endDateOffset(hoveredDate) : hoveredDate;
+        return dateAdapter.compare(date, startDate) > 0 && dateAdapter.compare(date, endDate) < 0 && (!isDaySelectable || isDaySelectable(date));
+      }
+      return false;
+    },
+    [
+      dateAdapter,
+      endDateOffset,
+      isOutsideAllowedDates,
+      selectionVariant,
+      selectedDate,
+      hoveredDate,
+      isDaySelectable,
+      startDateOffset
+    ]
+  );
+  const isHoveredEnd = useCallback(
+    (date) => {
+      if (selectionVariant === "range" && hoveredDate && dateAdapter.isSame(date, hoveredDate, "day")) {
+        const dateRanges = Array.isArray(selectedDate) ? selectedDate : [selectedDate];
+        const isIncompleteRange = dateRanges.some(
+          (range) => (range == null ? void 0 : range.startDate) && !(range == null ? void 0 : range.endDate) && hoveredDate && dateAdapter.compare(hoveredDate, range.startDate) >= 0
+        );
+        const endDateMatches = dateRanges.some(
+          (range) => (range == null ? void 0 : range.endDate) && dateAdapter.isSame(range.endDate, date, "day")
+        );
+        return endDateMatches || isIncompleteRange;
+      }
+      if (selectionVariant === "offset" && hoveredDate) {
+        const endDate = endDateOffset ? endDateOffset(hoveredDate) : hoveredDate;
+        return dateAdapter.isSame(date, endDate, "day") && (!isDaySelectable || isDaySelectable(date));
+      }
+      return false;
+    },
+    [
+      dateAdapter,
+      selectionVariant,
+      selectedDate,
+      hoveredDate,
+      endDateOffset,
+      isDaySelectable
+    ]
+  );
+  const defaultCreateAnnouncement = selectionVariant === "single" ? createSingleSelectionAnnouncement : createRangeSelectionAnnouncement;
+  const { announce } = useDateSelectionAnnouncer(
+    createAnnouncement === void 0 ? defaultCreateAnnouncement : createAnnouncement,
+    dateAdapter
+  );
+  const setFocusedDate = useCallback(
+    (event, date) => {
+      if (focusedDateRef && (event == null ? void 0 : event.target) instanceof HTMLElement) {
+        focusedDateRef.current = event.target;
+      }
+      const exceededRangeLimit = date ? isOutsideAllowedDates(date) : 0;
+      if (date && (focusedDate && dateAdapter.isSame(date, focusedDate, "day") || exceededRangeLimit !== 0)) {
+        if (exceededRangeLimit !== 0) {
+          announce(
+            exceededRangeLimit < 0 ? "minFocusableDateExceeded" : "maxFocusableDateExceeded"
+          );
+        }
+        return;
+      }
+      setFocusedDateState(date);
+      onFocusedDateChange == null ? void 0 : onFocusedDateChange(event, date);
+    },
+    [
+      announce,
+      dateAdapter,
+      focusedDate,
+      focusedDateRef,
+      isOutsideAllowedDates,
+      onFocusedDateChange
+    ]
+  );
+  useEffect(() => {
+    const shouldTransition = focusedDate && !focusedDateProp !== void 0 && !isDayVisible(focusedDate) && isOutsideAllowedDates(focusedDate) === 0;
+    if (shouldTransition) {
+      setVisibleMonth(null, dateAdapter.startOf(focusedDate, "month"));
+    }
+  }, [dateAdapter, focusedDateProp, isOutsideAllowedDates, focusedDate]);
+  const setVisibleMonth = useCallback(
+    (event, newVisibleMonth) => {
+      setVisibleMonthState(newVisibleMonth);
+      announce("visibleMonthChanged", {
+        startVisibleMonth: newVisibleMonth,
+        endVisibleMonth: dateAdapter.add(newVisibleMonth, {
+          months: responsiveNumberOfVisibleMonths - 1
+        })
+      });
+      onVisibleMonthChange == null ? void 0 : onVisibleMonthChange(event, newVisibleMonth);
+    },
+    [
+      announce,
+      dateAdapter,
+      onVisibleMonthChange,
+      responsiveNumberOfVisibleMonths
+    ]
+  );
+  return useMemo(
+    () => ({
+      state: {
+        visibleMonth,
+        timezone,
+        multiselect,
+        minDate,
+        maxDate,
+        numberOfVisibleMonths: responsiveNumberOfVisibleMonths,
+        selectionVariant,
+        hideOutOfRangeDates,
+        focusedDate,
+        focusableDate,
+        focusedDateRef
+      },
+      helpers: {
+        setVisibleMonth,
+        isDayUnselectable,
+        isDayHighlighted,
+        isDayVisible,
+        isHovered,
+        isHoveredStart,
+        isHoveredSpan,
+        isHoveredEnd,
+        isOutsideAllowedDates,
+        isOutsideAllowedMonths,
+        isOutsideAllowedYears,
+        setFocusedDate,
+        setHoveredDate,
+        isDaySelectable,
+        isSelected,
+        isSameDay,
+        setSelectedDate,
+        isSelectedStart,
+        isSelectedSpan,
+        isSelectedEnd
+      }
+    }),
+    [
+      visibleMonth,
+      timezone,
+      multiselect,
+      minDate,
+      maxDate,
+      responsiveNumberOfVisibleMonths,
+      selectionVariant,
+      hideOutOfRangeDates,
+      focusedDate,
+      focusedDateRef,
+      focusableDate,
+      setVisibleMonth,
+      isDayUnselectable,
+      isDayHighlighted,
+      isDayVisible,
+      isHovered,
+      isHoveredStart,
+      isHoveredSpan,
+      isHoveredEnd,
+      isOutsideAllowedDates,
+      isOutsideAllowedMonths,
+      isOutsideAllowedYears,
+      setFocusedDate,
+      setHoveredDate,
+      isDaySelectable,
+      isSelected,
+      isSameDay,
+      setSelectedDate,
+      isSelectedStart,
+      isSelectedSpan,
+      isSelectedEnd
+    ]
+  );
+}
+
+export { useCalendar };
+//# sourceMappingURL=useCalendar.js.map

package/dist-es/calendar/useCalendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCalendar.js","sources":["../src/calendar/useCalendar.ts"],"sourcesContent":["import {\n  type ResponsiveProp,\n  resolveResponsiveValue,\n  useBreakpoint,\n  useControlled,\n} from \"@salt-ds/core\";\nimport type { DateFrameworkType, Timezone } from \"@salt-ds/date-adapters\";\nimport { type SyntheticEvent, useCallback, useEffect, useMemo } from \"react\";\nimport { useLocalization } from \"../localization-provider\";\nimport {\n  createRangeSelectionAnnouncement,\n  createSingleSelectionAnnouncement,\n} from \"./internal/createAnnouncement\";\nimport { generateDatesForMonth } from \"./internal/utils\";\nimport {\n  type DateRangeSelection,\n  isDateRangeSelection,\n  type SingleDateSelection,\n  type UseCalendarSelectionMultiselectOffsetProps,\n  type UseCalendarSelectionMultiselectRangeProps,\n  type UseCalendarSelectionMultiselectSingleProps,\n  type UseCalendarSelectionOffsetProps,\n  type UseCalendarSelectionProps,\n  type UseCalendarSelectionRangeProps,\n  type UseCalendarSelectionSingleProps,\n  useCalendarSelection,\n} from \"./useCalendarSelection\";\nimport {\n  type CreateAnnouncement,\n  useDateSelectionAnnouncer,\n} from \"./useDateSelectionAnnouncer\";\n\n/**\n * Base properties for the UseCalendar hook.\n */\ninterface UseCalendarBaseProps {\n  /**\n   * Factory method for date selection live announcements or null to silence announcements\n   */\n  createAnnouncement?: CreateAnnouncement | null;\n  /**\n   * The default visible month.\n   */\n  defaultVisibleMonth?: DateFrameworkType;\n  /**\n   * The currently focused date in the calendar, or null if no date is focused.\n   */\n  focusedDate?: DateFrameworkType | null;\n  /**\n   * The currently hovered date.\n   */\n  hoveredDate?: DateFrameworkType | null;\n  /**\n   * Function to determine if a day is visible.\n   * @param date - The date to check.\n   * @returns `true` if the day is visible, otherwise `false`.\n   */\n  isDayVisible?: (date: DateFrameworkType) => boolean;\n  /**\n   * Ref to attach to the focused element, enabling focus to be controlled.\n   */\n  focusedDateRef?: React.MutableRefObject<HTMLElement | null>;\n  /**\n   * Callback fired when the focused date changes.\n   * @param event - The synthetic event, if user event triggered focus or null.\n   * @param date - The new focused date.\n   */\n  onFocusedDateChange?: (\n    event: SyntheticEvent | null,\n    date: DateFrameworkType | null,\n  ) => void;\n  /**\n   * Callback fired when the hovered date changes.\n   * @param event - The synthetic event.\n   * @param hoveredDate - The new hovered date.\n   */\n  onHoveredDateChange?: (\n    event: SyntheticEvent,\n    hoveredDate: DateFrameworkType | null,\n  ) => void;\n  /**\n   * Callback fired when the visible month changes.\n   * @param event - The synthetic event or null if triggered by code.\n   * @param visibleMonth - The new visible month.\n   */\n  onVisibleMonthChange?: (\n    event: SyntheticEvent | null,\n    visibleMonth: DateFrameworkType,\n  ) => void;\n  /**\n   * Function to determine if a day is unselectable.\n   * @param date - The date to check.\n   * @returns A string reason if the day is unselectable, otherwise `false` or `undefined`.\n   */\n  isDayUnselectable?: (date: DateFrameworkType) => string | false | undefined;\n  /**\n   * Function to determine if a day is highlighted.\n   * @param date - The date to check.\n   * @returns A string reason if the day is highlighted, otherwise `false` or `undefined`.\n   */\n  isDayHighlighted?: (date: DateFrameworkType) => string | false | undefined;\n  /**\n   * If `true`, hides dates that are out of the selectable range.\n   */\n  hideOutOfRangeDates?: boolean;\n  /**\n   * The minimum selectable date.\n   */\n  minDate?: DateFrameworkType;\n  /**\n   * The maximum selectable date.\n   */\n  maxDate?: DateFrameworkType;\n  /**\n   * Number of visible months, maximum 12, defaults to 1.\n   */\n  numberOfVisibleMonths?: ResponsiveProp<\n    1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12\n  >;\n  /**\n   * Specifies the timezone behavior:\n   * - If undefined, the timezone will be derived from the passed date, or from `defaultSelectedDate`/`selectedDate`.\n   * - If set to \"default\", the default timezone of the date library will be used.\n   * - If set to \"system\", the local system's timezone will be applied.\n   * - If set to \"UTC\", the time will be returned in UTC.\n   * - If set to a valid IANA timezone identifier, the time will be returned for that specific timezone.\n   */\n  timezone?: Timezone;\n  /**\n   * The currently visible month.\n   */\n  visibleMonth?: DateFrameworkType;\n}\n\n/**\n * UseCalendar hook props for a single date selection.\n */\nexport interface UseCalendarSingleProps\n  extends UseCalendarSelectionSingleProps,\n    UseCalendarBaseProps {}\n\n/**\n * UseCalendar hook props for a multi-select, single date selection.\n */\nexport interface UseCalendarMultiselectSingleProps\n  extends UseCalendarSelectionMultiselectSingleProps,\n    Omit<UseCalendarBaseProps, \"multiselect\"> {}\n\n/**\n * UseCalendar hook props for a date range selection.\n */\nexport interface UseCalendarRangeProps\n  extends UseCalendarSelectionRangeProps,\n    UseCalendarBaseProps {}\n\n/**\n * UseCalendar hook props for a multi-select, date range selection.\n */\nexport interface UseCalendarMultiselectRangeProps\n  extends UseCalendarSelectionMultiselectRangeProps,\n    Omit<UseCalendarBaseProps, \"multiselect\"> {}\n\n/**\n * UseCalendar hook props for an offset date selection.\n */\nexport interface UseCalendarOffsetProps\n  extends UseCalendarSelectionOffsetProps,\n    UseCalendarBaseProps {}\n\n/**\n * UseCalendar hook props for a multi-select, offset selection.\n */\nexport interface UseCalendarMultiselectOffsetProps\n  extends UseCalendarSelectionMultiselectOffsetProps,\n    Omit<UseCalendarBaseProps, \"multiselect\"> {}\n\n/**\n * UseCalendar hook props, wth the selection variant determining the return type of the date selection\n */\nexport type UseCalendarProps =\n  | UseCalendarSingleProps\n  | UseCalendarMultiselectSingleProps\n  | UseCalendarRangeProps\n  | UseCalendarMultiselectRangeProps\n  | UseCalendarOffsetProps\n  | UseCalendarMultiselectOffsetProps;\n\n/**\n * Default function to determine if a day is unselectable.\n * @returns `false` indicating the day is selectable.\n */\nconst defaultIsDayUnselectable = (): string | false => false;\n\n/**\n * Default function to determine if a day is highlighted.\n * @returns `false` indicating the day is not highlighted.\n */\nconst defaultIsDayHighlighted = (): string | false => false;\n\n/**\n * Represents the return type of the useCalendar hook.\n */\nexport interface UseCalendarReturn {\n  /**\n   * The state of the calendar.\n   */\n  state: {\n    /**\n     * The currently visible month in the calendar.\n     */\n    visibleMonth: DateFrameworkType;\n\n    /**\n     * The currently focused date in the calendar, or null if no date is focused.\n     */\n    focusedDate: DateFrameworkType | null;\n\n    /**\n     *  Focusable dates based on current state\n     */\n    focusableDate: DateFrameworkType | null;\n\n    /**\n     * Ref to attach to the focused element,enabling focus to be controlled.\n     */\n    focusedDateRef?: React.MutableRefObject<HTMLButtonElement | null>;\n\n    /**\n     * Multi-select variant of the calendar, indicating if multiple date selections are allowed.\n     */\n    multiselect: boolean;\n    /**\n     * The minimum selectable date in the calendar.\n     */\n    minDate: DateFrameworkType;\n\n    /**\n     * The maximum selectable date in the calendar.\n     */\n    maxDate: DateFrameworkType;\n\n    /**\n     * The selection variant of the calendar, indicating the type of selection allowed.\n     */\n    selectionVariant: \"single\" | \"range\" | \"offset\";\n\n    /**\n     * Whether to hide dates that are out of the selectable range.\n     */\n    hideOutOfRangeDates?: boolean;\n\n    /**\n     * Number of visible months\n     */\n    numberOfVisibleMonths: number;\n    /**\n     * Specifies the timezone behavior:\n     * - If undefined, the timezone will be derived from the passed date, or from `defaultSelectedDate`/`selectedDate`.\n     * - If set to \"default\", the default timezone of the date library will be used.\n     * - If set to \"system\", the local system's timezone will be applied.\n     * - If set to \"UTC\", the time will be returned in UTC.\n     * - If set to a valid IANA timezone identifier, the time will be returned for that specific timezone.\n     */\n    timezone?: Timezone;\n  };\n\n  /**\n   * Helper functions for interacting with the calendar.\n   */\n  helpers: {\n    /**\n     * Sets the visible month in the calendar.\n     *\n     * @param event - The synthetic event or null if triggered by code.\n     * @param newVisibleMonth - The new visible month to set.\n     */\n    setVisibleMonth: (\n      event: SyntheticEvent | null,\n      newVisibleMonth: DateFrameworkType,\n    ) => void;\n\n    /**\n     * Sets the focused date in the calendar.\n     *\n     * @param event - The synthetic event or null if triggered by code.\n     * @param date - The new date to focus.\n     */\n    setFocusedDate: (\n      event: SyntheticEvent | null,\n      date: DateFrameworkType | null,\n    ) => void;\n\n    /**\n     * Determines if a day is unselectable.\n     *\n     * @param date - The date to check.\n     * @returns A string reason if the day is unselectable, otherwise `false` or `undefined`.\n     */\n    isDayUnselectable: (date: DateFrameworkType) => string | false | undefined;\n\n    /**\n     * Determines if a day is highlighted.\n     *\n     * @param date - The date to check.\n     * @returns A string reason if the day is highlighted, otherwise `false` or `undefined`.\n     */\n    isDayHighlighted: (date: DateFrameworkType) => string | false | undefined;\n\n    /**\n     * Determines if a day is visible in the calendar.\n     *\n     * @param date - The date to check.\n     * @returns `true` if the day is visible, otherwise `false`.\n     */\n    isDayVisible: (date: DateFrameworkType) => boolean;\n\n    /**\n     * Determines if a date is outside the allowed date range.\n     *\n     * @param date - The date to check.\n     * * @returns -1 if before the allowed range, 0 if inside, 1 if after.\n     */\n    isOutsideAllowedDates: (date: DateFrameworkType) => -1 | 0 | 1;\n\n    /**\n     * Determines if a month is outside the allowed range.\n     *\n     * @param date - The date to check.\n     * @returns `true` if the month is outside the allowed range, otherwise `false`.\n     */\n    isOutsideAllowedMonths: (date: DateFrameworkType) => boolean;\n\n    /**\n     * Determines if a year is outside the allowed range.\n     *\n     * @param date - The date to check.\n     * @returns `true` if the year is outside the allowed range, otherwise `false`.\n     */\n    isOutsideAllowedYears: (date: DateFrameworkType) => boolean;\n\n    /**\n     * Determines if the date range is on the same day\n     *\n     * @param date - The range to check.\n     * @returns `true` if the range start and end date are the same\n     */\n    isSameDay: (date: DateFrameworkType) => boolean;\n\n    /**\n     * Sets the selected date in the calendar.\n     *\n     * @param event - The event triggering the change.\n     * @param newSelectedDate - The new date to select.\n     */\n    setSelectedDate: (\n      event:\n        | React.KeyboardEvent<HTMLButtonElement>\n        | React.MouseEvent<HTMLButtonElement, MouseEvent>,\n      newSelectedDate: DateFrameworkType,\n    ) => void;\n\n    /**\n     * Determines if a date is selected.\n     *\n     * @param date - The date to check.\n     * @returns `true` if the date is selected, otherwise `false`.\n     */\n    isSelected: (date: DateFrameworkType) => boolean;\n\n    /**\n     * Determines if a date is hovered.\n     *\n     * @param date - The date to check.\n     * @returns `true` if the date is hovered, otherwise `false`.\n     */\n    isHovered: (date: DateFrameworkType) => boolean;\n\n    /**\n     * Sets the hovered date in the calendar.\n     *\n     * @param event - The event triggering the change.\n     * @param newHoveredDate - The new date to hover.\n     */\n    setHoveredDate: (\n      event: SyntheticEvent,\n      newHoveredDate: DateFrameworkType | null,\n    ) => void;\n\n    /**\n     * Determines if a date is part of a selected span.\n     *\n     * @param date - The date to check.\n     * @returns `true` if the date is part of a selected span, otherwise `false`.\n     */\n    isSelectedSpan: (date: DateFrameworkType) => boolean;\n\n    /**\n     * Determines if a date is the start of a selected range.\n     *\n     * @param date - The date to check.\n     * @returns `true` if the date is the start of a selected range, otherwise `false`.\n     */\n    isSelectedStart: (date: DateFrameworkType) => boolean;\n\n    /**\n     * Determines if a date is the end of a selected range.\n     *\n     * @param date - The date to check.\n     * @returns `true` if the date is the end of a selected range, otherwise `false`.\n     */\n    isSelectedEnd: (date: DateFrameworkType) => boolean;\n\n    /**\n     * Determines if the hovered and a new date range would be created, if selected.\n     *\n     * @param date - The date to check.\n     * @returns `true` if the date is the start of a hovered offset, otherwise `false`.\n     */\n    isHoveredStart: (date: DateFrameworkType) => boolean;\n\n    /**\n     * Determines if a date is part of a hovered range.\n     *\n     * @param date - The date to check.\n     * @returns `true` if the date is part of a hovered offset, otherwise `false`.\n     */\n    isHoveredSpan: (date: DateFrameworkType) => boolean;\n\n    /**\n     * Determines if the hovered and a date range would be completed, if selected.\n     *\n     * @param date - The date to check.\n     * @returns `true` if the date is the end of a hovered offset, otherwise `false`.\n     */\n    isHoveredEnd: (date: DateFrameworkType) => boolean;\n\n    /**\n     * Determines if a day is selectable.\n     *\n     * @param date - The date to check.\n     * @returns `true` if the day is selectable, otherwise `false`.\n     */\n    isDaySelectable: (date: DateFrameworkType) => boolean;\n  };\n}\n\nexport function useCalendar(props: UseCalendarProps): UseCalendarReturn {\n  const {\n    dateAdapter,\n    defaultDates: { minDate: defaultMinDate, maxDate: defaultMaxDate },\n  } = useLocalization<DateFrameworkType>();\n  const {\n    createAnnouncement,\n    timezone,\n    defaultSelectedDate,\n    defaultVisibleMonth = dateAdapter.today(timezone),\n    hideOutOfRangeDates,\n    hoveredDate: hoveredDateProp,\n    focusedDate: focusedDateProp,\n    focusedDateRef,\n    isDayHighlighted = defaultIsDayHighlighted,\n    isDayUnselectable = defaultIsDayUnselectable,\n    multiselect,\n    maxDate = defaultMaxDate,\n    minDate = defaultMinDate,\n    numberOfVisibleMonths = 1,\n    onHoveredDateChange,\n    onSelectionChange,\n    onVisibleMonthChange,\n    onFocusedDateChange,\n    select,\n    selectedDate: selectedDateProp,\n    selectionVariant,\n    visibleMonth: visibleMonthProp,\n    startDateOffset,\n    endDateOffset,\n  } = props;\n  const { matchedBreakpoints } = useBreakpoint();\n\n  const responsiveNumberOfVisibleMonths =\n    resolveResponsiveValue(numberOfVisibleMonths, matchedBreakpoints) ?? 1;\n\n  const [hoveredDate, setHoveredDateState] = useControlled({\n    controlled: hoveredDateProp,\n    default: undefined,\n    name: \"Calendar\",\n    state: \"hoveredDate\",\n  });\n\n  const setHoveredDate = useCallback(\n    (event: SyntheticEvent, date: DateFrameworkType | null) => {\n      setHoveredDateState(date);\n      onHoveredDateChange?.(event, date);\n    },\n    [onHoveredDateChange],\n  );\n\n  const [visibleMonth, setVisibleMonthState] = useControlled({\n    controlled: useMemo(\n      () =>\n        visibleMonthProp\n          ? dateAdapter.startOf(visibleMonthProp, \"month\")\n          : undefined,\n      [visibleMonthProp, dateAdapter],\n    ),\n    // biome-ignore lint/correctness/useExhaustiveDependencies: just on mount\n    default: useMemo(\n      () => dateAdapter.startOf(defaultVisibleMonth, \"month\"),\n      [],\n    ),\n    name: \"Calendar\",\n    state: \"visibleMonth\",\n  });\n\n  const isOutsideAllowedDates = useCallback(\n    (date: DateFrameworkType): -1 | 0 | 1 => {\n      if (dateAdapter.compare(date, minDate) < 0) {\n        return -1;\n      }\n      if (dateAdapter.compare(date, maxDate) > 0) {\n        return 1;\n      }\n      return 0;\n    },\n    [dateAdapter, maxDate, minDate],\n  );\n\n  const isOutsideAllowedMonths = useCallback(\n    (date: DateFrameworkType) => {\n      const startOfMonth = dateAdapter.startOf(date, \"month\");\n      const endOfMonth = dateAdapter.endOf(date, \"month\");\n      return (\n        dateAdapter.compare(endOfMonth, minDate) < 0 ||\n        dateAdapter.compare(startOfMonth, maxDate) > 0\n      );\n    },\n    [dateAdapter, minDate, maxDate],\n  );\n\n  const isOutsideAllowedYears = useCallback(\n    (date: DateFrameworkType) => {\n      const startOfYear = dateAdapter.startOf(date, \"year\");\n      const endOfYear = dateAdapter.endOf(date, \"year\");\n      return (\n        dateAdapter.compare(endOfYear, minDate) < 0 ||\n        dateAdapter.compare(startOfYear, maxDate) > 0\n      );\n    },\n    [dateAdapter, minDate, maxDate],\n  );\n\n  const isDaySelectable = useCallback(\n    (date?: DateFrameworkType) =>\n      !(date && (isDayUnselectable(date) || isOutsideAllowedDates(date) !== 0)),\n    [isDayUnselectable, isOutsideAllowedDates],\n  );\n\n  const isDayVisible = useCallback(\n    (date?: DateFrameworkType | null) => {\n      if (!date) {\n        return false;\n      }\n      const startInsideDays = dateAdapter.startOf(visibleMonth, \"month\");\n      if (dateAdapter.compare(date, startInsideDays) < 0) return false;\n\n      const endVisibleMonth = dateAdapter.add(visibleMonth, {\n        months: responsiveNumberOfVisibleMonths - 1,\n      });\n      const endInsideDays = dateAdapter.endOf(endVisibleMonth, \"month\");\n\n      return !(dateAdapter.compare(date, endInsideDays) > 0);\n    },\n    [dateAdapter, responsiveNumberOfVisibleMonths, visibleMonth],\n  );\n\n  const selectionManager = useCalendarSelection({\n    defaultSelectedDate,\n    selectedDate: selectedDateProp,\n    isDaySelectable,\n    isOutsideAllowedDates,\n    multiselect,\n    onSelectionChange,\n    select,\n    selectionVariant,\n    startDateOffset,\n    endDateOffset,\n  } as UseCalendarSelectionProps);\n\n  const {\n    state: { selectedDate },\n    helpers: {\n      isSelected,\n      isSameDay,\n      setSelectedDate,\n      isSelectedStart,\n      isSelectedSpan,\n      isSelectedEnd,\n    },\n  } = selectionManager;\n\n  const isHovered = useCallback(\n    (date: DateFrameworkType) => {\n      return !!hoveredDate && dateAdapter.isSame(date, hoveredDate, \"day\");\n    },\n    [dateAdapter, hoveredDate],\n  );\n\n  const isHoveredStart = useCallback(\n    (date: DateFrameworkType) => {\n      if (\n        selectionVariant === \"range\" &&\n        hoveredDate &&\n        dateAdapter.isSame(date, hoveredDate, \"day\")\n      ) {\n        const dateRanges = (\n          Array.isArray(selectedDate) ? selectedDate : [selectedDate]\n        ) as DateRangeSelection[];\n        const allDatesPopulated = dateRanges.every(\n          (range) => range?.startDate && range?.endDate,\n        );\n        const startDateMatches = dateRanges.some(\n          (range) =>\n            range?.startDate &&\n            dateAdapter.isSame(date, range.startDate, \"day\"),\n        );\n        const firstIncompleteRange = dateRanges.find(\n          (range) => range?.startDate && !range?.endDate,\n        );\n        const newDateRangeRequired =\n          firstIncompleteRange?.startDate &&\n          dateAdapter.compare(date, firstIncompleteRange.startDate) < 0;\n        return allDatesPopulated || startDateMatches || newDateRangeRequired;\n      }\n      if (selectionVariant === \"offset\" && hoveredDate) {\n        const startDate = startDateOffset\n          ? startDateOffset(hoveredDate)\n          : hoveredDate;\n        return (\n          dateAdapter.isSame(date, startDate, \"day\") &&\n          (!isDaySelectable || isDaySelectable(date))\n        );\n      }\n      return false;\n    },\n    [\n      dateAdapter,\n      selectionVariant,\n      selectedDate,\n      hoveredDate,\n      isDaySelectable,\n      startDateOffset,\n    ],\n  );\n\n  const getDefaultFocusedDate = () => {\n    if (\n      selectedDate &&\n      (selectionVariant === \"range\" || selectionVariant === \"offset\")\n    ) {\n      const getFocusableDate = (\n        result: DateFrameworkType[],\n        selection: DateRangeSelection,\n      ) => {\n        if (selection?.startDate && isDayVisible(selection.startDate)) {\n          return [...result, selection.startDate];\n        }\n        if (selection?.endDate && isDayVisible(selection.endDate)) {\n          return [...result, selection.endDate];\n        }\n        return result;\n      };\n      let focusableSelectedDates: DateRangeSelection | DateRangeSelection[];\n      if (!multiselect) {\n        focusableSelectedDates = [selectedDate as DateRangeSelection];\n      } else {\n        focusableSelectedDates = selectedDate as DateRangeSelection[];\n      }\n      const selectionInMonth = focusableSelectedDates\n        .reduce(getFocusableDate, [])\n        .sort((a, b) => dateAdapter.compare(a, b));\n      if (selectionInMonth.length > 0) {\n        return selectionInMonth[0];\n      }\n    } else if (selectedDate && selectionVariant === \"single\") {\n      const focusableSelectedDate = multiselect\n        ? (selectedDate as SingleDateSelection[])?.[0]\n        : (selectedDate as SingleDateSelection);\n      if (focusableSelectedDate && isDayVisible(focusableSelectedDate)) {\n        return focusableSelectedDate;\n      }\n    }\n\n    // Defaults\n    if (\n      isDaySelectable?.(dateAdapter.today(timezone)) &&\n      isDayVisible(dateAdapter.today(timezone))\n    ) {\n      return dateAdapter.today(timezone);\n    }\n    const firstSelectableDate = generateDatesForMonth(\n      dateAdapter,\n      visibleMonth,\n    ).find((visibleDay) => visibleDay && isDaySelectable?.(visibleDay));\n    if (firstSelectableDate) {\n      return firstSelectableDate;\n    }\n    return null;\n  };\n\n  const [focusedDate, setFocusedDateState] = useControlled({\n    controlled: focusedDateProp,\n    // biome-ignore lint/correctness/useExhaustiveDependencies: initial value only\n    default: useMemo(() => getDefaultFocusedDate(), []),\n    name: \"Calendar\",\n    state: \"focusedDate\",\n  });\n\n  const focusableDate = useMemo(() => {\n    const dates: DateFrameworkType[] = [];\n\n    if (Array.isArray(selectedDate)) {\n      for (const selection of selectedDate) {\n        if (isDateRangeSelection(selection)) {\n          if (selection.startDate && isDayVisible(selection.startDate)) {\n            dates.push(selection.startDate);\n          } else if (selection.endDate && isDayVisible(selection.endDate)) {\n            dates.push(selection.endDate);\n          }\n        } else if (isDayVisible(selection as DateFrameworkType)) {\n          dates.push(selection as DateFrameworkType);\n        }\n      }\n    } else if (selectedDate) {\n      if (isDateRangeSelection(selectedDate)) {\n        if (selectedDate.startDate && isDayVisible(selectedDate.startDate)) {\n          dates.push(selectedDate.startDate);\n        } else if (selectedDate.endDate && isDayVisible(selectedDate.endDate)) {\n          dates.push(selectedDate.endDate);\n        }\n      } else if (isDayVisible(selectedDate)) {\n        dates.push(selectedDate);\n      }\n    }\n\n    if (\n      focusedDate &&\n      visibleMonth &&\n      dateAdapter.isSame(focusedDate, visibleMonth, \"month\")\n    ) {\n      dates.push(focusedDate);\n      return dates[0];\n    }\n\n    // Defaults\n    if (\n      dates.length === 0 &&\n      isDaySelectable(dateAdapter.today(timezone)) &&\n      isDayVisible(dateAdapter.today(timezone))\n    ) {\n      dates.push(dateAdapter.today(timezone));\n    }\n    if (dates.length === 0 || !dates.some(isDayVisible)) {\n      const firstSelectableDate = generateDatesForMonth(\n        dateAdapter,\n        visibleMonth,\n      ).find((visibleDay) => visibleDay && isDaySelectable(visibleDay));\n      if (firstSelectableDate) {\n        dates.push(firstSelectableDate);\n      }\n    }\n\n    return dates.length ? dates[0] : null;\n  }, [\n    dateAdapter,\n    focusedDate,\n    isDaySelectable,\n    isDayVisible,\n    selectedDate,\n    timezone,\n    visibleMonth,\n  ]);\n\n  const isHoveredSpan = useCallback(\n    (date: DateFrameworkType) => {\n      if (selectionVariant === \"range\") {\n        const dateRanges = Array.isArray(selectedDate)\n          ? selectedDate\n          : [selectedDate];\n        return dateRanges.some((range) => {\n          if (\n            isDateRangeSelection(range) &&\n            dateAdapter.isValid(range.startDate) &&\n            !dateAdapter.isValid(range.endDate) &&\n            isOutsideAllowedDates(range.startDate) === 0 &&\n            hoveredDate\n          ) {\n            const isForwardRange =\n              dateAdapter.compare(hoveredDate, range.startDate) > 0 &&\n              dateAdapter.compare(date, range.startDate) > 0 &&\n              dateAdapter.compare(date, hoveredDate) < 0;\n\n            const isValidDayHovered =\n              !isDaySelectable || isDaySelectable(hoveredDate);\n            return isForwardRange && isValidDayHovered;\n          }\n          return false;\n        });\n      }\n      if (selectionVariant === \"offset\" && hoveredDate) {\n        const startDate = startDateOffset\n          ? startDateOffset(hoveredDate)\n          : hoveredDate;\n        const endDate = endDateOffset\n          ? endDateOffset(hoveredDate)\n          : hoveredDate;\n        return (\n          dateAdapter.compare(date, startDate) > 0 &&\n          dateAdapter.compare(date, endDate) < 0 &&\n          (!isDaySelectable || isDaySelectable(date))\n        );\n      }\n      return false;\n    },\n    [\n      dateAdapter,\n      endDateOffset,\n      isOutsideAllowedDates,\n      selectionVariant,\n      selectedDate,\n      hoveredDate,\n      isDaySelectable,\n      startDateOffset,\n    ],\n  );\n\n  const isHoveredEnd = useCallback(\n    (date: DateFrameworkType) => {\n      if (\n        selectionVariant === \"range\" &&\n        hoveredDate &&\n        dateAdapter.isSame(date, hoveredDate, \"day\")\n      ) {\n        const dateRanges = (\n          Array.isArray(selectedDate) ? selectedDate : [selectedDate]\n        ) as DateRangeSelection[];\n        const isIncompleteRange = dateRanges.some(\n          (range) =>\n            range?.startDate &&\n            !range?.endDate &&\n            hoveredDate &&\n            dateAdapter.compare(hoveredDate, range.startDate) >= 0,\n        );\n        const endDateMatches = dateRanges.some(\n          (range) =>\n            range?.endDate && dateAdapter.isSame(range.endDate, date, \"day\"),\n        );\n        return endDateMatches || isIncompleteRange;\n      }\n      if (selectionVariant === \"offset\" && hoveredDate) {\n        const endDate = endDateOffset\n          ? endDateOffset(hoveredDate)\n          : hoveredDate;\n        return (\n          dateAdapter.isSame(date, endDate, \"day\") &&\n          (!isDaySelectable || isDaySelectable(date))\n        );\n      }\n      return false;\n    },\n    [\n      dateAdapter,\n      selectionVariant,\n      selectedDate,\n      hoveredDate,\n      endDateOffset,\n      isDaySelectable,\n    ],\n  );\n\n  const defaultCreateAnnouncement =\n    selectionVariant === \"single\"\n      ? createSingleSelectionAnnouncement\n      : createRangeSelectionAnnouncement;\n  const { announce } = useDateSelectionAnnouncer(\n    createAnnouncement === undefined\n      ? defaultCreateAnnouncement\n      : createAnnouncement,\n    dateAdapter,\n  );\n\n  const setFocusedDate = useCallback(\n    (event: SyntheticEvent | null, date: DateFrameworkType | null) => {\n      if (focusedDateRef && event?.target instanceof HTMLElement) {\n        focusedDateRef.current = event.target;\n      }\n      const exceededRangeLimit = date ? isOutsideAllowedDates(date) : 0;\n      if (\n        date &&\n        ((focusedDate && dateAdapter.isSame(date, focusedDate, \"day\")) ||\n          exceededRangeLimit !== 0)\n      ) {\n        if (exceededRangeLimit !== 0) {\n          announce(\n            exceededRangeLimit < 0\n              ? \"minFocusableDateExceeded\"\n              : \"maxFocusableDateExceeded\",\n          );\n        }\n        return;\n      }\n      setFocusedDateState(date);\n      onFocusedDateChange?.(event, date);\n    },\n    [\n      announce,\n      dateAdapter,\n      focusedDate,\n      focusedDateRef,\n      isOutsideAllowedDates,\n      onFocusedDateChange,\n    ],\n  );\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: isDayVisible ignored (due to dependency on visibleMonth)\n  useEffect(() => {\n    const shouldTransition =\n      focusedDate &&\n      !focusedDateProp !== undefined &&\n      !isDayVisible(focusedDate) &&\n      isOutsideAllowedDates(focusedDate) === 0;\n\n    if (shouldTransition) {\n      setVisibleMonth(null, dateAdapter.startOf(focusedDate, \"month\"));\n    }\n  }, [dateAdapter, focusedDateProp, isOutsideAllowedDates, focusedDate]);\n\n  const setVisibleMonth = useCallback(\n    (event: SyntheticEvent | null, newVisibleMonth: DateFrameworkType) => {\n      setVisibleMonthState(newVisibleMonth);\n      announce(\"visibleMonthChanged\", {\n        startVisibleMonth: newVisibleMonth,\n        endVisibleMonth: dateAdapter.add(newVisibleMonth, {\n          months: responsiveNumberOfVisibleMonths - 1,\n        }),\n      });\n      onVisibleMonthChange?.(event, newVisibleMonth);\n    },\n    [\n      announce,\n      dateAdapter,\n      onVisibleMonthChange,\n      responsiveNumberOfVisibleMonths,\n    ],\n  );\n\n  return useMemo(\n    () =>\n      ({\n        state: {\n          visibleMonth,\n          timezone,\n          multiselect,\n          minDate,\n          maxDate,\n          numberOfVisibleMonths: responsiveNumberOfVisibleMonths,\n          selectionVariant,\n          hideOutOfRangeDates,\n          focusedDate,\n          focusableDate,\n          focusedDateRef,\n        },\n        helpers: {\n          setVisibleMonth,\n          isDayUnselectable,\n          isDayHighlighted,\n          isDayVisible,\n          isHovered,\n          isHoveredStart,\n          isHoveredSpan,\n          isHoveredEnd,\n          isOutsideAllowedDates,\n          isOutsideAllowedMonths,\n          isOutsideAllowedYears,\n          setFocusedDate,\n          setHoveredDate,\n          isDaySelectable,\n          isSelected,\n          isSameDay,\n          setSelectedDate,\n          isSelectedStart,\n          isSelectedSpan,\n          isSelectedEnd,\n        },\n      }) as UseCalendarReturn,\n    [\n      visibleMonth,\n      timezone,\n      multiselect,\n      minDate,\n      maxDate,\n      responsiveNumberOfVisibleMonths,\n      selectionVariant,\n      hideOutOfRangeDates,\n      focusedDate,\n      focusedDateRef,\n      focusableDate,\n      setVisibleMonth,\n      isDayUnselectable,\n      isDayHighlighted,\n      isDayVisible,\n      isHovered,\n      isHoveredStart,\n      isHoveredSpan,\n      isHoveredEnd,\n      isOutsideAllowedDates,\n      isOutsideAllowedMonths,\n      isOutsideAllowedYears,\n      setFocusedDate,\n      setHoveredDate,\n      isDaySelectable,\n      isSelected,\n      isSameDay,\n      setSelectedDate,\n      isSelectedStart,\n      isSelectedSpan,\n      isSelectedEnd,\n    ],\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist-es/calendar/useCalendarDay.js

@@ -0,0 +1,82 @@
+import { useLocalization } from '../localization-provider/LocalizationProvider.js';
+import { useCalendarContext } from './internal/CalendarContext.js';
+import { useFocusManagement } from './internal/useFocusManagement.js';
+import { useCalendarSelectionDay } from './useCalendarSelection.js';
+
+function useCalendarDay(props) {
+  const { date, month } = props;
+  const { dateAdapter } = useLocalization();
+  const state = useCalendarContext();
+  const {
+    state: {
+      focusedDate,
+      focusedDateRef,
+      hideOutOfRangeDates,
+      timezone,
+      focusableDate
+    },
+    helpers: {
+      setHoveredDate,
+      isDayUnselectable,
+      isDayHighlighted,
+      isOutsideAllowedMonths,
+      isOutsideAllowedDates
+    }
+  } = state;
+  const selectionManager = useCalendarSelectionDay({ date });
+  const focusManager = useFocusManagement({ date });
+  const handleClick = (event) => {
+    selectionManager.handleClick(event);
+    focusManager.handleClick(event);
+  };
+  const handleKeyDown = (event) => {
+    focusManager.handleKeyDown(event);
+    selectionManager.handleKeyDown(event);
+  };
+  const handleFocus = (event) => {
+    focusManager.handleFocus(event);
+    setHoveredDate(event, date);
+  };
+  const handleMouseMove = (event) => {
+    setHoveredDate(event, date);
+  };
+  const eventHandlers = {
+    onClick: handleClick,
+    onKeyDown: handleKeyDown,
+    onFocus: handleFocus,
+    onMouseMove: handleMouseMove
+  };
+  const focused = focusedDate && dateAdapter.isSame(date, focusedDate, "day");
+  const tabIndex = focusableDate && dateAdapter.isSame(date, focusableDate, "day") ? 0 : -1;
+  const today = dateAdapter.isSame(dateAdapter.today(timezone), date, "day");
+  const unselectableReason = isDayUnselectable(date);
+  const highlightedReason = isDayHighlighted(date);
+  const outOfRange = !dateAdapter.isSame(date, month, "month");
+  const unselectable = Boolean(unselectableReason) || !!isOutsideAllowedMonths(date) || !!isOutsideAllowedDates(date);
+  const highlighted = Boolean(highlightedReason);
+  const hidden = hideOutOfRangeDates ? outOfRange : false;
+  return {
+    status: {
+      outOfRange,
+      today,
+      unselectable,
+      focused,
+      hidden,
+      highlighted,
+      ...selectionManager.status
+    },
+    dayProps: {
+      tabIndex,
+      "aria-current": today ? "date" : void 0,
+      "aria-hidden": hidden ? "true" : void 0,
+      ...eventHandlers,
+      ...selectionManager.dayProps
+    },
+    focusedDateRef: focused ? focusedDateRef : null,
+    unselectableReason,
+    highlightedReason
+  };
+}
+
+export { useCalendarDay };
+//# sourceMappingURL=useCalendarDay.js.map

package/dist-es/calendar/useCalendarDay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCalendarDay.js","sources":["../src/calendar/useCalendarDay.ts"],"sourcesContent":["import type { DateFrameworkType } from \"@salt-ds/date-adapters\";\nimport type {\n  ComponentPropsWithoutRef,\n  FocusEventHandler,\n  KeyboardEventHandler,\n  MouseEventHandler,\n} from \"react\";\nimport { useLocalization } from \"../localization-provider\";\nimport { useCalendarContext } from \"./internal/CalendarContext\";\nimport { useFocusManagement } from \"./internal/useFocusManagement\";\nimport { useCalendarSelectionDay } from \"./useCalendarSelection\";\n\n/**\n * Interface representing the status of a day in the Calendar.\n */\nexport interface DayStatus {\n  /**\n   * If `true`, the day is selectable but outside of current month.\n   */\n  outOfRange?: boolean;\n  /**\n   * If `true`, the day is selected.\n   */\n  selected?: boolean;\n  /**\n   * If `true`, the day is selected.\n   */\n  selectedStart?: boolean;\n  /**\n   * If `true`, the day is selected.\n   */\n  selectedSpan?: boolean;\n  /**\n   * If `true`, the day is selected.\n   */\n  selectedEnd?: boolean;\n  /**\n   * If `true`, the day is today.\n   */\n  today?: boolean;\n  /**\n   * If set, the day is unselectable with a reason.\n   */\n  unselectable?: string | false;\n  /**\n   * If set, the day is highlighted with a reason.\n   */\n  highlighted?: string | false;\n  /**\n   * If `true`, the day is focused.\n   */\n  focused?: boolean;\n  /**\n   * If `true`, the day is hidden.\n   */\n  hidden?: boolean;\n}\n\n/**\n * UseCalendar hook props to return a calendar day's status\n */\nexport interface useCalendarDayProps {\n  /**\n   * The date of the calendar day.\n   */\n  date: DateFrameworkType;\n  /**\n   * The month of the calendar day.\n   */\n  month: DateFrameworkType;\n}\n\nexport function useCalendarDay(props: useCalendarDayProps) {\n  const { date, month } = props;\n  const { dateAdapter } = useLocalization<DateFrameworkType>();\n  const state = useCalendarContext();\n  const {\n    state: {\n      focusedDate,\n      focusedDateRef,\n      hideOutOfRangeDates,\n      timezone,\n      focusableDate,\n    },\n    helpers: {\n      setHoveredDate,\n      isDayUnselectable,\n      isDayHighlighted,\n      isOutsideAllowedMonths,\n      isOutsideAllowedDates,\n    },\n  } = state;\n  const selectionManager = useCalendarSelectionDay({ date });\n  const focusManager = useFocusManagement({ date });\n\n  const handleClick: MouseEventHandler<HTMLButtonElement> = (event) => {\n    selectionManager.handleClick(event);\n    focusManager.handleClick(event);\n  };\n\n  const handleKeyDown: KeyboardEventHandler<HTMLButtonElement> = (event) => {\n    focusManager.handleKeyDown(event);\n    selectionManager.handleKeyDown(event);\n  };\n\n  const handleFocus: FocusEventHandler<HTMLButtonElement> = (event) => {\n    focusManager.handleFocus(event);\n    setHoveredDate(event, date);\n  };\n\n  const handleMouseMove: MouseEventHandler<HTMLButtonElement> = (event) => {\n    setHoveredDate(event, date);\n  };\n\n  const eventHandlers = {\n    onClick: handleClick,\n    onKeyDown: handleKeyDown,\n    onFocus: handleFocus,\n    onMouseMove: handleMouseMove,\n  };\n\n  const focused = focusedDate && dateAdapter.isSame(date, focusedDate, \"day\");\n  const tabIndex =\n    focusableDate && dateAdapter.isSame(date, focusableDate, \"day\") ? 0 : -1;\n  const today = dateAdapter.isSame(dateAdapter.today(timezone), date, \"day\");\n\n  const unselectableReason = isDayUnselectable(date);\n  const highlightedReason = isDayHighlighted(date);\n\n  const outOfRange = !dateAdapter.isSame(date, month, \"month\");\n  const unselectable =\n    Boolean(unselectableReason) ||\n    !!isOutsideAllowedMonths(date) ||\n    !!isOutsideAllowedDates(date);\n  const highlighted = Boolean(highlightedReason);\n  const hidden = hideOutOfRangeDates ? outOfRange : false;\n\n  return {\n    status: {\n      outOfRange,\n      today,\n      unselectable,\n      focused,\n      hidden,\n      highlighted,\n      ...selectionManager.status,\n    } as DayStatus,\n    dayProps: {\n      tabIndex,\n      \"aria-current\": today ? \"date\" : undefined,\n      \"aria-hidden\": hidden ? \"true\" : undefined,\n      ...eventHandlers,\n      ...selectionManager.dayProps,\n    } as ComponentPropsWithoutRef<\"button\">,\n    focusedDateRef: focused ? focusedDateRef : null,\n    unselectableReason,\n    highlightedReason,\n  };\n}\n"],"names":[],"mappings":"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"}