nexarch/web/dms-browser/lib/treeKeyboard.ts

// Reine Tastatur-Navigationslogik fuer den Ordnerbaum (Akzeptanzkriterium/
// Pflichtpruefung 2: Navigation vollstaendig per Tastatur) — arbeitet auf
// einer FLACHEN, sichtbaren Reihenfolge von Knoten (bereits nach Ein-/
// Ausklapp-Zustand aufgeloest), damit sie ohne DOM/React testbar ist.

export type TreeKeyAction =
  | { type: "moveDown" }
  | { type: "moveUp" }
  | { type: "expand" } // Pfeil rechts: aufklappen ODER ins erste Kind springen
  | { type: "collapse" } // Pfeil links: zuklappen ODER zum Elternteil springen
  | { type: "select" }; // Enter/Leertaste

export function mapTreeKeyToAction(key: string): TreeKeyAction | null {
  switch (key) {
    case "ArrowDown":
      return { type: "moveDown" };
    case "ArrowUp":
      return { type: "moveUp" };
    case "ArrowRight":
      return { type: "expand" };
    case "ArrowLeft":
      return { type: "collapse" };
    case "Enter":
    case " ":
      return { type: "select" };
    default:
      return null;
  }
}

export function moveFocus(currentIndex: number, visibleCount: number, direction: 1 | -1): number {
  if (visibleCount === 0) return 0;
  const next = currentIndex + direction;
  if (next < 0) return 0;
  if (next >= visibleCount) return visibleCount - 1;
  return next;
}