Initial commit

-o/InteractionLayer/Interactables/BaseInteractable.puml

@@ -0,0 +1,18 @@
+@startuml
+class BaseInteractable {
+    + onSelectEnterEvent : UnityEvent
+    + onSelectExitEvent : UnityEvent
+    + onHoverEnterEvent : UnityEvent
+    + onHoverExitEvent : UnityEvent
+    + <<virtual>> onHoverEnter() : void
+    + <<virtual>> onHoverExit() : void
+    - OnMouseEnter() : void
+    - OnMouseExit() : void
+    + <<virtual>> onSelectEnter() : void
+    + <<virtual>> onSelectExit() : void
+    + <<virtual>> highLightOn() : void
+    + <<virtual>> highLightOff() : void
+}
+MonoBehaviour <|-- BaseInteractable
+IInteractable <|-- BaseInteractable
+@enduml

-o/InteractionLayer/Interactables/GrabInteractable.puml

@@ -0,0 +1,17 @@
+@startuml
+class GrabInteractable {
+    - attachPoint : Transform
+    + alignToSurfaceNormal : bool = true
+    + alignmentSpeed : float = 15f
+    + snapRotation : bool = false
+    + followSpeed : float = 20f
+    + heightOffset : float = 0f
+    - validator : IValidator
+    + validTint : Color
+    + invalidTint : Color
+    + GetAttachPoint() : Transform
+    + SetAttachPoint(attachPoint:Transform) : void
+    + GetValidator() : IValidator
+}
+MonoBehaviour <|-- GrabInteractable
+@enduml

-o/InteractionLayer/Interactables/HoveredUI.puml

@@ -0,0 +1,11 @@
+@startuml
+class HoveredUI {
+    - ghostManager : GhostManager
+    - Start() : void
+    + OnPointerEnter(eventData:PointerEventData) : void
+    + OnPointerExit(eventData:PointerEventData) : void
+}
+MonoBehaviour <|-- HoveredUI
+IPointerEnterHandler <|-- HoveredUI
+IPointerExitHandler <|-- HoveredUI
+@enduml

-o/InteractionLayer/Interactables/IInteractable.puml

@@ -0,0 +1,11 @@
+@startuml
+interface IInteractable {
+    transform : Transform <<get>>
+    onSelectEnter() : void
+    onSelectExit() : void
+    onHoverEnter() : void
+    onHoverExit() : void
+    highLightOn() : void
+    highLightOff() : void
+}
+@enduml

-o/InteractionLayer/Interactables/UIInteractable.puml

@@ -0,0 +1,16 @@
+@startuml
+class UIInteractable {
+    - uIManager : UIManager
+    - blockData : BlockData
+    - isSelected : bool = false
+    - originalColor : Color
+    - Start() : void
+    + <<override>> onSelectEnter() : void
+    + <<override>> onSelectExit() : void
+    <<internal>> getAssociatedBlockData() : BlockData
+    + setBlockData(blockData:BlockData) : void
+    + OnPointerDown(eventData:PointerEventData) : void
+}
+BaseInteractable <|-- UIInteractable
+IPointerDownHandler <|-- UIInteractable
+@enduml

-o/InteractionLayer/Interactors/DeleteInteractor.puml

@@ -0,0 +1,11 @@
+@startuml
+class DeleteInteractor {
+    - inputProvider : BaseInputProvider
+    - commandHandler : CommandHandler
+    - selectionManager : SelectionManager
+    - Start() : void
+    + DeleteObjects() : void
+    - FindBlockIndex(obj:GameObject) : string
+}
+MonoBehaviour <|-- DeleteInteractor
+@enduml

-o/InteractionLayer/Interactors/RayInteractor.puml

@@ -0,0 +1,22 @@
+@startuml
+class RayInteractor {
+    - {static} instance : RayInteractor
+    + {static} getInstance() : RayInteractor
+    - gizmoLayerMask : LayerMask
+    - interactableLayerMask : LayerMask
+    - worldLayerMask : LayerMask
+    - inputProvider : BaseInputProvider
+    - mainCamera : Camera
+    - lastHit : RaycastHit
+    - currentGizmo : GameObject
+    + OnWorldClick : UnityEvent
+    + OnSelectEvent : UnityEvent<IInteractable>
+    - Awake() : void
+    - Start() : void
+    - SetupInput() : void
+    + GetHitInfo(hitInfo:RaycastHit) : bool
+    + GetCurrentGizmo() : GameObject
+    + GetHitPosition() : Vector3
+}
+MonoBehaviour <|-- RayInteractor
+@enduml

-o/InteractionLayer/Interactors/SnapSystem.puml

