#nullable enable using System; using System.Collections.Generic; using UnityEngine; namespace UVC.UI.List.Tree { /// /// 드래그 위치 표현. 위/안쪽/아래. /// public enum TreeDropPosition { Above, InsideAsChild, Below } /// /// 트리 리스트의 드래그 & 드롭 상호작용을 상태와 이벤트로 중재하는 관리자입니다. /// /// 역할: /// - 드래그 시작/진행/종료 상태 관리(상태 머신) /// - 드롭 유효성 검사(자기 자신/조상에게 드롭 금지로 순환 참조 방지) /// - 구독자에게 이벤트로 진행 상황 전달 /// /// 책임 경계: /// - 이 매니저는 데이터를 직접 수정(이동/부모 변경)하지 않습니다. /// - 실제 아이템 재배치/재귀 로직은 이벤트 구독자(예: 리스트/뷰 모델)에서 수행해야 합니다. /// /// 이벤트 흐름: /// - StartDrag → OnDragStarted(once) /// - OnDragOver/OnDragHovered → OnDragEntered(repeat) /// - TryDrop 유효 시 → OnDropped → (caller) EndDrag → OnDragEnded /// - TryDrop 무효/취소 시 → (caller) EndDrag → OnDragEnded /// public class TreeListDragDropManager { /// /// 현재 드래그 중인 아이템입니다(드래그 중이 아니면 null). /// public TreeListItemData? DraggedItem { get; private set; } /// /// 현재 드래그 중인 상태인지 여부입니다. /// public bool IsDragging { get; private set; } /// /// 드래그 시작 시1회 발생하는 이벤트입니다. /// 핸들러 시그니처: (TreeListItemData dragged) /// public Action? OnDragStarted; /// /// 드래그 진행 중 마우스가 특정 아이템 위에 있을 때 반복적으로 발생하는 이벤트입니다. /// 빈 공간 위라면 targetItem은 null이 될 수 있습니다. /// 핸들러 시그니처: (TreeListItemData dragged, TreeListItemData? targetItem) /// public Action? OnDragEntered; /// /// 드래그 진행 중 hover 대상과 의도된 드롭 위치를 함께 통지합니다. /// 핸들러 시그니처: (TreeListItemData dragged, TreeListItemData? targetItem, TreeDropPosition pos) /// public Action? OnDragHovered; /// /// 드래그가 종료될 때 발생하는 이벤트입니다(드롭 성공/실패/취소 포함). /// 핸들러 시그니처: (TreeListItemData dragged) /// public Action? OnDragEnded; /// /// 유효성 검사를 통과한 드롭이 확정될 때 발생하는 이벤트입니다. /// 핸들러 시그니처: (TreeListItemData dragged, TreeListItemData? target) /// 이 이벤트에서 실제 데이터 구조 변경(이동/부모 변경/정렬)을 수행하세요. /// public Action? OnDropped; /// /// 드래그를 시작합니다. 이미 드래그 중이면 무시됩니다. /// /// 드래그할 아이템. public void StartDrag(TreeListItemData draggedItem) { if (IsDragging) { return; } DraggedItem = draggedItem; IsDragging = true; OnDragStarted?.Invoke(draggedItem); } /// /// 드래그 중 마우스가 다른 아이템(또는 빈 영역) 위에 있을 때 호출됩니다. /// 상태를 변경하지 않고, 단순히 현재 hover 대상을 이벤트로 통지합니다. /// /// 현재 마우스 아래의 아이템. 빈 공간이면 null. public void OnDragOver(TreeListItemData? targetItem) { if (!IsDragging || DraggedItem == null) { return; } OnDragEntered?.Invoke(DraggedItem, targetItem); } /// /// 드래그 중 hover 대상과 드롭 위치를 함께 통지합니다. /// /// 현재 마우스 아래의 아이템(null 가능) /// 의도된 드롭 위치 public void OnDragOver(TreeListItemData? targetItem, TreeDropPosition position) { if (!IsDragging || DraggedItem == null) { return; } // 하위 호환 이벤트도 호출 OnDragEntered?.Invoke(DraggedItem, targetItem); OnDragHovered?.Invoke(DraggedItem, targetItem, position); } /// /// 드래그를 종료합니다. 드래그 중이 아니면 아무 동작도 하지 않습니다. /// public void EndDrag() { if (!IsDragging || DraggedItem == null) { return; } OnDragEnded?.Invoke(DraggedItem); IsDragging = false; DraggedItem = null; } /// /// 드래그된 아이템을 대상 아이템에 드롭 시도합니다. /// 유효성 검사(자기 자신/조상에게 드롭 금지)를 통과한 경우에만 OnDropped를 발생시킵니다. /// EndDrag는 호출 측(뷰/핸들러)에서 호출해야 합니다. /// /// 드롭 대상 아이템. 루트 레벨로 드롭하려면 null. /// 미사용 예약 필드. -1이면 끝에 추가 의도. /// OnDropped가 발생하면 true, 아니면 false. public bool TryDrop(TreeListItemData? targetItem, int insertIndex = -1) { if (!IsDragging || DraggedItem == null) { return false; } // 자기 자신에게 드롭하는 경우 무시 if (targetItem != null && targetItem == DraggedItem) { return false; } // 순환 참조 검사 (드래그 아이템이 드롭 대상의 부모인 경우) if (targetItem != null && IsAncestorOf(DraggedItem, targetItem)) { return false; } OnDropped?.Invoke(DraggedItem, targetItem); return true; } /// /// 첫 번째 아이템이 두 번째 아이템의 조상인지 확인합니다. /// public static bool IsAncestorOf(TreeListItemData potentialAncestor, TreeListItemData potentialDescendant) { var current = potentialDescendant.Parent; while (current != null) { if (current == potentialAncestor) { return true; } current = current.Parent; } return false; } /// /// 드래그 & 드롭 상태를 초기화합니다. /// public void Reset() { IsDragging = false; DraggedItem = null; } } }