added documentation, fixed some bugs

Packages/com.jovian.popup-system/Runtime/UI/PopupTrigger.cs

@@ -1,54 +1,48 @@
-using System;
 using UnityEngine;
 using UnityEngine.EventSystems;
 
 namespace Jovian.PopupSystem.UI {
+    /// <summary>
+    /// Reference holder MonoBehaviour for popup triggers. Attach to any UI element with a
+    /// Graphic component (Image, TMP_Text, etc.) that has Raycast Target enabled.
+    /// Configure category, anchor side, and position mode in the Inspector.
+    /// Forwards pointer events to the bound <see cref="PopupTriggerView"/>.
+    /// </summary>
     public class PopupTrigger : MonoBehaviour, IPointerEnterHandler, IPointerExitHandler {
         [SerializeField] PopupCategory category;
         [SerializeField] AnchorSide anchorSide = AnchorSide.Below;
         [SerializeField] PopupPositionMode positionMode = PopupPositionMode.AnchorToElement;
 
-        IPopupSystem popupSystem;
-        Action<PopupContentBuilder> contentCallback;
-        bool initialized;
+        PopupTriggerView handler;
 
+        /// <summary>The popup category this trigger belongs to.</summary>
         public PopupCategory Category => category;
 
-        public void Initialize(IPopupSystem popupSystem, Action<PopupContentBuilder> contentCallback) {
-            this.popupSystem = popupSystem;
-            this.contentCallback = contentCallback;
-            initialized = true;
-        }
-
-        public void Initialize(IPopupSystem popupSystem, PopupCategory category, Action<PopupContentBuilder> contentCallback) {
-            this.popupSystem = popupSystem;
-            this.category = category;
-            this.contentCallback = contentCallback;
-            initialized = true;
-        }
-
-        public void UpdateContent(Action<PopupContentBuilder> contentCallback) {
-            this.contentCallback = contentCallback;
+        /// <summary>Which side of this element the popup anchors to.</summary>
+        public AnchorSide AnchorSide => anchorSide;
+
+        /// <summary>Whether the popup anchors to this element or follows the mouse.</summary>
+        public PopupPositionMode PositionMode => positionMode;
+
+        /// <summary>The bound behavior handler. Null until <see cref="Bind"/> is called.</summary>
+        public PopupTriggerView Handler => handler;
+
+        /// <summary>
+        /// Binds a <see cref="PopupTriggerView"/> to this trigger. Called automatically
+        /// by <see cref="IPopupSystem.ScanTriggers"/> or <see cref="IPopupSystem.InitializeTriggersInChildren"/>.
+        /// </summary>
+        public void Bind(PopupTriggerView view) {
+            handler = view;
         }
 
+        /// <summary>Forwards pointer enter to the bound handler.</summary>
         public void OnPointerEnter(PointerEventData eventData) {
-            if(!initialized || popupSystem == null || contentCallback == null) {
-                return;
-            }
-
-            if(positionMode == PopupPositionMode.AnchorToElement) {
-                popupSystem.Show(category, contentCallback, (RectTransform)transform, anchorSide);
-            }
-            else {
-                popupSystem.Show(category, contentCallback);
-            }
+            handler?.OnPointerEnter(this);
         }
 
+        /// <summary>Forwards pointer exit to the bound handler.</summary>
         public void OnPointerExit(PointerEventData eventData) {
-            if(!initialized || popupSystem == null) {
-                return;
-            }
-            popupSystem.Hide(category);
+            handler?.OnPointerExit(this);
         }
     }
 }