@@ -0,0 +1,18 @@
+@startuml
+class SnapSystem {
+    - {static} instance : SnapSystem
+    + {static} getInstance() : SnapSystem
+    - socketDetectionRadius : float = 0.5f
+    - <<readonly>> nearbySockets : List<SocketPoint>
+    - <<readonly>> visitedRoots : HashSet<Transform>
+    - closestSocket : SocketPoint
+    - Awake() : void
+    + UpdateSockets(detectionPoint:Vector3, ghostRoot:Transform) : void
+    + ClearHighlights() : void
+    + Clear() : void
+    + GetNearbySockets() : List<SocketPoint>
+    + GetClosestSocket() : SocketPoint
+    - {static} FindClosest(position:Vector3, sockets:List<SocketPoint>) : SocketPoint
+}
+MonoBehaviour <|-- SnapSystem
+@enduml

-o/InteractionLayer/Interactors/TestCommandInteractor.puml

@@ -0,0 +1,7 @@
+@startuml
+class TestCommandInteractor {
+    - commandHandler : CommandHandler
+    - Update() : void
+}
+MonoBehaviour <|-- TestCommandInteractor
+@enduml

-o/InteractionLayer/Managers/GhostExtensions/AxisMoveStrategy.puml

@@ -0,0 +1,20 @@
+@startuml
+class AxisMoveStrategy {
+    - <<readonly>> _lockedRotation : Quaternion
+    - _isDragging : bool
+    - _axisDirection : Vector3
+    - _axisOrigin : Vector3
+    - _clampMin : float
+    - _clampMax : float
+    - _camera : Camera
+    - _frozenPosition : Vector3
+    - _lastMousePos : Vector2
+    - _accumulated : float
+    + AxisMoveStrategy(lockedRotation:Quaternion, clampMin:float, clampMax:float)
+    + BeginDrag(axisDirection:Vector3, ghostPosition:Vector3) : void
+    + EndDrag() : void
+    + UpdateMovement(ctx:GhostMovementContext) : void
+    - TrySocketSnap(ctx:GhostMovementContext) : bool
+}
+IGhostMovementStrategy <|-- AxisMoveStrategy
+@enduml

-o/InteractionLayer/Managers/GhostExtensions/AxisRotateStrategy.puml

@@ -0,0 +1,24 @@
+@startuml
+class AxisRotateStrategy {
+    + OverridesSurfaceTracking : bool <<get>>
+    - <<readonly>> _localAxis : LocalAxis
+    - <<readonly>> _lockedPosition : Vector3
+    - _isRotating : bool
+    - _pendingDegrees : float
+    - _lastMousePos : Vector2
+    + Sensitivity : float = 0.4f
+    + AxisRotateStrategy(localAxis:LocalAxis, lockedPosition:Vector3)
+    + BeginRotate() : void
+    + EndRotate() : void
+    + UpdateMovement(ctx:GhostMovementContext) : void
+    - GetWorldAxis(t:Transform) : Vector3
+    - {static} SnapToNearestRightAngle(q:Quaternion) : Quaternion
+}
+enum LocalAxis {
+    Up,
+    Forward,
+    Right,
+}
+IGhostMovementStrategy <|-- AxisRotateStrategy
+AxisRotateStrategy +-- LocalAxis
+@enduml

-o/InteractionLayer/Managers/GhostExtensions/FreeMoveStrategy.puml

@@ -0,0 +1,12 @@
+@startuml
+class FreeMoveStrategy {
+    + UpdateMovement(ctx:GhostMovementContext) : void
+    - {static} TrySocketSnap(ctx:GhostMovementContext) : bool
+    - {static} PerformSocketSnap(ctx:GhostMovementContext) : void
+    - {static} AlignToSurfaceNormal(ctx:GhostMovementContext) : void
+    - {static} MoveAlongSurface(ctx:GhostMovementContext) : void
+    - {static} GetCurrentPivot(ctx:GhostMovementContext) : Transform
+    - {static} SnapToNearestRightAngle(q:Quaternion) : Quaternion
+}
+IGhostMovementStrategy <|-- FreeMoveStrategy
+@enduml

-o/InteractionLayer/Managers/GhostExtensions/GhostMovementContext.puml

@@ -0,0 +1,16 @@
+@startuml
+struct GhostMovementContext {
+    + <<readonly>> GhostTransform : Transform
+    + <<readonly>> SurfacePoint : Vector3
+    + <<readonly>> SurfaceNormal : Vector3
+    + <<readonly>> MySocket : SocketPoint
+    + <<readonly>> TargetSocket : SocketPoint
+    + <<readonly>> AttachPoint : Transform
+    + <<readonly>> FollowSpeed : float
+    + <<readonly>> HeightOffset : float
+    + <<readonly>> AlignToSurfaceNormal : bool
+    + <<readonly>> SnapRotation : bool
+    + RotationAxis : Vector3
+    + GhostMovementContext(ghostTransform:Transform, surfacePoint:Vector3, surfaceNormal:Vector3, mySocket:SocketPoint, targetSocket:SocketPoint, attachPoint:Transform, followSpeed:float, heightOffset:float, alignToSurfaceNormal:bool, snapRotation:bool)
+}
+@enduml

