접근성

// spatial-nav.ts — 핵심 판정 흐름

function handleKeyDown(e: KeyboardEvent): void {
  // 1. 방향키 확인
  if (!ARROW_KEYS.has(e.key)) return;
  const dir = getDirection(e.key);

  // 2. 이미 처리됨 (Composite/Listbox/Menu 등)
  if (e.defaultPrevented) return;

  // 3. 수식키 동반
  if (e.ctrlKey || e.metaKey || e.altKey || e.shiftKey) return;

  // 4. activeElement 확인
  const el = document.activeElement as HTMLElement;
  if (!el || el === document.body) return;

  // 5. 입력 필드 보호
  if (shouldSkipArrow(el, dir)) return;

  // 6. dialog/menu/listbox 내부
  if (isInsideTrappedContext(el)) return;

  // 7. 후보 계산 및 포커스 이동
  const target = findBestCandidate(el, getTabbableElements(), dir);
  if (target) {
    e.preventDefault();
    target.focus({ preventScroll: false });
  }
}

export function getTrappedContextRole(el: HTMLElement): string | null {
  let node: HTMLElement | null = el;
  while (node) {
    const role = node.getAttribute("role");
    if (
      role === "dialog" || role === "alertdialog" ||
      role === "menu" || role === "listbox" || role === "tree"
    ) {
      return role;
    }
    if (node.hasAttribute("data-dialog")) return "dialog";
    if (node.hasAttribute("data-popover")) return "popover";
    node = node.parentElement;
  }
  return null;
}