@astryxdesign/core 0.1.2 → 0.1.3-canary.6d57c8d

package/src/Calendar/hooks/useCalendarRovingTabindex.ts

@@ -1,118 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-'use client';
-
-/**
- * @file useCalendarRovingTabindex.ts
- * @input Uses React useMemo, PlainDate utilities
- * @output Exports useCalendarRovingTabindex hook for accessible grid navigation
- * @position Calendar-specific hook; used by Calendar
- *
- * SYNC: When modified, update:
- * - /packages/core/src/Calendar/hooks/index.ts
- */
-
-import {useMemo} from 'react';
-import type {ISODateString} from '../../utils/dateTypes';
-import {type PlainDate, plainDateToISO} from '../../utils/plainDate';
-import type {CalendarDay} from './useCalendarDays';
-
-/**
- * Configuration for calendar roving tabindex
- */
-export interface UseCalendarRovingTabindexOptions {
-  /** All days in the grid */
-  days: CalendarDay[];
-  /** Today's date as a PlainDate */
-  today: PlainDate;
-  /** The year being displayed */
-  year: number;
-  /** The month being displayed (1-based: 1 = January, 12 = December) */
-  month: number;
-  /** Function to check if a date is disabled */
-  isDateDisabled: (date: PlainDate) => boolean;
-  /** Currently selected date (if any) */
-  selectedDate?: PlainDate | null;
-}
-
-/**
- * Return type for useCalendarRovingTabindex hook
- */
-export interface UseCalendarRovingTabindexReturn {
-  /** The ISO date string of the tabbable element, or null */
-  tabbableDate: ISODateString | null;
-  /** Check if a specific date is the tabbable one */
-  isTabbable: (iso: ISODateString) => boolean;
-}
-
-/**
- * Hook for managing roving tabindex in calendar grids.
- *
- * Implements the WAI-ARIA roving tabindex pattern where only one element
- * in a group has tabindex="0" while others have tabindex="-1".
- *
- * Priority for tabbable element:
- * 1. Today if visible in the current month and enabled
- * 2. First enabled day in the month
- *
- * @example
- * ```
- * const {tabbableDate, isTabbable} = useCalendarRovingTabindex({
- *   days,
- *   today: {year: 2026, month: 1, day: 20},
- *   year: 2026,
- *   month: 1, // January (1-based)
- *   isDateDisabled,
- * });
- *
- * // In day rendering:
- * <button tabIndex={isTabbable(day.iso) ? 0 : -1}>
- *   {day.dayNumber}
- * </button>
- * ```
- */
-export function useCalendarRovingTabindex(
-  options: UseCalendarRovingTabindexOptions,
-): UseCalendarRovingTabindexReturn {
-  const {days, today, year, month, isDateDisabled, selectedDate} = options;
-
-  // Determine which day should be tabbable
-  const tabbableDate = useMemo(() => {
-    // Priority 1: Selected date if visible in this month and enabled
-    if (selectedDate) {
-      const isSelectedInMonth =
-        selectedDate.year === year && selectedDate.month === month;
-      if (isSelectedInMonth && !isDateDisabled(selectedDate)) {
-        return plainDateToISO(selectedDate);
-      }
-    }
-
-    // Priority 2: Today if visible in this month and enabled
-    const isTodayInMonth = today.year === year && today.month === month;
-
-    if (isTodayInMonth && !isDateDisabled(today)) {
-      return plainDateToISO(today);
-    }
-
-    // Priority 3: First enabled day in this month
-    for (const day of days) {
-      if (!day.isOutside && !isDateDisabled(day.date)) {
-        return day.iso;
-      }
-    }
-
-    return null;
-  }, [days, today, year, month, isDateDisabled, selectedDate]);
-
-  // Check if a specific date is tabbable
-  const isTabbable = useMemo(() => {
-    return (iso: ISODateString): boolean => {
-      return tabbableDate !== null && iso === tabbableDate;
-    };
-  }, [tabbableDate]);
-
-  return {
-    tabbableDate,
-    isTabbable,
-  };
-}