-o/InteractionLayer/Managers/GhostExtensions/GhostStrategyHandler.puml

@@ -0,0 +1,18 @@
+@startuml
+class GhostStrategyHandler {
+    - {static} instance : GhostStrategyHandler
+    + {static} getInstance() : GhostStrategyHandler
+    - ghostManager : GhostManager
+    - Awake() : void
+    - Start() : void
+    + StartDraggingRight() : void
+    + StartDraggingUp() : void
+    + StartDraggingForward() : void
+    + EndDragging() : void
+    + StartRotatingRight() : AxisRotateStrategy
+    + StartRotatingUp() : AxisRotateStrategy
+    + StartRotatingForward() : AxisRotateStrategy
+    + StartRotation() : void
+}
+MonoBehaviour <|-- GhostStrategyHandler
+@enduml

-o/InteractionLayer/Managers/GhostExtensions/GhostStrategyTester.puml

@@ -0,0 +1,41 @@
+@startuml
+class GhostStrategyTester {
+    + TestTarget : GameObject
+    + ClampMin : float
+    + ClampMax : float = 5f
+    + RotateSensitivity : float = 0.4f
+    - _mode : Mode
+    - _moveStrat : AxisMoveStrategy
+    - _rotStrat : AxisRotateStrategy
+    - _isEditing : bool
+    - _buttonHeld : bool
+    - _activeAxisIndex : int
+    - _lastMouseX : float
+    - _editingOrigin : Vector3
+    - {static} <<readonly>> AxisColors : Color[]
+    - {static} <<readonly>> AxisLabels : string[]
+    - {static} <<readonly>> LocalMoveAxes : Vector3[]
+    - {static} <<readonly>> RotateAxes : AxisRotateStrategy.LocalAxis[]
+    - <<const>> BtnW : float = 96f
+    - <<const>> BtnH : float = 36f
+    - <<const>> PadX : float = 12f
+    - <<const>> PadY : float = 8f
+    - Start() : void
+    - OnGUI() : void
+    - DrawAxisButton(i:int, rect:Rect) : void
+    - OnAxisButtonDown(axisIndex:int) : void
+    - OnAxisButtonUp() : void
+    - EnsureEditing() : void
+    - CommitEdit() : void
+    - StopEditing() : void
+    - ResetState() : void
+    - DrawModeButton(label:string, target:Mode, rect:Rect) : void
+}
+enum Mode {
+    None,
+    AxisMove,
+    AxisRotate,
+}
+MonoBehaviour <|-- GhostStrategyTester
+GhostStrategyTester +-- Mode
+@enduml

-o/InteractionLayer/Managers/GhostExtensions/IGhostMovementStrategy.puml

@@ -0,0 +1,5 @@
+@startuml
+interface IGhostMovementStrategy {
+    UpdateMovement(ctx:GhostMovementContext) : void
+}
+@enduml

-o/InteractionLayer/Managers/GhostManager.puml

@@ -0,0 +1,72 @@
+@startuml
+class GhostManager {
+    - {static} instance : GhostManager
+    + {static} getInstance() : GhostManager
+    - selectedBlockData : BlockData
+    - ghostObject : GameObject
+    - canPlace : bool = false
+    - onClearEvent : UnityEvent
+    - alignToSurfaceNormal : bool = true
+    - snapRotation : bool = false
+    - followSpeed : float = 20f
+    - heightOffset : float = 0f
+    - validTint : Color
+    - invalidTint : Color
+    - attachPoint : Transform
+    - validator : IValidator
+    - isValidPlacement : bool = true
+    - currentSurfaceNormal : Vector3
+    - currentSurfacePoint : Vector3
+    - rotationAxis : Vector3
+    - ghostRenderers : Renderer[]
+    - container : SocketContainer
+    - jointBlock : JointBlock
+    - block : Block
+    - isDragged : bool = false
+    - isJustPlaced : bool = false
+    - editingSourceObject : GameObject
+    - editingOriginalPos : Vector3
+    - editingOriginalRot : Quaternion
+    - isEditingExisting : bool
+    - currentStrategy : IGhostMovementStrategy
+    + SetMovementStrategy(strategy:IGhostMovementStrategy) : void
+    - rayInteractor : RayInteractor
+    - snappingSystem : SnapSystem
+    - environment : Environment
+    - commandHandler : CommandHandler
+    - socketIterator : SocketIterator
+    - inputProvider : BaseInputProvider
+    - Awake() : void
+    - Start() : void
+    - Update() : void
+    + GhostTransform : Transform <<get>>
+    + setDrag(drag:bool) : void
+    - OnPlace() : void
+    + ForcePlace() : void
+    - resetPlaced() : IEnumerator
+    - OnPlaceWithDragging() : void
+    - PlaceBlock() : void
+    - CommitExistingBlock() : void
+    + SetupBlock(blockData:BlockData) : void
+    + SetupExistingBlock(sourceObject:GameObject, strategy:IGhostMovementStrategy) : void
+    - InitialiseGhostFromObject(ghost:GameObject) : void
+    + HasActiveGhost() : bool
+    + isGhost(obj:GameObject) : bool
+    + ClearGhost() : void
+    + ClearGhostData() : void
+    - UpdateSurfaceTracking() : void
+    - UpdateVisualFeedback(isValid:bool) : void
+    - {static} SetLayerRecursively(obj:GameObject, layer:int, Method:Func<Transform, bool>) : void
+    - {static} SetLayerRecursively(obj:GameObject, layer:int) : void
+    - {static} RestoreMaterialAlpha(obj:GameObject, Method:Func<GameObject, bool>) : void
+    - {static} RestoreMaterialAlpha(obj:GameObject) : void
+    - {static} RestoreMaterialColor(obj:GameObject, Method:Func<GameObject, bool>) : void
+    - {static} RestoreMaterialColor(obj:GameObject) : void
+    + onClearAddListener(action:UnityAction) : void
+    + setupBlock(blockData:BlockData) : void
+    + clearGhost() : void
+    + clearGhostData() : void
+    - afterCreation(blockObj:GameObject) : void
+}
+MonoBehaviour <|-- GhostManager
+@enduml

-o/InteractionLayer/Managers/InteractionManager.puml

@@ -0,0 +1,14 @@
+@startuml
+class InteractionManager {
+    - {static} instance : InteractionManager
+    - commandHandler : CommandHandler
+    - ghostManager : GhostManager
+    - selectionManager : SelectionManager
+    - uiManager : UIManager
+    - Awake() : void
+    + {static} getInstance() : InteractionManager
+    - Start() : void
+    - setupListeners() : void
+}
+MonoBehaviour <|-- InteractionManager
+@enduml

-o/InteractionLayer/Managers/SelectionManager.puml

@@ -0,0 +1,18 @@
+@startuml
+class SelectionManager {
+    - {static} instance : SelectionManager
+    + {static} getInstance() : SelectionManager
+    - rayInteractor : RayInteractor
+    - inputProvider : BaseInputProvider
+    - <<readonly>> currentSelections : List<IInteractable>
+    - multiSelectEnabled : bool = false
+    + SelectionEvent : UnityEvent<IInteractable>
+    - Awake() : void
+    - Start() : void
+    - HandleSelect(interactable:IInteractable) : void
+    + GetCurrentSelections() : List<IInteractable>
+    + ClearSelection() : void
+    + HasOneSelection() : bool
+}
+MonoBehaviour <|-- SelectionManager
+@enduml

-o/InteractionLayer/Managers/SocketManagerChecker.puml

@@ -0,0 +1,18 @@
+@startuml
+class SocketManagerChecker {
+    - environment : Environment
+    - ghostManager : GhostManager
+    - rayInteractor : RayInteractor
+    - jointPlacementHandler : JointPlacementHandler
+    - socketTolerance : float = 0.5f
+    - Start() : void
+    - OnRemove(arg0:Block) : void
+    - OnAdd(arg0:Block) : void
+    - OnBlockRemoved(arg0:Block) : void
+    - OnJointRemoved(arg0:Block) : void
+    - OnBlockAdded(arg0:Block) : void
+    - OnJointAdded(arg0:Block) : void
+    - getClosestSocketBy(socketPoint:SocketPoint, tol:float) : SocketPoint
+}
+MonoBehaviour <|-- SocketManagerChecker
+@enduml

-o/InteractionLayer/Managers/UIManager.puml

@@ -0,0 +1,14 @@
+@startuml
+class UIManager {
+    - {static} instance : UIManager
+    - currentSelectedUIInteractable : UIInteractable
+    - currentSelectedData : BlockData
+    + onSelectEvent : UnityEvent<BlockData>
+    - currentCategory : CategoryData
+    - Awake() : void
+    + {static} getInstance() : UIManager
+    + selectUIInteractable(uiInteractable:UIInteractable) : void
+    + deselectUIInteractable() : void
+}
+MonoBehaviour <|-- UIManager
+@enduml